Omnivore
Omnivore is a complete, open source read-it-later solution for people who like text.
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 articles via email (with substack support!)
- PDF support
- Web app written in node and typescript
- Native iOS app
- Progressive web app for Android users
- Browser extensions for Chrome, Safari, Firefox, and Edge
- Tagging (coming soon!)
- Offline support (coming soon!)
Every single part is fully open source! Fork it, extend it, or deploy it to your own server.
We also have a free hosted version of Omnivore at omnivore.app -- try it now!
Join us on Discord!
We're building our community on Discord. Join us!
How to setup local development
The easiest way to get started with local development is to use docker-compose up. This will start a postgres container, our web frontend, and an API server.
Along with docker-compose you will need to run our pupeteer-parse service. This service is used to
fetch web page content and relies on pupeteer and chromium which currently do not run inside of
docker.
Running the web and API services
1 Start docker-compose
git clone https://github.com/omnivore-app/omnivore
cd omnivore
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. Create a test account
Omnivore uses social login for most users. But for testing there is an email + password option.
Open a browser and go to http://localhost:3000/email-registration
Running the pupeteer-parse service
1. Install and configure Chromium
If you are using an M1 Mac:
brew install chromium --no-quarantine
export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
export CHROMIUM_PATH=/opt/homebrew/bin/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 navigate to http://localhost:3000/home click the Add Link button and enter a URL
such as https://blog.omnivore.app/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.
How to deploy to your own server
FIXME: Jackson to fill this in
License
Omnivore and our extensions to Readability.js are under the AGPL-3.0 license.