Repolode
Submit
karinushka

karinushka/paneru

A sliding, tiling window manager for macOS that arranges windows on an infinite horizontal strip so new windows never resize existing ones.

Open-source alternative to:MagnetMoom

View on GitHub
Stars
2,396
Forks
115
Open issues
51
Last commit
3 days ago

What is it?

Paneru is a window manager for macOS that places windows on a horizontal strip extending to the right. Opening a new window does not resize the windows already on the strip, which keeps the layout stable. Each monitor gets its own independent strip, so windows stay on their display instead of spilling onto adjacent screens.

The project is aimed at users who want a scrollable tiling workflow similar to Niri on Linux. It works alongside native macOS Spaces, and adds experimental virtual workspaces that stack multiple rows within one space. Navigation supports keyboard shortcuts and touchpad gestures, with optional focus-follows-mouse behavior.

Configuration is done through a TOML file or an embedded Lua script, with live reloading when the file changes. Paneru can be controlled from the command line via a send-cmd subcommand, and it exposes JSON state queries and event subscriptions for status bars and scripts. It is installable through Cargo, Homebrew, and Nix.

Key features

  • 01Scrollable horizontal window strip per monitor that never resizes existing windows on open
  • 02Virtual workspaces (experimental) that stack multiple rows within one macOS space
  • 03Keyboard shortcuts, touchpad sliding, and optional focus-follows-mouse
  • 04Configuration via TOML or embedded Lua, with live reloading
  • 05Command-line control with send-cmd and JSON state queries and subscriptions
  • 06Startup session restore of window layouts and display assignments

Use cases

  • Keeping a stable window layout on a large external display without oversized or tiny windows
  • Working on a laptop screen where traditional tiling leaves windows too small
  • Scripting window actions or feeding workspace state into a status bar

Quick start

  1. 1

    Install from crates.io

    cargo install paneru
  2. 2

    Or install with Homebrew

    brew install paneru
  3. 3

    Grant accessibility access to Paneru in System Settings

  4. 4

    Run Paneru in the foreground

    paneru

Things to know

  • Paneru is for macOS only.
  • Paneru needs accessibility access to move windows.
  • Multiple displays can cause odd behavior unless they are arranged above or below the main display.
  • Virtual workspaces are marked as experimental.

Topics

#window-manager#macos#tiling#rust#productivity#lua#automation

FAQ

What is paneru?
A sliding, tiling window manager for macOS that arranges windows on an infinite horizontal strip so new windows never resize existing ones. Paneru is a window manager for macOS that places windows on a horizontal strip extending to the right. Opening a new window does not resize the windows already on the strip, which keeps the layout stable. Each monitor gets its own independent strip, so windows stay on their display instead of spilling onto adjacent screens.
Is paneru free to use? What license does it have?
paneru is open source under the MIT license. Check the license terms before using it in commercial products.
Is paneru still maintained?
Actively maintained. The last commit to paneru was on Oct 17, 2026.
What can I use paneru for?
Keeping a stable window layout on a large external display without oversized or tiny windows Working on a laptop screen where traditional tiling leaves windows too small Scripting window actions or feeding workspace state into a status bar
How do I install paneru?
Install from crates.io: cargo install paneru Or install with Homebrew: brew install paneru Grant accessibility access to Paneru in System Settings Run Paneru in the foreground: paneru
Where can I get paneru?
The source code and installation instructions are on GitHub: https://github.com/karinushka/paneru

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects