KOReader to Markdown

Read bookmarks from KOReader sidecars to Markdown files per book, prefixed with the date you added the most recent bookmark

How-to

2. Run pipenv install to install all dependencies from Pipfile
   • Install pipenv if you don't have it yet
3. Run make to download slpp.py
4. Start your KOReader's SSH server without a password and make note of its IP address
5. Make sure you can connect to it using ssh from your terminal. See this for more info
6. Rename example.env to .env and add the host (IP address) and user (typically root) of your KOReader's SSH
7. Run koreader-to-markdown.py
   1. If your SSH key requires a passphrase, you will be prompted
8. Copy the result from output to your Obsidian vault, or wherever you want to have your highlights as Markdown

Credits

• paramiko to read your KOReader's sidecars over SSH
• python-dotenv to read the contents of .env
• inquirer to ask for your SSH key's passphrase, if needed