Skip to content
atraonePublic

About

Single-session Linux multiseat: two independent mouse/keyboard pairs sharing one Xfce X11 desktop and login, using MPX/XInput2. Includes installer, seat-aware menu, and recovery.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Seats

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.

Install on another machine

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:

./install

Setup 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 start

Menu 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 stop

Use 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.

Prerequisites and individual setup commands

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 activation

An 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.

What installation changes

  • A versioned private release under $XDG_DATA_HOME/seats/releases/ (normally ~/.local/share/seats/releases/).
  • The ~/.local/bin/seats command. 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.

Recovery and removal

seats stop
seats menu-disable
# Save work, log out, and log back into Xfce.
seats uninstall

The 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.

Source and provenance

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.

Publish or transfer

./seats package

This 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.

Installer order and reinstalling

./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 release

Previous 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.

About

Single-session Linux multiseat: two independent mouse/keyboard pairs sharing one Xfce X11 desktop and login, using MPX/XInput2. Includes installer, seat-aware menu, and recovery.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages