Metadata-Version: 2.1
Name: turtl-backup
Version: 0.1.0
Summary: Tool to backup a turtl account.
Home-page: https://github.com/JulienPalard/turtle-backup
Author: Julien Palard
Author-email: julien@palard.fr
License: MIT
Keywords: turtl backup
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: requests
Requires-Dist: cryptography

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:
```bash
pip3 install turtl-backup
```

Usage
-----

There's a graphical user interface:
```bash
turtl-backup-gui
```

And a command line tool, here's its usage:
```bash
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:
```bash
$ turtl-backup backup https://api.framanotes.org backup.json
username: test
password:
```

To decrypt a backup:
```bash
$ turtl-backup decrypt backup.json backup/
username: test
password:
```

To export a decrypted backup to markdown:
```bash
$ 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.


