Skip to content

Releases

v0.7.1 — Privacy toggle works again

Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 14:54

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

Choose a tag to compare

@github-actions github-actions released this 16 Nov 13:29

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 = true in config.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

Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 Oct 09:40

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.
  • 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

Choose a tag to compare

@github-actions github-actions released this 21 Oct 05:08

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.tgz mit 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.tgz nach .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

Choose a tag to compare

@dkuester dkuester released this 20 Oct 07:24

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 Datei nickelstoregraph.log wird 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.ini wird dort leicht als cookies.ini.txt gespeichert, 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 vorhandene config.ini bleibt erhalten.
  • Erst .adds, dann .kobo kopieren 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

Choose a tag to compare

@dkuester dkuester released this 19 Oct 18:37

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.
  • „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 vorhandene config.ini bleibt erhalten.
  • Erst .adds, dann .kobo kopieren 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

Choose a tag to compare

@dkuester dkuester released this 19 Oct 18:08

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.ini mit den Zeilen session_cookie=… und remember_user_token=… an, dann Einstellungen → Cookies importieren. Die Cookies landen in config.ini, cookies.ini wird danach gelöscht. Die Datei bitte nicht cookies.txt nennen: 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 gespeicherten user_slug scheiterte 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 vorhandene config.ini bleibt erhalten.
  • Erst .adds, dann .kobo kopieren 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

Pre-release

Choose a tag to compare

@dkuester dkuester released this 19 Oct 13:28

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 in config_example.ini dokumentiert, fehlte aber im Rust-Parser. Jetzt akzeptiert.
  • sync_on_close im Bereich 1–100: 1 wurde trotz der Dokumentation „1–100" abgelehnt (Crash). Der volle Bereich wird jetzt akzeptiert; auch der C++-Reader wertet 100 nicht mehr fälschlich als „deaktiviert".
  • Versionsanzeige: justfile und Cargo.toml waren hart auf 0.1.0 kodiert, sodass Plugin und CLI intern stets „0.1.0" meldeten — unabhängig vom Release-Tag. Jetzt korrekt 0.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

Choose a tag to compare

@dkuester dkuester released this 17 Oct 17:13

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|en in config.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 in config.ini geschrieben.

⚠️ 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+

Choose a tag to compare

@dkuester dkuester released this 17 Oct 16:37

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 libnickel ABI changes: ReadingMenuView ctor, Content::getId)
  • Qt 6 enum class fixes
  • NickelHook switched to the Qt 6 fork (nicoverbruggen/NickelHook branch qt6-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)

  1. Copy Kobo.tgz into the device's .kobo/ folder.
  2. Unzip NickelStorygraph-adds.zip and copy the NickelStorygraph/ folder into .adds/.
  3. Safely eject; the device installs the plugin and restarts.
  4. Copy .adds/NickelStorygraph/config_example.ini to config.ini and 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).