The Manual
Everything GemWM does, and how to change it. GemWM works out of the box: install it, log in, and the defaults are the Atari ST's. Then make it yours with one small text file, writing only what you change.
Getting Started
- Install
- Build GemWM, install it as a login session, or try it in a window first.
- Getting Around
- The menu bar, windows, workspaces, and the first keys to know.
- Login Screen
- gemwm-greeter, a GEM login screen for greetd, with the people who can log in as desktop icons.
Customizing
- Desktop and Looks
- The desktop's colour, picture and pattern, the font, the focus border, and animation.
- Key Bindings
- Every default key, and how to add, change or remove them.
- The Menu Bar
- Change the menus, add your own, and choose the menu apps at the right of the bar.
Modes
- Window Mode
- Overlapping GEM windows, moved and sized in outline, with an overview of every window.
- Tiling Mode
- Windows share the screen in two columns, as in i3 and sway, and glide or step to their places.
- Scrolling Mode
- A strip of columns that scrolls sideways, after niri. New windows open to the right.
- Workspaces
- Dynamic workspaces, shown in the middle of the menu bar.
Going Further
- Scripting with gemwm msg
- Control GemWM from scripts and key bindings, and follow what changes, in JSON.
- Writing Menu Apps
- Put your own item at the right of the menu bar, with any program that prints a line.
- For App Developers
- Give your application GEM menus in the menu bar and GEM scroll bars in its frame.
- AI
- GemWM's programs get AI from Augur, a service on the session bus, and it can be turned off for the whole session.
- Configuration Files
- Where every setting, and everything GemWM keeps, lives.