Document Grace Poppy Tactility book package
This commit is contained in:
@@ -491,6 +491,35 @@ Use the following as the working direction for Codex when implementing the app:
|
||||
Create a new Tactility app for ESP32 called “Book Player”. It should scan `/sdcard/books/` for subfolders with `manifest.json`, show a book picker, then play each selected book page by displaying the page image and playing the matching audio. Provide Prev, Play/Pause, and Next controls. Auto-advance when audio finishes. Follow existing Tactility app structure, UI conventions, app registration, SD-card access, image rendering, and audio playback patterns in the repository. Keep memory usage safe by loading only the current page. Handle no SD card, no books, invalid JSON, missing assets, and playback errors gracefully. Add registration/build entries, a README, and a sample manifest. Build and report changed files and limitations.
|
||||
```
|
||||
|
||||
### Initial Example Book Package
|
||||
|
||||
A ready-to-copy example package was assembled on 2026-07-08 using the current Grace/Poppy assets:
|
||||
|
||||
- ZIP: `/home/adolforeyna/output/tactility-book-packages/grace-poppy-tactility-book-example.zip`
|
||||
- Folder inside ZIP: `books/grace-poppy/`
|
||||
- Manifest: `books/grace-poppy/manifest.json`
|
||||
- Pages: 21 sequential app pages, with `original_page` preserving the source page numbers where the original book skipped pages 19 and 21.
|
||||
- Images: `page001.png` through `page021.png`, 320×240 PNG.
|
||||
- Audio: `page001.mp3` through `page021.mp3`, mono 16 kHz 24 kbps MP3.
|
||||
- Includes `README.md` explaining SD-card placement.
|
||||
|
||||
To install on the SD card, unzip so the final path is:
|
||||
|
||||
```text
|
||||
/sdcard/books/grace-poppy/manifest.json
|
||||
/sdcard/books/grace-poppy/page001.png
|
||||
/sdcard/books/grace-poppy/page001.mp3
|
||||
...
|
||||
```
|
||||
|
||||
Package verification at creation:
|
||||
|
||||
```text
|
||||
unzip -t: No errors detected
|
||||
manifest pages: 21
|
||||
sha256: e84a5ecdcd44235ab44775aee3867fb71d2f1cd0e1be439002a640d922cd3ed9
|
||||
```
|
||||
|
||||
## Correction Workflow Ideas
|
||||
|
||||
Corrections should be recorded as structured page-level notes rather than ad hoc prompts.
|
||||
|
||||
Reference in New Issue
Block a user