MustardOS 2601.0 Jacaranda

Current Release

Pronunciation

/ˌdʒækəˈrændə/

Download – Full Image

Please make sure that you have either migrated your data to SD2 or have used the Device Backup feature and copied your backup archive(s).

Additional Information

Themes are now stored as open folders instead of compressed archives (previously extracted to the active folder). This enables faster theme switching, alternate theme changes, and restores random theme selection on device start. Existing .muxthm theme files in MUOS/theme must be extracted manually.

Support MustardOS

Want to join us on this crazy and rewarding journey?

This can be done a few ways:

Take part in the Community Forum
Be helpful around the Discord Server
Contribute code directly to our GitHub Repositories
Spread the good word about MustardOS and all the amazing features

You can join the testing crew directly by:

Supporting XongleBongle via a Ko-fi Subscription
Boosting the Discord Server
Contributing major code pull requests on our GitHub Repositories
Showing exceptional values and building community rapport

Support Development Crew

We are a small team, and with your generous support we can continue growing and spreading that sweet MustardOS across other devices. If you can, support the development crew below:

AntiKk – https://buymeacoffee.com/antikk

Corey – https://ko-fi.com/cmclark00

Bitter Bizarro – https://ko-fi.com/bitterbizarro

Contributors

antikk
bitter_bizarro
duncanyoyo1
escal8tor
fashberg
imcokeman
nesreka
xonglebongle

Changes

