Borgend is a retrying and queuing scheduler as well as a macOS tray icon for BorgBackup. If you are not on macOS, no tray icon will be displayed, but you can still use Borgend as a scheduler.
Designed with laptops in mind, Borgend works in “dreamtime”: on macOS the scheduler discounts system sleep periods from the backup intervals. If you wish, you can also choose “realtime” scheduling.
You can have multiple backups to the same repository; for example, you may backup a small subset of your files every couple of hours, and everything once a day or once a week. Borgend will ensure that only one backup is launched at a time, and queue the other one until the repository is available.
If there was an error, such as when you are offline and backup to a remote
sshlocation, Borgend will also retry the backup at set shorter intervals.
The lead author is Tuomo Valkonen (firstname.lastname@example.org).
You will need to install the following non-standard Python packages:
The use the tray icon on macOS, you will need:
- rumps (Ridiculously Uncomplicated macOS Python Statusbar apps)
If you are not on macOS, you will need:
- xdg for configuration file location
With the dependencies satisfied, Borgend may be run with
To permanently authenticate Borgend to use the keychain, and therefore not have to enter the keychain password every time Borgend is launched, it is useful to create a standalone Mac app. This can be done with
To create an app that you can launch at startup and give permanent permissions to the keychain, use
python3 setup.py py2app -A
The app hould be placed under
dist/. Copy it to your
directory, and set it up to launch on login.
If you are keen on wasting your life, you can try to run py2app without the
-A option to create a standalone app that you can copy to computers without
Python installed, but it will probably most likely not work because py2app
is shit. Currently (2018-09-18) it is not working with the keyring package.
Usage and configuration
See the included
config.example.yaml, which shoud be relatively
self-explanatory. The lists
prune_parameters are simply Borg command line key–value parameters, passed
to it after expansion of environment variables.
Edit the sample configuration file and copy it to its proper location. On
macOS this should be
and on other systems this will usually be
You can find out the actual location by launching Borgend from the command
line with the
Passphrases are stored in the OS X Keychain (or whatever the
package supports on other systems). In the Borgend configuration file, you
only configure the ‘account’ of the of the password using
keyword of each backup set. The ‘service’ of the password has to be
borg-backup. To add a password into the keychain for the
‘account’, you may use:
security add-generic-password -a myrepo -s borg-backup -w [PASSWORD]
This software is distributed under an ANTI-ABUSE LICENSE (aka. f..k copyright and f..k distributions license), and without any warranty whatsoever. If you redistribute this software as part of a larger collection/distribution/suite of software, you must do either of the following:
(a) Always redistribute the unmodified and latest version provided by the lead author. If the lead author releases a new version (on a specific branch, such as 'stable' or 'development'), you must promptly make that new version the default version offered to your users (on that specific branch).
(b) Rename the software, and make it obvious that your modified or obsolete software is in no way connected to the lead author of the original software. The users of your version should under no circumstances be under the illusion hat they can contact the lead author or any of the authors of the original software if they have any complaints or queries.
Otherwise, do whatever you want with this software. In particular, you may freely use code snippets in other projects.