Chris Spackman

NeoFlux

A Fluxbox-style window manager for X11, written in Rust


NeoFlux is a reparenting window manager for X11 in the spirit of Fluxbox. It wraps each window in a decorated frame and adds three signature features:

Window grouping and tabbing
Windows can be merged into one frame and switched between with tabs. On the focused window the active tab takes half of the title bar and the rest share the other half, so the one you are using is always readable.
The slit
A Window Maker-style dock for dockapps, with up to four slits, one per screen edge. The fluxDockApps were written for it, and any dockapp can say which slit it wants with --dock N.
Chord keybindings
Emacs and PekWM-style multi-key shortcuts: press a leader key, then a second key from a chord table, with a universal argument key for repeat counts. Plain single-key bindings still work for navigation.

Beyond those: multi-monitor workspaces with hidden desktops and a built-in pager, window rules, picture-in-picture, a fullscreen policy that can keep the slits visible, keyboard-navigable menus, shading, edge grips, and a lock to this window mode. It is configured entirely through TOML files in ~/.config/neoflux/, re-read live by the reconfigure action, and speaks enough EWMH and ICCCM to cooperate with panels, pagers, wmctrl and xdotool. The whole stack is pure Rust with no C libraries on the X path, and NeoFlux’s own crates forbid unsafe code.

The same code builds five programs:

Both window managers come with a session wrapper (neoflux-session) and desktop entries, so they can be chosen from a display manager’s login screen.

Downloads: version 0.5.3 (2026-10-30)

Install from source

tar xzf neoflux-src-0.5.3-0496df8.tar.gz
cd neoflux-0.5.3
cargo build --release --locked --workspace      # rustc 1.85 or newer; do not cargo update
sh dist/make-bin-tarball.sh                     # stages a binary tarball into /var/tmp
sudo sh /var/tmp/install-neoflux-bin.sh /var/tmp/neoflux-bin-0.5.3-*.tar.gz

Install the binary tarball

sudo sh install-neoflux-bin.sh neoflux-bin-0.5.3-0496df8-x86_64.tar.gz
sudo sh install-neoflux-bin.sh --uninstall      # removes exactly those files

Then log out and pick NeoFlux (bin) or NeoFlux Media Center (bin) from the display manager’s session list. The first run seeds the configuration files in ~/.config/neoflux/ (or ~/.config/nfmc/) and writes a log under ~/.local/state/. To try it without logging out, run it in a nested X server: Xephyr :5 -screen 1920x1080 & then DISPLAY=:5 neoflux.

Manual pages

The .1 files are in the same folder for man; the tarballs install them.

What’s new

The installed neoflux --whats-new prints the same list, filtered to what changed since the version that last ran.

0.5.3 (2026-10-30)

0.5.2 (2026-10-21)

0.5.0 (2026-10-16)

0.4.0 (2026-10-03)

0.3.x (2026-09)

0.2.0 (2026-08)

License

NeoFlux is released under the MIT license or the Apache License 2.0, at your option. The fluxDockApps it was built alongside are CC0.

Send bug reports and questions to chris@chrisspackman.com.

Last updated: 2026-10-30

This page is Copyright © 2026 Chris Spackman.
Developed on Gentoo Linux with the help of Claude Code.

This page is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Creative Commons License