sysd-manager 2.6.0

Application to empower user to manage their <b>systemd units</b> via Graphical User Interface. Not only are you able to make changes to the enablement and running status of each of the units, but you will also be able to view and modify their unit files and check the journal logs.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204

<div align="center">

![SysD Manager Icon](data/icons/hicolor/scalable/apps/io.github.plrigaux.sysd-manager.svg "App Icon")

# SysD Manager

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://raw.githubusercontent.com/plrigaux/sysd-manager/refs/heads/main/LICENSE)
[![Love SysD Manager? Please consider donating to sustain our activities](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86&style=flat)](https://github.com/sponsors/plrigaux)
[![Flathub](https://img.shields.io/flathub/v/io.github.plrigaux.sysd-manager?logo=flathub&logoColor=white&label=Flathub)](https://flathub.org/apps/io.github.plrigaux.sysd-manager)

A user-friendly GUI to manage systemd units

</div>

## 📋 Description

- Change the enablement and running status of systemd units
- View and modify unit files with syntax highlighting
- Check journal logs with syntax highlighting
- Explore unit dependencies visually
- And much more!

> **Disclaimer:** This application is intended for users with less experience with systemd rather than professional system administrators. If you consider yourself an administrator, please refer to `systemctl` and `journalctl` documentation.

## ✨ Features

| Feature | Status |
|---------|--------|
| Unit file browser with search and filtering | ✅ |
| Enable or disable a unit | ✅ |
| Enable a unit in runtime | ✅ |
| Activate or deactivate a unit | ✅ |
| View and modify unit file | ✅ |
| View and navigate unit's dependencies | ✅ |
| Unit file syntax highlighting | ✅ |
| Journal file syntax highlighting | ✅ |
| List of all running units (systemd-analyze blame) | ✅ |
| Dark and Light style switching | ✅ |
| Select a unit at program opening via CLI | ✅ |
| Clean unit like `systemctl clean` | ✅ |
| Freeze & Thaw unit like `systemctl freeze` and `systemctl thaw`  | ✅ |
| Multi-language support | ✅ |
| Real-time journal events update | ✅ |
| Retrieve list of boot IDs | ✅ |
| Ability to watch _systemd_ signals | ✅ |

*Need a feature? Contact the author or contribute to the project! If you're stuck, take a look at `systemctl`.*

## 📸 Screenshots

<div align="center">

### Unit Info (Dark)
![Unit Info Dark](screenshots/unit_info_dark.png)

### Unit Info (Light)
![Unit Info Light](screenshots/unit_info.png)

### Unit Dependencies
![Unit Dependencies](screenshots/dependencies_dark.png)

### Unit Files
![Unit Files](screenshots/unit_file_dark.png)

### Unit Journal
![Unit Journal](screenshots/journal_dark.png)

</div>

## 🔧 Installation

### Flathub
<a href="https://flathub.org/apps/io.github.plrigaux.sysd-manager"><img width="200" alt="Download on Flathub" src="https://flathub.org/api/badge?svg"/></a>

### Arch Linux

<a href="https://aur.archlinux.org/packages/sysd-manager"><img width="200" alt="Download on Flathub" src="https://aur.archlinux.org/static/css/archnavbar/aurlogo.png"/></a>


```bash
yay -S sysd-manager
```

### AppImage
<a href="https://github.com/plrigaux/sysd-manager/releases/latest"><img width="100" alt="Download latest Appimage release" src="https://docs.appimage.org/_images/appimage.svg"/></a>

### Build from Source

1. Install prerequisites:
   - [Rust](https://www.rust-lang.org/tools/install)
   - GTK 4 and build essentials ([how-to](https://gtk-rs.org/gtk4-rs/stable/latest/book/installation_linux.html))
   - Libadwaita ([how-to](https://gtk-rs.org/gtk4-rs/stable/latest/book/libadwaita.html))
   - Systemd development library (`libsystemd-dev`)
   - GtkSourceView 5 development library

2. Clone and build:
```bash
git clone https://github.com/plrigaux/sysd-manager
cd sysd-manager/scripts 
sh install.sh
```

3. Run:
```bash
sysd-manager
```

*For a clean removal, execute:* `sh uninstall.sh`

## 🧪 Testing

You can safely test SysD Manager using **tiny_daemon**, a simple web server service included with the project:

```bash
cd packaging
python install_tiny
```

## 🛣️ Roadmap

Planned features:
- Filter units on more properties
   - Save filters
- Display more properties in the unit browser
   - Add/Remove columns
   - Ajust cell viewer according to property types (time)
- Functionality edit gereated file or original
- Context menu on unit browser row
- Always administrator mode
- Continuous UX improvements

## 📝 Changelog

All notable changes are documented in the [CHANGELOG](CHANGELOG.md).

## 🤝 Contributing

Interested in contributing? Contact the project maintainer on [GitHub](https://github.com/plrigaux/sysd-manager).

## 🌐 Internationalization

__SysD Manager__ can be displayed in different languages as long a translation has been provided.

<div align="center">
<a href="https://hosted.weblate.org/engage/sysd-manager/" target="_blank">
<img src="https://hosted.weblate.org/widget/sysd-manager/translation/multi-auto.svg" alt="Status da tradução" style="height:300px;" >
</a>
</div>


### Translators

Translations are generously hosted by [Weblate](https://weblate.org).
Please help translate __Sysd Manager__ into more languages through the [__Sysd Manager__ Hosted Weblate](https://hosted.weblate.org/engage/sysd-manager/).

### Developpers and Translator

Some tools have been created to help with translation. The following shows the most important ones to help translators


<!-- ### Generate POTFILES

To generate the POTFILES file that contains the list of input files to look for to exrtact translatable strings. 
```
cargo run -p transtools -- potfiles
```

_Normally a translator don't have to use this command. Use it only after you created or removed new source files_ -->

#### Generate missing po files or update them

After changes in the source code it's needed to update a po languages file. The following command helps you to perform that.
```
cargo run -p transtools -- po -lang <LANG>
```

_Also useful for adding a new translated language_

#### Extract transalation texts

To extract translation texts form source code and generate a Portable Object Template (pot) file. This is needed __only__ after code changes.

```
cargo run -p transtools -- extract -lang <LANG>
```

#### Notes

- To add a new translated language, first add the new language code, respecting ```ll``` or ```ll_LL``` format, in the ```./po/LINGUAS``` files.
- To test any tanslated languages, just set the envroment variable like this:  ```export LANGUAGE=<language code>```
<!--
### Generate Templated

To generate the language template. 
The xgettext program extracts translatable strings from given input files.
```
cargo run -p transtools -- xgettext
```

_Normally a translator don't have to use this command. Use it only after you created or removed new source files_
-->
## 💡 Credits

This project is inspired by the work of Guillaume Gomez: https://github.com/GuillaumeGomez/systemd-manager/