Turtl Backup

This program permits to download a whole turtl account for offline backuping, and optionally decrypt the backup file, then optionally export the decrypted file to markdown.

Installation

You can install turtl-backup using pip:

pip3 install turtl-backup

Usage

There's a graphical user interface:

turtl-backup-gui

And a command line tool, here's its usage:

usage: turtl-backup [-h] {backup,get_auth_token,export} ...

Backup a turtl account.

positional arguments:
{backup,get_auth_token,export}
                      Backup can be done with a login/password pair or using
                      an auth token.
  backup              Backup a turtl account (with a password or an auth
                      token)
  get_auth_token      Get a turtl auth token
  export              Decrypt and export all notes in the given directory.

optional arguments:
-h, --help            show this help message and exit

So typically to create an encrypted backup:

$ turtl-backup backup https://api.framanotes.org backup.json
username: test
password:

To decrypt a backup:

$ turtl-backup decrypt backup.json backup/
username: test
password:

To export a decrypted backup to markdown:

$ turtl-backup export backup/ backup-md/
$ cat backup-md/Hello.md
type: text
title: Hello
tags: []
url: None
username: None
password: None

world

FAQ

Is it possible to setup a cron to backup my notes without storing my login/password in plaintext in my crontab?

Yes, the turtl auth_token is enough to backup an account. You can get your auth token using turtl-backup get_auth_token, but still be carefull not to leak it. Then use turtl-backup backup --auth-token YOUR_AUTH_TOKEN.

Is it possible to decrypt my notes using my auth_token?

No, you'll need your login and password again.