Settings & Export
Configure Resolume paths, manage autosave and logging, export your project to Resolume Advanced Output XML, and keep Filament up to date.
Settings & Export
The Settings tab and the Export dialog cover the operational side of Filament: project autosave, Resolume paths, application status, logging, and the handoff from Filament into Resolume Advanced Output XML.
Settings
License
The Settings page now includes a dedicated License card.
Use it to:
- review the current license state (
trial,licensed, orstale/offline) - paste and activate a purchased license key
- revalidate the current installation against Filament's backend
- remove the license from the current machine before moving seats
- jump to the customer portal or purchase flow
Filament stores the raw license key in the operating system's secure credential store where available, and stores signed license receipts plus non-secret state in the app's local database.
Trial vs paid behavior
The trial uses the same Filament binary as the paid app. The two enforced trial restrictions are:
- Export is disabled until the app has a valid paid license
- Live output is disrupted every 20 seconds while the app remains in trial mode
Support-oriented log export remains available in trial mode. That keeps troubleshooting possible even when paid export surfaces are locked.
Theme
Filament ships with a large set of DaisyUI themes. Open Settings and choose the one that works best in your environment.
Each theme button shows its primary, secondary, accent, and neutral colors at a glance, and the change applies immediately.
[GRAPHIC: Screenshot of the Settings theme picker showing the grid of theme swatches and the active theme selection]
Project auto-save
Filament can save your work automatically in the background.
- Enable project auto-save - turns periodic autosave on or off
- Auto-save interval - choose any whole-minute interval from 1 to 60 minutes
The default interval is 1 minute. If you are making risky edits and want full manual control, disable autosave temporarily and save explicitly instead.
Resolume paths
For Filament to exchange fixtures and Advanced Output data with Resolume Arena, it needs to know two directory locations:
Fixture library - where Resolume stores fixture-definition XML files. When this path is set correctly:
- Import from Resolume in Library -> Fixtures can read your existing Resolume fixtures
- Export from a fixture detail view can write a fixture back into Resolume's fixture library
- Also export fixtures to Resolume Fixture Library in the export dialog can publish custom fixtures alongside your XML export
Advanced output - where Resolume stores Advanced Output configurations.
Filament tries to detect both paths automatically. If your Resolume setup lives somewhere unusual, use the Choose Fixture Directory and Choose Advanced Output Directory buttons, then Refresh to re-check status.
Application status & logs
The current Settings page includes a dedicated Application status & logs surface for troubleshooting and operator handoff.
It shows:
- Database path
- Logs folder
- Active session log
- Crash reports count
- any detected path issues
It also gives you direct controls for:
- Retention (days) for automatic log pruning
- Verbosity (
StandardorVerbose) - Transport debug logging for route/output troubleshooting
- Apply Log Settings
- Open Logs Folder
- Export Logs
Crash reports are not just raw stack traces. Filament also records context such as app version, project/canvas output summary, diagnostics snapshot, readiness state, and recent runtime log events when available.
[GRAPHIC: Screenshot of the Application status & logs card showing database path, logs folder, crash-report count, retention/verbosity controls, and the Open Logs Folder / Export Logs buttons]
Keyboard shortcuts
Press Cmd+/ (macOS) or Ctrl+/ (Windows) to open the keyboard shortcuts reference dialog from anywhere in the app.
Full shortcuts reference
Tools:
| Key | Action |
|---|---|
V | Select tool |
H | Pan tool |
P | Bezier pen (draw curves) |
B | Freehand pen |
Space (hold) | Temporary pan from any tool |
View:
| Key | Action |
|---|---|
G | Toggle grid |
Cmd/Ctrl + 0 | Fit canvas to view |
Cmd/Ctrl + = / + | Zoom in |
Cmd/Ctrl + - | Zoom out |
Alt/Option + Scroll | Zoom canvas at the pointer |
Edit:
| Key | Action |
|---|---|
Cmd/Ctrl + Z | Undo |
Cmd/Ctrl + Shift + Z | Redo |
Cmd/Ctrl + Y | Redo (alternative) |
Cmd/Ctrl + A | Select all in current Surface |
Cmd/Ctrl + D | Duplicate selection |
Delete / Backspace | Delete selection |
Escape | Deselect / cancel drawing |
File and navigation:
| Key | Action |
|---|---|
Cmd/Ctrl + N | New project dialog |
Cmd/Ctrl + S | Save current project |
Cmd/Ctrl + E | Export XML |
Cmd/Ctrl + Shift + R | Refresh library |
Cmd/Ctrl + 1 | Go to Library |
Cmd/Ctrl + 2 | Go to Canvas |
Cmd/Ctrl + 3 | Go to Output |
Cmd/Ctrl + 4 | Go to Player |
Cmd/Ctrl + 5 | Go to Settings |
Player:
| Key | Action |
|---|---|
Space | Play / Pause |
B | Toggle blackout |
[ | Decrease animation speed |
] | Increase animation speed |
- | Decrease brightness |
+ | Increase brightness |
← / → | Step sequential LED test |
Exporting to Resolume
When your layout is ready to hand off to Resolume, use File -> Export to generate an Advanced Output XML file.
If Filament is still in trial mode, the export commands stay blocked. Activate a paid license first from Settings -> License.
What the export contains
Filament's export can include:
- every Surface in the project
- each slice's geometry and DMX channel assignment
- output rectangles for Resolume sampling
- optionally, fixture definitions for Resolume's fixture library
Opening export preview
The export dialog opens with a project summary and immediately runs validation.
[GRAPHIC: Screenshot of the export dialog showing project summary, validation state, and the conversion preview list]
The summary includes:
- Project
- Canvas Size
- Surfaces
- Total Fixtures
- Total DMX Channels
Validation and readiness
If the preview is not valid yet, Filament shows Cannot export yet and lists blocking errors. Common categories include:
- missing or invalid fixture data
- invalid geometry
- channel-range problems
Warnings do not block export, but they do appear in the preview so you can make an informed decision before writing the file.
Temporary Art-Net conversion for sACN
Resolume's Advanced Output XML is still Art-Net-shaped, but Filament no longer makes you manually reconfigure a live sACN project just to export it.
If any Surface is configured for sACN, the export preview can enter a temporary Art-Net conversion flow. In that state Filament shows:
- how many sACN Surfaces need conversion
- a Conversion Preview card for each Surface
- whether the export target is preserved, inferred, or unresolved
- per-Surface notes about what the export will do
- an Export Audit Summary section when extra context needs to be called out
Each Surface preview shows:
- source protocol -> export protocol
- source destination -> export destination
- absolute universe -> Art-Net subnet / universe
- fixture-slice and channel totals
- conversion notes
Before exporting, you must explicitly confirm:
- Use temporary Art-Net conversion for this export only. Do not change the live project.
That confirmation matters: the XML export can be Art-Net-compatible even while your live project stays sACN in the editor and Player.
Fixture-library export
You can also enable:
- Also export fixtures to Resolume Fixture Library
Use this when the receiving Resolume system needs the fixture definitions that your Filament project depends on.
Completing the export
Click Export, choose the file destination, and Filament writes the XML.
On success, the dialog reports:
- the saved file path
- Surface count
- total exported fixture slices
- any warnings returned during export
If temporary Art-Net conversion was used, the completion screen also states that it was applied only for the export and that the live project was not changed.
[GRAPHIC: Screenshot of the completed export dialog showing saved file path, Surface count, slice count, warnings, and the "live project was not changed" confirmation]
In-app updater
Filament checks for updates and can install them without requiring a manual download.
When an update is available:
- a notification appears after startup checks complete
- the update dialog shows your current version, the available version, and release notes
- Update Now downloads and installs the update
- Filament prompts you to relaunch after installation
You can choose Later if you need to stay on the current session.
About Filament
The About dialog, available from the Help menu, shows:
- current app version
- website and support links
- copyright information
Project management on the Library landing page
Some project-management controls live at the top of the Library page rather than inside Settings:
- duplicate a project to branch a layout
- delete a project with confirmation
- review canvas dimensions and last-modified times
- reopen the most recently active project automatically on launch