borgmatic systray icon
Project description
Traycortex
Tray icon for borgmatic.
(Early work in Progress.)
traycortex is an application that will show the status of borgmatic backup in your system tray.
Along with it comes a traycortex-cli application, that is used in the borgmatic hooks configuration to signal the tray icon. Currently the only states that are implemented are "job_started" and "job_finished".
When the status of a backup is updated, a notification will be displayed and the icon changes accordingly.
Installation
Prerequites
Some packages are required to build and install traycortex (probably incomplete):
- Ubuntu:
apt install libcairo2-dev python-gi-dev libgirepository1.0-dev
- Arch:
pacman -S gobject-introspection python-cairo libappindicator-gtk3
Recommended way to install:
pipx install traycortex
Also works:
pip install traycortex
Packagers welcome
Configuration File
Location: $XDG_CONFIG_HOME/traycortex.ini
Currently the only configuration that is possible is the authkey that is used to authenticate the connection between traycortex and traycortex-cli
Example:
[connection]
authkey = ce03f7af891ebc29defc0643faf71025
To create a working minimal configuration (if you do not have one already) use:
traycortex-cli --ini
This will generate a random authkey and place it in a new configuration file. If a configuration file already exists, above command will fail.
Other Configuration File Options
The command used to create a backup (when selecting the "Engage" menu item):
[borgmatic]
; default: borgmatic
command = systemd-inhibit --why="Backup is running" /usr/local/bin/borgmatic
Tray Menu
- Engage: Run a borgmatic backup
- Discard: Quit traycortex and remove the icon from the tray. If a backup is currently running, it will be killed.
Integrating with borgmatic
Example ~/.config/borgmatic.d/home.yaml
:
[...]
source_directories:
- /home/seb
repositories:
- path: ssh://...
before_backup:
- traycortex-cli job_started
after_check:
- traycortex-cli job_finished
[...]
Running
To start the tray application:
traycortex &
Other methods of starting will be investigated (.desktop file, systemd user unit)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for traycortex-0.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7614c5d7fd657a16cc3f00eb132910eb889be8a1f55d8348c3d09ad2393d6300 |
|
MD5 | 934701c1506d5eaff882fc67449fa6fd |
|
BLAKE2b-256 | 54a2cc3f3aa4c4289856cefcf01ab93f17a2336d6e9929db76df886c1d723779 |