# Omnivore — Open-Source Read-It-Later Platform for Developers

> A self-hostable read-it-later application with full-text search, highlights, annotations, and integrations with Logseq, Obsidian, and other knowledge tools.

## Install

Save in your project root:

# Omnivore — Open-Source Read-It-Later Platform for Developers

## Quick Use
```bash
# Clone and run with Docker
git clone https://github.com/omnivore-app/omnivore.git
cd omnivore
docker compose up -d
# Access at http://localhost:3000
```

## Introduction
Omnivore is an open-source read-it-later application built for people who take reading seriously. It saves articles, newsletters, and documents for offline reading with full-text search, highlights, and annotations. Developers value it for its Logseq and Obsidian integrations, turning saved articles into structured knowledge.

## What Omnivore Does
- Saves web articles, PDFs, and email newsletters for later reading
- Provides full-text search across all saved content
- Supports highlighting, annotations, and labels for organization
- Syncs reading data with Logseq, Obsidian, and Notion via plugins
- Offers browser extensions and mobile apps for capturing content anywhere

## Architecture Overview
Omnivore is built with a TypeScript backend using Node.js and PostgreSQL for storage. The frontend is a Next.js application. Content is fetched and parsed server-side, stripping ads and formatting for clean reading. A GraphQL API powers all client interactions, and the system supports self-hosted deployment via Docker Compose.

## Self-Hosting & Configuration
- Deploy with Docker Compose using the provided configuration
- Requires PostgreSQL and Elasticsearch for full-text search
- Configure SMTP for newsletter ingestion via email
- Set up OAuth providers for authentication or use built-in email login
- Environment variables control storage backends and API keys

## Key Features
- Distraction-free reader with customizable typography
- Newsletter ingestion via dedicated email addresses
- Full-text search powered by Elasticsearch
- First-class integrations with Logseq, Obsidian, and Readwise
- GraphQL API for building custom workflows and automations

## Comparison with Similar Tools
- **Pocket** — popular but closed-source with limited export options
- **Wallabag** — open-source PHP alternative; fewer integrations
- **Instapaper** — clean reader but no self-hosting option
- **Readwise Reader** — polished but proprietary and subscription-based
- **Karakeep** — newer open-source bookmark manager with AI features

## FAQ
**Q: Can I self-host Omnivore?**
A: Yes. The full stack can be deployed with Docker Compose on any server.

**Q: Does Omnivore support newsletters?**
A: Yes. You get a dedicated email address that captures newsletters directly into your library.

**Q: How does the Obsidian integration work?**
A: An official Obsidian plugin syncs highlights and annotations into your vault as Markdown notes.

**Q: Is there mobile support?**
A: Yes. Native iOS and Android apps are available alongside the web interface.

## Sources
- https://github.com/omnivore-app/omnivore
- https://omnivore.app/

---
Source: https://tokrepo.com/en/workflows/asset-6cbc28ef
Author: AI Open Source