turtl-backup
turtl-backup copied to clipboard
Tool to backup a turtl account
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.