Documentation

Tune your desktop

Margine ships a curated GNOME setup: tiling extensions, a dock, a panel with blur, 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 blur, dock, search-light, 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 (workspaces are dynamic)
  • 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 — open Search Light
  • 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
  • Search Light — Spotlight-style popup
  • Blur My Shell — panel/overview/dash blur
  • 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.