etyOS

etyDE, the desktop

Configuration files

Where the desktop keeps its settings and its state, file by file, and the keys of the shell's preferences.

Everything Settings does ends up as plain text in your home directory. Settings is the easy way; the files are the truth, and can be edited, copied to another machine, or kept in version control.

Settings: ~/.config/etyde/

FileWhat it holds
shellThe shell’s preferences, key = value (below)
appearancelight, dark or auto
localeThe interface language
dockPinned applications, one desktop-file id per line
launcher-hiddenApplications hidden from the launcher’s lists
notificationsDo Not Disturb and quiet hours (schedule, schedule_from, schedule_to)
filesFiles’ own settings: icon size, columns, single click, …
desktop-layoutWhere desktop icons were put, when not kept on a grid
wallpaper/The chosen background picture, copied here
bluetooth-codecs/The codec chosen for each Bluetooth audio device

The compositor’s own settings are in ~/.config/yawc/config: see YAWC’s configuration.

State: ~/.local/state/etyde/

What the desktop remembers, as opposed to what you chose:

FileWhat it holds
clipboard, clipboard-images/The clipboard history
notificationsWhat programs announced, for the notification centre
calculatorThe calculator’s history

~/.local/state/yawc/session.log is the session log. ~/.local/share/etyde/keyring/ is the keyring. ~/.cache/etyde/ holds what can be fetched again (the forecast).

The shell’s preferences

~/.config/etyde/shell. The dock applies a change within half a second; a missing key means “as shipped”.

KeyWhat it sets
dock.icon_sizeIcon size, 32–80
dock.alignstart, center or end along the bottom edge
dock.magnify, dock.labels, dock.shadeHover magnification, names above icons, dimming behind the dock
clock.showThe clock above the dock
clock.hoursauto, 12 or 24
clock.seconds, clock.sizeSeconds; its size
clock.datefull, short or none
start.width, start.height, start.columns, start.icon_sizeThe launcher’s size and grid
start.frequentHow many most-used applications lead the launcher (0 for none)
start.shortcutsButtons under the applications: settings, files, terminal, monitor
screenshot.copy, screenshot.saveWhere a screenshot goes
clipboard.enabled, clipboard.sizeThe clipboard history
appearance.scheduleLight and dark by the clock
lock.widgets, desktop.widgetsWhich cards the lock screen and the desktop show
dock.icon_size = 48
dock.align = center
clock.hours = 24
start.frequent = 6

Environment

VariableEffect
ETYDE_SKIP_AUTOSTART=1The session does not run XDG autostart entries
NIRVANA_DISABLE_GPU=1Software rendering for an applet, when the GPU process is unstable
YAWC_STARTUP_COMMANDWhat YAWC runs instead of etyde-session

Sound

At login, etyde-audio-setup creates ~/.config/wireplumber/wireplumber.conf.d/90-etyde-bluetooth-volume.conf if it is missing: the rule that gives Bluetooth devices software volume. An existing file is left alone. Remove it to go back to hardware volume (it is made again at the next login); keep an empty file to opt out for good.

Something wrong or missing on this page? Say so in the tracker (choose “Site and docs”).

Esc