From 566cf638f6b9c076f8b7f8e77322a159a9fa2e85 Mon Sep 17 00:00:00 2001 From: Dennis Schoepf Date: Wed, 4 Mar 2026 20:24:01 +0100 Subject: [PATCH] enables scrolling desktop --- AGENTS.md | 245 +++++++++++ flake.lock | 45 ++ flake.nix | 4 + modules/hosts/dnsc-machine/default.nix | 2 +- modules/scrolling-desktop/default.nix | 128 ++++++ modules/scrolling-desktop/niri/config.kdl | 499 ++++++++++++++++++++++ 6 files changed, 922 insertions(+), 1 deletion(-) create mode 100644 AGENTS.md create mode 100644 modules/scrolling-desktop/default.nix create mode 100644 modules/scrolling-desktop/niri/config.kdl diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..0b76ea8 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,245 @@ +# AGENTS.md — nix-config + +Personal NixOS/nix-darwin configuration using flake-parts, import-tree, home-manager, and nixvim. + +--- + +## Repository Overview + +``` +flake.nix # Thin entry: delegates to import-tree ./modules +Justfile # Task runner (deploy, dry-run, update, gc, etc.) +modules/ + config.nix # flake-parts options schema (flake.modules, flake.globalConfig) + systems.nix # Supported systems list + hosts/ + dnsc-machine/ # Only active NixOS host (x86_64-linux) + base/ # macOS system defaults + NixOS locale/boot/user base + / # One directory per feature module + default.nix # Always the primary file + _sub-module.nix # Underscore-prefixed for large module splits +``` + +`import-tree` auto-discovers every `.nix` file under `modules/` — **no manual imports list in flake.nix**. +New modules are picked up automatically; just create `modules//default.nix`. + +--- + +## Build / Validation Commands + +There is no CI and no `nix fmt`/`nix flake check` target configured. + +| Goal | Command | +|---|---| +| Deploy to host | `just deploy ` (`sudo nixos-rebuild switch --flake .#`) | +| Deploy with trace | `just debug ` (adds `--show-trace --verbose`) | +| Dry-run build | `just dry ` — evaluates the closure without realising it | +| Update all inputs | `just update` (`nix flake update`) | +| Garbage collect | `just gc` (`sudo nix-collect-garbage --delete-old`) | +| Wipe old profiles | `just clean` (removes profiles older than 7 days) | +| NixOS REPL | `just repl` | + +**Only active host:** `dnsc-machine` + +``` +just dry dnsc-machine # fastest sanity check — no sudo required +just deploy dnsc-machine +``` + +There are no unit tests or `checks` outputs. Validation = dry-run build succeeds + manual deploy. + +**Linting tools available** (installed as system packages): `nil` (LSP), `statix` (linter). +Run `statix check .` to lint Nix files for common anti-patterns. + +--- + +## Flake Architecture + +``` +inputs.flake-parts → mkFlake framework +inputs.import-tree → auto-loads modules/ +inputs.nixpkgs → nixpkgs-unstable (channel tarball URL, not github:) +inputs.home-manager → follows nixpkgs +inputs.nix-darwin → LnL7/nix-darwin master +inputs.nixvim → nix-community/nixvim +inputs.helium → custom browser flake +inputs.dms → DankMaterialShell (COSMIC alternative desktop) +``` + +**Custom flake-parts options** (defined in `modules/config.nix`): +- `flake.modules.nixos.` — NixOS system modules +- `flake.modules.darwin.` — nix-darwin system modules +- `flake.modules.homeManager.` — home-manager user modules +- `flake.globalConfig.{username,fullname,email}` — shared personal values + +--- + +## Module Pattern + +Every feature lives in `modules//default.nix` and registers itself into the module registry. +Host configs (`modules/hosts//default.nix`) opt in by listing modules explicitly. + +### Standard tri-layer module + +```nix +{ inputs, ... }: +{ + flake.modules.nixos. = + { pkgs, ... }: + { + # NixOS system-level config + home-manager.sharedModules = [ + inputs.self.modules.homeManager. + ]; + }; + + flake.modules.darwin. = + { pkgs, ... }: + { + # nix-darwin system-level config + home-manager.sharedModules = [ + inputs.self.modules.homeManager. + ]; + }; + + flake.modules.homeManager. = + { pkgs, config, ... }: + { + # home-manager user-level config + }; +} +``` + +### System-only module (no HM layer) + +```nix +{ ... }: +{ + flake.modules.nixos. = + { pkgs, ... }: + { + # NixOS config only, e.g. bluetooth, printing, gaming + }; +} +``` + +### Sub-module splitting (for large modules like neovim) + +```nix +flake.modules.homeManager.neovim = + { pkgs, ... }: + { + imports = [ + ./_options.nix + ./_lsp.nix + ./_formatter.nix + ]; + }; +``` + +### Host definition pattern + +```nix +{ inputs, config, ... }: +let + hostname = "dnsc-machine"; +in +{ + flake.nixosConfigurations.dnsc-machine = inputs.nixpkgs.lib.nixosSystem { + system = "x86_64-linux"; + modules = with config.flake.modules.nixos; [ + home-manager + base + shell + # ... feature modules by name + { + imports = [ ./_hardware-configuration.nix ]; + networking.hostName = hostname; + system.stateVersion = "24.11"; + } + ]; + }; +} +``` + +--- + +## Code Style + +### Formatting + +- **2-space indentation** throughout, no tabs +- Opening brace on the same line as the attribute/binding +- Closing brace on its own line +- No trailing commas in attribute sets or lists (standard Nix) +- Multi-line function arguments use the exploded form: + ```nix + { + inputs, + config, + ... + }: + ``` + Short arg lists use the inline form: `{ pkgs, ... }:` + +### Inline embedded languages + +Use language comments to enable editor syntax highlighting inside multiline Nix strings: + +```nix +interactiveShellInit = /* fish */ '' + fish_vi_key_bindings insert +''; + +extraConfig = /* lua */ '' + vim.opt.number = true +''; +``` + +### Naming conventions + +| Thing | Convention | Example | +|---|---|---| +| Module directories | `kebab-case` | `cli-tools/`, `nvidia-graphics/` | +| Primary module file | `default.nix` | every feature dir | +| Sub-module files | `_kebab-case.nix` (underscore prefix) | `_lsp.nix`, `_formatter.nix` | +| Hardware config | `_hardware-configuration.nix` | matches sub-module style | +| `flake.modules.nixos.*` keys | `kebab-case` | `flake.modules.nixos.cli-tools` | +| `flake.modules.homeManager.*` keys | `kebab-case` name, `homeManager` namespace | `flake.modules.homeManager.shell` | +| `let` bindings | `camelCase` | `hmConfig`, `commonPackages` | +| Host names | `kebab-case` with owner prefix | `dnsc-machine`, `dnsc-server` | +| Fish functions | `snake_case` | `fish_greeting`, `tmux_sessionizer` | +| Fish abbrs | short lowercase | `lg`, `gg`, `g` | + +### Attribute ordering + +In NixOS/HM options, follow upstream conventions: +- `enable = true;` first +- then primary config attributes +- then nested option sets + +### No conditional feature flags + +Feature modules do **not** use `mkEnableOption`/`mkIf`. Everything in a module is unconditionally enabled when that module is included in a host's modules list. Opt-in/opt-out happens at the host level by adding or removing the module name. + +--- + +## Adding a New Feature Module + +1. Create `modules//default.nix` +2. Define `flake.modules.nixos.` and/or `flake.modules.homeManager.` +3. To activate on a host, add `` to the `modules = with config.flake.modules.nixos; [ ... ]` list in the host's `default.nix` +4. No registration in `flake.nix` needed — `import-tree` picks it up automatically + +--- + +## Commit Style + +Lowercase, brief, imperative — no conventional-commits prefix required: + +``` +add bluetooth module +fix cli tools config +remove gtk handling +update nixpkgs input +``` diff --git a/flake.lock b/flake.lock index 6712a6e..5de2b6a 100644 --- a/flake.lock +++ b/flake.lock @@ -1,5 +1,27 @@ { "nodes": { + "dms": { + "inputs": { + "nixpkgs": [ + "nixpkgs" + ], + "quickshell": "quickshell" + }, + "locked": { + "lastModified": 1772034342, + "narHash": "sha256-InX8kRyrpVL+MP/gW1qhH9tGtDx2z2gmJ9NfmvUJ35I=", + "owner": "AvengeMedia", + "repo": "DankMaterialShell", + "rev": "47b12d09fc8526f9c231de60848a41b5990b4a37", + "type": "github" + }, + "original": { + "owner": "AvengeMedia", + "ref": "stable", + "repo": "DankMaterialShell", + "type": "github" + } + }, "flake-parts": { "inputs": { "nixpkgs-lib": [ @@ -167,8 +189,31 @@ "type": "github" } }, + "quickshell": { + "inputs": { + "nixpkgs": [ + "dms", + "nixpkgs" + ] + }, + "locked": { + "lastModified": 1766725085, + "narHash": "sha256-O2aMFdDUYJazFrlwL7aSIHbUSEm3ADVZjmf41uBJfHs=", + "ref": "refs/heads/master", + "rev": "41828c4180fb921df7992a5405f5ff05d2ac2fff", + "revCount": 715, + "type": "git", + "url": "https://git.outfoxxed.me/quickshell/quickshell" + }, + "original": { + "rev": "41828c4180fb921df7992a5405f5ff05d2ac2fff", + "type": "git", + "url": "https://git.outfoxxed.me/quickshell/quickshell" + } + }, "root": { "inputs": { + "dms": "dms", "flake-parts": "flake-parts", "helium": "helium", "home-manager": "home-manager", diff --git a/flake.nix b/flake.nix index b93f3bd..bdb77a1 100644 --- a/flake.nix +++ b/flake.nix @@ -20,6 +20,10 @@ nixpkgs.url = "https://channels.nixos.org/nixpkgs-unstable/nixexprs.tar.xz"; nixpkgs-lib.follows = "nixpkgs"; nixvim.url = "github:nix-community/nixvim"; + dms = { + url = "github:AvengeMedia/DankMaterialShell/stable"; + inputs.nixpkgs.follows = "nixpkgs"; + }; }; outputs = diff --git a/modules/hosts/dnsc-machine/default.nix b/modules/hosts/dnsc-machine/default.nix index b1604d7..1cd1efa 100644 --- a/modules/hosts/dnsc-machine/default.nix +++ b/modules/hosts/dnsc-machine/default.nix @@ -18,7 +18,7 @@ in drawing-tablet bluetooth printing - desktop + scrolling-desktop terminal gaming browser diff --git a/modules/scrolling-desktop/default.nix b/modules/scrolling-desktop/default.nix new file mode 100644 index 0000000..49f4cd6 --- /dev/null +++ b/modules/scrolling-desktop/default.nix @@ -0,0 +1,128 @@ +{ inputs, ... }: +{ + flake.modules.nixos.scrolling-desktop = + { pkgs, ... }: + { + programs.niri.enable = true; + security.polkit.enable = true; + services.gnome.gnome-keyring.enable = true; + xdg.portal = { + enable = true; + extraPortals = [ + pkgs.xdg-desktop-portal-gtk + pkgs.xdg-desktop-portal-gnome + ]; + }; + services.gvfs.enable = true; + + services.displayManager = { + enable = true; + ly = { + enable = true; + settings = { + asterisk = "0x2022"; + bigclock = "en"; + default_input = "password"; + doom_fire_height = 1; + doom_top_color = "0x00c57faf"; + doom_middle_color = "0x00d369af"; + doom_bottom_color = "0x00572454"; + session_log = ".local/share/ly-session.log"; + vi_mode = true; + vi_default_mode = "insert"; + bg = "0x000f0b15"; + border_fg = "0x00807c9f"; + box-title = "dnsc-machine"; + }; + }; + }; + + environment.systemPackages = with pkgs; [ + bibata-cursors + gimp + darktable + ]; + + home-manager.sharedModules = [ + inputs.self.modules.homeManager.scrolling-desktop + ]; + }; + + flake.modules.homeManager.scrolling-desktop = + { pkgs, config, ... }: + { + services.polkit-gnome.enable = true; + xdg.desktopEntries = { + screenshot = { + type = "Application"; + name = "Screenshot"; + exec = "niri msg action screenshot"; + icon = "screenie"; + }; + screenshot-screen = { + type = "Application"; + name = "Screenshot Screen"; + exec = "niri msg action screenshot-screen"; + icon = "screenie"; + }; + color-pickers = { + type = "Application"; + name = "Color Picker"; + exec = "hyprpicker -a -f=hex -n -l -q"; + icon = "colorpicker"; + }; + notes = { + type = "Application"; + name = "Notes"; + exec = "ghostty --working-directory=${config.home.homeDirectory}/notes -e nvim -c \":lua Snacks.picker('files')\""; + icon = "gnotes"; + }; + lock = { + type = "Application"; + name = "Lock"; + exec = "hyprlock"; + icon = "lock-screen"; + }; + logout = { + type = "Application"; + name = "Logout"; + exec = "niri msg action quit"; + icon = "administration"; + }; + shutdown = { + type = "Application"; + name = "Shutdown"; + exec = "shutdown now"; + icon = "com.github.bcedu.shutdownscheduler"; + }; + }; + + imports = [ + inputs.dms.homeModules.dank-material-shell + ]; + + programs.dank-material-shell = { + enable = true; + systemd = { + enable = true; + restartIfChanged = true; + }; + + enableSystemMonitoring = true; + enableVPN = true; + enableClipboardPaste = true; + + settings = { + theme = "dark"; + }; + + session = { + isLightMode = false; + }; + }; + + xdg.configFile."niri" = { + source = config.lib.file.mkOutOfStoreSymlink "${config.home.homeDirectory}/dev/nix-config/modules/wm/niri/config"; + }; + }; +} diff --git a/modules/scrolling-desktop/niri/config.kdl b/modules/scrolling-desktop/niri/config.kdl new file mode 100644 index 0000000..3628011 --- /dev/null +++ b/modules/scrolling-desktop/niri/config.kdl @@ -0,0 +1,499 @@ +// This config is in the KDL format: https://kdl.dev +// "/-" comments out the following node. +// Check the wiki for a full description of the configuration: +// https://yalter.github.io/niri/Configuration:-Introduction + +environment { + QT_QPA_PLATFORMTHEME "qt6ct" +} + +// Input device configuration. +// Find the full list of options on the wiki: +// https://yalter.github.io/niri/Configuration:-Input +input { + keyboard { + xkb { + layout "eu" + } + numlock + } + + // Next sections include libinput settings. + // Omitting settings disables them, or leaves them at their default values. + // All commented-out settings here are examples, not defaults. + touchpad { + // off + tap + // dwt + // dwtp + // drag false + // drag-lock + natural-scroll + // accel-speed 0.2 + // accel-profile "flat" + // scroll-method "two-finger" + // disabled-on-external-mouse + } + + mouse { + // off + // natural-scroll + accel-speed -0.3 + // accel-profile "flat" + // scroll-method "no-scroll" + } + + tablet { + map-to-output "DP-3" + // calibration-matrix 1.0 1.0 1.0 1.0 1.0 1.0 + } + + // Uncomment this to make the mouse warp to the center of newly focused windows. + // warp-mouse-to-focus + + // Focus windows and outputs automatically when moving the mouse into them. + // Setting max-scroll-amount="0%" makes it work only on windows already fully on screen. + // focus-follows-mouse max-scroll-amount="0%" +} + +output "DP-3" { + // off + mode "3440x1440@99.982" + scale 1 + transform "normal" +} + +cursor { + xcursor-theme "Bibata-Modern-Ice" + xcursor-size 24 + hide-when-typing + hide-after-inactive-ms 5000 +} + +layout { + gaps 8 + + // When to center a column when changing focus, options are: + // - "never", default behavior, focusing an off-screen column will keep at the left + // or right edge of the screen. + // - "always", the focused column will always be centered. + // - "on-overflow", focusing a column will center it if it doesn't fit + // together with the previously focused column. + center-focused-column "on-overflow" + + // You can customize the widths that "switch-preset-column-width" (Mod+R) toggles between. + preset-column-widths { + proportion 0.33333 + proportion 0.5 + proportion 0.66667 + } + + default-column-width { proportion 0.5; } + + // By default focus ring and border are rendered as a solid background rectangle + // behind windows. That is, they will show up through semitransparent windows. + // This is because windows using client-side decorations can have an arbitrary shape. + // + // If you don't like that, you should uncomment `prefer-no-csd` below. + // Niri will draw focus ring and border *around* windows that agree to omit their + // client-side decorations. + // + // Alternatively, you can override it with a window rule called + // `draw-border-with-background`. + + // You can change how the focus ring looks. + focus-ring { + // off + width 3 + active-color "#c57faf" + inactive-color "#d369af" + } + + // You can also add a border. It's similar to the focus ring, but always visible. + border { + // The settings are the same as for the focus ring. + // If you enable the border, you probably want to disable the focus ring. + off + + width 4 + active-color "#ffc87f" + inactive-color "#505050" + + // Color of the border around windows that request your attention. + urgent-color "#9b0000" + + // Gradients can use a few different interpolation color spaces. + // For example, this is a pastel rainbow gradient via in="oklch longer hue". + // + // active-gradient from="#e5989b" to="#ffb4a2" angle=45 relative-to="workspace-view" in="oklch longer hue" + + // inactive-gradient from="#505050" to="#808080" angle=45 relative-to="workspace-view" + } + + // You can enable drop shadows for windows. + shadow { + // Uncomment the next line to enable shadows. + // on + + // By default, the shadow draws only around its window, and not behind it. + // Uncomment this setting to make the shadow draw behind its window. + // + // Note that niri has no way of knowing about the CSD window corner + // radius. It has to assume that windows have square corners, leading to + // shadow artifacts inside the CSD rounded corners. This setting fixes + // those artifacts. + // + // However, instead you may want to set prefer-no-csd and/or + // geometry-corner-radius. Then, niri will know the corner radius and + // draw the shadow correctly, without having to draw it behind the + // window. These will also remove client-side shadows if the window + // draws any. + // + // draw-behind-window true + + // You can change how shadows look. The values below are in logical + // pixels and match the CSS box-shadow properties. + + // Softness controls the shadow blur radius. + softness 30 + + // Spread expands the shadow. + spread 5 + + // Offset moves the shadow relative to the window. + offset x=0 y=5 + + // You can also change the shadow color and opacity. + color "#0007" + } + + // Struts shrink the area occupied by windows, similarly to layer-shell panels. + // You can think of them as a kind of outer gaps. They are set in logical pixels. + // Left and right struts will cause the next window to the side to always be visible. + // Top and bottom struts will simply add outer gaps in addition to the area occupied by + // layer-shell panels and regular gaps. + struts { + // left 64 + // right 64 + // top 64 + // bottom 64 + } +} + +// STARTUP +spawn-at-startup "waybar" +spawn-at-startup "swaync" +spawn-at-startup "swww-daemon" +spawn-sh-at-startup "~/.config/awww/bin/random-bg.sh ~/Pictures/Wallpapers/safe/dark" + +hotkey-overlay { + // Uncomment this line to disable the "Important Hotkeys" pop-up at startup. + skip-at-startup +} + +// Uncomment this line to ask the clients to omit their client-side decorations if possible. +// If the client will specifically ask for CSD, the request will be honored. +// Additionally, clients will be informed that they are tiled, removing some client-side rounded corners. +// This option will also fix border/focus ring drawing behind some semitransparent windows. +// After enabling or disabling this, you need to restart the apps for this to take effect. +prefer-no-csd + +// You can change the path where screenshots are saved. +// A ~ at the front will be expanded to the home directory. +// The path is formatted with strftime(3) to give you the screenshot date and time. +screenshot-path "~/Pictures/Screenshots/taken_at_%Y-%m-%d %H-%M-%S.png" + +// Animation settings. +// The wiki explains how to configure individual animations: +// https://yalter.github.io/niri/Configuration:-Animations +animations { + // Uncomment to turn off all animations. + off + + // Slow down all animations by this factor. Values below 1 speed them up instead. + // slowdown 3.0 +} + +overview { + backdrop-color "#0f0b15" +} + +// Window rules let you adjust behavior for individual windows. +// Find more information on the wiki: +// https://yalter.github.io/niri/Configuration:-Window-Rules + +window-rule { + match app-id=r#"^steam$"# +} + +// window-rule { +// match at-startup=true app-id=r#"^Spotify$"# +// open-on-workspace "media" +// } + +// window-rule { +// match at-startup=true app-id=r#"^Signal$"# +// open-on-workspace "chat" +// } + +// Open the Firefox picture-in-picture player as floating by default. +window-rule { + // This app-id regular expression will work for both: + // - host Firefox (app-id is "firefox") + // - Flatpak Firefox (app-id is "org.mozilla.firefox") + match app-id=r#"zen-beta$"# title="^Picture-in-Picture$" + open-floating true +} + +window-rule { + match app-id=r#"gimp$"# title="^GIMP$" + open-maximized true +} + +// Example: block out two password managers from screen capture. +// (This example rule is commented out with a "/-" in front.) +/-window-rule { + match app-id=r#"^org\.keepassxc\.KeePassXC$"# + match app-id=r#"^org\.gnome\.World\.Secrets$"# + + block-out-from "screen-capture" + + // Use this instead if you want them visible on third-party screenshot tools. + // block-out-from "screencast" +} + +// Example: enable rounded corners for all windows. +// (This example rule is commented out with a "/-" in front.) +window-rule { + geometry-corner-radius 12 + clip-to-geometry true +} + +debug { + // Allows notification actions and window activation from Noctalia. + honor-xdg-activation-with-invalid-serial +} + +binds { + // Keys consist of modifiers separated by + signs, followed by an XKB key name + // in the end. To find an XKB name for a particular key, you may use a program + // like wev. + // + // "Mod" is a special modifier equal to Super when running on a TTY, and to Alt + // when running as a winit window. + // + // Most actions that you can bind here can also be invoked programmatically with + // `niri msg action do-something`. + + // Mod-Shift-/, which is usually the same as Mod-?, + // shows a list of important hotkeys. + Mod+Shift+Slash { show-hotkey-overlay; } + + // Suggested binds for running programs: terminal, app launcher, screen locker. + Mod+Return hotkey-overlay-title="Open a terminal" { spawn "ghostty"; } + Mod+Space hotkey-overlay-title="Launcher" { spawn-sh "noctalia-shell ipc call launcher toggle"; } + Mod+B hotkey-overlay-title="Browser" { spawn "zen-beta"; } + Mod+M hotkey-overlay-title="System Monitor" { spawn-sh "noctalia-shell ipc call systemMonitor toggle"; } + Mod+N hotkey-overlay-title="File Manager" { spawn "nautilus"; } + Mod+Shift+V hotkey-overlay-title="Clipboard" { spawn-sh "noctalia-shell ipc call launcher clipboard"; } + Mod+Shift+M hotkey-overlay-title="Emoji" { spawn-sh "noctalia-shell ipc call launcher emoji"; } + Mod+Alt+L hotkey-overlay-title="Open session menu" { spawn-sh "noctalia-shell ipc call sessionMenu toggle"; } + Mod+Comma hotkey-overlay-title="Open system settings" { spawn-sh "noctalia-shell ipc call settings toggle"; } + + // Use spawn-sh to run a shell command. Do this if you need pipes, multiple commands, etc. + // Note: the entire command goes as a single argument. It's passed verbatim to `sh -c`. + // For example, this is a standard bind to toggle the screen reader (orca). + // Super+Alt+S allow-when-locked=true hotkey-overlay-title=null { spawn-sh "pkill orca || exec orca"; } + + // Example volume keys mappings for PipeWire & WirePlumber. + // The allow-when-locked=true property makes them work even when the session is locked. + // Using spawn-sh allows to pass multiple arguments together with the command. + XF86AudioRaiseVolume allow-when-locked=true { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1+"; } + XF86AudioLowerVolume allow-when-locked=true { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1-"; } + XF86AudioMute allow-when-locked=true { spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle"; } + XF86AudioMicMute allow-when-locked=true { spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle"; } + + // Example brightness key mappings for brightnessctl. + // You can use regular spawn with multiple arguments too (to avoid going through "sh"), + // but you need to manually put each argument in separate "" quotes. + XF86MonBrightnessUp allow-when-locked=true { spawn "brightnessctl" "--class=backlight" "set" "+10%"; } + XF86MonBrightnessDown allow-when-locked=true { spawn "brightnessctl" "--class=backlight" "set" "10%-"; } + + // Open/close the Overview: a zoomed-out view of workspaces and windows. + // You can also move the mouse into the top-left hot corner, + // or do a four-finger swipe up on a touchpad. + Mod+O repeat=false { toggle-overview; } + Mod+Q repeat=false { close-window; } + + Mod+Left { focus-column-left; } + Mod+Down { focus-window-down; } + Mod+Up { focus-window-up; } + Mod+Right { focus-column-right; } + Mod+H { focus-column-left; } + Mod+J { focus-window-or-workspace-down; } + Mod+K { focus-window-or-workspace-up; } + Mod+L { focus-column-right; } + + Mod+Shift+H { move-column-left; } + Mod+Shift+J { move-column-to-workspace-down; } + Mod+Shift+K { move-column-to-workspace-up; } + Mod+Shift+L { move-column-right; } + + Mod+A { focus-column-first; } + Mod+E { focus-column-last; } + Mod+Ctrl+A { move-column-to-first; } + Mod+Ctrl+E { move-column-to-last; } + + Mod+D { focus-workspace-down; } + Mod+U { focus-workspace-up; } + Mod+Ctrl+D { move-column-to-workspace-down; } + Mod+Ctrl+U { move-column-to-workspace-up; } + + Mod+Shift+Page_Down { move-workspace-down; } + Mod+Shift+Page_Up { move-workspace-up; } + Mod+Shift+U { move-workspace-down; } + Mod+Shift+I { move-workspace-up; } + + // You can bind mouse wheel scroll ticks using the following syntax. + // These binds will change direction based on the natural-scroll setting. + // + // To avoid scrolling through workspaces really fast, you can use + // the cooldown-ms property. The bind will be rate-limited to this value. + // You can set a cooldown on any bind, but it's most useful for the wheel. + Mod+WheelScrollDown cooldown-ms=150 { focus-workspace-down; } + Mod+WheelScrollUp cooldown-ms=150 { focus-workspace-up; } + Mod+Ctrl+WheelScrollDown cooldown-ms=150 { move-column-to-workspace-down; } + Mod+Ctrl+WheelScrollUp cooldown-ms=150 { move-column-to-workspace-up; } + + Mod+WheelScrollRight { focus-column-right; } + Mod+WheelScrollLeft { focus-column-left; } + Mod+Ctrl+WheelScrollRight { move-column-right; } + Mod+Ctrl+WheelScrollLeft { move-column-left; } + + // Usually scrolling up and down with Shift in applications results in + // horizontal scrolling; these binds replicate that. + Mod+Shift+WheelScrollDown { focus-column-right; } + Mod+Shift+WheelScrollUp { focus-column-left; } + Mod+Ctrl+Shift+WheelScrollDown { move-column-right; } + Mod+Ctrl+Shift+WheelScrollUp { move-column-left; } + + // Similarly, you can bind touchpad scroll "ticks". + // Touchpad scrolling is continuous, so for these binds it is split into + // discrete intervals. + // These binds are also affected by touchpad's natural-scroll, so these + // example binds are "inverted", since we have natural-scroll enabled for + // touchpads by default. + // Mod+TouchpadScrollDown { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.02+"; } + // Mod+TouchpadScrollUp { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.02-"; } + + // You can refer to workspaces by index. However, keep in mind that + // niri is a dynamic workspace system, so these commands are kind of + // "best effort". Trying to refer to a workspace index bigger than + // the current workspace count will instead refer to the bottommost + // (empty) workspace. + // + // For example, with 2 workspaces + 1 empty, indices 3, 4, 5 and so on + // will all refer to the 3rd workspace. + Alt+1 { focus-workspace 1; } + Alt+2 { focus-workspace 2; } + Alt+3 { focus-workspace 3; } + Alt+4 { focus-workspace 4; } + Alt+5 { focus-workspace 5; } + Alt+6 { focus-workspace 6; } + Alt+7 { focus-workspace 7; } + Alt+8 { focus-workspace 8; } + Alt+9 { focus-workspace 9; } + Alt+Ctrl+1 { move-column-to-workspace 1; } + Alt+Ctrl+2 { move-column-to-workspace 2; } + Alt+Ctrl+3 { move-column-to-workspace 3; } + Alt+Ctrl+4 { move-column-to-workspace 4; } + Alt+Ctrl+5 { move-column-to-workspace 5; } + Alt+Ctrl+6 { move-column-to-workspace 6; } + Alt+Ctrl+7 { move-column-to-workspace 7; } + Alt+Ctrl+8 { move-column-to-workspace 8; } + Alt+Ctrl+9 { move-column-to-workspace 9; } + + // Alternatively, there are commands to move just a single window: + // Mod+Ctrl+1 { move-window-to-workspace 1; } + + // Switches focus between the current and the previous workspace. + // Mod+Tab { focus-workspace-previous; } + + // The following binds move the focused window in and out of a column. + // If the window is alone, they will consume it into the nearby column to the side. + // If the window is already in a column, they will expel it out. + Mod+Period { consume-or-expel-window-right; } + + // Consume one window from the right to the bottom of the focused column. + // Mod+Comma { consume-window-into-column; } + // Expel the bottom window from the focused column to the right. + // Mod+Period { expel-window-from-column; } + + Mod+R { switch-preset-column-width; } + // Cycling through the presets in reverse order is also possible. + // Mod+R { switch-preset-column-width-back; } + Mod+Shift+R { switch-preset-window-height; } + Mod+Ctrl+R { reset-window-height; } + Mod+F { maximize-column; } + Mod+Shift+F { fullscreen-window; } + + // Expand the focused column to space not taken up by other fully visible columns. + // Makes the column "fill the rest of the space". + Mod+Ctrl+F { expand-column-to-available-width; } + + Mod+C { center-column; } + + // Center all fully visible columns on screen. + Mod+Ctrl+C { center-visible-columns; } + + // Finer width adjustments. + // This command can also: + // * set width in pixels: "1000" + // * adjust width in pixels: "-5" or "+5" + // * set width as a percentage of screen width: "25%" + // * adjust width as a percentage of screen width: "-10%" or "+10%" + // Pixel sizes use logical, or scaled, pixels. I.e. on an output with scale 2.0, + // set-column-width "100" will make the column occupy 200 physical screen pixels. + Mod+Minus { set-column-width "-10%"; } + Mod+Equal { set-column-width "+10%"; } + + // Finer height adjustments when in column with other windows. + Mod+Shift+Minus { set-window-height "-10%"; } + Mod+Shift+Equal { set-window-height "+10%"; } + + // Move the focused window between the floating and the tiling layout. + Mod+Shift+S { toggle-window-floating; } + // Mod+Shift+V { switch-focus-between-floating-and-tiling; } + + // Toggle tabbed column display mode. + // Windows in this column will appear as vertical tabs, + // rather than stacked on top of each other. + // Mod+W { toggle-column-tabbed-display; } + + // Actions to switch layouts. + // Note: if you uncomment these, make sure you do NOT have + // a matching layout switch hotkey configured in xkb options above. + // Having both at once on the same hotkey will break the switching, + // since it will switch twice upon pressing the hotkey (once by xkb, once by niri). + // Mod+Space { switch-layout "next"; } + // Mod+Shift+Space { switch-layout "prev"; } + + Print { screenshot; } + + // Applications such as remote-desktop clients and software KVM switches may + // request that niri stops processing the keyboard shortcuts defined here + // so they may, for example, forward the key presses as-is to a remote machine. + // It's a good idea to bind an escape hatch to toggle the inhibitor, + // so a buggy application can't hold your session hostage. + // + // The allow-inhibiting=false property can be applied to other binds as well, + + // The quit action will show a confirmation dialog to avoid accidental exits. + Mod+Shift+E { quit; } + Ctrl+Alt+Delete { quit; } +} + +xwayland-satellite { + // off + path "xwayland-satellite" +}