Skip to content

joehillen/sysz

Repository files navigation

A fzf terminal UI for systemctl

Console - Developer Tool of the Week

Demo

asciicast

Features

VERSION: 1.4.3

  • See and filter both system and user units simultaneously.
  • Supports all unit types.
  • Units ordered by service, timer, socket, and the rest.
  • Runs sudo automatically and only if necessary.
  • Filter units by state using ctrl-s or the --state option.
  • Run daemon-reload with ctrl-r.
  • Has short versions of systemctl commands to reduce typing.
  • Runs status after other commands (start, stop, restart, etc).
  • Select multiple units, states, and commands using TAB.
  • Only prompts commands based on current state (e.g. show "start" only if the unit is inactive).

Requirements

  • fzf >= 0.27.1
  • bash > 4.3 (released 2009)
  • awk

Installation

Arch Linux

paru -S sysz

NixOS

nix-env -iA nixos.sysz

Using Nix

nix-env -iA nixpkgs.sysz

Using bin

bin install https://github.com/joehillen/sysz

Direct Download

wget -O ~/.bin/sysz https://github.com/joehillen/sysz/releases/latest/download/sysz
chmod +x ~/.bin/sysz

From Source

git clone https://github.com/joehillen/sysz.git
cd sysz
sudo make install # /usr/local/bin/sysz

Usage

A utility for using systemctl interactively via fzf.

Usage: sysz [OPTS...] [CMD] [-- ARGS...]

sudo is invoked automatically, if necessary.

If only one unit is chosen, available commands will be presented
based on the state of the unit (e.g. "start" only shows if unit is "active").

OPTS:
  -u, --user               Only show --user units
  --sys, --system          Only show --system units
  -s STATE, --state STATE  Only show units in STATE (repeatable)
  -V, --verbose            Print the systemctl command
  -v, --version            Print the version
  -h, --help               Print this message

  If no options are given, both system and user units are shown.

CMD:
  start                  systemctl start <unit>
  stop                   systemctl stop <unit>
  r, restart             systemctl restart <unit>
  s, stat, status        systemctl status <unit>
  ed, edit               systemctl edit <unit>
  reload                 systemctl reload <unit>
  en, enable             systemctl enable <unit>
  d, dis, disable        systemctl disable <unit>
  c, cat                 systemctl cat <unit>

  If no command is given, one or more can be chosen interactively.

ARGS are passed to the systemctl command for each selected unit.

Keybindings:
  TAB           Toggle selection.
  ctrl-v        'cat' the unit in the preview window.
  ctrl-s        Select states to match. Selection is reset.
  ctrl-r        Run daemon-reload. Selection is reset.
  ctrl-p        History previous.
  ctrl-n        History next.
  ?             Show keybindings.

History:
  sysz is stored in $XDG_CACHE_HOME/sysz/history
  This can be changed with the environment variable: SYSZ_HISTORY

Some units are colored based on state:
  green       active
  red         failed
  yellow      not-found

Examples:
  sysz -u                      User units
  sysz --sys -s active          Active system units
  sysz --user --state failed   Failed user units

Examples with commands:
  sysz start                  Start a unit
  sysz --sys s                Get the status of system units
  sysz --user edit            Edit user units
  sysz s -- -n100             Show status with 100 log lines
  sysz --sys -s active stop    Stop an active system unit
  sysz -u --state failed r    Restart failed user units

Acknowledgements

Inspired by fuzzy-sys by NullSense

Thank you for ShellCheck without which this would be a buggy mess.