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:
- neoflux — the window manager (manual).
- nfmc, NeoFlux Media Center — the same window manager under a profile for a television driven from the couch: its own config, fullscreen that keeps the dockapp slits visible, one tabbed window, TV-sized menus and title bars, and remote-control keys (manual).
- nfmc-pad — turns a game pad into keyboard presses so it can drive nfmc, the slit dockapps and ordinary applications (manual).
- neoflux-import — a one-shot converter from Fluxbox configuration and styles to NeoFlux TOML (manual).
- neoflux-menugen — generates a root menu from the installed XDG applications (manual).
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)
- next-window:monitor and prev-window:monitor (Super+grave, Super+Shift+grave) cycle only the windows on the monitor you’re on; plain next-window still cycles every monitor.
- Eight new themes: the seasonal autumn, winter, spring, summer, halloween and festive, plus high-contrast (black on white) and high-contrast-dark (yellow and white on black). Bora-black, conky-colors and zenburn make the focused window much easier to spot.
- Screen lockers started from a key binding (Super+l) lock on the first try, and launched commands no longer linger as zombie processes.
- nfmc-pad: a stick can move the mouse pointer and buttons can click and scroll, so a game pad can drive a browser.
0.5.2 (2026-10-21)
- lock-window (Super+Shift+l) pins the screen to the focused window: every other window is hidden, new ones are held back, and desktop switching and menus are refused until it is pressed again. A courtesy lock, not a security boundary.
- Menus draw labels on one line and elide what does not fit; the window list shows a group’s hidden tabs indented under its displayed tab.
0.5.0 (2026-10-16)
- New binaries nfmc (NeoFlux Media Center) and nfmc-pad (game pad to keyboard), plus a script that pairs a Flirc IR receiver’s buttons to nfmc’s keys.
- Fullscreen policy:
fullscreen = "cover" | "fill", with movie and fill actions (Super+Shift+f) and a per-window rule override, so a player can go fullscreen while the slits stay visible.
- Keyboard-navigable menus, and actions to open the root menu, window menu and window list from the keyboard (Super+x then r, m, w).
- focus-slit gives keyboard focus to a dockapp; Tab steps along the slit, Escape returns (Super+x then s).
auto-group = "off" | "same-class" | "all": one tabbed window for everything, if you want it.
- Remote-control keysyms (XF86Back, Red/Green/Yellow/Blue, and so on) parse in bindings.
0.4.0 (2026-10-03)
- Move a tab left or right with Super+Control+arrows or by Super-dragging it; last-window (Super+Alt+Tab) flips between the two most recent windows.
- Default keys Super+m maximize and Super+n minimize; moving a maximized window by hand un-maximizes it.
- An unplugged monitor’s desktops fold onto the primary; title-bar icons for clients that only set the legacy WM_HINTS icon.
0.3.x (2026-09)
- A second monitor with its own independent desktops, a per-monitor pager, and move-to-monitor and focus-monitor actions.
- Hidden desktops stay out of the window list and group pickers unless they are current.
0.2.0 (2026-08)
- The universal argument key (Super+u, like Emacs C-u), window nudging from the chord table, equal-width tabs on unfocused windows, tab dimming,
--whats-new, and a defaults/ folder of always-current reference files.
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.