One place for behavior and compression defaults.
Open Settings from the DwarFSctl tray. Everyday choices remain visible; exact DwarFS controls appear only when Advanced User is enabled.
General
Open a volume after mounting
Enabled by default. Dolphin opens the mounted folder after a successful graphical mount. Disable it when you prefer to open volumes later from Places or the tray.
Recent images
Choose how many recently used images the tray remembers, or turn the list off. This history is local to your account.
Image creation
DwarFSctl examines the selected folder and chooses technical settings for the outcome you prefer:
| Outcome | Best for |
|---|---|
| Balanced | Everyday creation and browsing. |
| Smaller Image | Reducing storage when creation time is less important. |
| Faster Browsing | Images you expect to open and explore frequently. |
| Faster Creation | Large or temporary images that need to finish sooner. |
The recommendation is based on bounded metadata sampling. It does not read file contents or promise an optimal result.
Advanced User
Enable Advanced User once at the top of Settings to reveal custom compression profiles and diagnostic timeouts. The preference controls advanced disclosure throughout the application.
Exact writer settings can make creation much slower or produce images poorly suited to your workload. Start from an everyday outcome unless you have a specific requirement.
Compression profiles
Select Create or Edit Profiles… from Image Creation. A profile starts from Balanced, Faster Creation or Smaller Image and stores only values you change. The editor exposes every supported DwarFS 0.15.7 writer control, validates it before saving and preserves repeated or negative values.
Profiles belong to your user account. The Create window displays the selected profile but does not duplicate its controls.
Configuration files
Most people should use the tray Settings window. Administrators and scripts can use these TOML files:
| System | /etc/dwarfs-dolphin/config.toml |
|---|---|
| User | ~/.config/dwarfs-dolphin/config.toml |
User values override system values. An explicit --config file overrides both. Inspect the resolved result with:
dwarfsctl config show
dwarfsctl config show --section creationUnknown keys are ignored with a warning. Invalid types and values stop the operation instead of silently changing behavior.