{ "id": "fennek", "name": "Fennek", "type": "fork", "maintainer": "danst0", "description": "An alternative open-source firmware for the LilyGO T-Deck Pro — music, audiobooks, eBooks and LoRa mesh chat via MeshCore. Features a homescreen launcher, touch and physical keyboard support, EPUB reader, audiobook player, and PCM5102A DAC audio output.\n", "repository": "https://github.com/danst0/fennek", "license": "GPL-3.0", "status": "active", "lifecycle": "active", "maturity": "beta", "distribution": "community", "lineage": { "kind": "fork", "upstreamFirmwareId": "meshcore-official", "upstreamRepository": "https://github.com/meshcore-dev/MeshCore" }, "runtime": { "framework": "arduino", "language": "cpp" }, "roles": [ "companion", "standalone-ui" ], "features": [ "Homescreen launcher", "Music playback (PCM5102A DAC)", "Audiobook player", "EPUB and TXT reader with page-index cache", "LoRa mesh chat via MeshCore", "Touch + physical keyboard support", "Per-book reading position" ], "capabilities": { "protocol": { "meshcoreCompatible": true }, "transports": { "ble": true, "usbSerial": true, "nativeTcp": true, "wifiAp": true }, "operations": { "ota": false, "webFlasher": false }, "networking": { "repeater": false, "roomServer": false, "observer": false, "kissModem": false }, "hardware": { "gps": true, "display": true, "sensors": false, "lowPowerRx": false } }, "devices": [ { "id": "lilygo-tdeck-pro", "status": "supported" } ], "popularity": { "githubStars": 2, "githubForks": 0, "githubWatchers": 0, "githubOpenIssues": 0, "githubContributors": 101, "releaseDownloads": 0, "latestReleaseDownloads": 0, "lastChecked": "2026-06-21" }, "verification": { "sourceAvailable": true, "releasesAvailable": true, "ciBuilds": false, "lastChecked": "2026-06-21" }, "source": { "path": "data/firmwares/fennek/firmware.yaml", "updatedAt": "2026-06-22T21:31:07+02:00" }, "latest_version": "2.5.9", "released": "2026-06-21", "releases": [ { "version": "v2.5.9", "name": "Fennek v2.5.9", "datetime": "2026-06-21T19:36:11Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.9", "prerelease": false, "notes": "Podcast-App deaktiviert (WLAN-Sync zu langsam).\n\n- Auto-WLAN-Sync vor Standby (podcast::flushBeforeStandby) auskommentiert — brachte bei jedem Standby das WLAN über den 4-MHz-SD-Bus hoch\n- Launcher-Kachel + appmgr-Registrierung + podcast::begin() aus → App vom Gerät verschwunden, Slot 13 (Seite 2) bleibt leer\n- Code/Konsolen-Befehle/NVS-Toggle/i18n bewusst behalten (reaktivierbar)", "notesHtml": "

Podcast-App deaktiviert (WLAN-Sync zu langsam).

\n\n" }, { "version": "v2.5.7", "name": "v2.5.7", "datetime": "2026-06-21T19:05:52Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.7", "prerelease": false, "notes": "## Sudoku als fünftes Spiel\n\nNeues Spiel **Sudoku** in der Spiele-App (neben 2048, Minensucher, Schach, Tic-Tac-Toe).\n\n- Arduino-freier Generator + Solver (`sudoku_core.h`, host-getestet): randomisiertes Backtracking für die Vollösung, dann eindeutigkeitsprüfendes Ausgraben — erzeugt nur Rätsel mit genau einer Lösung. Rekursionsfrei (iterativer Level-Stack).\n- 9×9-Gitter à 26 px, Touch-Tap/WASD-Cursor, Zifferntasten 1–9 setzen, 0/Backspace/Mikrofon leeren, Konfliktzellen invertiert, „Gelöst\"-Overlay mit Zeit.\n- Schwierigkeit Leicht/Mittel/Schwer (40/32/26 Vorgaben).\n- Beststände im NVS (gelöste Rätsel + Bestzeit), inkl. INI-Export/-Import.\n\n**OTA:** `firmware.bin` angehängt.", "notesHtml": "

Sudoku als fünftes Spiel

\n

Neues Spiel Sudoku in der Spiele-App (neben 2048, Minensucher, Schach, Tic-Tac-Toe).

\n\n

OTA: firmware.bin angehängt.

\n" }, { "version": "v2.5.6", "name": "v2.5.6", "datetime": "2026-06-21T15:32:44Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.6", "prerelease": false, "notes": "fix(power): Dateien-Modus am Kabel nicht einschlafen lassen\n\n- battery::external() (DSG-Bit aus BatteryStatus 0x0A) erkennt Netzteil zuverlässig, auch bei vollem Akku (charging() fiel bei Strom ~0 auf false)\n- power::poll() nutzt external() statt charging() für die Dateien-Standby-Bremse", "notesHtml": "

fix(power): Dateien-Modus am Kabel nicht einschlafen lassen

\n\n" }, { "version": "v2.5.5", "name": "v2.5.5", "datetime": "2026-06-21T15:07:48Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.5", "prerelease": false, "notes": "feat(wecker): Einmalig-Option für Wecker\n\n- Neues Alarm-Feld `once` (NVS byte0 Bit4, abwärtskompatibel)\n- Einmalige Wecker feuern am nächsten hh:mm tageunabhängig und schalten sich danach selbst aus\n- Editor-Preset \"Einmalig\" im Feld Tage; Liste/Editor zeigen es an\n- Konsole: `alarm einmal` (once/1x)\n\nOTA: firmware.bin angehängt.", "notesHtml": "

feat(wecker): Einmalig-Option für Wecker

\n\n

OTA: firmware.bin angehängt.

\n" }, { "version": "v2.5.4", "name": "v2.5.4", "datetime": "2026-06-21T15:00:17Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.4", "prerelease": false, "notes": "OTA-Update-Fix + Ollama-Timeout.\n\n- **OTA `-104` behoben:** GitHub liefert für Release-Assets eine signierte Redirect-URL (`release-assets.githubusercontent.com`, ~900 Zeichen). Diese sprengte den 300-Byte-Puffer in `apply()` → abgeschnittene URL → `httpUpdate`-Fehler `-104` (wrong http code). Puffer auf 1400 Byte vergrößert.\n- **notes_ai (Ollama) Timeout:** `HTTPClient::setTimeout()` nimmt `uint16_t` (max 65535 ms); der Wert 120000 lief still auf 54464 ms über. Konstante auf 65000 ms korrigiert.\n\nErstes Release, mit dem OTA von einer früheren Version aus zuverlässig durchläuft.", "notesHtml": "

OTA-Update-Fix + Ollama-Timeout.

\n\n

Erstes Release, mit dem OTA von einer früheren Version aus zuverlässig durchläuft.

\n" }, { "version": "v2.5.3", "name": "v2.5.3", "datetime": "2026-06-21T14:48:58Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.3", "prerelease": false, "notes": "perf(dateien): Request-Zähler-Refresh 10x seltener gegen E-Ink-Flackern\n\n- Drosselung des Request-Zähler-Voll-Redraws im RUNNING-Zustand von 5 s auf 50 s\n- Zähler ist reine Info; seltenere Voll-Redraws sparen sichtbares E-Ink-Flackern", "notesHtml": "

perf(dateien): Request-Zähler-Refresh 10x seltener gegen E-Ink-Flackern

\n\n" }, { "version": "v2.5.2", "name": "Fennek v2.5.2", "datetime": "2026-06-21T14:29:15Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.2", "prerelease": false, "notes": "## Highlights\n\n- **On-Device-OTA-Knopf** (Settings → Update → „Aktualisieren\"): prüft GitHub-Releases und flasht direkt am Gerät mit Vollbild-Fortschritt (Phase + Balken + %). Kein Browser/Konsole mehr nötig.\n- **Notizen:** Audionotiz-Player (Play/Pause, ±10 s, Region-Fortschritt) + hoch-scrollbarer Editor.\n- **Karteikarten:** Übersicht mit Leitner-Fächer-Verteilung (fällig/bearbeitet).\n- **Kopfrechnen:** adaptive Schwierigkeit, je-Modus persistierte Stufe.\n- **notes_ai:** behutsamerer Korrektur-Prompt (nur Rechtschreibung/Umlaute, kein Umdichten).\n- **Tools:** `maps_tiles.py` mit wählbaren Kachelquellen (`--preset standard|cyclosm|topo`).\n\n## OTA-Update\n\nGeräte ab v2.5.1 können direkt am Gerät auf diese Version aktualisieren (Settings → Update → „Aktualisieren\") oder via Web-UI (`fennek.local`) / Konsole (`ota update`).\n\n**Flashen (USB):** `firmware.bin` in den inaktiven OTA-Slot bzw. via `pio run -e fennek -t upload`.", "notesHtml": "

Highlights

\n\n

OTA-Update

\n

Geräte ab v2.5.1 können direkt am Gerät auf diese Version aktualisieren (Settings → Update → „Aktualisieren\") oder via Web-UI (fennek.local) / Konsole (ota update).

\n

Flashen (USB): firmware.bin in den inaktiven OTA-Slot bzw. via pio run -e fennek -t upload.

\n" }, { "version": "v2.5.0", "name": "v2.5.0", "datetime": "2026-06-21T10:11:51Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.5.0", "prerelease": false, "notes": "**Full Changelog**: https://github.com/danst0/fennek/compare/v2.4.9...v2.5.0", "notesHtml": "

Full Changelog: https://github.com/danst0/fennek/compare/v2.4.9...v2.5.0

\n" }, { "version": "v2.4.8", "name": "Fennek v2.4.8", "datetime": "2026-06-20T19:59:52Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.4.8", "prerelease": false, "notes": "## Änderungen\n\n- **OTA:** Semver-Vergleich für Update-Erkennung (`tag_name != FENNEK_VERSION` → korrekte Versionslogik)\n- **Akku:** Batterieanzeige-Fix in der Statuszeile\n\n## Flashen\n\n```\npio run -e fennek -t upload\n```\n\noder OTA via `fennek.local` → Firmware-Update.", "notesHtml": "

Änderungen

\n\n

Flashen

\n
pio run -e fennek -t upload\n
\n

oder OTA via fennek.local → Firmware-Update.

\n" }, { "version": "v2.3.1", "name": "Fennek v2.3.1", "datetime": "2026-06-19T14:27:33Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.3.1", "prerelease": false, "notes": "## Notizen / Audio\n- **Sprachnotiz-Liste** zeigt jetzt **Datum + HH:MM** (statt HH:MM:SS bzw. generisch „Sprachnotiz\").\n- **Aufnahme-Gain ×6** mit Sättigung: das PDM-Mikro war ~−20 dBFS leise → Wiedergabe kaum hörbar. Neue Aufnahmen sitzen bei ~−7 dBFS (kein Clipping).\n- **Sauberer I2S0-Handover** nach der Aufnahme: kein doppeltes `i2s_driver_uninstall` mehr (`endMic`/`MicResume` macht uninstall+install in einem Schritt).\n\n## Karten / GPS\n- **No-Fix-Fallback** zentriert jetzt auf **Düsseldorf** (51.2277/6.7735); `DEFAULT_ZOOM` 15 → 13 (NRW-weit bekachelt).\n- **GPS-Zeit-Diagnose**: Einmal-Log `[MAPS] GPS-Zeit empfangen …` pro Karten-Session.\n\nEnthält außerdem v2.3.0 (GPS-/WAV-Diagnose-Logs, Karten-Fallback, Notizen-Zeitlabel).", "notesHtml": "

Notizen / Audio

\n\n

Karten / GPS

\n\n

Enthält außerdem v2.3.0 (GPS-/WAV-Diagnose-Logs, Karten-Fallback, Notizen-Zeitlabel).

\n" }, { "version": "v2.0.4", "name": "v2.0.4", "datetime": "2026-06-17T17:30:26Z", "url": "https://github.com/danst0/fennek/releases/tag/v2.0.4", "prerelease": false, "notes": "## Changes\n\n- **Regenerated README/website screenshots.** The home-screen mirror in the host renderer (`tools/screenshot.cpp`) was stuck on an old layout (6 tiles, 2×3); it now matches the real `launcher.cpp` — a 2×5 grid with all 10 slots (Music/Listen/Read/Mesh/Settings/Games/Files/Notes/Alarm). The Settings screenshot now shows the current version.\n- Images updated in `docs/screenshots/{de,en,sv}/` and on [fennek.dumke.me](https://fennek.dumke.me).\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)", "notesHtml": "

Changes

\n\n

🤖 Generated with Claude Code

\n" }, { "version": "v1.9.4", "name": "v1.9.4", "datetime": "2026-06-17T06:53:30Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.9.4", "prerelease": false, "notes": "## Änderungen\n\n- **Web-Dateimanager**: Löschen ohne Rückfrage. Nur Ordner mit Unterordnern fragen kurz nach und werden dann rekursiv gelöscht (`rmRecursive`); Dateien und flache Ordner verschwinden sofort.\n- **Notizen-App + Konsole**: weitere Verbesserungen.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)", "notesHtml": "

Änderungen

\n\n

🤖 Generated with Claude Code

\n" }, { "version": "v1.9.2", "name": "Fennek v1.9.2", "datetime": "2026-06-15T15:51:06Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.9.2", "prerelease": false, "notes": "### Added\n- **`BATTLOG` — opt-in battery & activity logger** (`services/battlog`). When the `BATTLOG` build flag is set, the firmware writes one record per event (app switch, audio track, mesh radio on, Wi-Fi on/off, standby/wake) **and** a battery probe every 60 s to `/.fennek/battery.log` (timestamp + %/mV/charging? + Wi-Fi/mesh status). It's a throttled PSRAM ring flushed to SD before standby, and downloadable via the Web file manager — useful for diagnosing real-world battery drain. Deliberately zero-cost when the flag is off (all `BATTLOG_*` calls compile to nothing).\n\n🌐 Project page & screenshots: **https://fennek.dumke.me**\n\n**Full changelog:** [`CHANGELOG.md`](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

Added

\n\n

🌐 Project page & screenshots: https://fennek.dumke.me

\n

Full changelog: CHANGELOG.md

\n" }, { "version": "v1.9.1", "name": "Fennek v1.9.1", "datetime": "2026-06-15T15:51:06Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.9.1", "prerelease": false, "notes": "### Fixed\n- **Notes never silently lost on a failed SD write.** The save path now clears its dirty flag only on a *complete* success; if an SD write or remove fails, the note stays dirty and is retried on the next autosave instead of being overwritten on the next editor open.\n- **Just-played track now reaches the scrobble queue before standby.** `power::poll()` stops audio (and lets the audio task drain the stop command) *before* the pre-standby Navidrome flush, so the current track is enqueued via `noteTrackEnded()` rather than landing in the PSRAM ring that deep sleep would otherwise discard.\n\n**Full changelog:** [`CHANGELOG.md`](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

Fixed

\n\n

Full changelog: CHANGELOG.md

\n" }, { "version": "v1.9.0", "name": "Fennek v1.9.0", "datetime": "2026-06-15T15:51:05Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.9.0", "prerelease": false, "notes": "### Added\n- **Mesh: `contacts reset` console command** + `mesh_client::resetContacts()`. Clears all contacts and their persistent mirrors (SPIFFS `/contacts`, SD `/meshcore/contacts.bin`); the contact table then rebuilds itself from incoming adverts. Handy when the 64-slot table fills up with stale nodes or you want a clean slate.\n\n**Full changelog:** [`CHANGELOG.md`](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

Added

\n\n

Full changelog: CHANGELOG.md

\n" }, { "version": "v1.8.1", "name": "Fennek v1.8.1", "datetime": "2026-06-15T15:51:04Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.8.1", "prerelease": false, "notes": "### Changed\n- **Unified back/home navigation across all apps.** Home is now a visible affordance: the status bar shows a house glyph (⌂) outside the launcher and the whole bar taps to Home. Lower corner buttons are consistently labelled **\"Back\"** (exactly one level) — audiobook/reader/notes lists and Settings now say \"Back\" instead of \"Home\", and the Settings back button steps edit → category → root → launcher. Mesh sub-screens dropped their redundant second \"Home\" button, the Files app gained a visible \"Back\" button, and the reader footer tap-zone is labelled \"◄ List\". Games keep no on-screen back button (exit via the ⌂ glyph; keyboard `Backspace`/`Q` still works). Keyboard conventions (`Q` = Home, `Backspace` = one level back) unchanged.\n\n**Full changelog:** [`CHANGELOG.md`](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

Changed

\n\n

Full changelog: CHANGELOG.md

\n" }, { "version": "v1.8.0", "name": "Fennek v1.8.0", "datetime": "2026-06-13T19:18:10Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.8.0", "prerelease": false, "notes": "## Added\n- **Notes app** (launcher tile 7): a daily-notes model — exactly one note per day, named after the local date (`/notes/YYYY-MM-DD.md`). **\"+ Today\"** opens or appends to today's note; the list shows every day newest-first with a first-line preview, and notes can be deleted with a confirmation. The editor is append-style (type / Backspace / Enter) with its own word wrap and a compact header.\n\n Persistence is chunked under `spiLock` (never inside `draw()`), with a 30 s autosave and a save on leave; empty notes are removed. Without an SD card it shows \"No SD card\" + \"Search again\" like the other apps. The date comes from the local system clock (`timesync`). New console command `notes` runs an SD round-trip / scan self-check (in the style of `books`).\n\nLocalized in DE/IT/SV/EN/ES. Verified on device (clean boot, SD round-trip with UTF-8 preserved, scan/sort).\n\n**Full changelog:** [CHANGELOG.md](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

Added

\n\n

Localized in DE/IT/SV/EN/ES. Verified on device (clean boot, SD round-trip with UTF-8 preserved, scan/sort).

\n

Full changelog: CHANGELOG.md

\n" }, { "version": "v1.7.1", "name": "Fennek v1.7.1", "datetime": "2026-06-13T04:08:05Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.7.1", "prerelease": false, "notes": "## ✨ Added\n- **Settings backup as INI** (`services/settingsfile`): export/import all NVS settings to/from an SD file. SPI-free serialization on a RAM buffer, SD I/O isolated under `spiLock`. Per-book bookmarks/reading positions are excluded (CRC32-hashed keys). New console command + `main`/`power` wiring.\n\n## 📝 Docs\n- Added `CHANGELOG.md` and GitHub releases for v1.3.0–v1.7.0.\n- README now ships in **English (default)**, German (`README.de.md`) and Swedish (`README.sv.md`) with a language switcher and release/changelog badges.\n\n📋 Full history: [CHANGELOG.md](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

✨ Added

\n\n

📝 Docs

\n\n

📋 Full history: CHANGELOG.md

\n" }, { "version": "v1.7.0", "name": "Fennek v1.7.0", "datetime": "2026-06-13T04:03:33Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.7.0", "prerelease": false, "notes": "## ✨ Added\n- **\"+ New Channel\" UI** for joining hashtag channels — a \"► New Channel\" row at the top of the chat list opens a join screen (keyboard types the `#name`, PSK derived from it, persisted to `channels.txt` on SD; jumps straight into the new channel after joining).\n\n## 🔄 Changed\n- **Robust time synchronization without a hardware RTC.** Canonical clock is now ESP32 system time (`SystemRTCClock`), which survives deep sleep. New `services/timesync` coordinator: opportunistic NTP (when Wi-Fi is up) + a top-up before auto-standby, with Mesh adverts as a passive source. Quality model (`estErr = learned drift × time since sync`) with exponential back-off, `s_clockConfident` bootstrap for the first advert after boot, POSIX time zone (default `Europe/Berlin` incl. DST), settings rows \"Time zone\"/\"Time\", and console `time` / `time set` / `time sync` / `tz`.\n\n📋 Full history: [CHANGELOG.md](https://github.com/danst0/fennek/blob/main/CHANGELOG.md)", "notesHtml": "

✨ Added

\n\n

🔄 Changed

\n\n

📋 Full history: CHANGELOG.md

\n" }, { "version": "v1.6.3", "name": "v1.6.3", "datetime": "2026-06-13T04:03:32Z", "url": "https://github.com/danst0/fennek/releases/tag/v1.6.3", "prerelease": false, "notes": "## 📡 Mesh SD persistence & clock hardening\n- Contact mirror (`/meshcore/contacts.bin`, SD takes load priority over SPIFFS, deferred write from `loop()`) and joined hashtag channels (`/meshcore/channels.txt`, re-joined on boot).\n- RTC sync guard against future-clock outliers (bootstrap + forward jumps < 1 h, backward only on a 3× advert consensus).\n- Contact overflow fix: overwrite the oldest non-favorite when the table (64) is full instead of dropping new adverts.\n- Console hashtag commands `join` / `chan`, plus a new `i2cscan` command. Verified on device: the T-Deck Pro V1.1 has **no hardware RTC** (0x51 empty).", "notesHtml": "

📡 Mesh SD persistence & clock hardening

\n\n" } ], "changelogSource": "github", "changelogUpdatedAt": "2026-06-22T12:12:05.972Z" }