Skip to content
 
 

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

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
Ctrl+D Split right
Ctrl+W Close focused pane
Ctrl+B Toggle sidebar
Ctrl+T New terminal tab
Ctrl+Arrow Focus pane in direction
Ctrl+PageDown/Up Next/prev 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

Releases

Packages

Contributors

Languages