Repository navigation
FroggyReader 1.0.0
First public release of FroggyReader, a from-scratch EPUB reader for the
Data Frog SF2000 and GB300 / GB300V2.
FroggyReader is a Libretro core for sf2000_multicore. It uses a 320x240
RGB565 framebuffer, integer/fixed-point layout, and contains no hardware-FPU
instructions.
Highlights
- EPUB 2 and EPUB 3, including OPF, spine, NCX, EPUB 3 nav, nested TOC, and
internal anchors. - XHTML + a practical CSS subset: headings, paragraphs, justification,
indentation, bold/italic/underline, super/subscript, lists, block quotes,
tables,pre,hr, page breaks, backgrounds, and borders. - JPEG, PNG (with alpha), GIF (first frame), and BMP images.
- Kindle-style library: flat light/night themes, 3x2 grid with 62x82 covers,
titles under covers, smooth marquee for a selected long title, title/author
sorting, shelf paging, progress bars, and bookmark markers. - Paper, Sepia, and Night reading themes; four text sizes; three margin
widths; optional justification; reflow that keeps the reading position. - Smooth D-pad scrolling, page turns, chapters, bookmarks, and resume.
- UI in English (default), Polish, German, and Japanese.
Downloads
| Console | Core asset |
|---|---|
| Data Frog SF2000 | epub.sf2k |
| GB300 / GB300V2 | epub.gb3k |
Recommended: download froggyReader-sd-files.zip. It contains ready-to-copy
GB300 and SF2000 trees with the correct core name, launcher stubs, menu
artwork, display-name configuration, and the 12 sample books. Copy the contents
of the folder for your console to the SD-card root.
If you install a core manually, the loader expects the file at
/system/Deimos/cores/epub.sf2k on both consoles. Rename the GB300 asset from
epub.gb3k to epub.sf2k when copying it. Create /ROMS/EPUB.gba containing:
epub;epub;EPUB.gba
Then put books in /ROMS/epub/books/ and start ROMS/EPUB.gba from the menu.
Verification
make test: 101 PNG captures, exit 0make test-mipsunder QEMU: 42 PNG captures, exit 0make edge-test: 5 PNG captures, exit 0- Hardware-FPU instructions in both final ELFs: 0
- SF2000 ELF text / data / bss: 4,392,752 / 3,224 / 3,352 bytes
Checksums for all release assets are in SHA256SUMS.txt.
The core was tested on the host and on MIPS under QEMU, built for both devices,
and installed to a GB300 SD card. A hands-on test on physical hardware is still
recommended.
Links
- Source and documentation: https://github.com/Synaps33/FroggyReader
- Test report: https://github.com/Synaps33/FroggyReader/blob/main/TEST_REPORT.md
- Support further work: https://ko-fi.com/sajnaps