Added inotify tracking for status files to reduce IO
Added inotify watch live messages and progress to reduce CPU usage
Added ability to set sorting levels for content
Added active hour and favourite day to global stats for activity tracker
Added activity tracker data archive to Task Toolkit
Added activity tracker information module
Added activity tracker toggle in advanced settings
Added activity tracker toggle in launch script
Added activity tracker toggle on device sleep and resume
Added additional colour filter profiles
Added additional directory and file checks
Added additional overlay options
Added additional RetroArch core names
Added advanced menu navigation option
Added alternative PICO-8 -Splore- file name detection
Added auto detect disc folders as content
Added back random theme option
Added background image support for scaled displays
Added basic joystick calibration tool
Added basic themeable logo screensaver support for frontend
Added battery offset value calculation to battery overlay
Added battery overlay glyph
Added bind map recording the real backing storage for each logical path
Added box art and counter to activity tracker
Added brightness and volume indicators to default MustardOS theme
Added brightness and volume step indicators
Added bulk indicator path returns with safe dimension
Added change support to inotify tracked changes
Added chrony binaries
Added Chrony time sync details to information module
Added collection and history launch failure message
Added colour adjustment glyphs to default theme
Added colour adjustment option to kiosk module
Added colour adjustment runners to overlay
Added colour filter archive support
Added colour filter glyphs to default theme
Added colour filter info message parsing
Added colour filter launch parsing
Added colour filter profiles to content options
Added colour filter with external filter file support
Added colour implementation to stage overlay
Added common build Makefile include to muX builder
Added common extracting theme and removing directory
Added common Syncthing termination function
Added community news module to information
Added complete halt register for revision devices
Added complete theme fallback to internal MustardOS theme
Added confirm deletion for collection and history items
Added confirm deletion for screenshots
Added confirm sound to sort module launch
Added content assignment information archive support
Added content assignment information to backup module
Added content width custom option
Added control scheme switch to all content
Added core name to overlay loader
Added creation of missing important directories on SD1 if mount fails
Added default active theme config setting
Added default colour adjustment variables
Added default overlay step images
Added default screensaver power config variable
Added default theme overlay indicators
Added define for path reset on screen cleanup
Added deletion of automatic core and governor flag files on launch and startup
Added deletion of language archive when successfully extracted
Added deletion of overlay disable file on content launch
Added detail view to activity tracker
Added directory check for colour filter assign
Added enum value for shared modules
Added extra code support to virtual terminal
Added extra network checks and failovers for blank/open networks
Added file change notifications for base overlay toggle
Added first init forced copy of control content
Added flag for updating bootlogo
Added font cache system for improved performance
Added friendlier names for core assignment labels
Added friendly name support to activity tracker
Added frontend and hotkey control combo function
Added global content colour adjustment settings
Added global live message display function
Added global mount points and purge markers for Archive Manager
Added global statistics to activity tracker
Added grid mode detection for fonts
Added hardware overlay disable for frontend modules
Added hardware overlay disable hotkey
Added HTML export for activity tracker
Added idle state check for TrimUI switch status
Added init script to reduce flashing of RGB LEDs on startup
Added label value width adjustment to shared functions
Added LOG fallback functions to prevent missing LOG warnings when debug is disabled
Added long power press sleep hotkey
Added low battery glyph overlay activation
Added max brightness variable to suspend resume
Added missing default visual fonts and sound font
Added mixed content option for content explore
Added muX idle timer display refresh
Added network status updates for frontend UI
Added option sound to content option remove config field
Added overlay bypass for PortMaster application
Added overlay disable file check
Added overlay kiosk option
Added overlay options to muX frontend
Added overlay staging preload to launch content scripts
Added percentage integer calculation for labels
Added play styles to activity tracker
Added preinstalled colour filters
Added previews default theme
Added RetroArch configuration removal to content options
Added RetroArch startup cache option
Added retry count to network advanced settings
Added reverse audio option to advanced settings
Added runtime scale and rotation methods to GLES and SDL overlay renderers
Added SDL and GL overlay stage injection module
Added SDL direct offset configurable support for themes
Added separate navigation sound volume setting
Added set navigation button on theme alternative
Added shared UI group creation and reset functions
Added sound volume setting and theme glyph
Added Splore application when extracting PICO-8 archive
Added stage overlay bypass variable
Added standard logo to shared media and screensaver glyph to default theme
Added static assets for calculated time values
Added support for multiple theme preview images
Added system time sync after network connection
Added system time validation check for download based frontend modules
Added theme manager module
Added theme scaling glyph to default theme
Added theme scaling option
Added threaded video toggle to content options
Added UI network lock back to network module
Added used attributes to force compiler to link
Added UUID generation on first install
Added verbose live message support to global functions
Added verification check for internal system script modifications
Added Wolfenstein 3D capsule launcher
Adjusted activity tracker HTML export data table colouring
Adjusted default anchor for brightness and volume
Adjusted default variables due to frontend changes
Adjusted default variables due to frontend changes
Adjusted internal timer actions and tasks
Adjusted status timer to reduce IO
Adjusted timers for date time and battery capacity
Disabled SDL debug logging reference
Enabled right-stick navigation for devices with right-stick
Ensure Pipewire audio is ready before frontend load
Ensure safe dimension returns
Ensure screensaver is only initialised after factory reset
Fixed LD_PRELOAD handling when unset
Fixed accessing community news with no network access kicking back to main menu
Fixed activity tracker map overflow
Fixed activity tracker on suspend
Fixed assignment picker confusing content index on manual assign
Fixed base overlay refreshing when disabled
Fixed battery offset value calculation
Fixed blank screen when setting scale to stretch
Fixed blank space in activity tracker for TUI devices without HDMI mode
Fixed brightness overlay loading on first content launch
Fixed button logic detecting global view
Fixed collection removal in kiosk restricted mode
Fixed colour temperature variable setting
Fixed community news glyphs and post show after download
Fixed confused save states for Doom content
Fixed content explorer duplicated focused group and index selection
Fixed content item index when returning from options menu
Fixed content names getting cut off
Fixed content option assigned labels
Fixed content scheme naming
Fixed core assignment previous index selection
Fixed core configuration removal
Fixed core display name for current assign value
Fixed current uptime and last resume integer calculation on suspend
Fixed deadlock with shuffle selection on small set of items
Fixed delayed display of theme preview image
Fixed ethernet connections
Fixed exiting theme downloader while extracting
Fixed false "out of space" errors caused by tmpfs free space checks on bind mounts
Fixed first navigation sound for network information
Fixed first navigation sound play for content explorer
Fixed focus check in customisation module movement
Fixed frontend restart function call
Fixed game controller selector
Fixed general setting offset when exiting advanced settings
Fixed general settings always saving regardless of no changes due to dpad toggle
Fixed general settings issue with visible item index
Fixed graphical overlap glitch due to opaque background with no image
Fixed grid mode content previous index focus
Fixed header glyph fallback
Fixed help lookup item mismatch
Fixed help messages on grid and carousel mode
Fixed hidden content variable
Fixed intermittent theme download issues
Fixed kiosk module language for colour options
Fixed last folder selection for Task Toolkit
Fixed left right navigation on network items when connecting
Fixed loading content description
Fixed logged message defines
Fixed long title overlap in content options
Fixed missing theme download option with no present themes
Fixed mixed folder and item content focus due to bucket changes
Fixed MPV support for TrimUI devices
Fixed network connect status timer
Fixed network module exit if currently connecting
Fixed option previous index selection
Fixed overlay brightness and volume percentage calculation
Fixed overlay image path loading priority
Fixed overlay indicator validation by reset on context change
Fixed page up and down navigation in content
Fixed PICO-8 Splore file generation
Fixed previous history item selection when history drop is enabled
Fixed progress bar glitches during theme extraction
Fixed progress bar updates
Fixed reboot and shutdown splash image refresh
Fixed saving of brightness and volume integers on set
Fixed screensaver interruption from active timers
Fixed SDL overlay refreshing on render context change
Fixed sorting by display name instead sort name
Fixed sorting when changing content tag
Fixed sorting with folders when mixed content disabled
Fixed subsequent sorting jumble on activity tracker
Fixed supporter credit launch
Fixed text scrolling for folders with single item
Fixed theme fallback
Fixed theme preview downloads
Fixed theme version compatibility testing
Fixed top launch integer value
Fixed top launch statistic for HTML export
Fixed TrimUI network modprobe
Fixed updating boot logo
Fixed various log messages to use LOG function
Fixed verbose text alpha overlapping text
General overlay code cleanup
Initialised right-stick navigation similar to left-stick navigation
Merged general panel update to shared function
Merged general refresh task to shared function
Merged general step movement to shared function
Merged multiple lines to defines to reduce DRY code
Merged option value changes to singular function
Merged panel UI adjustment into header and footer setup function
Modified brightness and volume setters on boot
Modified colour temperature configuration path
Modified config and device values to suit enum values
Modified default theme glyphs to suit changes to frontend
Modified extraction and backup logic to query free space on actual path
Modified friendly lookup to shared function
Modified frontend render blend modes
Modified general settings to hide volume when using Console Mode
Modified global script init with background functions
Modified help messages to use enum values
Modified launch script to remove overlay colour filter on quit
Modified low battery to 0-100 percentage values
Modified menu selection handlers to have action paths
Modified module initialisation to use inherent function name
Modified MPV launcher to keep fullscreen aspect ratio video
Modified network module initialisation script
Modified network script to run Chrony time sync
Modified network scripts to ensure device is down on reconnect
Modified RetroArch to hide base overlay on quick menu open
Modified sorting priority with maximum item count
Modified testing watermark to function quantifier
Modified timers to suspend and resume
Modified toast messages to force refresh on FOREVER status
Modified USB function variable to suit frontend changes
Moved "Cannot Delete Active Theme" message
Moved inotify code to global common structure
Moved archive creation away from tmpfs
Moved common core functions and structure to own directory
Moved common font functions to own structure
Moved content to base for main overlay
Moved friendly name resolver to shared function
Moved from full screen refresh to conditional refresh
Moved grid mode specific fonts to grid font folder
Moved hidden network SSID to better name variable
Moved previous brightness and volume settings to integer value
Moved stage overlay system to opt-in
Moved system init scripts to muOS internal path
Moved theme extraction to UI refresh function
Moved themes away from compressed archives
Moved USB function to integer value
Optimised bind mount script
Optimised frontend loader script with predefined variables
Optimised hotkey script functions
Optimised launch script with predefined variables
Optimised muX frontend functions for module refresh and dispatch
Optimised muX frontend with cached render state
Optimised play style calculations
Optimised startup script to use individual background tasks
Refactor sorting priority to read custom tags
Refactored active theme loading
Refactored applying theme alternates
Remove auto size from activity tracker
Removed MUOS_old movement as it is no longer required
Removed nice process priority
Removed audio and brightness file locking
Removed concurrent logged messages on content launch
Removed FNV-1a hash calculation of default theme
Removed idle state file when not in idle mode
Removed message output for audio mixer reset
Removed NTP from Web Services
Removed preinstalled theme archives
Removed reliance on toybox sleep with updated system
Removed unused frontend functions
Removed unused variables in suspend script
Renamed reset alert images
Replaced buffered line calculation to simple division of 4
Replaced NTP service runner with Chrony
Simplified application initialisation function
Split base overlay structure to own overlay files
Split last and resume game routine to separate script
Split overlay staging system to individual files
Switched application and content options to use X button
Switched back to disp0 to ensure internal controller changes LCD display
Switched to archive copy on factory reset
Updated activity tracker language
Updated additional sleep hotkeys
Updated battery overlay to use step images
Updated bind mount and extraction system
Updated bind mount script to global ignore SD2 if not mounted
Updated Chrony configuration and burst update on network connect
Updated Chrony initialisation script to correct H700 RTC data point
Updated community news module to obtain dynamic threads and posts
Updated configuration loader to create default value files if missing
Updated corrected glyph name for default theme
Updated default charge boot logo change routine
Updated default theme version
Updated default theme with community news glyphs
Updated default year to 2026
Updated device tree information
Updated entropy initialisation
Updated extract script to extract theme
Updated H700 boot packages
Updated header glyphs for 1280x720 resolution
Updated HTML export with data table support
Updated language fields to match content
Updated long integer values to percentage calculations
Updated message delivery module with modified inotify changes
Updated Prboom launch script to load from central .WAD directory
Updated preinstalled colour filter profiles
Updated preinstalled default themes
Updated preinstalled themes to accept minimum theme compatibility version
Updated RetroArch cores
Updated ScummVM to 2026.1.0
Updated theme downloader to extract theme
Updated theme fallback routine
Updated TrimUI RetroArch binary
Updated UnionFS binaries
Updated virtual terminal to cache font glyphs