Authors: Adam Gaertner & Chelsea Goodell
2026 · github.com/atraone
Two independently routed mouse/keyboard pairs in a single Linux user session. Seats uses XInput2 / Multi-Pointer X (MPX) on an Xfce X11 desktop so two people can point, click, and type into different windows on the same shared desktop. Mouse and keyboard devices are automatically detected; you explicitly choose which mouse and keyboard form the second pair. The remaining devices stay on the primary seat.
This is single-session multiseat: dual mouse, dual keyboard, one shared login. Conventional Linux multiseat gives each person a separate login and graphical session, typically with assigned displays and input devices. Seats keeps one session and desktop, with no requirement to dedicate a monitor or GPU to each person. Existing monitors form the shared workspace.
This repository contains the complete system: the patched window manager, the seat-aware start menu, device selection, application keyboard compatibility relay, installer, and supervised recovery.
This is experimental desktop input compatibility software. Workspaces, stacking, clipboard, session, permissions, and some application state remain shared. It is not user isolation. Some applications, especially Chromium and Electron, retain one internal active window across a process; the relay handles keyboard delivery, not every application limitation.
Clone or unpack this entire repository. No source downloads are needed to build; upstream source and licenses are included. Run as the desktop user, not root:
./installSetup visibly checks build prerequisites, offers distribution package installation with confirmation, builds both patched desktop components and the helper programs, and installs the bundle under your home directory. Arch, Debian/Ubuntu, and Fedora package installation commands are provided; other distributions can satisfy the same prerequisites manually. Package names and versions must exist in the chosen distribution's repositories. Failures are shown rather than silently ignored.
If Xfce is absent, setup offers to install its session packages. This can add a substantial desktop stack and update shared dependencies. It does not change the display manager, default session, boot configuration, or current session. Save your work and log out yourself, then select Xfce / X11 at the login screen. Wayland with Xwayland is insufficient.
In the Xfce X11 session:
~/.local/bin/seats doctor
~/.local/bin/seats menu-enable
~/.local/bin/seats startMenu enablement activates the bundled seat-aware start menu as part of Seats. It asks before changing the existing Whisker Menu module selection and restarting the panel. Existing menu instance IDs, favorites, and settings stay in place. When no menu instance exists, it explains how to add Seats Whisker Menu through Panel Preferences. The system Whisker package stays installed for restoration. There is no AI launcher or AI-menu integration in this project.
The chooser asks which physical mouse and keyboard belong to the second seat. It starts a 60-second trial. Click Keep enabled to retain it; otherwise the supervisor restores ordinary operation. Closing the chooser requests deactivation, even after keeping a trial. Other input devices stay on the primary seat.
For a terminal workflow:
seats devices
seats activate --pointer MOUSE_ID --keyboard KEYBOARD_ID
seats keep
seats status
seats stopUse IDs from seats devices each time; they can change. USB interfaces are grouped
by physical device, including media/control interfaces. Seats never guesses which
unrelated mouse and keyboard belong together. At least one physical typing
keyboard and mouse must remain on the primary seat. Activation rejects missing,
stale, disabled, or already reassigned selections. Device disconnects trigger
recovery rather than silently assigning replacements.
The native source targets Xfwm4 4.20.0 and Whisker Menu 2.10.0, with local Xfce/GTK libraries meeting their version requirements. The runtime requires a working systemd user manager, Linux sysfs input identities, XI2 >= 2.2, Python >= 3.10 with Tk, and at least two identifiable physical mice and typing keyboards. See dependency details.
./seats doctor --build-only # only inspect compiler/library prerequisites
./seats dependencies # show and confirm system package installation
./seats desktop-install # offer Xfce session packages; never switch session
./seats build # compile into build/bundle; no installation
./seats install # install private bundle; no activationAn installed seats doctor prints each runtime check and returns a nonzero status
when a prerequisite is missing. seats start and seats activate repeat those
checks before changing input routing. No network service or external account is
required at runtime. Building requires no root access; only the explicitly
confirmed distribution package installation uses sudo.
- A versioned private release under
$XDG_DATA_HOME/seats/releases/(normally~/.local/share/seats/releases/). - The
~/.local/bin/seatscommand. A pre-existing command requires confirmation and is backed up; it is not silently overwritten. - A seat-aware menu module under
~/.local/lib/xfce4/panel/plugins/and its descriptor under$XDG_DATA_HOME/xfce4/panel/plugins/. - Installation records and user-file backups under
$XDG_DATA_HOME/seats/.
seats install does not start or replace the running window manager. Activation
starts the private Xfwm4 with --replace and uses transient systemd user services.
It does not overwrite /usr/bin/xfwm4, install a system service, or edit the login
session's window manager choice. The runtime and menu are installed together;
menu activation is an explicit panel restart because that affects a live desktop.
seats autostart-on adds only a chooser at login, not automatic unattended device
assignment. seats autostart-off removes that chooser. Put ~/.local/bin on PATH
if your distribution does not include it. A fresh terminal may be needed.
seats stop
seats menu-disable
# Save work, log out, and log back into Xfce.
seats uninstallThe recovery supervisor restores hardware attachments and client pointers and
restarts the system Xfwm4. It watches liveness, input identity, and observed lock
notifications. The start-menu module restoration is separately recorded so it
can restore the original module selection. Uninstallation restores backed-up
user files, including an earlier seats command, and refuses to overwrite files
that somebody has independently edited. Distribution packages are not removed.
Extra virtual master devices are deliberately kept alive until logout because removing them live has crashed Qt applications. Their pointers are hidden and physical devices are returned to the primary seat; the compatibility relay may remain running until logout. Log out before uninstalling so no running helper needs the private files. If you added a menu item manually, remove it through Panel Preferences before uninstalling. Do not manually delete an active release.
If recovery cannot reach X, log out/log in. From a TTY or SSH use the desktop
user, DISPLAY, XAUTHORITY, and XDG_RUNTIME_DIR from that session, then run the
installed seats stop. See operations and boundaries.
Deactivate before locking for predictable normal locker behavior: reactive lock
recovery is not a certification of a multi-seat screen locker.
See the component inventory and source manifest.
Upstream copyrights and licenses remain in both vendor trees. Local code is
GPL-2.0-or-later. LICENSE contains the GPL text. This project incorporates the
current fixes without redesigning the live runtime during packaging.
Builds can be reproduced from the bundled source. No compiled artifacts from the original machine, user configuration, credentials, display cookies, runtime state, or machine-specific device IDs are distributed. Historical integration probes are retained as development reference; they have not been run for this packaging work. Building successfully does not establish compatibility with every Linux distribution, input device, toolkit, or browser.
./seats packageThis produces a source-complete dist/seats-1.0.0.3.tar.gz and SHA-256 checksum.
It excludes build results, local logs, caches, installation records, and Git
metadata. You can alternatively publish the repository directly. The source
inventory is verified before export. Archive users run ./install after
unpacking; they do not need the original development directories.
Menu enablement copies an existing Whisker instance's settings into the Seats module's configuration on first use. Later toggles preserve both modules' settings. Menu disablement restores the original module and its original settings; edits made while using Seats remain in its own rc file for future use. These small user configuration files are retained on uninstall rather than deleting preferences.
./install prints Seats 1.0.0.3, then performs component checks, then reports
existing managed installations, existing seats commands, and an existing/running
Seats/MPX controller. Only then does it ask whether to install or reinstall. You
can run it on an already working machine, inspect its report, and answer No
without changing the installation or running session.
Reinstalling is supported. A new private release is staged before replacing the user command and bundled menu files, and the original pre-installation backups are retained. A running previous release continues until you approve restarting it. Setup offers to activate the bundled start-menu handling and restart the existing Seats service with the same selected physical devices. These actions have their own prompts because they interrupt panel interaction or reset focus.
seats restart # switch a running Seats session to the installed releasePrevious releases remain on disk after reinstall so their running processes and recovery commands keep their files. They are not automatically garbage-collected. Uninstall restores the original user files; old release directories can be removed manually after logging out if no longer needed. Existing arbitrary user edits are reported rather than silently discarded during removal.