Wren Linux

wren-linux / docs / extras / console-only.md (as plain text)

Console-only: tmux instead of sway (extras/console-only.sh)

SYNOPSIS

wrenctl install console-only                     log in to tmux from now on (from sway, it leaves sway)
wrenctl remove console-only                      log in to sway again (from tmux, it starts sway)
wrenctl manual console-only                      print the manual steps below

Alt+1 ... Alt+0      workspace 1 ... 10 (Alt+Shift+1 ... sends the pane)
Alt+Enter / Alt+v    split beside / below     Alt+h j k l or arrows: move
Alt+f fullscreen the pane   Alt+Shift+q close it   Alt+m the Wren menu
Alt+t timers   Alt+? keys   Alt+w Wi-Fi   Alt+- Alt+= volume   Alt+, Alt+. brightness
sway                 start the desktop by hand

A login on a text console then goes straight into tmux, with the bar and keys of the sway desktop (Alt where sway uses Super), instead of starting sway. Only the login changes: sway stays installed. The tmux look comes with the base install (parts/console-tmux.sh), and the login loop Wren Linux put in ~/.profile starts whatever ~/.config/wren/login names: sway or console. When that file changes while one is running, the loop starts the other.

LIMITS

MANUAL INSTALL

# The tmux look, if it isn't there yet (the base install has it):
# tmux, the bar's helpers and the config
sudo apt install --no-install-recommends tmux
for c in sway-status console-click console-font; do install -D -m 0755 @WREN_DIR@/bin/$c ~/.local/bin/$c; done
mkdir -p ~/.config/tmux ~/.local/share/wren
cp @WREN_DIR@/data/tmux.conf ~/.config/tmux/tmux.conf
cp @WREN_DIR@/data/tmux-console.conf ~/.config/tmux/console.conf
install -m 0644 @WREN_DIR@/data/keys-console.txt ~/.local/share/wren/keys-console.txt

# Log in to tmux: the login loop in ~/.profile reads this file
# (it must have the "Wren Linux autostart" block: grep shows it)
grep -n 'Wren Linux autostart' ~/.profile
mkdir -p ~/.config/wren
echo console >~/.config/wren/login
# From inside sway, leaving it now starts tmux
swaymsg exit

To undo:

# Log in to sway again; from inside tmux, detaching starts it
echo sway >~/.config/wren/login
tmux detach-client