https://github.com/stelzch/rm2anki

Convert remarkable notebooks into Anki packages (.apkg)
https://github.com/stelzch/rm2anki

anki cli remarkable-tablet

Last synced: 3 months ago
JSON representation

Convert remarkable notebooks into Anki packages (.apkg)

• Host: GitHub
• URL: https://github.com/stelzch/rm2anki
• Owner: stelzch
• License: gpl-3.0
• Created: 2023-11-22T16:56:34.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-01-14T17:56:44.000Z (10 months ago)
• Last Synced: 2024-05-21T13:34:03.969Z (6 months ago)
• Topics: anki, cli, remarkable-tablet
• Language: Rust
• Homepage: https://ch-st.de/remarkable-anki/
• Size: 53.7 KB
• Stars: 6
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-reMarkable - rm2anki - Convert reMarkable notebooks into an Anki card decks. (Other / Launchers)

README

        
# rm2anki

> [!WARNING]

> rm2anki uses [a library](https://github.com/ax3l/lines-are-rusty) for rendering notebooks that does not support the new lines format version 6.

> This means that notebooks created with OS versions 3.x will not work as input.

> OS version 2.15.1.1189 is known to create notebook files that can be parsed.

This tool allows you to write flashcards on a reMarkable paper tablet and then convert them into Anki Decks.

* 1 notebook = 1 Anki deck

* The name of the deck is either the notebook name or the filename

* Editing cards works by reconverting the notebook. Learning progress is not lost.

## Usage

```

Usage: rm2anki [OPTIONS]  [NOTEBOOKS]...

Arguments:

          Path to the destination .apkg

  [NOTEBOOKS]...  Path to a notebook in rmapi zip file format

Options:

  -a, --anki-media-dir 

          Path to Anki collection.media directory

  -n, --name-from-filename

          Use zipfile basename as deck name. Default is to use notebook name.

  -h, --help

          Print help

  -V, --version

          Print version

```

The input to this tool are notebook zip files generated by [rmapi](https://github.com/juruen/rmapi).

## Template

To write flashcards, either install the provided template pictured below or provide your own.



### Installation

If you prefer a GUI to do this, maybe try [rM2 Template Helper](https://www.freeremarkabletools.com/).

The following commands assume that you have SSH access to your remarkable and your current work directory is this repository.

Then you can run:

```sh

cd templates

scp flashcard.* [email protected]:/usr/share/remarkable/templates

```

Then you also need to register the template on the remarkable in a json file by pasting the below lines into the array under the path `/usr/share/remarkable/templates/templates.json`:

```json

{

    "name": "Flashcards",

    "filename": "flashcard",

    "iconCode": "\ue9d7",

    "categories": [

        "Life/organize"

    ]

}

```

### Designing your own

Right now, the area of the drawing that is extracted into the cards is fixed.

The bounding boxes given relative to width and height respectively are x=0.1740, y=0.1474, w=0.6519, h=0.3326 for the front and y=0.5200 for the back of a card.

As long as the cards in your template have the same size and position, they should import just fine.

The background is removed during import.