KoreaderHistory

Application Android KOReader History (par l’Atelier) : widget d’historique de lecture et dock d’actions, reliés à KOReader via le plugin bridge.
📸 Aperçu
| Widget | Dock |
|---|---|
![]() |
![]() |
📖 À propos
Application Android KOReader History (par l’Atelier) : widget d’historique de lecture et dock d’actions, reliés à KOReader via le plugin bridge Atelier History Bridge (athistory.koplugin).
Le widget lit l’historique KOReader sur l’appareil ; le dock peut ouvrir KOReader, un livre, une app, une URI, ou demander au bridge d’exécuter une action dans KOReader (historique, dossier, collection, plugin, dispatcher…).
🧩 Composants
| Élément | Rôle |
|---|---|
App Android (app/, Gradle) |
Widget + configuration + dock |
athistory.koplugin |
Bridge : lit settings/athistory/pending.lua et exécute l’action |
| Assets embarqués | Copie du bridge installable depuis l’app |
Package : fr.atelier.koreaderhistory.
⬇️ Installation
Application Android
- Ouvrir le projet Gradle (
ATkoreaderhistory) - Compiler :
gradlew.bat assembleDebug(ou depuis Android Studio) - Installer l’APK sur l’appareil
- Accorder l’accès à tous les fichiers (nécessaire pour lire l’historique KOReader)
- Ajouter le widget KOReader History à l’écran d’accueil
- Configurer le chemin KOReader, le nombre d’ouvrages, filtres, thème, dock…
Bridge KOReader
Depuis l’app : Installer le bridge KOReader (copie athistory.koplugin dans le dossier plugins KOReader), ou copier manuellement :
<koreader>/plugins/athistory.koplugin/
├── _meta.lua
└── main.lua
Puis redémarrer KOReader et activer le plugin si besoin.
✏️ Utilisation
- Le widget affiche les ouvrages récents (couverture / titre / auteur / pourcentage selon les options)
- Un tap ouvre le livre dans KOReader
- Le dock (icônes configurables) lance des actions Android ou écrit une action « pending » puis ouvre KOReader ; le bridge l’exécute au démarrage
Actions du dock
| Action | Côté | Description |
|---|---|---|
| Ouvrir KOReader | Android | Lance l’app KOReader |
| Ouvrir un livre | Android | Ouvre un fichier via KOReader |
| Lancer une app Android | Android | Package / activité |
| Ouvrir URI / intent | Android | URI libre |
| Continuer la lecture | Bridge | Dernier ouvrage de l’historique |
| Historique KOReader | Bridge | Ouvre l’historique |
| Dossier | Bridge | Ouvre un dossier dans le file manager |
| Collection | Bridge | Ouvre une collection |
| Plugin | Bridge | Lance l’UI d’un plugin |
| Action système | Bridge | Module / dispatcher |
| Dispatcher (ID libre) | Bridge | ID d’action Dispatcher |
⚙️ Configuration (widget)
- Dossier KOReader, package (
org.koreader.launcher/ F-Droid / auto) - Nombre d’ouvrages, exclure terminés / non-livres
- Afficher auteur / pourcentage, thème sombre (e-ink)
- Dock en haut, taille des icônes, édition des slots
🔗 Ressources
| 🌐 l’Atelier | atelier.atechnologie.fr |
| 📖 KOReader | github.com/koreader/koreader |
📸 Vorschau
| Widget | Dock |
|---|---|
![]() |
![]() |
📖 Über
Android-App KOReader History (von l’Atelier): Lesehistorie-Widget und Aktions-Dock, verbunden mit KOReader über das Bridge-Plugin Atelier History Bridge (athistory.koplugin).
Das Widget liest die KOReader-Historie auf dem Gerät; das Dock kann KOReader, ein Buch, eine App, eine URI öffnen oder die Bridge bitten, eine Aktion in KOReader auszuführen (Historie, Ordner, Sammlung, Plugin, Dispatcher…).
🧩 Komponenten
| Teil | Rolle |
|---|---|
Android-App (app/, Gradle) |
Widget + Konfiguration + Dock |
athistory.koplugin |
Bridge: liest settings/athistory/pending.lua und führt die Aktion aus |
| Eingebettete Assets | Bridge-Kopie, installierbar aus der App |
Package: fr.atelier.koreaderhistory.
⬇️ Installation
Android-Anwendung
- Gradle-Projekt öffnen (
ATkoreaderhistory) - Bauen:
gradlew.bat assembleDebug(oder Android Studio) - APK auf dem Gerät installieren
- Zugriff auf alle Dateien gewähren (nötig zum Lesen der KOReader-Historie)
- Widget KOReader History zum Startbildschirm hinzufügen
- KOReader-Pfad, Anzahl, Filter, Theme, Dock konfigurieren…
KOReader-Bridge
Aus der App: KOReader-Bridge installieren (kopiert athistory.koplugin in die KOReader-Plugins), oder manuell kopieren:
<koreader>/plugins/athistory.koplugin/
├── _meta.lua
└── main.lua
Danach KOReader neu starten und das Plugin bei Bedarf aktivieren.
✏️ Nutzung
- Das Widget zeigt kürzlich gelesene Werke (Cover / Titel / Autor / Prozent je nach Optionen)
- Ein Tippen öffnet das Buch in KOReader
- Das Dock (konfigurierbare Icons) startet Android-Aktionen oder schreibt eine „pending“-Aktion und öffnet KOReader; die Bridge führt sie beim Start aus
Dock-Aktionen
| Aktion | Seite | Beschreibung |
|---|---|---|
| KOReader öffnen | Android | KOReader starten |
| Buch öffnen | Android | Datei über KOReader öffnen |
| Android-App starten | Android | Package / Activity |
| URI / Intent öffnen | Android | Freie URI |
| Weiterlesen | Bridge | Letzter Historieneintrag |
| KOReader-Historie | Bridge | Historie öffnen |
| Ordner | Bridge | Ordner im Dateimanager öffnen |
| Sammlung | Bridge | Sammlung öffnen |
| Plugin | Bridge | Plugin-UI starten |
| Systemaktion | Bridge | Modul / Dispatcher |
| Dispatcher (freie ID) | Bridge | Dispatcher-Aktions-ID |
⚙️ Widget-Konfiguration
- KOReader-Ordner, Package (
org.koreader.launcher/ F-Droid / auto) - Anzahl, fertige / Nicht-Bücher ausschließen
- Autor / Prozent anzeigen, dunkles Theme (E-Ink)
- Dock oben, Icon-Größe, Slot-Bearbeitung
🔗 Ressourcen
| 🌐 l’Atelier | atelier.atechnologie.fr |
| 📖 KOReader | github.com/koreader/koreader |
📸 Preview
| Widget | Dock |
|---|---|
![]() |
![]() |
📖 About
Android app KOReader History (by l’Atelier): reading-history widget and action dock, linked to KOReader through the Atelier History Bridge plugin (athistory.koplugin).
The widget reads KOReader history on the device; the dock can open KOReader, a book, an app, a URI, or ask the bridge to run an action inside KOReader (history, folder, collection, plugin, dispatcher…).
🧩 Components
| Piece | Role |
|---|---|
Android app (app/, Gradle) |
Widget + configuration + dock |
athistory.koplugin |
Bridge: reads settings/athistory/pending.lua and runs the action |
| Bundled assets | Bridge copy installable from the app |
Package: fr.atelier.koreaderhistory.
⬇️ Installation
Android application
- Open the Gradle project (
ATkoreaderhistory) - Build:
gradlew.bat assembleDebug(or Android Studio) - Install the APK on the device
- Grant All files access (needed to read KOReader history)
- Add the KOReader History widget to the home screen
- Configure KOReader path, item count, filters, theme, dock…
KOReader bridge
From the app: Install KOReader bridge (copies athistory.koplugin into KOReader plugins), or copy manually:
<koreader>/plugins/athistory.koplugin/
├── _meta.lua
└── main.lua
Then restart KOReader and enable the plugin if needed.
✏️ Usage
- The widget shows recent books (cover / title / author / percent depending on options)
- A tap opens the book in KOReader
- The dock (configurable icons) launches Android actions or writes a “pending” action then opens KOReader; the bridge executes it on startup
Dock actions
| Action | Side | Description |
|---|---|---|
| Open KOReader | Android | Launch KOReader |
| Open a book | Android | Open a file via KOReader |
| Launch an Android app | Android | Package / activity |
| Open URI / intent | Android | Free URI |
| Continue reading | Bridge | Latest history entry |
| KOReader history | Bridge | Open history |
| Folder | Bridge | Open a folder in the file manager |
| Collection | Bridge | Open a collection |
| Plugin | Bridge | Launch a plugin UI |
| System action | Bridge | Module / dispatcher |
| Dispatcher (free ID) | Bridge | Dispatcher action ID |
⚙️ Widget configuration
- KOReader folder, package (
org.koreader.launcher/ F-Droid / auto) - Item count, exclude finished / non-books
- Show author / percent, dark theme (e-ink)
- Dock on top, icon size, slot editing
🔗 Resources
| 🌐 l’Atelier | atelier.atechnologie.fr |
| 📖 KOReader | github.com/koreader/koreader |
📸 Vista previa
| Widget | Dock |
|---|---|
![]() |
![]() |
📖 Acerca de
Aplicación Android KOReader History (por l’Atelier): widget de historial de lectura y dock de acciones, enlazados a KOReader mediante el plugin bridge Atelier History Bridge (athistory.koplugin).
El widget lee el historial de KOReader en el dispositivo; el dock puede abrir KOReader, un libro, una app, una URI, o pedir al bridge que ejecute una acción en KOReader (historial, carpeta, colección, plugin, dispatcher…).
🧩 Componentes
| Elemento | Función |
|---|---|
App Android (app/, Gradle) |
Widget + configuración + dock |
athistory.koplugin |
Bridge: lee settings/athistory/pending.lua y ejecuta la acción |
| Assets incluidos | Copia del bridge instalable desde la app |
Package: fr.atelier.koreaderhistory.
⬇️ Instalación
Aplicación Android
- Abrir el proyecto Gradle (
ATkoreaderhistory) - Compilar:
gradlew.bat assembleDebug(o Android Studio) - Instalar el APK en el dispositivo
- Conceder acceso a todos los archivos (necesario para leer el historial KOReader)
- Añadir el widget KOReader History a la pantalla de inicio
- Configurar la ruta KOReader, número de obras, filtros, tema, dock…
Bridge KOReader
Desde la app: Instalar el bridge KOReader (copia athistory.koplugin en los plugins de KOReader), o copiar manualmente:
<koreader>/plugins/athistory.koplugin/
├── _meta.lua
└── main.lua
Luego reinicie KOReader y active el plugin si hace falta.
✏️ Uso
- El widget muestra las obras recientes (portada / título / autor / porcentaje según opciones)
- Un toque abre el libro en KOReader
- El dock (iconos configurables) lanza acciones Android o escribe una acción « pending » y abre KOReader; el bridge la ejecuta al arrancar
Acciones del dock
| Acción | Lado | Descripción |
|---|---|---|
| Abrir KOReader | Android | Lanza la app KOReader |
| Abrir un libro | Android | Abre un archivo vía KOReader |
| Lanzar una app Android | Android | Package / actividad |
| Abrir URI / intent | Android | URI libre |
| Continuar la lectura | Bridge | Última entrada del historial |
| Historial KOReader | Bridge | Abre el historial |
| Carpeta | Bridge | Abre una carpeta en el file manager |
| Colección | Bridge | Abre una colección |
| Plugin | Bridge | Lanza la UI de un plugin |
| Acción de sistema | Bridge | Módulo / dispatcher |
| Dispatcher (ID libre) | Bridge | ID de acción Dispatcher |
⚙️ Configuración del widget
- Carpeta KOReader, package (
org.koreader.launcher/ F-Droid / auto) - Número de obras, excluir terminados / no-libros
- Mostrar autor / porcentaje, tema oscuro (e-ink)
- Dock arriba, tamaño de iconos, edición de slots
🔗 Recursos
| 🌐 l’Atelier | atelier.atechnologie.fr |
| 📖 KOReader | github.com/koreader/koreader |


