A collection of small scripts for looking after your device. They clear and restore files, mount and eject storage, switch layouts and write diagnostic reports for the MustardOS crew. You can also write your own.
Open itGo to Applications > Task Toolkit. Folders hold related tasks.
Read firstPress Menu on a task to read what it does before you run it.
Run itPress A. Most tasks show their progress on screen and say when they are done.
How tasks run
ProgressThe task runs while a progress screen shows what it is doing, then reports that it finished or what went wrong.
PromptLike Progress, but the task can stop and ask you a question before it carries on.
TerminalThe task opens a terminal and shows its output as text. Used for tests that print a lot as they run.
CancelSome tasks can be stopped part way with B. Tasks that would leave things half done, such as restores, cannot be stopped.
Reports from the Diagnostics tasks are saved to MUOS/log/diagnostics on SD1. Attach the report when asking for help on Discord or the forum.
What each task does
Main Toolkit
Dot and Junk File CleanupRemoves junk left behind by other computers, such as macOS dot files and Windows System Volume Information folders, from SD1, SD2 and USB storage.Progress
Export Collection to HTMLWrites your collections, with box art where it is found, to a collection.html page at the root of SD1. The active theme can supply its own page layout.Progress
Refresh Automatic Core AssignRebuilds the automatic core assignments for recognised folder names, which helps after adding folders or updating the core manifests.Progress
Refresh BootlogoRebuilds the boot logo and charging image from your chosen boot logo or the active theme.Progress
Replay Tour IntroductionShow the introduction on every menu again, as it appeared the first time you used the device.Progress
System DiagnosticsCreates a ZIP file on SD1 with logs and system details to send to the MustardOS crew when asking for help.Progress
Clear Tasks
Clear Activity DataArchives your Activity Tracker records and starts a fresh set, keeping the old ones in a backup.Progress
Clear Catalogue - EverythingRemoves the whole catalogue of artwork and text and builds a clean, empty one.Progress
Clear Catalogue - Folder OnlyRemoves only the folder artwork in the catalogue, leaving content artwork alone.Progress
Clear CollectionsRemoves every collection and the shortcuts inside them. Your content is not touched.Progress
Clear Content AssignmentsRemoves the core and governor assignments you have made, so content goes back to its defaults.Progress
Clear HistoryRemoves every entry from History. Your content is not touched.Progress
Clear Network ProfilesRemoves all saved Wi-Fi network profiles.Progress
Diagnostics
Audio ReportChecks sound cards, mixer levels, PipeWire and the selected output, then saves a report to SD1Progress
Battery Gauge RepairResets a fuel gauge stuck at the wrong level using the battery voltage, then restarts. Unplug the charger firstPromptCan cancel
Battery ReportChecks the battery, charger and fuel gauge, then saves a report to SD1 for the MustardOS crewProgress
Bluetooth ReportChecks the Bluetooth adapter, service and paired devices, then saves a report to SD1Progress
Boot and Services ReportChecks boot health, safe mode, background services and recent errors, then saves a report to SD1Progress
Display ReportChecks the panel, framebuffer, backlight, HDMI and screen settings, then saves a report to SD1Progress
Input Event TestShows every button and stick event for 20 seconds so you can check each control worksTerminal
Input ReportLists controllers, buttons and input services, then saves a report to SD1Progress
Network ReportChecks Wi-Fi, addresses, routing, DNS, internet access and the clock, then saves a report to SD1Progress
Storage ReportChecks SD cards and USB storage, free space, file system errors and read speed, then saves a report to SD1Progress
Thermal and CPU ReportChecks temperatures, CPU and GPU clocks, memory and the busiest processes, then saves a report to SD1Progress
Grid Mode Toggles
Toggle Grid Mode ApplicationsSwitches the Applications screen between a list and a grid.Progress
Toggle Grid Mode CollectionsSwitches Collections between a list and a grid.Progress
Toggle Grid Mode Content ExplorerSwitches Explore Content between a list and a grid.Progress
Toggle Grid Mode HistorySwitches History between a list and a grid.Progress
Toggle Grid Mode Main MenuSwitches the Main Menu between a list and a grid.Progress
Migration Tasks
Import RetroArch Saves to PicklesCopies your RetroArch save games into Pickles, along with save states when you choose them and the content and core match. Existing Pickles saves are never replaced and the RetroArch files are left where they are.Progress
Network Tasks
Enable Wi-Fi (8188eu)Enable Wi-Fi using an 8188eu chipset USB adapterProgress
Toggle EthernetTurns a USB Ethernet adapter on or off.Progress
Restore Tasks
Restore Background MusicRestore the default MustardOS background musicProgress
Restore DraStic ConfigurationRestore the default DraStic settings and hotkeys.Progress
Restore Friendly Name FilesRestore the default friendly name filesProgress
Restore HotkeysRestore the default MustardOS hotkeys.Progress
Restore Network ConfigurationPuts the default network configuration back, which helps when Wi-Fi will not connect after manual changes.Progress
Restore PPSSPP ConfigurationRestore the default PPSSPP-SA settings and hotkeys.Progress
Restore PortMasterReinstalls the bundled PortMaster application.Progress
Restore RetroArch ConfigurationRestore the default RetroArch global settings and hotkeys (retroarch.cfg). Per-system core overrides will not be modified.Progress
Restore RetroArch OverridesRestore the default RetroArch overridesProgress
Restore ThemesRestore the default MustardOS themes and theme overridesProgress
Restore YabaSanshiro ConfigurationRestore the default YabaSanshiro Controls.Progress
Storage Tasks
Eject Secondary StorageWill attempt to eject any secondary storage that has been configured by the systemProgress
Eject USB External StorageWill attempt to eject any external USB storage that has been configured by the systemProgress
Mount Secondary StorageWill attempt to mount any secondary storage that has been configured by the systemProgress
Mount USB External StorageWill attempt to mount any USB external storage that has been configured by the systemProgress
Syncthing Tasks
Manual Syncthing ScanAsks Syncthing to look for changed files straight away.Progress
Toggle Syncthing Auto-ScanTurns automatic Syncthing scanning on or off.Progress
Make your own
Tasks are ordinary shell scripts, so you can add your own to the toolkit. A task can show progress, ask questions and report errors on the device screen with a handful of functions.