bookapp v0.1.0-beta

bookapp v0.1.0-beta

SK ďalej v tomto dokumente je slovenská verzia, EN anglická verzia je pod ňou.

---

SK — Slovensky

Čo appka robí

bookapp je priestorové dvojča vašej domácej knižnice, modelované
v milimetroch. Nakreslíte si police presne tak, ako stoja doma (aj
s dvierkami a zásuvkami), knihy pridáte skenom ISBN, hľadaním alebo
ručne — a appka vám povie, či sa vám kniha na policu zmestí a kam presne
patrí (podľa série, autora, tesnosti). K tomu katalóg s filtrami,
výpožičky, sledovanie čítania po stranách (nie percentom), hodnotenie
★1–10, zálohy (aj tichá denná), MARC21 export/import, import
z Goodreads a StoryGraph, a synchronizácia dvoch zariadení cez lokálnu
Wi-Fi. Appka je offline, bez účtu a bez cloudu.

Toto je verejná BETA a je zadarmo

Cieľom tohto vydania je zbierať stiahnutia a hlavne spätnú väzbu.
Licenciu a prípadnú platenú verziu riešime až neskôr — teraz nič
nekupujete a appka od vás nič nevyžaduje.

Čo (zatiaľ) nefunguje

Automatické meranie hrúbky kníh z fotky police appka neponúka a nikdy
nesľubovala. Bolo to poctivo vyskúšané — štyri rôzne metódy vrátane
OpenCV — a zamietnuté, pretože fungovalo len náhodou (susedné knihy
rovnakej farby, tlač silnejšia než hrana medzi knihami, naklonené
chrbty). Appka radšej necháva pole prázdne, než aby si vymyslela číslo.

Hrúbku knihy teda buď odmeriate meradlom raz (appka si ju odvtedy
pamätá a dokáže z tesne zaplnenej police dopočítať aj hrúbky ostatných
kníh na nej), alebo appka ponúkne odhad podľa formátu knihy — ten je
vždy viditeľne označený slovom „približne".

Appka sťahuje obálky kníh z Google Books a Open Library, ale
len na vaše výslovné kliknutie, nikdy sama od seba.

Inštalácia — Android

1. Stiahnite bookapp-0.1.0-android-arm64.apk (funguje na bežných
   64-bitových ARM telefónoch — to je dnes prakticky každý moderný
   Android telefón).
2. Android pri inštalácii mimo Google Play zobrazí varovanie
   „Neznámy zdroj" — v nastaveniach povoľte inštaláciu z aplikácie,
   ktorou súbor otvárate (Súbory, prehliadač...). Toto hlásenie sa
   zobrazuje pri každej appke mimo obchodu, nielen pri tejto.
3. Nainštalujte a spustite. APK je podpísané (nie je to appka
   z neznámeho zdroja bez podpisu) — zatiaľ len nie je na Google Play.

Inštalácia — Windows

1. Stiahnite bookapp-0.1.0-windows-x64.zip a rozbaľte kamkoľvek —
   appka nepotrebuje inštalátor, stačí priečinok.
2. Spustite bookapp.exe. Windows SmartScreen pri prvom spustení
   zobrazí „Windows chránil váš počítač", pretože appka (zatiaľ) nie je
   podpísaná plateným certifikátom. Kliknite „Viac informácií" a
   potom „Spustiť napriek tomu".
3. Dáta appka ukladá vo vašom profile — žiadny cloud, žiadny účet.

Overenie súborov

Kontrolné súčty SHA-256 sú v SHA256SUMS.txt v tomto vydaní.

Spätná väzba

• e-mail: andrej@arling.sk
• GitHub issues: https://github.com/AndryRoby/bookapp/issues

Najviac pomôže: čo vám nesedelo, čo appke chýba pre vašu knižnicu, a na
akej veľkosti/type knižnice ste to skúšali. Ďakujem, že ste appku
vyskúšali.

---

EN — English

What the app does

bookapp is a spatial digital twin of your home library, modeled in
millimeters. You draw your shelves exactly as they stand at home
(doors and drawers included), add books by scanning the ISBN,
searching, or entering them by hand — and the app tells you whether a
book fits on a shelf and exactly where it belongs (by series, author,
snugness). It also has a filterable catalog, loan tracking, page-based
reading progress (not a percentage), ★1–10 ratings, backups (including
a silent daily one), MARC21 export/import, Goodreads and StoryGraph
import, and syncing two devices over local Wi-Fi. The app is offline,
with no account and no cloud.

This is a public BETA and it is free

The goal of this release is to gather downloads and, above all,
feedback. Licensing and any paid version will be decided later — you
are not buying anything right now, and the app asks nothing of you.

What does NOT (yet) work

Automatic thickness measurement from a photo of the shelf is not
offered and was never promised. It was genuinely tried — four
different methods including OpenCV — and rejected, because it only
worked by accident (neighboring books of the same color, printed text
stronger than the edge between books, tilted spines). The app would
rather leave a field empty than invent a number.

So book thickness is either measured once with a ruler (the app
remembers it from then on, and can back-calculate the thickness of
other books on a tightly packed shelf), or the app offers an
estimate based on the book's format — always clearly labeled
"approximately".

The app downloads book covers from Google Books and Open Library, but
only when you explicitly tap for one, never on its own.

Installation — Android

1. Download bookapp-0.1.0-android-arm64.apk (works on standard
   64-bit ARM phones — essentially every modern Android phone today).
2. Installing outside Google Play, Android shows an "Unknown source"
   warning — in Settings, allow installs from whichever app you opened
   the file with (Files, your browser, etc.). This warning appears for
   any app installed outside the store, not something specific to
   this one.
3. Install and open it. The APK is properly signed (not an
   unsigned package from nowhere) — it just isn't (yet) on Google
   Play.

Installation — Windows

1. Download bookapp-0.1.0-windows-x64.zip and extract it anywhere —
   no installer needed, just a self-contained folder.
2. Run bookapp.exe. Windows SmartScreen will show "Windows protected
   your PC" on first launch, because the app is not (yet) signed with
   a paid code-signing certificate. Click "More info", then
   "Run anyway".
3. The app stores its data in your user profile — no cloud, no
   account.

Verifying the files

SHA-256 checksums are in SHA256SUMS.txt in this release.

Feedback

• email: andrej@arling.sk
• GitHub issues: https://github.com/AndryRoby/bookapp/issues

Most useful: what didn't feel right, what's missing for your library,
and what size/type of library you tried it on. Thank you for trying
it.