mirror
/
vorta
mirror of https://github.com/borgbase/vorta
1
0
Fork 0
Code Issues Releases Wiki Activity
139 Commits 8 Branches 85 Tags 7.7 MiB
Python 99.2%
Makefile 0.5%
Shell 0.3%
Go to file
Manu 175a00726f Add Makefile to enable building macOS app package. 2018-11-21 16:22:33 +08:00
bin/macosx64 Package macOS app as DMG. Add Sparkle Framework. 2018-11-21 16:17:27 +08:00
src/vorta Package macOS app as DMG. Add Sparkle Framework. 2018-11-21 16:17:27 +08:00
tests re-arrange wait conditions. 2018-11-20 17:45:14 +08:00
.bumpversion.cfg Bump version: 0.4.0 → 0.4.1 2018-11-20 18:07:41 +08:00
.gitignore Add Makefile to enable building macOS app package. 2018-11-21 16:22:33 +08:00
.travis.yml Skip existing pyenv version. 2018-11-20 17:25:00 +08:00
LICENSE.txt Finish packaging. 2018-10-27 00:01:59 +08:00
MANIFEST.in Fixes to packaging 2018-11-02 23:46:14 +08:00
Makefile Add Makefile to enable building macOS app package. 2018-11-21 16:22:33 +08:00
README.md Add Makefile to enable building macOS app package. 2018-11-21 16:22:33 +08:00
Vagrantfile Add Vagrantfile 2018-11-13 14:49:42 +08:00
appdmg.json Package macOS app as DMG. Add Sparkle Framework. 2018-11-21 16:17:27 +08:00
requirements-dev.txt Add forked pytest to avoid segfaults. 2018-11-20 17:19:59 +08:00
setup.cfg Tooltip to explain unlimited backups. 2018-11-21 14:03:39 +08:00
setup.py Fixes to packaging 2018-11-02 23:46:14 +08:00
vorta.spec Package macOS app as DMG. Add Sparkle Framework. 2018-11-21 16:17:27 +08:00

README.md

Vorta - A Boring Open Source GUI for BorgBackup

Build Status

Vorta is an open source macOS/Linux GUI for BorgBackup. It's currently in beta status.

Main features

  • Encrypted, deduplicated and compressed backups.
  • Works with any local (NEW!) or remote Borg repo. Try BorgBase for advanced features like append-only repositories and monitoring.
  • Add SSH keys and initialize repos directly from the GUI.
  • Repo keys are securely stored in macOS Keychain, SecretService or KWallet.
  • Mount existing snapshots via FUSE.
  • Manage multiple backup profiles with different source folders, destinations and settings. (NEW!)
  • Prune and check backups periodically.
  • Flexible scheduling for automatic background backups. Only allow on certain Wifis.
  • View a list of snapshots and action logs.
  • Exclude options/patterns.
  • Error notifications.

Coming soon:

  • Full test coverage (currently: ~60%)
  • Packaging for Linux? How?

Installation and Download

Vorta should work on all platforms that support Qt and Borg. Currently Borg doesn't support Windows, but this may change in the future. Setting allowed Wifi networks is currently not supported on Linux, but everything else should work.

macOS

Download the pre-built macOS binary from Releases. Just download, unzip and run. If you want detailed steps, there is also a tutorial.

Linux

First install Borg and its dependencies. Then install Vorta from Pypi:

$ pip install vorta

After installation run with the vorta command.

$ vorta

Development

Install in development/editable mode while in the repo:

$ pip install -e .

Then run as Python script:

$ vorta

Install developer packages we use (pytest, tox, pyinstaller):

pip install -r requirements-dev.txt

Qt Creator is used to edit views. Install from their site or using Homebrew and then open the .ui files in vorta/UI:

$ brew cask install qt-creator
$ brew install qt

To build a macOS app package:

  • add Sparkle.framework from here and borg from here in bin/macosx64
  • then uncomment or change the Apple signing profile to be used in Makefile
  • finally run to $ make Vorta.app to build the app into the dist folder.

Testing (work in progress)

Tests are in the folder /tests. Testing happens at the level of UI components. Calls to borg are mocked and can be replaced with some example json-output. To run tests:

$ pytest

Why the Name?

Vorta are a race referenced in Star Trek. They serve the Dominion and are replaced by their clones if they die. Just like our backups.

Privacy Policy

  • No personal data is ever stored or transmitted by this application.
  • During beta, crash reports are sent to Sentry to quickly find bugs. You can disable this by setting the env variable NO_SENTRY=1.

Author

(C) 2018 Manuel Riel for BorgBase.com

License and Credits