Repository navigation
Releases
v0.7.1 — Privacy toggle works again
v0.7.1 — Privacy toggle works again
A small update to v0.7.0 that gets another feature past StoryGraph's Cloudflare
block.
Fixed
- Making a book private or public works again. The plugin now reads and sets
it through the shelf page instead of the blocked book page. This applies to
books on the "Currently Reading" or "Paused" shelf; other books still fail.
Still limited
- The edition picker list has no reachable source: search shows one edition
per work, and the editions page is blocked. Switching editions works when the
target edition is known. - This remains a workaround for a block on StoryGraph's side. If Cloudflare
changes its rules, it can break too. Details in the
roadmap.
Tested
- Privacy, with a real session: a book on the shelf set to private and back to
public. - The device test of v0.7.0 is done and v0.7.0 works on the device. v0.7.1 only
changes the CLI.
Installation
| Firmware | File(s) |
|---|---|
| 4.x (Kobo) | Copy KoboRoot.tgz to .kobo/ and eject |
| 5.18 and newer (Kobo, Tolino) | Unzip NickelStorygraph-adds.zip, copy NickelStorygraph/ to .adds/, then copy Kobo.tgz to .kobo/ and eject |
An existing config.ini is kept. From v0.7.0 it is enough to replace cli in
.adds/NickelStorygraph/.
v0.7.0 — Automatischer Sammel-Sync und ein Workaround für die StoryGraph-Sperre
v0.7.0 — Automatic sync-all and a workaround for StoryGraph's block
Since mid-November StoryGraph's bot protection (Cloudflare) has been blocking
the book pages /books/… for the plugin, so syncing failed even with valid
cookies. This release reads the data it needs from the "Currently Reading"
page instead. Sync-all can also run on its own now.
Important: StoryGraph's block
- Syncing works again. For books on the "Currently Reading" or "Paused"
shelf, progress is read and written through the shelf page. New books that
are on no shelf yet are linked as before and set to "Currently Reading"; the
plugin reads their status from the search results, and a book you have
already read is not overwritten (it becomes "Rereading"). - Writing a review and switching editions work again.
- Still limited: the private/public toggle and the edition picker list go
through blocked pages and fail. For books on no shelf the plugin only returns
status and page count, not the exact progress. - This is a workaround for a block on StoryGraph's side. If Cloudflare changes
its rules, it can break too.
New
- Automatic sync-all (
sync_all_auto = trueinconfig.ini, off by
default): when the Wi-Fi connects, books with new progress are synced
silently, at most once an hour. Only books that are already linked are sent,
nothing is newly linked and no dialog appears. - Prompt before linking store books on Kobo: "Sync now", "Enable auto-sync"
and "Manually link book" ask before linking a store-bought book, because Kobo
already syncs those with StoryGraph and StoryGraph could otherwise be updated
twice. The prompt does not appear on Tolino.
Fixed
- The plugin loads correctly alongside other mods (NickelHardcover,
NickelInkSync): the hook calls the chained original function instead of
skipping other mods' hooks. - "Did not finish" entries in the reading journal no longer show as "Finished
reading". - Clearer error messages: an expired login on streak, goals and "Currently
Reading" is reported as such (it used to say "unexpected error"), and the
Cloudflare message says that fresh cookies only help if the old ones expired.
Tested
- Checked with a real session: progress on a book on the shelf, a new book on
no shelf, switching editions and back, writing a review. Not checked live:
journal entries. - The device test of this release has been done and works. A Kobo on firmware
5.18 or 6.x has not been tested with the store-book prompt; please report back
in the issues.
Installation
| Firmware | File(s) |
|---|---|
| 4.x (Kobo) | Copy KoboRoot.tgz to .kobo/ and eject |
| 5.18 and newer (Kobo, Tolino) | Unzip NickelStorygraph-adds.zip, copy NickelStorygraph/ to .adds/, then copy Kobo.tgz to .kobo/ and eject |
An existing config.ini is kept. From v0.6.0 it is enough to replace cli in
.adds/NickelStorygraph/ and copy Kobo.tgz or KoboRoot.tgz to .kobo/.
v0.6.0 — Alle Bücher synchronisieren
v0.6.0 — Alle Bücher synchronisieren
Neu im StoryGraph-Menü auf dem Home-Bildschirm: „Alle Bücher synchronisieren“
(englisch „Sync all books“). Damit kommt Lesefortschritt bei StoryGraph an, den
das Plugin bisher verpasst hat. Getestet auf einem Kobo Clara BW (Firmware
4.46.23836) und einem Tolino (Firmware 5.18.264769).
Neu
- Alle Bücher synchronisieren: Überträgt den Fortschritt aller Bücher, die
seit dem letzten Sync weitergelesen wurden. Das hilft in zwei Fällen:- Lesen ohne WLAN, etwa im Zug. Fehlte beim Schließen des Buchs die
Verbindung, kam der Fortschritt bisher erst beim nächsten Öffnen dieses
Buchs bei StoryGraph an. - Lesen in Kobalt. Kobalt
umgeht das Plugin, schreibt den Fortschritt aber in die Kobo-Datenbank;
von dort holt ihn der Sammel-Sync.
- Lesen ohne WLAN, etwa im Zug. Fehlte beim Schließen des Buchs die
- Vorschau vor dem Senden: Vor dem Sync zeigt das Plugin, welche Bücher
betroffen sind und mit welchem Stand. Erst nach „Synchronisieren“ wird etwas
gesendet, danach folgt eine Zusammenfassung.
Welche Bücher werden berücksichtigt?
- Nur Bücher, die schon mit StoryGraph verknüpft sind, und nur, wenn der
Fortschritt seit dem letzten Sync gestiegen ist. - Seitlich geladene Bücher immer.
- Gekaufte Bücher hängen vom Gerät ab: Auf dem Kobo werden sie
ausgelassen, weil der Kobo gekaufte Bücher selbst mit StoryGraph
synchronisiert. Auf dem Tolino sind sie dabei.
Beides lässt sich in .adds/NickelStorygraph/config.ini anpassen:
| Einstellung | Wirkung | Standard |
|---|---|---|
sync_all_store_books |
gekaufte Bücher mit synchronisieren | Kobo: false, Tolino: true |
sync_all_link_new |
auch noch nicht verknüpfte Bücher verknüpfen, die gerade gelesen werden | false |
sync_all_link_new = true verknüpft solche Bücher automatisch (ISBN, dann
Titel). Die Vorschau markiert sie mit „(neu)“.
Installation
| Firmware | Datei(en) |
|---|---|
| 4.x (Kobo) | KoboRoot.tgz nach .kobo/ kopieren und auswerfen |
| 5.18 und neuer (Kobo, Tolino) | NickelStorygraph-adds.zip entpacken, NickelStorygraph/ nach .adds/ kopieren, danach Kobo.tgz nach .kobo/ und auswerfen |
Eine vorhandene config.ini bleibt erhalten. Von v0.5.0 (5.18+) aus genügt es,
cli in .adds/NickelStorygraph/ zu ersetzen und Kobo.tgz nach .kobo/ zu
kopieren.
v0.5.0 — Firmware 4.x und 5.18+ aus einem Projekt
v0.5.0 — Firmware 4.x und 5.18+ aus einem Projekt
Ab diesem Release gibt es NickelStorygraph wieder für beide Firmware-Linien:
Kobo-Geräte mit Firmware 4.x (Qt 5) und Kobo/Tolino mit Firmware 5.18 und
neuer (Qt 6). Beide Varianten werden aus demselben Quellcode gebaut und
enthalten dieselben Funktionen und Fixes. Getestet auf einem Kobo Clara BW mit
Firmware 4.46.23836 (zusammen mit NickelMenu und Kobalt) und einem Tolino mit
Firmware 5.18.264769.
Welche Datei brauche ich?
Die Firmware-Version steht unter Einstellungen → Geräteinformationen (Kobo)
bzw. Einstellungen → Über (Tolino).
| Firmware | Datei(en) |
|---|---|
| 4.x (Kobo) | KoboRoot.tgz |
| 5.18 und neuer (Kobo, Tolino) | Kobo.tgz + NickelStorygraph-adds.zip |
Neu
- Firmware 4.x wird wieder unterstützt. Die 4.x-Variante nutzt die
Toolchain und das Paketformat des Originalprojekts (KoboRoot.tgzmit Plugin
und.adds-Ordner in einer Datei). - Firmware-Prüfung in beide Richtungen: Jede Variante prüft beim Start die
Firmware und bleibt inaktiv, wenn sie nicht zur Firmware passt, statt
Nickel zu gefährden. Im Log steht dann, welche Variante passt.
Behoben
- Installationsanleitung für 5.18+: Erst den Ordner nach
.adds/, dann
Kobo.tgznach.kobo/kopieren. In der umgekehrten Reihenfolge kann sich
das Plugin beim ersten Start selbst wieder deinstallieren.
Installation
Firmware 4.x: KoboRoot.tgz nach .kobo/ kopieren und auswerfen. Das
Gerät installiert Plugin und .adds-Ordner und startet neu. Eine vorhandene
config.ini bleibt erhalten.
Firmware 5.18+: NickelStorygraph-adds.zip entpacken und NickelStorygraph/
nach .adds/ kopieren, danach Kobo.tgz nach .kobo/ kopieren und
auswerfen. Eine vorhandene config.ini bleibt erhalten.
Von v0.4.0 (5.18+) aus: cli in .adds/NickelStorygraph/ ersetzen und
Kobo.tgz nach .kobo/ kopieren.
Wer bisher das Originalprojekt auf Firmware 4.x nutzt, kann direkt mit
KoboRoot.tgz aktualisieren; Einstellungen und Verknüpfungen bleiben erhalten.
v0.4.0 — Private Bücher und Neuerungen aus dem Originalprojekt
v0.4.0 — Private Bücher und Neuerungen aus dem Originalprojekt
Dieses Release übernimmt die aktuellen Änderungen aus dem Originalprojekt von Victoria Kerr, angepasst an Firmware 5.18+ (Qt 6). Getestet auf einem Tolino mit Firmware 5.18.264769.
Neu
- Private Bücher: Im Menü Buchstatus aktualisieren gibt es jetzt „Privat: Ja/Nein“. Antippen schaltet um, der Lesestatus bleibt erhalten. Private Bücher zeigen in „Currently Reading“ und „Pausiert“ das durchgestrichene Auge von StoryGraph. (Victoria Kerr)
- Verträglichkeit mit NickelHardcover: Sind beide Plugins installiert, laufen künftig auch die Hardcover-Synchronisation und der Hardcover-Knopf im Lesemenü. NickelHardcover unterstützt Firmware 5.x selbst noch nicht; bis dahin hat das keine Auswirkung. (James Ashley)
Behoben
- Pausierte Hörbücher zeigten 0 % Fortschritt, weil StoryGraph das HTML geändert hat. (Victoria Kerr)
- Currently Reading: Beide Tabs blättern jetzt mit festen 4 Büchern pro Seite. (Victoria Kerr)
- Community-Feed: Lange Buchtitel brechen um, statt abgeschnitten zu werden. (Victoria Kerr)
- Fehlermeldung: Hat ein Buch auf StoryGraph keine Privat-Option, erscheint eine verständliche Meldung statt „unerwarteter Fehler“.
Geändert
- Interne Umbenennung
nickelstoregraph→nickelstorygraph. Auf dem Gerät betrifft das nur das CLI-Log: Es heißt jetzt.adds/NickelStorygraph/nickelstorygraph.log. Die alte Dateinickelstoregraph.logwird nicht mehr beschrieben und kann gelöscht werden. - README: genauere Anleitung zum Auslesen der Cookies, auch für Firefox, und ein Hinweis für Windows: Eine Datei
cookies.iniwird dort leicht alscookies.ini.txtgespeichert, und die Firmware macht daraus ein Buch.
Installation
Kobo.tgz→ nach.kobo/kopieren (Firmware 5.18+ entpackt es beim Neustart).NickelStorygraph-adds.zip→ entpacken,NickelStorygraph/nach.adds/kopieren. Eine vorhandeneconfig.inibleibt erhalten.- Erst
.adds, dann.kobokopieren und danach auswerfen.
Von v0.3.x aus genügt es, cli in .adds/NickelStorygraph/ zu ersetzen und Kobo.tgz nach .kobo/ zu kopieren. Einstellungen und Verknüpfungen bleiben erhalten.
Firmware: 5.18 und neuer (Qt 6). Für Firmware 4.x bitte das Originalprojekt verwenden.
v0.3.3 — Shop-Bücher verknüpfen sich wieder
v0.3.3 — Shop-Bücher verknüpfen sich wieder
Bugfix-Release für Tolino-Shop-Bücher. Alle drei Fixes wurden auf einem Tolino (Firmware 5.18.264769) getestet.
Behoben
- Shop-Bücher verknüpften sich nie automatisch. Der Tolino-Shop lässt das ISBN-Feld in der Gerätedatenbank leer, in einer echten Bibliothek bei allen 362 Shop-Büchern. Das Plugin gab dann mit „Couldn't find an ISBN in the database“ auf, ohne nach dem Titel zu suchen.
- Die ISBN wird jetzt aus der Cover-URL des Shops gelesen, die sie enthält (z. B.
…/9781068563119_A62207078/cover). Das klappt bei rund 97 % der Shop-Bücher. - Fehlt sie auch dort, sucht das Plugin nach Titel und Autor.
- Die ISBN wird jetzt aus der Cover-URL des Shops gelesen, die sie enthält (z. B.
- „Buch manuell verknüpfen“ im Buch-Menü füllte das Suchfeld noch mit der Serie in Klammern vor, z. B. „Good Boy (The Northern Weird Project) Neil McRobert“, und fand damit nichts. Der Klammerzusatz wird jetzt auch dort entfernt.
Installation
Kobo.tgz→ nach.kobo/kopieren (Firmware 5.18+ entpackt es beim Neustart).NickelStorygraph-adds.zip→ entpacken,NickelStorygraph/nach.adds/kopieren. Eine vorhandeneconfig.inibleibt erhalten.- Erst
.adds, dann.kobokopieren und danach auswerfen.
Von v0.3.2 aus genügt es, cli in .adds/NickelStorygraph/ zu ersetzen und Kobo.tgz nach .kobo/ zu kopieren.
Firmware: 5.18 und neuer (Qt 6). Für Firmware 4.x bitte den main-Branch des Originalprojekts verwenden.
v0.3.2 — Cookie-Import, Such-Paging, Fixes aus dem Gerätetest
v0.3.2 — Cookie-Import, Such-Paging, Fixes aus dem Gerätetest
Erstes Release, das vollständig auf einem Tolino (Firmware 5.18.264769) getestet wurde.
Neu
- Cookies importieren: Lege eine Datei
.adds/NickelStorygraph/cookies.inimit den Zeilensession_cookie=…undremember_user_token=…an, dann Einstellungen → Cookies importieren. Die Cookies landen inconfig.ini,cookies.iniwird danach gelöscht. Die Datei bitte nichtcookies.txtnennen: Die Firmware macht aus jeder.txt-Datei ein Buch in der Bibliothek. - Such-Paging beim manuellen Verlinken: Mehr als eine Seite Treffer, jeweils mit Cover, Seitenzahl und Serie.
- Update-Prüfung im StoryGraph-Menü auf dem Home-Bildschirm.
- Firmware-Prüfung: Unter 5.18 (Qt 5) hängt sich das Plugin nicht mehr ein. 5.18 wird unterstützt, neuere Firmware mit einem Hinweis im Log.
Behoben
- Sync ohne gespeicherten Profilnamen: StoryGraph hat die Profil-URL von
/users/…auf/profile/…umgestellt. Ohne gespeichertenuser_slugscheiterte deshalb jeder Sync. - Suche mit Serie im Titel: Titel wie „Good Boy (The Northern Weird Project)“ fanden weder automatisch noch beim manuellen Verlinken einen Treffer. Klammerzusätze werden jetzt aus dem Suchtext entfernt.
- Lesejournal: „Pausiert“ und „Weitergelesen“ erschienen als „Als gelesen markiert“.
- Abgelaufene Anmeldung: Erschien als „unerwarteter Fehler, bitte melden“. Jetzt kommt eine klare Meldung mit Hinweis auf den Cookie-Import; die Cloudflare-Meldung ebenso.
- Zeile „Log in“ entfernt: Die Anmeldung mit E-Mail und Passwort scheitert immer an der Cloudflare-Prüfung von StoryGraph. Bitte den Cookie-Import nutzen.
- Darstellung: Doppelt kodierte Trennzeichen (
•,★) in den Suchergebnissen. - Versionsanzeige: Plugin und CLI melden die echte Version aus dem Git-Tag.
Installation
Kobo.tgz→ nach.kobo/kopieren (Firmware 5.18+ entpackt es beim Neustart).NickelStorygraph-adds.zip→ entpacken,NickelStorygraph/nach.adds/kopieren. Eine vorhandeneconfig.inibleibt erhalten.- Erst
.adds, dann.kobokopieren und danach auswerfen. Fehlt.adds/NickelStorygraph/beim Start, deinstalliert sich das Plugin selbst.
Firmware: 5.18 und neuer (Qt 6). Geräte mit Firmware 4.x, z. B. ein Kobo Libra 2 auf 4.x, werden von diesem Branch nicht unterstützt.
v0.3.1 — Bugfix: Config-Parser
v0.3.1 — Bugfix: Config-Parser
Behoben
sync_bookmarks = "manual"(Einstellung „Manual only") ließ die CLI bei jedem Aufruf crashen — der Wert war im Einstellungs-Dialog anwählbar und inconfig_example.inidokumentiert, fehlte aber im Rust-Parser. Jetzt akzeptiert.sync_on_closeim Bereich 1–100:1wurde trotz der Dokumentation „1–100" abgelehnt (Crash). Der volle Bereich wird jetzt akzeptiert; auch der C++-Reader wertet100nicht mehr fälschlich als „deaktiviert".- Versionsanzeige:
justfileundCargo.tomlwaren hart auf0.1.0kodiert, sodass Plugin und CLI intern stets „0.1.0" meldeten — unabhängig vom Release-Tag. Jetzt korrekt0.3.1.
Installation
Kobo.tgz→ nach.kobo/kopieren (wird von Firmware 5.18+ extrahiert).NickelStorygraph-adds.zip→ entpacken,NickelStorygraph/nach.adds/kopieren.
v0.3.0 — Deutsche Lokalisierung + Login-Flow
v0.3.0 — Deutsche Lokalisierung + Login-Flow
Neu: Deutsch (i18n)
- Zentrale String-Tabelle mit ~185 übersetzten UI-Strings. Die Sprache folgt automatisch dem Kobo-Locale; per
language = de|eninconfig.iniüberschreibbar.
Neu: Login via E-Mail/Passwort
- Neues CLI-Subkommando
login <email> <password>und ein Login-Dialog im Plugin (Einstellungen → „Anmelden"). Nach erfolgreicher Anmeldung werden die Session-Cookies automatisch inconfig.inigeschrieben.
⚠️ Bekannter Blocker beim Login
app.thestorygraph.com/users/sign_in liegt derzeit hinter einer Cloudflare-Bot-Challenge (HTTP 403). Der direkte Login schlägt deshalb mit „Could not find CSRF token" fehl, bis Cloudflare die Challenge lockert oder ein gültiges cf_clearance-Cookie vorliegt. Bis dahin: Session-Cookies weiterhin manuell aus dem Browser übernehmen.
Installation
Kobo.tgz→ nach.kobo/kopieren (wird von der Firmware 5.18+ extrahiert).NickelStorygraph-adds.zip→ entpacken,NickelStorygraph/nach.adds/kopieren.
v0.2.0 — Qt 6 port for Kobo/Tolino firmware 5.18+
Qt 6 port — runs on Kobo/Tolino firmware 5.18+
Firmware 5.18+ ships Qt 6.5.2 (instead of the Qt 5.2.1 in 4.x), so this release ports the plugin to Qt 6.
Changes
- Qt 6 hook port (3
libnickelABI changes:ReadingMenuViewctor,Content::getId) - Qt 6
enum classfixes - NickelHook switched to the Qt 6 fork (
nicoverbruggen/NickelHookbranchqt6-support) - Cross-toolchain
arm-kobo-linux-gnueabihf-, Qt 6.5.2 - Packaging for 5.x:
Kobo.tgz(hook) +.adds/NickelStorygraph/(CLI + config) - Symbol-regression and artifact tests
- Fix: manual sync no longer fails with "no saved reading progress" right after opening a book
Install (firmware 5.x)
- Copy
Kobo.tgzinto the device's.kobo/folder. - Unzip
NickelStorygraph-adds.zipand copy theNickelStorygraph/folder into.adds/. - Safely eject; the device installs the plugin and restarts.
- Copy
.adds/NickelStorygraph/config_example.initoconfig.iniand fill in your StoryGraph session cookie + token.
For firmware 4.x, use the upstream release (KoboRoot.tgz) instead.
Smoke-tested on a Tolino running 5.18.x — install, menu injection, sync, NickelMenu coexistence, uninstall all pass.
Thanks to Nico Verbruggen (NickelMenu Qt 6 port, NickelHook qt6-support, kobuild), Patrick Gaskin (NickelHook, NickelTC), Ava Johnson / StrayRose (NickelHardcover), and Victoria Kerr (upstream).