Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nicciniamh/sview

Systemd Unit Viewer
https://github.com/nicciniamh/sview

administration gui linux point-and-click system systemd

Last synced: about 1 month ago
JSON representation

Systemd Unit Viewer

Awesome Lists containing this project

README 

        
# sview - The Linux Systemd Unit Viewer



![Screenshot](screenshot.png)



## Description

This program loads a list of systemd services and displays them with check boxes for "Active" and "Running". Toggling these checkboxes will trigger systemd commands to enable or disable the unit, or start or stop the unit. To accomplish this a policykit policy is used along with a helper than performs the job that we want to use. 



Units can be filtered so that only matches are shown, or mateches are not shown. Units can be searched with forward and backward searching. 



## Warning



I know very little about systemd but I'm learning. I have, for many years, wished for a way to control systemd securely and visually. 



I wrotet this yesterday, while watching TV. This should be considered ALPHA code, and should be treated as such. 



## Using

Each row in the list contains t he name of the unit, description, active and running states, the latter two represented by check boxes. Clicking the checkboxes triggers a systemctrl command to enable/disbale a unit, or start it. 



On the bottom of the screen are buttons for Close, Reload, Filter, Reset Filter and Search. 



* Close closes the program

* Reload reloads the services and states

* Filter allows for entering a search term (see below) to filter in or out matching units depending 

on wether the include or exclude is selected.

* Reset filter removes any filtering.

* Search prompts for a search term which is a full or partial name of a unit. When a successful seach is performed three more buttons are added: search previous, seearch next and close search. Searches and filters are case insensitive. 

* Search previous selects the previous item in the search. Searches wrap. 

* Search next selects the next item in the search. 

* Close search clears the search data and removes the search next, search previous and close search buttons. 



If an open search is active, filtering will close that search but searching filtered items is valid.



## Installation

To use sview, the follwing python modules are required: 



|Module   |Installation Candidate|

|---------|----------------------|

|    gi   | pygobject, cairo     |

| pystemd | python3-pystemd      |



If these modules are not installed, check your distributions installation instructions.



### setup.sh

The script, setup.sh, must be run as root. It will install the program, policy file, polkit helper and the desktop menu file. 



## Files 



| File                     | Purpose                                        |

|--------------------------|------------------------------------------------|

|sview                     | Main program module                            |

|setup.sh                  | program setup, run as root                     |

|sview.desktop             | opendesktop.org desktop entry file             |

|testmod                   | Python module to test imports, used by setup.sh|

|screenshot.png            | Screenshot of app                              |

|10-systemctl-polkit.rules | Rules for systemctl in polkit                  |

|com.ducksfeet.sview.policy| Policy for policykit                           |

|license.txt               | License for using this software                |



## Bugs 

probably a lot. 



## Documentation

This is it, sadly.