Make it yours
- Machine settings. The defaults at the top of
config/hypr/hyprland.luaare for a MacBook's display (scale 2) and a Finnish Mac keyboard. The installer writes the machine's own intoconfig/hypr/local.lua: on a PC the display scale picked automatically and the keyboard layout Fedora's installer set, in a VM settings for it, on a Mac the layout unless it's Finnish. The login screen uses the same layout. A scale picked in the launcher (Settings › Display) wins over both. - Per-machine overrides go to
config/hypr/local.lua, which git ignores. - Keybindings are in
config/hypr/bindings.lua, a plugin's in its own folder. Apps open with Hyper (Caps Lock,MOD3) + a letter, chosen in the launcher (Settings › Keyboard Shortcuts); a Hyper key bound inlocal.lua(hl.bind("MOD3 + D", …)) is a default that a choice there replaces. - Optional parts (recommended apps, ready-made web apps, plugins): a one-line part, such as a web app or an app from dnf or Flathub, is a line in
plugins.txt, with its keybinding inbindings.lua'soptionallist and SHORTCUTS.md (with an{id}tag). A part with files of its own (a top bar module and menu, keys, a service, commands) is a folder inplugins/, likeplugins/ferry.plugins/README.mdexplains how to make one, with a small example to copy. A plugin of your own can live in its own repo, with the folder's files at its top:nightdrive plugins add <git-url>clones it. - Background apps: apps that ⌘W should only hide are in
config/hypr/background-apps. - Launcher apps: only the apps in
config/fuzzel/apps-allow.txtare listed. Search finds the rest. - Private additions: some things don't belong in a public repo, like work tools or a personal dashboard. You can keep them in your own private repo and link them into git-ignored local slots. Nightdrive loads them when they exist:
| Slot | What you can add there |
|---|---|
config/hypr/local.d/*.lua | autostart entries, window rules, keybindings |
config/hypr/background-apps.local, SHORTCUTS.local.md | more background apps, your own entries in the shortcut list |
config/quickshell/local/ | <Name>Menu.qml bar menus, and LauncherExtension.qml for your own launcher levels |
config/fuzzel/apps-allow.local.txt | more apps shown in the launcher |
config/topbar/local.modules.jsonc, status.local, local.adjust.conf | your own bar modules (at the left end of the icons), their status and icon sizes |
From README.md › Make it yours in the Nightdrive repo