Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,145 @@
+---
+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