4.4 KiB
Tactility Bible Audio
Status — 2026-11-13
User requested an initial audio Bible app using the existing BibleVerse book-selection UI, first on the Mac mini emulator. Implemented a native Tactility app and functionally verified it in the Mac mini simulator. No physical boards were installed or modified, and no server catalog records were changed.
Source: /Users/adolforeyna/Projects/electronics/tactility/tactility_apps/Apps/BibleAudio/
App ID: one.tactility.bibleaudio
Simulator package: Apps/BibleAudio/build/one.tactility.bibleaudio.sim.app
Builder: python3 Apps/BibleAudio/build-simulator.py from tactility_apps root.
Evidence: /Users/adolforeyna/output/bible-audio-simulator/
Local simulator viewer: http://127.0.0.1/sim
Verified implementation
- Same BibleVerse-style horizontal 66-book picker with arrows, scrub slider, dark colors, and embedded Georgia Regular 24 font.
- Real PocketBase catalog on FamReynaServer
.110:8095, usingaudio_libraries,audio_collections, andaudio_tracks. - Native chapter listing, pagination, back navigation, downloads with exact catalog-size validation, cached-play indicators, stop, clean exit/reopen.
- Real minimp3 decoding through firmware audio-stream0 → SDL/CoreAudio, not the legacy Mp3Player silent simulator branch.
- Tested at 480x320 and 320x240. Genesis chapter 1 downloaded 2,070,582 bytes, SHA-256
5e3dd36bc35dcdf4284bd0d36ccae0c6f59c3d83815244268b7bcdf4fed6e4f5, exactly matching server bytes. - Native audio logs show 44,100 Hz mono output and decoded samples written; tested stop and cached replay. This is output-path verification, not independent microphone confirmation of audibility.
- Eight tests compile and run actual C book-mapping and PCM-write logic, including partial timeout writes, bounded no-progress retry and fatal driver errors. Two SDL simulator audio suites pass.
- Delayed review was reconciled with final source: all reviewed alias/lifecycle/download/catalog defects fixed; Back cancels pending download/autoplay, malformed pages fail explicitly, PCM partial writes retry safely. Rebuilt, reinstalled, exact installed/package binary match verified; playback/stop/exit/reopen retested. Final binary SHA-256:
9e46b4842fe13d336bd11f49b7da1f440a0200cd6b5e789d902e6ba924ada6b5.
Important source-library limitation
Live backend: 1 library, 18 collections, 1,167 MP3 tracks. Actual C mapping recognizes 1,163 tracks across 53 canonical books. Four records are general section introductions (history/wisdom/prophets/New Testament), not canonical books.
Absent source audio: Daniel, Hosea, Joel, Amos, Obadiah, Jonah, Micah, Nahum, Habakkuk, Zephaniah, Haggai, Zechariah, Malachi. App keeps these books in canonical order and labels them unavailable. Do not describe the hosted library as a complete audio Bible.
Remaining work
Persistent catalog/offline restart browsing, resume/history, seeking, pause/volume UI, auto-next chapter, source-audio gap restoration and one-board end-to-end rollout.
ESP32-S3 build — 2026-11-13
Latest source built successfully against a fresh SDK from local firmware revision dcfd4e9bcc12da39f3af8cc80f7bc6388e29b56f. Package: /Users/adolforeyna/output/bible-audio-esp32/BibleAudio-0.1.0-esp32s3.app (71,680 bytes), SHA-256 3d190068cadb841d5959103f2bb1fa03a8bcf3de10c94e412af72038f4da9857.
- Package manifest and embedded ESP32-S3 ELF match source/build artifacts exactly.
- Source export audit: 125 imports, 1,662 exports, zero missing imports. Both locally compiled ES3C28P and ES3C35P firmware ELFs contain all imported symbols; this is not proof of the firmware currently flashed on any board.
- Eight app tests pass. MP3 decoder moved from task stack to heap because it occupies 23,068 bytes vs the 8 KiB ESP-IDF playback stack. Host heap-decoder smoke test decoded 20 real Genesis frames / 23,040 samples.
- Receipt:
/Users/adolforeyna/output/bible-audio-esp32/build-receipt.json. - Build only: no hardware installs, launches, firmware flashes or device changes performed. Device runtime remains unverified. Simulator was not redeployed for this heap-allocation-only change.
Continuity
Earlier server setup was completed in session 20260919_215532_5e469e (Extend Discovery Mountain for Bible audio). Audio resides at /mnt/mydisk/media/podcasts/Bible Message/episodes/, served through read-only Nginx at http://192.168.68.110:8098/bible-message/. Original external-drive archive was preserved.