Skip to main content
Version: 2.2

Config profiles

Dux Modular Shell

Config profiles

A config profile is a saved copy of the DMS settings with a configurable scope. Profiles are under Settings → Wallpaper & colors. Clicking a profile switches to it, and its right-click menu has Apply, Partial apply, Edit and Delete. Manage profiles opens the full page with New profile and Import.

Opening Manage profiles for the first time creates a Default profile from the current settings, makes it active and keeps it in sync. Until then the Profiles card only shows the Manage profiles link.

What a profile includes​

A new profile uses the current settings for the groups picked in its editor, and switching to it only changes those groups.

CategoryGroups
Theme & colorsTheme, Wallpaper, Dark mode, App theming, Interface style, Shadows
LayoutBar, Frame, Dock, Desktop widgets, Control Center, Dashboard, Compositor, Display assignment
AppearanceFonts & motion, Icons, Cursor
OtherTime & weather, Lock screen, Launcher, Notifications, On-screen displays, Sound & media, Plugins, General

Settings that belong to the machine or the user are not included: input devices, power and battery, display configuration, lock screen and greeter authentication, night mode, custom commands, launcher and notification history, and the weather location.

Only the plugins installed when a profile was last updated are included. Settings of other plugins are kept as they are when switching.

Sync​

With Sync changes to this profile on, changes made while the profile is active are saved into it shortly after. Sync is the default for new profiles. Update from current settings saves the current settings into any profile on demand, including ones that aren't active.

Partial apply​

Compare on the edit page (or Partial apply in the right-click menu) lists every group where the profile differs from the current settings. Only the groups left on are applied, and the active profile stays the same.

Preview image​

Each profile can have a preview image, set on its edit page. Browse Files picks an image and Take screenshot captures the screen. Take screenshot shows a small bar at the bottom of the screen, so Settings can be closed and the desktop arranged first. The bar's Take screenshot button captures the screen, and Settings reopens on the profile.

Control Center​

The Profiles widget can be added in the Control Center editor. Its tile switches to the next profile, and its detail view lists all profiles.

Export and import​

Export saves a profile as a .tar.gz archive that includes its wallpapers. Import adds an archive as a new profile and opens its editor to select which of its settings to keep for the new local profile. Nothing is applied until switching to it.

For safety, exports and imports don't contain plugin settings, plugin widgets or custom dock commands, and reject all values that can run commands. Cycling folders and custom theme files are not bundled but keep their paths, so they need to be installed separately.

An archive holds at most 64 files, 128 MB per file and 512 MB in total. Wallpapers over a limit are not bundled and keep their paths.

The same works from the command line:

dms profile list
dms profile export <id> work.tar.gz
dms profile import work.tar.gz

list prints one profile per line as the id and the name separated by a tab. export prints every path it could not bundle, one per line. import prints the id of the new profile.

Profiles are stored in ~/.config/dms/profiles/, one folder per profile, and imported wallpapers in ~/.local/share/dms/wallpapers/. dms backup includes the profiles, but not those wallpapers.