uConsole Sway

Polished Sway configuration for the ClockworkPi uConsole on Ubuntu 26.04 LTS, tuned for the 5 inch display while keeping GNOME installed as a fallback session. This setup supports a standard Ubuntu installation on the uConsole.

What Is Included

• Sway config with 1.0 output scale, larger terminal text, larger Wofi launcher, compact workspace labels, smart single-window gaps, and polished Arc/Papirus-focused borders.
• Waybar setup with grouped compact modules, richer status icons, integrated resource status, dynamic battery state, brightness, audio, clock, and tray modules.
• Sway Notification Center styling flattened to avoid nested notification boxes.
• Foot terminal, Wofi launcher/run prompt, expanded quick settings menu, compact Wofi power menu, physical power-key handler, wallpaper picker, theme switcher, lock screen with locked-output poweroff, clipboard picker, scratchpad terminal, brightness/volume helpers with Wob feedback, Wofi brightness picker, Waybar media and idle-inhibitor status, and window picker scripts.
• GTK, Gammastep, Mako fallback, Wlogout legacy files, and setup/uninstall notes.

Layout

config/
  foot/
  gammastep/
  gtk-3.0/
  gtk-4.0/
  mako/
  sway/
  swaync/
  waybar/
  wob/
  wlogout/
  wofi/
notes/
  sway-setup-notes.md
  sway-uninstall-notes.md

Install Packages

These instructions target an Ubuntu 26.04 LTS installation on the uConsole.

sudo apt install sway swaybg swayidle swaylock waybar wofi foot mako-notifier grim grimshot slurp wl-clipboard xdg-desktop-portal-wlr pavucontrol blueman wdisplays gammastep cliphist wlogout wob fonts-font-awesome fonts-jetbrains-mono sway-notification-center udiskie thunar tumbler mousepad mpv mpv-mpris playerctl power-profiles-daemon evtest evemu-tools

Optional theme tools:

sudo apt install lxappearance qt5ct qt6ct arc-theme papirus-icon-theme materia-gtk-theme

Apply Config

Back up existing config first:

mkdir -p ~/old-sway-config
mv ~/.config/sway ~/.config/waybar ~/.config/wofi ~/.config/foot ~/.config/swaync ~/.config/mako ~/.config/wlogout ~/.config/gammastep ~/old-sway-config/ 2>/dev/null

Copy the repo config into place:

cp -a config/sway ~/.config/
cp -a config/waybar ~/.config/
cp -a config/wofi ~/.config/
cp -a config/foot ~/.config/
cp -a config/swaync ~/.config/
cp -a config/mako ~/.config/
cp -a config/wlogout ~/.config/
cp -a config/gammastep ~/.config/
cp -a config/wob ~/.config/
mkdir -p ~/.config/gtk-3.0 ~/.config/gtk-4.0
cp -a config/gtk-3.0/settings.ini ~/.config/gtk-3.0/settings.ini
cp -a config/gtk-4.0/settings.ini ~/.config/gtk-4.0/settings.ini

Log out and choose the Sway session from the login screen.

Main Shortcuts

• Super+Enter: terminal
• Super+Shift+Enter: fullscreen terminal
• Super+grave: scratchpad terminal
• Super+Space or Super+d: app launcher
• Super+Shift+Space: run prompt
• Super+q: quick settings menu
• Super+Tab: window picker
• Super+Shift+Tab: choose a window to close
• Super+/: fullscreen shortcut sheet
• Super+n: notification center
• Super+Control+l: lock screen
• Super+Shift+p: power menu
• Super+Shift+r: Shairport TUI
• Super+Shift+t: theme switcher
• Super+Shift+w: wallpaper picker
• Super+Shift+c: reload Sway
• Physical power button: tap for power menu, hold 2s to shut down

See notes/sway-setup-notes.md for the full setup history and notes/sway-uninstall-notes.md for removal steps.

Device Notes

• The config intentionally uses output * scale 1.0; app and terminal readability are handled through font and UI sizing. The uConsole panel is explicitly pinned as DSI-1 mode 720x1280 transform 90 scale 1.0.
• Foot launches standalone terminals with term=foot; the terminal wrapper disables Codex keyboard enhancement to avoid duplicate key behavior.
• Brightness uses config/sway/brightness.sh because the uConsole panel exposes only a small number of hardware brightness levels; clicking the Waybar brightness module opens a compact Wofi picker for fixed brightness levels.
• Volume up is capped at 100% for both hardware volume keys and Waybar scroll.
• Waybar uses a compact grouped status style with richer FontAwesome glyphs for CPU, memory, brightness, media, idle lock, and clock. The bar keeps status spacing tight, uses concise hover text across status modules, includes a one-click idle-inhibitor toggle, and hides the notification-center and power-menu buttons; use Super+n for notifications and Super+Shift+p for power actions.
• Waybar, Wofi, and Sway Notification Center use no-install CSS transitions for smoother hover, selection, and status feedback. Plain Sway does not animate windows or workspace transitions.
• Sway Notification Center opens with Super+n, without a Waybar icon, and its panel is flush with the top edge.
• Wofi keeps app icons visible, uses its cache so frequent apps appear first, and shares the same compact dark surface treatment as the quick and power menus.
• Super+q opens a quick settings menu for device status, power profile, disk tools, network status/settings, Bluetooth, audio, brightness, display, night color, theme, wallpaper, config folder, notifications, screenshots, clipboard, notes, UI restart, Waybar restart, Quiet Mode, cleanup review, AirPlay TUI, lock, and power actions.
• Waybar includes fast playerctl media status: playing, paused, and stopped have distinct icons; artist-first track text updates through a continuous 1-second helper loop, escapes markup-sensitive track text, is bounded to 30 characters on the bar, and expires after 10 minutes without active playback.
• Hardware and Waybar volume controls use config/sway/volume.sh for capped volume-up behavior, Wob progress feedback when available, and notification fallback.
• Super+Shift+Space opens the Wofi run prompt; floating toggle is Super+Control+f.
• Super+grave toggles a floating scratchpad Foot terminal.
• Workspaces are intentionally icon-free numeric labels in Sway and Waybar to keep the bar compact.
• Super+Shift+r opens /home/mew/bin/shairport-tui in a fullscreen Foot terminal on the current workspace.
• The lock helper turns the output off after 5 seconds of locked inactivity and wakes it on key/input resume before unlocking.
• Gammastep remains installed and can be toggled with Super+Shift+g, but it no longer autostarts because this display path currently reports no gamma adjustment support.
• Arc Darker + Papirus is the default visual profile. Optional Arc/Materia/Yaru/Papirus themes are available in the switcher when installed. Choosing some third-party themes may make snapd-desktop-integration warn about missing theme snaps; switch to Yaru/Adwaita if you want a quiet login.
• Suspend is not exposed in the power menu because this device currently has wake issues after suspend/black-screen behavior. The physical power key is configured so logind ignores short presses and Sway handles tap versus hold through power-key.sh.

Credits

• Ubuntu 26.04 LTS as the supported installation base.