BlueGit

timfa hfy-novels

Overview

Activity

NovDecJanFebMarAprMayJunJulAugSepOctNov

15 contributions in the last 12 months

LessMore

Commits, merge requests and comments.

hfy-novels
README.md

HFY Novels

Een LNReader-pluginbron voor verhalen van r/HFY. Deze repository is zelf de plugin-repository: LNReader laadt een plugins.min.json en een gebouwde plugin-JS via de raw-URL van BlueGit.

De index bevat alleen metadata (titel, auteur, hoofdstukvolgorde, Reddit-IDs). De tekst van de verhalen staat er niet in. Die haalt de plugin pas op als je een hoofdstuk opent: eerst via Reddit-JSON (met de sessie uit de WebView), en bij een fout, 403 of loginpagina via Arctic Shift.

In LNReader zetten

1. Open LNReader → Plugins (of Instellingen → Repos). 2. Voeg deze repository-URL toe, precies zo (inclusief plugins.min.json en ?rev=master):

https://git.timfalken.com/timfa/hfy-novels/-/raw/.dist/plugins.min.json?rev=master

LNReader accepteert alleen een URL die plugins.min.json bevat. Daarna bronnen verversen en de plugin HFY Novels installeren of bijwerken.

BlueGit slaat de repository op als timfa/hfy-novels (kleine letters). Die spelling moet in de URL staan; HFY-Novels geeft een 404.

BlueGit serveert raw-bestanden als text/plain. Dat is voor LNReader geen probleem: de app evalueert de JS zelf en parst de JSON zelf. Een losse .apk-plugin bestaat niet; LNReader-plugins zijn JavaScript uit een repository-manifest.

Wat de plugin kan

  • Bladeren (paginagewijs, nieuwste reeksen eerst) en zoeken op titel of auteur.
  • Filters: reeksen / oneshots, NSFW verbergen of tonen.
  • Een reeks openen met de volledige hoofdstuklijst.
  • Een hoofdstuk lezen (eerst Reddit-JSON, anders Arctic Shift; onderaan het hoofdstuk staat welke bron is gebruikt).

Elk verhaal zonder eigen omslag krijgt een deterministische cover: uit een hash van de titel volgt een kleurverloop of patroon, met de titel leesbaar erop. Dezelfde titel geeft altijd dezelfde cover; lange titels worden netjes afgebroken. De indexer schrijft een PNG (240×360) in public/covers/, omdat LNReader covers via expo-image laadt. Zonder Pillow valt hij terug op SVG. De covers worden bij het bouwen van de index meegenomen, ook in CI.

Inloggen via de WebView (aanbevolen)

Anonieme Reddit-JSON is sinds 2026 vaak geblokkeerd. Als je in LNReader op reddit.com inlogt, stuurt de plugin die cookies automatisch mee (dezelfde cookie-jar als de WebView; fetchApi gebruikt dezelfde User-Agent).

1. Werk de plugin bij als LNReader een update naar een nieuwere versie toont (bronnen verversen, daarna bijwerken). 2. Open de plugin HFY Novels → Website (of in een reeks/hoofdstuk Open in WebView). Je komt op r/HFY. 3. Log in op Reddit en sluit de WebView daarna af. 4. Open een hoofdstuk. Onderaan de tekst staat Bron: Reddit als het via je sessie lukte, of Bron: Arctic Shift (fallback) als Reddit een 403 of loginpagina teruggaf.

In de plugin-instellingen kun je de bron vastzetten op Automatisch, Alleen Reddit of Alleen Arctic Shift, en zo nodig de index-URL of Arctic Shift-basis-URL aanpassen.

Hoe de index wordt gemaakt

Het programma indexer/build_index.py gebruikt de officiële wiki-serie-index van r/HFY als catalogus. Per serie komen daar titel, auteur (als die vermeld is) en de link naar de wiki-subpagina (eerste deel of inhoudsopgave) vandaan. Van die subpagina’s haalt de indexer de hoofdstuklinks, en volgt daarna de “next”-links in de posts zelf — met titelgelijkenis, in de geest van hfydl, maar zonder die code te kopiëren.

Omdat anonieme Reddit-JSON (/wiki/series.json en url/.json) sinds 2026 geblokkeerd is, gebeurt het ophalen via Arctic Shift: de wiki-API voor de index en subpagina’s, en /api/posts/ids voor post-metadata (geen /.json). Arctic Shift heeft niet elke wiki-subpagina in het archief; series zonder subpagina én zonder bekende auteur kunnen daardoor ontbreken. Titelzoeken op heel r/HFY wordt door die API geweigerd (te actieve subreddit); met auteur + titel lukt het wel.

De uitvoer staat in public/: een gesplitste catalogus, een zoekindex en per reeks een JSON-bestand met de hoofdstuklijst (geen verhaaltekst). Onderbroken runs hervatten via public/.cache/ (alleen metadata en links).

BlueGit heeft geen geplande pipelines. Op master staat een handmatige job update-index (of start een web-pipeline). Die ververst de index incrementeel. Om de nieuwe index ook terug in de repo te zetten, voeg je het geheim INDEX_PUSH_TOKEN toe (een token met schrijfrechten op deze repo, niet het job-token). Zonder dat geheim blijft de index een artifact.

Lokaal:

python3 -m unittest discover -s indexer/tests -v
node scripts/build-manifest.js
node scripts/test-plugin.js
python3 indexer/build_index.py --dest public --incremental --max-pages 200

Zet HFY_LIVE=1 bij de plugintest om parseChapter ook tegen de echte Arctic Shift-API te draaien.

Beperkingen

  • De catalogus volgt de wiki, niet een eigen scan van de subreddit. De wiki is zelf een momentopname (Arctic Shift bewaart een revisie) en is niet altijd volledig of bijgewerkt. Ontbrekende subpagina’s in het archief betekenen vaak dat een serie nog geen hoofdstukken in de index krijgt.
  • Hoofdstukken na het laatste wiki-deel worden via next-links en titelgelijkenis toegevoegd; die heuristiek kan een keten te vroeg stoppen of (zelden) een verkeerde link volgen.
  • Hoofdstukken komen bij voorkeur van Reddit-JSON met je WebView-sessie. Zonder login (of bij een 403/blokpagina) valt de plugin terug op Arctic Shift, een onofficieel archief zonder uptime-garantie.
  • Auteurs houden het auteursrecht op hun verhalen. Deze repo host die teksten bewust niet. Gebruik is bedoeld voor persoonlijk lezen; een openbare herpublicatie van de teksten is iets anders.
  • --max-pages is een budget voor API-verzoeken per run. Een eerste volledige index kan meerdere update-index-runs nodig hebben.

Zie docs/ASSUMPTIONS.md voor de aannames en juridische kaders.

Licentie

De code in deze repository is MIT. Dat geldt niet voor de verhalen van r/HFY; die blijven van hun auteurs. hfydl zelf is GPL-3; deze indexer is opnieuw geschreven en bevat geen code daaruit.