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.
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.
And of course...
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.
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.
2. Open the browser
Open http://localhost:3000 and confirm Omnivore is running
3. Login with the test account
During database setup docker compose creates an account [email protected], password: demo_password.
Go to http://localhost:3000/ in your browser and choose Continue with Email to login.
Frontend Development
If you want to work on just the frontend of Omnivore you can run the backend services
with docker compose and the frontend locally:
docker compose up api content-fetch
cd packages/web
cp .env.template .env.local
yarn dev
You will need to configure some values in the new .env.local file. These are
the values for running the web service directly on your host machine and
running api and content-fetch within docker:
NEXT_PUBLIC_BASE_URL=http://localhost:3000
NEXT_PUBLIC_HIGHLIGHTS_BASE_URL=http://localhost:3000
NEXT_PUBLIC_LOCAL_BASE_URL=http://localhost:3000
NEXT_PUBLIC_SERVER_BASE_URL=http://localhost:4000
NEXT_PUBLIC_LOCAL_SERVER_BASE_URL=http://localhost:4000
Running the puppeteer-parse service outside of Docker
To save pages you need to run the puppeteer-parse service.
brew install chromium --no-quarantine
export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
export CHROMIUM_PATH=`which chromium`
2. Navigate to the service directory, setup your env file, and install dependencies
cd packages/puppeteer-parse
cp .env.example .env
yarn
3. Start the service
yarn start
This will start the puppeteer-parse service on port 9090.
In your browser go to http://localhost:3000/home, click the Add Link button,
and enter a URL such as https://blog.omnivore.work/p/getting-started-with-omnivore.
You should see a Chromium window open and navigate to your link. When the service
is done fetching your content you will see it in your library.
License
Omnivore and our extensions to Readability.js are under the AGPL-3.0 license.
Omnivore 是一个开源的稍后读应用：你可以把文章、PDF 和邮件订阅内容存进个人阅读队列，之后阅读时可以划重点、写笔记、打标签和搜索。