Docs \ Going Further \ Files

Configuration Files

Every file is optional: GemWM and its programs start with their defaults, and you write only what you change.

Settings

File What
~/.config/gemwm/config GemWM: desktop, keys, layout, highlight, animation, font, clock, battery, AI
~/.config/gemwm/menu the menus and menu apps
~/.config/gemwm/env environment variables for the session (TERMINAL=...)
/etc/pam.d/gemwm-lock how the lock screen checks your password
/etc/gemwm/greeter.conf the login screen’s desktop
~/.config/gemweb/settings GemWeb: home page, search, ad blocking, passwords, zoom
~/.config/gemmail/settings GemMail: the account
~/.config/gemmail/categories GemMail’s AI categories
~/.config/gemwrite/settings.ini GemWrite: your name, the spelling language
~/.config/foot/foot.ini the terminal: your own settings, under its theme

What GemWM keeps

Where What
~/.local/state/gemwm.log the session’s log
~/.local/state/gemwm/notifications notification history
~/.local/share/gemweb/ GemWeb’s cookies, site data, history and ad-block rules
~/.local/state/gemweb/zoom zoom remembered per site
~/.local/share/gemmail/addresses.sqlite the people you write to, for GemMail’s suggestions
~/.cache/gemmail/ GemMail’s mail, for offline reading and a quick start
~/.local/state/gemwm/files GemFiles: icons or text, the sort, hidden files
~/.local/state/gemwm/gemview where each PDF was left, and its zoom
~/.local/state/gemwm/play GemPlay’s playlist, Shuffle and Repeat
~/.config/gempod/settings GemPod’s sync server (and its password, if there’s no keyring)
~/.local/share/gempod/ GemPod’s podcasts, episodes, where you got to, and downloads
~/.local/state/gemwm/gemview-recent, gemwrite-recent File > Open Recent’s documents
~/.local/state/gemwm/solitaire Solitaire’s draw option and statistics
~/.local/share/gemwm/crossword/ crossword puzzles and progress
~/Pictures/Screenshots/ screenshots (or $GEMWM_SCREENSHOT_DIR)