Skip to content

Console mode - #101

Merged
MrMilenko merged 6 commits into
mainfrom
console-mode
Nov 20, 2026
Merged

MrMilenko merged 6 commits into
mainfrom
console-mode

Conversation

@MrMilenko

Copy link
Copy Markdown
Owner

First step toward using UIX Desktop in place of a machine's normal shell, without changing anything about the OS itself. The desktop stays underneath the whole time.

  • Console Mode (Settings > General, or --console): borderless fullscreen with no frame, the pointer hidden until the mouse moves, straight to the dashboard.
  • Start at Login, per user only: a LaunchAgent on macOS, an autostart entry on Linux, the user's Run key on Windows. Turning it off removes exactly what it added, and the setting shows what's really there.
  • Exit page in console mode: Go to Desktop, Exit, Sleep, Restart, Shut Down. Restart and Shut Down ask first and start on Cancel.
  • Crash watchdog in console mode: relaunches after a crash, gives up after two crashes within a minute and leaves you on the desktop. On Windows the guide's restart goes through the watchdog so it keeps watching.
  • Battery level in the guide header on battery or charging, and a System Settings row that opens the OS's own settings.

Checked on macOS: login item written and removed only in a throwaway home, power actions in dry run only (UIX_DEV_POWER_DRYRUN=1), watchdog relaunch and give-up with a forced crash, confirm screens start on Cancel. Lint, desktop and both Xbox builds clean. Windows and Linux were syntax checked; real power, autostart and watchdog runs on those still need testing.

Turned on in Settings or with --console, it runs fullscreen with no frame, keeps the pointer hidden until the mouse moves and goes straight into the dashboard after the first run.
It writes a LaunchAgent on macOS, an autostart entry on Linux or the HKCU Run value on Windows, each starting UIX Desktop with --console, and turning it off removes that entry. The setting shows what's really there instead of what desktop.ini says. Windows and Linux need a real test.
In Console Mode the Exit page now has Go to Desktop, Sleep, Restart and Shut Down, with Restart and Shut Down asking first and starting on Cancel. Tested on macOS in dry run only; Linux and Windows need a real test.
With --console the first process just runs UIX Desktop as its child and starts it again after a crash, but gives up and logs it if it crashes twice within a minute. On Windows a restart from the guide or Ctrl+R now asks the watchdog to do it, since exec there would end the watched process. Windows needs a real test.
The guide header shows the battery when running on it or charging. Desktop Tools has System Settings, which opens the OS's own settings and is hidden on Linux when nothing can open them. Linux and Windows need a real test.
UIX_DEV_WINDOWED=1 skips the fullscreen switch, so the power screens can be checked without taking over the display.
@MrMilenko
MrMilenko merged commit d64ff0f into main Nov 20, 2026
9 of 10 checks passed
@MrMilenko
MrMilenko deleted the console-mode branch November 20, 2026 14:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant