Watchtower
A task manager & system monitor - done right
NOTE: Watchtower is a linux application and should not be installed on a windows system, reported bugs about features not working or crashes / errors on windows will not be fixed.
Features
- Resource usage (updating live)
- Disk space (Used and availble)
- List of all processes running (updates every second)
- Show individual process resource usage
- Ability to kill (nuke) any process
- Advanced statistics on processes disk usage, uptime etc
- Sorting the processlist by ram and cpu usage
- Searching the processlist
- Customization through themes (config based)
- Config with a growing amount of values to configure
Installation
Note: This will not work until the first release of watchtower, you can still manually install the source from the repo but i recommend you wait for a release! You can install it from pypi using a tool of your choice, some examples are:
- pip:
pip install watchtower-app - pipx:
pipx install watchtower-app - uv:
uv tool install watchtower-app
Then you can launch the app by running watchtower in your terminal!
To make application launchers (Like rofi) and DE startmenus (KDE, Gnome etc) recognize and show the application a little more setup is needed, but fear not! Ive made it as easy as possible and you only have to run watchtower-install for it to work!
Configuration
Where are the config files?
The path can very depending on operating system, so to ensure that you have the right folder, launch watchtower through the terminal using watchtower after installation, this will log out the now created themes and config files.
config.toml
Here is a full config.toml config with description on what everything means:
[misc]
default-sort = "cpu" # ram or cpu - the sorting option that will be set on startup
default-theme = "Modern" # must be one of the themes in themes.toml - theme to be loaded on startup
More configuration will come as i add more features, so dont worry that its not that much yet!
themes.toml
The themes file will automatically add the 2 default themes ("Modern" and "Modern (Light)") if the themes.toml file doesnt exist or is empty. Lets have a look at one of the default themes and what the different colors represent:
["Modern"]
bg = "#191c24" # Background of the window(s)
fg-1 = "#1F232D" # Foreground 1 - Background of the windows different sections
fg-2 = "#242935" # Foreground 2 - Background of the Meters, Processes, Buttons and Searchbars inside a section
fg-3 = "#2A2F3C" # Foreground 3 - Background of the handle in the process sections scrollbar
text = "hsl(0, 0%, 75%)" # Color of most of the text
text-header = "hsl(0, 0%, 85%)" # Color of the bigger text in Meters and Topbars
border = "rgb(46, 50, 66)" # Border of almost everything
button-bg = "rgb(44, 50, 63)" # Background of buttons in the process elements (except the NUKE button)
button-kill-bg = "#a32626" # Color of the NUKE button
bar-meter = "qlineargradient(x1:0, y1:0, x2:1, y2:0, stop:0 rgb(230,120,120), stop:1 rgb(231,89,236))" # Color of the filled part in the meters, by default a nice gradient yoinked from my website, ch0.dev
Metadata
Release files for watchtower-app 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| watchtower_app-0.1.0.tar.gz | 12.7 kB | Without provenance | Details for watchtower_app-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| watchtower_app-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for watchtower_app-0.1.0-py3-none-any.whl |
Total release size: 28.1 kB
Release files / watchtower_app-0.1.0.tar.gz
| Download URL | watchtower_app-0.1.0.tar.gz |
|---|---|
| Size | 12.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be07490756c09e3a10ccc142c21d0248c4799bf1edebc868172684073c7859f0
|
|
BLAKE2b-256 checksum How to use checksums |
7c4c3ed90ac8f5e3b4cbb38110721ca8a9fd12cde56ba21c5b5d839d2ff6534d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / watchtower_app-0.1.0-py3-none-any.whl
| Download URL | watchtower_app-0.1.0-py3-none-any.whl |
|---|---|
| Size | 15.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c4e048e130420f6c11ed56f5098a091a8cf2ef8f21d73edc376f2b75fb1de6ab
|
|
BLAKE2b-256 checksum How to use checksums |
138012f87208372a13e6eea0ad0b8e67803104bd3fb9b2e187911b50021bc463
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for watchtower-app 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.