Warning

Omnivore, the service, is going away. This exporter will be be archived soon.

Omnivore Export

Export omnivore.app articles to markdown.

Installation

go install github.com/rubiojr/omnivore-exporter@latest

Usage

Get your API key and export it:

export OMNIVORE_API_TOKEN=your-api-key

omnivore-exporter export --output-dir ~/Documents/omnivore-exports

By default, omnivore-exporter uses obelisk to export the articles to a single HTML file on disk, without additional dependencies.

It can optionally use monolith instead of obelisk, if available in PATH. The the fidelity of the exports with monolith is generally better, in its current version.

omnivore-exporter --output-dir ~/Documents/omnivore-exports --use-monolith

By default, all articles except the ones labeled with RSS, Newsletter or omnivore-exporter-skip are exported. Select the labeled articles to export with the --labels flag:

omnivore-exporter --output-dir ~/Documents/omnivore-exports --labels label-to-export --labels another-label

You can also use --skip-labels to exclude articles with specific labels and export the rest:

omnivore-exporter --output-dir ~/Documents/omnivore-exports --skip-labels label-to-skip

User service

You can use the omnivore-exporter.service and omnivore-exporter.timer to run the exporter as a user service. Copy the files to ~/.config/systemd/user/ and enable it with:

systemctl --user enable --now omnivore-export.timer

Defaults to export every hour, you can change the timer to your liking.

Credits

• go-shiori/obelisk - Awesome tool and Go library to export URL contents to disk.
• Y2Z/monolith - Another awesome tool to export URL contents to disk, that inspired Obelisk.