Repository navigation
GitHub Release: v3.12.0
Tag version: v3.12.0
Release title: v3.12.0 - Native Korean Font Engine, Multi-Line Card Text Wrapping & Zero-Smear Marquee Scrolling
What's Changed in v3.12.0
This release introduces a Native Korean Bitmap Font Engine, Multi-Line Card Text Wrapping Mode (designed for SMS forwarding from Tasker and automated alerts), and Zero-Smear Marquee Scrolling, while preserving all features of the GeekMagic SmallTV-PRO (ESP32 8MB Flash) including Scheduled App Timers, LCD Burn-in Wiper, and KRX/US Candlestick Charts.
🌟 Highlights & New Features
-
🇰🇷 Native Korean Bitmap Font Engine (KS X 1001):
- Full support for 2,350 KS X 1001 Korean syllables, full ASCII, and common symbols based on the Galmuri font.
- 22px Balanced Font Size (11px base × 2 integer scale): 22×22 px Korean glyphs with 12×22 px monospace Latin/numbers.
- +1px Letter Spacing: Clean separation between consecutive Korean characters prevents visual crowding.
- 12px Line Gap (Configurable via
"gap"): Ideal breathing room for multi-line readability.
-
📜 Multi-Line Card Mode (
"wrap": true):- Designed specifically for text messages, mobile notifications, and Tasker SMS forwarding.
- Instead of scrolling on a single line, it formats notifications into a clean card:
- Top sender/title
- Accent divider line
- 5
6 lines of clean, word-wrapped body text (up to 5060 Korean characters or ~100 Latin characters at once)
- Can be activated via
"wrap": trueor by including line breaks (\n) in the JSON payload.
-
🚀 Zero-Smear Marquee Scrolling:
- Completely resolves letter smearing and SPI bus deadlock during 1-line text scrolling by batch-clearing text bands via 1ms high-speed SPI fill and off-screen glyph rejection.
-
🛡️ 100% Backward Compatible:
- All existing notifications without
wrapcontinue to display with their 160×160 animated icons and 1-line scrolling text. - Stock charts, weather, clocks, and burn-in wipers remain 100% untouched.
- All existing notifications without
📦 Downloadable Assets
| File Name | Size | Target / Usage |
|---|---|---|
firmware_v3.12.0_public_release.bin |
~2.08 MB | Recommended for Web OTA update via browser (/update) |
firmware.factory_v3.12.0_public_release.bin |
~2.14 MB | For initial flashing or USB recovery via esptool.py (flashed to 0x0) |
🚀 How to Update (Easy OTA)
- Open your browser and go to your SmallTV's web interface:
http://<device-ip>/(orhttp://smalltv.local/). - Go to the System tab -> Update.
- Choose
firmware_v3.12.0_public_release.binand click Upload. - The device will flash, reboot in ~5 seconds, and preserve all your existing Wi-Fi, tickers, and settings.
Full Changelog: v3.11.3...v3.12.0