Omnivore

Omnivore is a complete, open source read-it-later solution for people who like text.

[!IMPORTANT] Omnivore is now a completely Self-Hosted application. The Cloud application was deprecated in November of 2024. The community still exists on Discord, and we endeavour to keep things updated and bug-fixes ongoing.

A guide for running a self hosted server can be found here

We built Omnivore because we love reading and we want it to be more social. Join us!

• Highlighting, notes, search, and sharing
• Full keyboard navigation
• Automatically saves your place in long articles
• Add newsletter articles via email (with substack support!)
• PDF support
• Web app written in Node.js and TypeScript
• Native iOS app (source)
• Android app (source)
• Progressive web app for Android users
• Browser extensions for Chrome, Safari, Firefox, and Edge
• Labels (aka tagging)
• Offline support
• Text to speech (iOS only)
• Logseq support via our Logseq Plugin
• Obsidian support via our Obsidian Plugin
• RSS Client with ability to hide/categorise your RSS Feeds

Every single part is fully open source! Fork it, extend it, or deploy it to your own server.

A guide for running a self hosted server can be found here

Join us on Discord! :speech_balloon:

We're building our community on Discord. Join us!

Shoutouts :tada:

Omnivore takes advantage of some great open source software:

• TypeScript - Most of our backend and frontend are written in TypeScript.
• Next.js - Our frontend is a Next.JS app and is hosted on Vercel.
• SWR - We do all our data fetching on the web using SWR.
• Stitches - We use Stitches on the frontend to style our components.
• Mozilla Readability - We use Mozilla's Readability library to make pages easier to read.
• Swift GraphQL - We generate our GraphQL queries on iOS using Swift GraphQL.
• Apollo GraphQL - We generate our GraphQL queries on Android using Apollo GraphQL.
• Radix - We use Radix UI's components on our frontend.
• PDF.js - PDF.js is used to have open source pdf functionality.
• And many more awesome libraries, just checkout our package files to see what we are using.

Shoutouts: Community 🧑‍🤝‍🧑

• Poudlardo - Providing a Podman-compose file for self-hosting.
• leopku - Fixing build issues with v3 manifest
• travisemslander-fn - Providing fixes for SNS Emails.
• andrew-craig & lukebtaylor - Providing fixes for emails.
• Benature - Providing fixes for Minio
• rbarbazz - Providing a HTML toggle for notes.
• pgrosslicht - various fixes to iOs Applications
• Adil, m1xxos, Mike Baker, David Adams, Russ Taylor, William Theaker, keumky2 - Who contributed to the initial commit for self-hosting, which was squashed - unfortunately losing the history in the process.
• mollydot on Discord - For continuing to moderate, and be an active part of our community!

And of course...

• jacksonh, sywhb and satindar - who provided the initial repo, and core functionality.

and many more who contributed in the past. If you feel like your name is missing from this list, please contact me (Podginator) via our Discord.

How to deploy to your own server

A guide for running a self hosted server can be found here

How to setup local development :computer:

The easiest way to get started with local development is to use docker compose up. This will start a postgres container, our web frontend, an API server, and our content fetching microservice.

Requirements for development

Omnivore is written in TypeScript and JavaScript.

• Node.js (v24.22.1) and Yarn -- Versions are managed by Volta.
• Chromium -- See below for installation info.

Running the web and API services

1. Start docker compose

git clone https://github.com/omnivore-app/omnivore
cd omnivore/self-hosting/docker-compose/self-build
docker compose up

This will start postgres, initialize the database, and start the web and api services.

This is the beginning of the README. Read the rest at the original. Read the full README ↗