LunaDash GUIDES
LUDASH / SETTINGS

Make it feel like you.

A practical guide to the settings center: change the look, shape your workspaces, choose default applications, and understand which controls belong to your host desktop.

Start with the panel gear. You can also right-click the wallpaper or run ludashctl open-settings inside LuDash. Use the sidebar search to find a category. Most desktop preferences save immediately; JSON editors have an explicit Save button.

Language & everyday preferences

Open General to select English or Traditional Chinese, a font family, the clock format, or the first-run guide.

  • The shell updates language live; reopen native applications to apply a different language.
  • Reset desktop preferences restores LunaDash appearance, keyboard and workspace defaults. It does not erase files or network profiles.

Color, wallpaper & soft blur

Choose a color swatch, an image or shader wallpaper, then tune gaps, panel height, background blur and motion.

  • Blur starts enabled at radius 18. Lower the radius to reduce GPU work; window opacity ranges from 60% to 100%.
  • Set animation duration between 0 and 600 ms, or disable animations for reduced motion.
  • Files follows the accent immediately. New Konsole terminals receive the generated palette; third-party apps keep their own themes.

Tiling & workspaces

Choose 1–9 workspaces, a 30–70% master pane and whether new windows start floating.

  • Super+1…9 switches workspaces; Super+Shift+1…9 moves the focused window to an existing workspace.
  • Super+J/K focuses, Super+H/L changes the master ratio, Super+Space toggles floating, and Super+Q closes the focused window.
  • Reducing workspace count moves windows from removed workspaces to the last remaining workspace.

Display, keyboard & pointer

Display reports the current output and can resize a nested session. Keyboard settings change the Wayland keymap and repeat behavior.

  • Available keyboard layouts: us, gb, de, fr, es, jp and tw. Repeat rate is 0–60; delay is 200–1500 ms.
  • Cursor size applies to the next session. Host monitor, mouse and touchpad editors are labelled as host controls.
  • Standalone multiple outputs, physical modes, scaling, refresh rate, HDR and full libinput device controls are not implemented.

Sound, networking & power

Sound controls the default output and microphone through WirePlumber. Power profiles use power-profiles-daemon.

  • Volume is capped at 100%. Unavailable devices and failed commands are shown rather than reported as successful changes.
  • Existing network connections are reused. Network configuration opens NetworkManager's editor; passwords remain in that editor.
  • Bluetooth, printers, disks, accounts, clock and accessibility pages show available system tools and packages to install.
  • Locking, a complete notification service, polkit agent and full portal integration remain incomplete.

Your terminal & file manager

Applications and startup lists every installed application for each default role, with the built-in default pinned at the top of the list.

  • Terminal defaults to Konsole with interactive Fish and a LunaDash prompt. The login shell and user Fish configuration are not rewritten.
  • Files defaults to the LunaDash file manager. Choose icon or details view, browse common locations, filter a folder, and use the compact toolbar.
  • These defaults affect LunaDash launchers and shortcuts, not system-wide MIME associations.
  • Startup selection currently covers built-in tools; general desktop-entry autostart and session restoration are not implemented.
DEFAULT APPLICATION EXAMPLES
# Use your preferred applications
ludashctl default-apps '{"terminal":["konsole","-e","fish"],"files":["dolphin"]}'

# Restore LunaDash Files and the LunaDash Fish terminal profile
ludashctl default-apps '{"terminal":[],"files":[]}'
ludashctl launch-default terminal

Where preferences live

Desktop settings use ~/.config/LuDash/LuDash.conf, respecting XDG_CONFIG_HOME. Shell module JSON lives beside it as shell-modules.json. Custom QML belongs in the sibling modules/ directory. Module code is disabled until explicitly trusted.

APPLY A DESKTOP CHANGE
ludashctl appearance '{"accent":"#c4b5fd","gap":16,"blur":true,"blurRadius":18}'
ludashctl open-settings appearance

Each block can also have its own dimensions, color and corner radius. Follow the module guide for the JSON schema, a visual style playground, user QML and recovery commands.

A calmer file browser

LunaDash Files uses a consistent outline icon set, a compact action toolbar, a location field and a spacious icon view. Alt+Left/Right navigates history, Alt+Up goes to the parent, Ctrl+L edits the location, and F2 renames one item. Accent changes also update open Files windows.

Copy supports regular files. Moves and Trash operations run off the UI thread; existing destinations are not overwritten. Folder copying, cross-application clipboard integration, tabs, archive tools, recursive search and network shares are still incomplete.