| NEOFLUX-SESSION(1) | User Commands | NEOFLUX-SESSION(1) |
neoflux-session - session wrapper that starts neoflux from a display manager
neoflux-session [neoflux-options]
neoflux-session is a small shell wrapper meant to be the entry point for a graphical (display-manager) login. It prepares the per-user X session environment, then hands off to neoflux(1). It plays the role startfluxbox(1) plays for Fluxbox.
In order, it:
neoflux itself does not source ~/.xprofile or run xrdb(1) — by design it reads the effects of the session environment (for example the RESOURCE_MANAGER property) but does not own session plumbing. Many display managers run an Xsession wrapper that already does this work, but it is not universal; doing it here makes neoflux start consistently regardless of the display manager. Both steps are idempotent, so repeating work the display manager already did is harmless.
The wrapper, not the window manager, is the session process: the login ends when the wrapper exits. If neoflux crashes — a panic (exit status 101) or death by a fatal signal (illegal instruction, abort, bus error, arithmetic error, kill, segmentation fault) — its windows are untouched (the X server hands them back to the root window), and the wrapper starts neoflux again after one second. The new instance adopts every open window, as a Restart does, and does not run the startup script a second time. Each restart is reported on standard error (usually ~/.xsession-errors).
Anything else ends the session as usual: Quit (status 0), an error exit such as losing the X server or finding another window manager running (1), and bad arguments (2). Three crashes within 60 seconds also end it, so a window manager that cannot stay up is not restarted forever. A signal sent to the wrapper (as a display manager does to end the session) is passed on to neoflux.
Point an xsessions desktop entry's Exec= line at this script (this is what the shipped neoflux.desktop does), so the login greeter offers “NeoFlux” as a session and starts it through the wrapper. When packaged, the script is installed on PATH (e.g. /usr/bin/neoflux-session).
To start neoflux from a plain ~/.xinitrc under startx(1) instead, the wrapper is unnecessary — put the same .xprofile / xrdb steps in your .xinitrc (or just exec neoflux if your environment is already set up).
neoflux(1), xrdb(1), startfluxbox(1), Xsession(5)
neoflux is developed by Chris (OsugiSakae).
| November 21, 2026 | neoflux 0.6.1 |