tmr232 / omnivore-epub

A program to generate epub files from your unarchived Omnivore articles and send them to eReaders like Kindle or Pocketbook

Omnivore EPUB

A program to generate epub files from your unarchived Omnivore articles

It can also optionally send the ebook to your eReader using email

Forked from here

Usage

• Install Deno
• Get an API token for Omnivore following instructions here
• Put your token in the token field in config file
• Modify the configuration file if necessary
• In your terminal, go to the app folder and run the following command deno run -A main.ts
• The ebook with extension .epub should be in the app directory after execution

Send to eReader like Kindle

List of eReaders that support sending ebook using email:

• Kindle
• Pocketbook

Tip

Make sure the email address used is approved to send ebook to your eReader

Configuring email

• Ability to send ebook over email is disabled by default
• To enable it, set emailSupport to true in the config file
• Set emailHost to the SMTP address of your email provider
• E.g. smtp.gmail.com for Gmail and smtp-mail.outlook.com for Outlook
• Set emailPort to the SMTP Port. Usually it is 587, 465 or 25
• Set emailUser which is usually your email address
• Set emailPassword to your email account password. This is stored locally on your device and is never sent to us
• Set emailRecipient to the email you want to receive ebook on (your eReader's email address). See the links in list of eReaders above to know more
• You may need to set emailAllowSTARTTLS to false when using 465 as emailPort. Leave it to true when not sure

Caution

The email password is stored in plaintext on your device, unencrypted. Therefore, it is highly recommended to use app password instead of your account password whenever your email provider supports it

You may also need to turn on 2FA (Two Factor Authentication)

Instructions for setting an app password for a few popular email providers:

• Gmail
• Outlook
• Zoho Mail

Configuration

Configuration options available in the config file

Option	Type	Description
token	string	Omnivore API Token
endpoint	string	Omnivore GraphQL API endpoint
title	string	Title of the ebook
author	string	Author of the ebook
cover	string	URL for fetching cover image for the ebook
description	string	Description of the ebook
addLabelsInContent	boolean	Whether to add the labels for the article below title
addArticleLinkInContent	boolean	Whether to add the link for the article below title
allowImages	boolean	Whether to add images linked in article in the ebook
outputFileName	string	ebook file name
maxArticleCount	number	Number of articles to fetch
searchQuery	string	Valid query for article search, default: "sort:saved-desc". Change it to "sort:saved-asc" for fetching oldest articles first
ignoredLabels	string[]	List of labels to exclude from the ebook
ignoredLinks	string[]	List of urls to exclude from the ebook
emailSupport	boolean	Whether to send the ebook via email (to your eReader)
emailHost	string	SMTP Hostname of your email provider
emailPort	number	Usually one of 587, 465 or 25. Prefer 587 when available
emailUser	string	Username/Email address of your email account
emailPassword	string	Password of your email account. Prefer app password
emailRecipient	string	Email address that should receive your ebook
emailFrom	string	Sender name that appears to the email receiver
emailAllowSTARTTLS	boolean	Allow connecting to the SMTP server using STARTTLS
emailSizeWarningSuppress	boolean	Show a warning if ebook is over emailSizeWarningMinSize
emailSizeWarningMinSize	number	Min ebook size to show warning while sending email in MB