Skip to content

am-will/limux

Repository files navigation

Limux

A GPU-accelerated terminal workspace manager for Linux, powered by Ghostty's rendering engine. A special thanks to the cmux contributors who inspired this build.

If you are on Mac, please visit https://github.com/manaflow-ai/cmux to download the original.

952_1080x60_shots_so.mp4

Features

  • GPU-rendered terminals via embedded Ghostty (OpenGL)
  • Workspaces with folder-based naming, persistence across restarts, and sidebar management
  • Split panes (horizontal/vertical) with keyboard navigation
  • Tabbed terminals within each pane
  • Built-in browser (WebKitGTK)
  • Right-click context menu with copy, paste, split, clear
  • Drag-and-drop workspace reordering with favorites/pinning
  • Animated sidebar collapse/expand

Install

Download the latest release from GitHub Releases.

Debian/Ubuntu (.deb) — recommended:

sudo dpkg -i ./limux_0.1.6_amd64.deb

AppImage — portable, no install needed:

chmod +x Limux-0.1.6-x86_64.AppImage
./Limux-0.1.6-x86_64.AppImage

Tarball — manual install:

tar xzf limux-*-linux-x86_64.tar.gz
cd limux-*-linux-x86_64
sudo ./install.sh

Arch Linux (unofficial AUR package) — community-maintained by antonbarchukov:

yay -S limux-bin

The AUR package is available at limux-bin. Thanks to antonbarchukov for packaging Limux for Arch users. Arch packaging is not currently maintained by upstream; please report AUR packaging issues to the package maintainer first. See issue #5.

To uninstall:

# deb
sudo apt remove limux

# tarball
sudo ./install.sh --uninstall

System dependencies

# Ubuntu/Debian
sudo apt install libgtk-4-1 libadwaita-1-0 libwebkitgtk-6.0-4

Build from source

Prerequisites

  • Rust toolchain (stable)
  • GTK4, libadwaita, WebKitGTK dev packages
  • Pre-built libghostty.so (included in releases, or build from the Ghostty submodule with Zig)
# Install dev dependencies (Ubuntu/Debian)
sudo apt install libgtk-4-dev libadwaita-1-dev libwebkitgtk-6.0-dev pkg-config build-essential

# Build
cargo build --release

# Run (point to libghostty.so location)
LD_LIBRARY_PATH=../ghostty/zig-out/lib:$LD_LIBRARY_PATH ./target/release/limux

Package a release tarball

./scripts/package.sh

This builds the binary, bundles libghostty.so, icons, and an install script into a tarball.

Development

Run the canonical local quality gate before committing:

./scripts/check.sh

Repository maintainability rules live in docs/maintainability.md.

Keyboard shortcuts

Most default shortcuts use Ctrl. Fullscreen defaults to F11. Custom remaps may also use Cmd, which Limux maps to either the Linux Meta or Super modifier. Opt maps to Alt.

App

Shortcut Action
Ctrl+Q Quit Limux
Ctrl+Alt+N Open a new Limux instance
F11 Toggle fullscreen

Browser

Shortcut Action
Ctrl+Shift+L Open the focused browser page in a new split
Ctrl+L Focus browser address bar
Ctrl+[ Browser back
Ctrl+] Browser forward
Ctrl+R Browser reload
Ctrl+Alt+I Open Web Inspector
Ctrl+Alt+C Open Web Inspector (console-only targeting is not exposed by WebKitGTK)

Find

Shortcut Action
Ctrl+F Open find on the focused terminal or browser
Ctrl+G Find next
Ctrl+Shift+G Find previous
Ctrl+Shift+F Hide find
Ctrl+E Use selection for find

Terminal

Shortcut Action
Ctrl+K Clear scrollback
Ctrl+C Copy selection
Ctrl+V Paste
Ctrl++ Increase font size
Ctrl+- Decrease font size
Ctrl+Shift+0 Reset font size

Workspace And Pane

Shortcut Action
Ctrl+Shift+N New workspace (folder picker)
Ctrl+Shift+W Close workspace
Ctrl+Shift+Left/Right Cycle tabs in focused pane
Ctrl+Shift+D Split down
Ctrl+Shift+T New terminal tab in the focused pane
Ctrl+D Split right
Ctrl+W Close focused pane
Ctrl+M Toggle sidebar
Ctrl+Shift+M Toggle top bar
Ctrl+T New terminal tab
Ctrl+Arrow Focus pane in direction
Ctrl+PageDown/Up Next or previous workspace
Ctrl+1-9 Switch to workspace by number

Architecture

rust/
  limux-host-linux/    # GTK4/Adwaita UI (window, sidebar, panes, tabs)
  limux-ghostty-sys/   # FFI bindings to libghostty
  limux-core/          # Command dispatcher and state engine
  limux-protocol/      # Socket wire format types
  limux-control/       # Unix socket server
  limux-cli/           # CLI client

The terminal rendering is handled entirely by Ghostty's embedded library (libghostty.so), which provides GPU-accelerated OpenGL rendering. The UI layer is native GTK4 with libadwaita.

License

MIT

About

GPU-accelerated terminal multiplexer for Linux

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors