Readwise to Omnivore importer

The "Readwise to Omnivore Importer" is a custom tool developed using Rust to facilitate the import of articles from Readwise Reader into Omnivore. It uses a CSV file exported from Readwise Reader using the web interface. The importer parses this CSV file, ensuring all data is transferred to Omnivore. Additionally, a verification check is run to confirm the existence of a URL before importing it into Omnivore. This is done to avoid polluting your Omnivore library with broken links. Furthermore, the tool provides clear logging results and a summary of the import process.

Features

• Parse the exported CSV file
• URLs that are invalid won't be imported into Omnivore
• Import into Omnivore using an API key for authentication
• Detailed logging of invalid and errored results shown in the terminal and stored as a CSV file
• Possibility to run the project locally or use the tool as a binary

Prerequisites

• Exported CSV file from Readwise Reader using the web interface. Check the FAQ for the steps.
• API key from Omnivore

Running the importer tool

There are two ways to run the importer tool. The easiest way without requiring to install Rust is by using the binary. For those who would like to explore the repository or make changes to the source code, it's also possible to run the tool with the Rust build tools.

Running it with the binary

A compiled binary is available for download in the project GitHub Releases.

1. Download the binary

   Navigate to the Release page and download the latest version for your operating system

2. Run the binary

   Open a terminal and navigate to the directory where you downloaded the binary. Add your CSV file in that directory and then run the following command with the two parameters replaced

   ./readwise_to_omnivore_importer --key YOUR_API_KEY --file-path PATH_TO_CSV

Running it locally

To run the project locally, make sure to first install Rust on your local machine. This should only take a few minutes. When that is done, open up a terminal and follow these steps:

1. Clone the repository

   git clone [email protected]:duncanlew/readwise-to-omnivore-importer.git
   cd readwise-to-omnivore-importer

2. Add your CSV file

   Add your exported CSV file from Readwise Reader into the directory called readwise-to-omnivore-importer.

3. Run the importer

   cargo run -- --key YOUR_API_KEY --file-path PATH_TO_CSV

Licence

This project is licensed under the MIT License. See the LICENSE file for more details.