Documentation

Tune your desktop

Margine ships a curated GNOME setup: tiling extensions, a dock, a panel, custom keybindings, default apps for opening files and links. Nearly everything is configured from regular GNOME graphical tools: Settings, Extension Manager, the dock right-click menu. This page tells you which knob is where, and what the Margine defaults are so you know what you're departing from.

The everyday tools: all graphical

  • Settings (Activities → Settings) for network, display, keyboard, mouse, default applications, power profile, sound, accounts. Same Settings you'd find on Fedora Workstation or Ubuntu GNOME. Nothing special.
  • Extension Manager (preinstalled in the dock) for everything related to GNOME Shell extensions: enable / disable, open the per-extension preferences, browse extensions.gnome.org for new ones. The right place for tweaking the dock and tiling behaviour.
  • Bazaar for app installs (see Install & remove apps).
  • Activities → keyboard shortcut to change a shortcut: Settings → Keyboard → View and customise shortcuts. Search by name (e.g. "switch to workspace") to rebind.

Beyond GNOME Settings: the knobs Margine adds

Three things people search GNOME Settings for and don't find, because GNOME doesn't have them. Margine does:

Reset everything to the Margine defaults

If you've changed a lot and want to go back to "what Margine ships with" (extensions, keybindings, dock layout, appearance, default apps), open Ptyxis and run:

ujust margine-bootstrap

This is a single command that re-applies the whole canon­ ical user-state setup, idempotently, without touching your files. There's no GUI for it (it's a Margine- specific helper, not a GNOME feature). Log out + back in once it finishes.

Keybindings (Hyprland-flavoured)

  • Super + 1, 2, 3…: switch to workspace (5 fixed workspaces)
  • Super + Shift + 1, 2, 3…: move the active window to that workspace
  • Super + H / J / K / L: move focus between tiles (o-tiling)
  • Super + Ctrl + Arrow: swap the tile with its neighbour (o-tiling)
  • Super + Return: open the terminal (Ptyxis)
  • Super + Shift + Return: open the browser (Zen)
  • Super + E: open Files (Nautilus)
  • Super + Space: app grid / search
  • Super + period: emoji picker (Smile, inserts into the focused field)
  • Super + M: minimize · Super + F: fullscreen · Super + S: quick settings
  • Super + Shift + T: toggle auto-tiling on/off

Extensions enabled by default

  • o-tiling: binary-tree auto-split tiling
  • Dash to Dock: always-visible dock
  • Caffeine: keep-screen-awake toggle
  • Hide Cursor: auto-hide cursor while typing
  • AppIndicator Support, GSConnect, Bazaar Integration, Gradia Integration

Manage them with Extension Manager (preinstalled). Don't fight the extension at the dconf level. Open Extension Manager, tweak there.

Default apps

Set in configure-default-applications and applied via xdg-mime / xdg-settings:

  • Web browser → Zen Browser
  • Mail → Thunderbird ESR
  • Terminal → Ptyxis
  • Files → Nautilus
  • PDF → Papers
  • Image viewer → Loupe

Change any of these via Settings → Default Applications.