Repository navigation
Jcorp Nomad Mk2
Backfilled tag. This is the last state of main before Mk3 work started. The firmware rewrite that became Mk3 landed on 2026-04-02, so this is cut at the commit before it.
- Commit:
b8373fc(2026-02-23) - Firmware Version 3.x
- The bundled Arduino libraries were dropped from the repo during Mk2, so this source archive does not build on its own. Library versions were not pinned in the README until Mk4.
LATEST UPDATE
Major Highlights:
- Plyr Integration: Replaced native browser video elements with the Plyr library. This ensures a uniform UI across all devices and fixes playback issues specifically on Apple hardware.
- Theme Customization: Added a new Theme Control Panel to the Admin Console. It includes 15 preset themes and a customizer for manual color adjustments.
- Music Overhaul & Queue: Music now plays seamlessly across the Songs, Playlists, and Queue pages without interruption. The new Queue feature allows you to add tracks from any music page and reorder or delete them on the fly.
- Books & Comics: The PDF viewer is now split into its own page for better performance. EPUB support has been cleaned up and is now fully functional. The Comic Reader now supports Webtoon infinite scroll and standard reading modes.
- Comic Formatting: To use the comic reader, rename a
.cbzfile to.zip, unzip it, and place the resulting folder (containing the images) into/Books. The system will automatically identify it as a comic.
Default Themes:
Default Blue, Forest Night, Cherry Blossom, Mocha Latte, Ocean Depths, Autumn Leaves, Lavender Fields, Sunset Horizon, Coral Reef, Mountain Mist, Jade Garden, Desert Sand, Arctic Aurora, DeLorean, Midnight Code.
Stability & Features Update
Nomad is now stable on the main branch with several new features and improvements.
Notable Updates:
- EPUB support: works, though formatting is rough.
- Audiobooks: MP3 format with basic resume tracking; minor bugs may occur.
- CBZ support: experimental; files may load slowly.
Key Improvements
-
Faster & More Reliable Indexing
- Non-blocking, background indexing for large libraries.
- Safe on power loss; partial indexes remain intact.
- Auto-updates changes; frontend detects updates automatically.
-
Resume Functionality
- Movies and Shows track playback progress.
- Options for Play from Start or Resume.
- Menu displays last three movies/shows; mobile shows most recent.
-
Dark Mode
- Toggleable across all pages from the menu.
- Minor visual bugs may exist depending on browser.
-
Admin Page
- Full device control: shutdown, restart, flash mode, Wi-Fi, RGB LEDs, brightness, credentials, indexing, and file management.
- Safe shutdown option for SD card health.
- Real-time system console feedback.
-
Stability Improvements
- Fixed frontend NDJSON sync issues.
- Crash recovery on large indexes.
- Dynamic LCD brightness adjustment.
- Streaming stability enhancements.
-
Improved Library Support
- Supports deeper folder structures for Shows and Music.
- Flexible organization; media files can be nested at any level.
All commits in this release
- Mk2 Update!!! (
13e9d1c) - Mk2 Update (beta) (
79ed4d9) - Mk2 Update (beta) (
fb78e68) - Setup TIp (
a9b60a3) - Note on Bug Fixes (
4e3c5ba) - Stablish Version (
67ff391) - Major Polish/Stability 1 (
a53fe47) - Fixed Stream Activity handler (
bfd9fe9) - Fixed Display Issues (
c9014f1) - Improve folder card styles and logic, fix broken display (
9f1a54c) - Updated to play nice with filebrowser when adding subdirectories (
4237823) - Updated to function better with subdirectories and folders > improved uploads (
c634973) - Redirect Music/Shows paths and update index handling (
5373a87) - Added Version Tracker (
4db0a00) - Added Version Tracker (
847310a) - Ver3.1 Updated Indexing to be more stable, fixed SD scan system to not crash (
7c26f02) - Updated the broken display name for media files (
edbd1d6) - Additional Libraries for Books.html (
157f210) - Added Versioning (
904ecbb) - Fixed File Display Issue, Theming, And Download Handling (
a4ed6c0) - Fixed Download error and Tweaked styles (
776a7ed) - Improve Hash Catches for Seasons, Fixed Downloads (
f8862f0) - Disabled ZIM Scan, Fixed Hash Sends, Improved Search Indexing (
30e513c) - Minor Visual Changes (
f219605) - Update auto-generate logic and alert messages (
ad9f0bb) - Fixed Resume Display, Seperated Search and Resume warm function (
b360eef) - Wifi Password Length Requirment for Captive Portal Stability (
d857156) - Update WiFi password length requirement to 8 characters (
6aa4f46) - Fixed Wifi hosting two networks on SSID Change. (
2b9ba20) - new cover image (
f23bf7d) - New Cover Image (
9409e49) - Update for new features (
6495313) - Improved Filebrowser, Added more logging (
32c319b) - Updated Apearance / minor handling changes (
9ecff95) - Fixed SD corrupting error and improved file functions. (
7684fd2) - Update footer version and improve stall watcher (
0ca6f63) - Hash Routing change, removed footer (
59b2045) - Remove upload button and footer from gallery (
55f9149) - remove footer (
14a1dc5) - remove footer (
37d42d4) - audio state restoration with internal playlists and music page (
84e6e72) - audio state restoration with playlist.html (
294eda0) - Remove Items from resume section (
f2567a1) - Fixed SD card Read error (
a4a7735) - Fixed PDF Download Bug (
93e1619) - Fixed Download Bug (
4dd5ff1) - Merge pull request #105 from Jstudner/main (
21b7977) - Add PLYR Library (
3ac8d8b) - Refactor video player to use Plyr library (
773c547) - Integrate Plyr for video playback (
64c05c1) - Update book row and folder icon styles (
12d3c20) - Refactor comic display styles and loading logic (
2bda150) - Added new book pages (PDF and EPUB isolated) (
b86d596) - Enhance UI and add queue management features (
feaa0a7) - Refactor playlist.html with UI updates and queue features (
019388d) - New Page for Music Queue (
354eacc) - Feature Overhaul and Cleanup (
4eae073) - Update README with latest features and improvements (
b8373fc)