Skip to content

igormino104/servicemaster

 
 

Repository files navigation

ServiceMaster 1.6.1

ServiceMaster is a powerful terminal-based tool for managing systemd units on Linux systems. It provides an intuitive interface for viewing and controlling system and user units, making it easier to manage your units without leaving the command line.

Features

  • View all systemd units or filter by type (services, devices, sockets, etc.)
  • Start, stop, restart, enable, disable, mask, and unmask units
  • View detailed status information for each unit
  • Switch between system and user units
  • User-friendly ncurses interface with color-coded information
  • Keyboard shortcuts for quick navigation and control
  • DBus event loop: Reacts immediately to external changes to units
  • Search for units by name

Requirements

  • Linux system with systemd
  • NCurses library
  • Systemd development libraries

Usage

After launching ServiceMaster, you can use the following controls:

  • Arrow keys, page up/down: Navigate through the list of units
  • Space: Toggle between system and user units
  • Enter: Show detailed status of the selected unit
  • F1-F8: Perform actions (start, stop, restart, etc.) on the selected unit
  • a-z: Quick filter units by type
  • q or ESC: Quit the application
  • f: Search for units by name

CLI Options

  • -v: Display the version information and exit
  • -w: Do not show the welcome message
  • -h: Display help / usage message and exit

Security Note

For security reasons, only root can manipulate system units, and only user units can be manipulated when running as a regular user.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author

Lennart Martens

Version

1.6.1 (2025)

Building & Install

Dependencies

Archlinux

pacman -S cmake meson ncurses systemd-libs

Ubuntu/Debian

apt install cmake meson libncurses5-dev libsystemd-dev

Building

git clone https://github.com/Lennart1978/servicemaster.git

cd servicemaster/

mkdir builddir

meson setup builddir --buildtype=release --prefix=/usr/local

meson compile -C builddir

Install

meson install -C builddir

For Archlinux users: There is 'servicemaster-git' (recommended) and 'servicemaster-bin' in the AUR

I recommend installing the -git version ! It is in most cases much more bugfree / stable and uptodate than the -bin version

(I'm not the maintainer of the -bin version)

Screenshots

ServiceMaster in 'kgx' standard Gnome terminal emulator: ss1 ServiceMaster in 'Kitty' terminal and 'gruvbox-dark' theme: ss2

Logo

ss3

About

Linux systemd administration tool with nice TUI written in C

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C 96.7%
  • Roff 2.6%
  • Meson 0.7%