Skip to content
ArchEclipse

Common pages

↑↓to navigate↵to openescto close
Settings
On this page

Configuration

Settings

Every section of the in-shell Settings panel, where values are stored, and which changes apply live.

The Settings panel is a tab inside the left panel. Open the left panel with SUPER + L and select Settings. The panel keeps a category rail on the left that follows the scroll position, and a searchable list of sections on the right.

Values are persisted by the Quickshell Settings singleton to:

text
~/.cache/quickshell/settings/settings.json

The shell reads the file at startup and rewrites it after changes. The file is an implementation detail: prefer the panel, because it normalizes invalid values and updates running widgets. Editing the JSON while the shell runs can be overwritten.

Sections#

Bar#

SettingDefaultNotes
OrientationTopTop or bottom edge for the bar.

Additional bar behaviour is stored in the settings data (barSmartHide, barFullWidth, reveal pressures) and is covered in Bar.

Panels#

SettingDefaultRange / notes
Left panel width400 px200–1500 px, per monitor
Right panel width350 px200–1500 px, per monitor
Left panel hot zoneonHover the left edge to open the panel
Right panel hot zoneonHover the right edge
Left hot zone size5 px1–50 px hover strip
Right hot zone size5 px1–50 px hover strip
Preview hot zones—Flashes the hover strips on screen

Width overrides are stored per monitor name. A monitor without an override uses the global width.

Theme#

SettingDefaultEffect
Dynamic theme colorsonRecolor the shell from the current wallpaper palette
Dynamic theme variantsoffLet ColorEclipse switch the light/dark variant from the wallpaper
Radius12Corner radius token used across the shell
Pad (inset)6The single content-padding token for cards and islands
Spacing6Gap between bar elements and panel rows

Interface#

SettingDefaultEffect
Opacity0.618Shell surface opacity; 1 is fully opaque
Font size12Base font size; derived sizes rescale with it

Animations#

SettingDefaultEffect
EnabledonGlobal gate for shell animations
Speed1.00×Duration multiplier, 0.2–2.0; lower is faster
Island styleEmphasizedStandard, Emphasized, Bouncy Fast, Bouncy Default, Bouncy Slow
Reveal-in pressure250 msHover dwell before a pill or island reveals
Reveal-out pressure1000 msDelay before a hovered island closes

User Agents#

Editable user-agent strings for Booru, MangaDex, MangaLib, Waifu and Fastfetch requests. The panel can copy each value.

API Keys#

Stores credentials for the optional integrations:

  • OpenRouter user and API key (ChatBot)
  • Danbooru user and key
  • Gelbooru user and key
  • Safebooru user and key
  • Wallhaven API key (optional; unlocks NSFW results)

The ChatBot has its own provider setting and an optional "notify on reply" toggle. Manga and Booru features are optional; the desktop works without them.

Hyprland#

This section edits a curated set of Hyprland leaves:

  • general: border size, gaps in/out
  • decoration: rounding, active/inactive opacity
  • decoration blur: enabled, size, passes, xray
  • decoration shadow: enabled, range, render power
  • Game Mode: disables blur and animations for performance
  • Blue Light Filter: on/off, temperature (1000–6500 K), auto schedule with start/end times

Apply Hyprland Settings writes one small Lua file per leaf to ~/.config/hypr/config/custom/ and runs hyprctl reload. The files are named with underscores (decoration_blur_size.lua, for example), so they load after the tracked base modules. Reset to Default is a global reset: it restores the panel's built-in defaults for shell and Hyprland values, then persists them. Run Apply Hyprland Settings afterwards to write the Hyprland side.

Lockscreen#

SettingDefaultEffect
Grace period10 sEsc dismisses the lock without a password within this window

Recording#

These values are read by screenrecord.sh through gpu-screen-recorder:

SettingDefault
Video codecauto
Qualityvery_high
Color rangelimited
Audio codecopus
Frame rate60
Frame rate modeauto
Record cursoron
Output devicedefault_output
Input devicenone
Directory~/Videos/ScreenRecords
Containermp4

Video codec, quality and container choices are validated against gpu-screen-recorder. For example, WebM requires VP8, VP9 or AV1, and FLV requires H.264. Changes apply on the next recording.

Screenshots#

SettingDefault
Directory~/Pictures/Screenshots
Image formatpng
JPEG quality85
PNG compression6
Optimize PNGoff
Include cursoroff
Copy to clipboardon
Show notificationon
Freeze during area selectionon

Screenshot settings are read by ~/.config/hypr/scripts/screenshot.sh on the next capture. PNG optimization uses ImageMagick and is opt-in.

Settings panel

Resetting#

The Reset to Default button in the Hyprland section is a global reset for the shell settings and the Hyprland slider values. Some reset values differ from the fresh-install defaults in theme/Settings.qml (for example rightPanelWidth = 250 and uiPad = 8 after a reset, versus 350 and 6 for a new profile). To reset one area, set the values yourself or delete the settings file while the shell is stopped, which makes the singleton fall back to its built-in defaults on the next start.