146 lines
5.2 KiB
Markdown
146 lines
5.2 KiB
Markdown
---
|
|
title: Readeck
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, bookmarks, read-later, go, ebook, epub, kobo, progress-tracking, oauth2]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Bookmarks, https://readeck.org, https://github.com/readeck/readeck]
|
|
---
|
|
|
|
# 📖 Readeck
|
|
|
|
> **Le read-it-later moderne en Go** : EPUB natif pour Kobo/Kindle, suivi de progression, OAuth2, et une UI soignée. Le successeur spirituel de Wallabag pour une nouvelle génération.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [readeck.org](https://readeck.org) |
|
|
| **GitHub** | [readeck/readeck](https://github.com/readeck/readeck) |
|
|
| **Licence** | AGPL-3.0 |
|
|
| **Langage** | Go |
|
|
| **Étoiles GitHub** | 880 ⭐ |
|
|
| **Dernière MAJ** | 2026-05-25 |
|
|
| **Catégorie** | [[cat-bookmarks\|Bookmarks]] |
|
|
|
|
## 📝 Description
|
|
|
|
**Readeck** est un projet open-source de **read-it-later** moderne, écrit en **Go**, dont l'objectif affiché est de devenir *"le Wallabag killer"*. Pensé à l'origine comme un fork spirituel, le projet a pris ses propres décisions techniques : pas de Symfony, pas de PHP, juste un binaire Go rapide avec une UI Svelte réactive.
|
|
|
|
Ce qui distingue Readeck :
|
|
- 📕 **Export EPUB / KEPUB** de qualité, **sync native avec Kobo** (et Kindle via Calibre)
|
|
- 📊 **Suivi de progression** : pourcentage lu, position de scroll, temps estimé
|
|
- 🔐 **OAuth2 natif** (créez d'autres apps sur votre instance)
|
|
- 🏷️ **Étiquettes, collections, labels** avec couleurs
|
|
- 🔌 **API REST documentée** + **extensions navigateur** + **bookmarklet**
|
|
- 📥 **Import** depuis Wallabag, Pocket, Pinboard
|
|
- 🌓 **UI dark/light**, rapide, single-page
|
|
|
|
Readeck vise un public qui veut **lire** (et non seulement archiver) : intégration Kobo, EPUB soigné, progression sync. Pour un homelab, c'est l'option **la plus moderne** en Go pur, sans dépendance exotique. La base SQLite par défaut simplifie énormément les sauvegardes.
|
|
|
|
⚠️ Le projet est **plus jeune** que Wallabag : la communauté est encore en formation, certains importers sont en bêta. C'est le compromis modernité vs maturité.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Option 1 : Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
readeck:
|
|
image: ghcr.io/readeck/readeck:latest
|
|
container_name: readeck
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8484:8080"
|
|
environment:
|
|
- READECK_DATABASE=sqlite:///data/readeck.db
|
|
- READECK_DATA_DIR=/data
|
|
- READECK_HOST=0.0.0.0
|
|
- READECK_PORT=8080
|
|
- READECK_BASE_URL=http:/...84
|
|
- READECK_SMTP_HOST=smtp.example.com
|
|
- READECK_SMTP_PORT=587
|
|
- READECK_SMTP_USER=no-reply@example.com
|
|
- READECK_SMTP_PASSWORD=*** - READECK_SMTP_FROM=no-reply@example.com
|
|
volumes:
|
|
- readeck-data:/data
|
|
|
|
volumes:
|
|
readeck-data:
|
|
```
|
|
|
|
### Option 2 : Binaire unique
|
|
|
|
```bash
|
|
wget https://github.com/readeck/readeck/releases/latest/download/readeck_Linux_x86_64.tar.gz
|
|
tar -xzf readeck_Linux_x86_64.tar.gz
|
|
sudo mv readeck /usr/local/bin/
|
|
|
|
# Service systemd minimal
|
|
cat > /etc/systemd/system/readeck.service <<EOF
|
|
[Unit]
|
|
Description=Readeck
|
|
After=network.target
|
|
|
|
[Service]
|
|
ExecStart=/usr/local/bin/readeck -host 0.0.0.0 -port 8080
|
|
WorkingDirectory=/var/lib/readeck
|
|
Restart=always
|
|
User=readeck
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
EOF
|
|
```
|
|
|
|
## ⚙️ Configuration Initiale
|
|
|
|
1. **Créer le premier utilisateur** via `readeck user add admin` puis suivre l'UI.
|
|
2. **Changer le mot de passe** immédiatement.
|
|
3. **Activer OAuth2** : créer un client depuis l'admin pour brancher des apps tierces.
|
|
4. **Configurer SMTP** pour les exports EPUB par email et la récupération de mot de passe.
|
|
5. **Activer le partage Kobo** : URL `/kobo/{user_id}` à entrer dans la liseuse.
|
|
6. **Brancher un reverse proxy HTTPS** (Caddy/Traefik) pour usage public.
|
|
7. **Importer** depuis Wallabag, Pocket, Pinboard ou un fichier HTML.
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-wallabag]] — Le père, PHP/Symfony, plus mature
|
|
- [[app-karakeep]] — Next.js moderne, IA et highlights
|
|
- [[app-linkwarden]] — Collaboratif, snapshots
|
|
- [[app-linkding]] — Minimaliste Django
|
|
- [[app-shiori]] — Go, plus minimaliste
|
|
|
|
### Propriétaires (ce que Readeck remplace)
|
|
- **Pocket** — Sunset 2025
|
|
- **Instapaper** — Cloud-only
|
|
- **Readwise Reader** — Freemium, Evernote-like
|
|
- **Matter** — Fermé
|
|
- **Amazon Kindle Highlights** — Lock-in propriétaire
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- Authentification par **session sécurisée** (cookies HttpOnly, SameSite)
|
|
- **OAuth2** pour clients tiers
|
|
- Pas de télémétrie par défaut
|
|
- À placer derrière **HTTPS** (Traefik/Caddy)
|
|
- Le binaire Go a une **surface d'attaque très réduite**
|
|
- Sauvegarder simplement le volume `readeck-data` (SQLite + fichiers)
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Site officiel](https://readeck.org)
|
|
- [Documentation](https://docs.readeck.org)
|
|
- [Dépôt GitHub](https://github.com/readeck/readeck)
|
|
- [selfh.st — Bookmarks](https://selfh.st/apps/?tag=Bookmarks)
|
|
|
|
## Pages Liées
|
|
- [[cat-bookmarks]] — Vue d'ensemble de la catégorie Bookmarks
|
|
- [[app-wallabag]] — Le vétéran dont Readeck veut être le successeur
|
|
- [[app-karakeep]] — Concurrent moderne en Next.js
|
|
- [[recettes-docker-compose]] — Bonnes pratiques Docker Compose
|