Skip to main content
swanshell documentation
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Changelog

swanshell 1.2.4 (19th July 2026)

  • Fixed: Worked around some cases of EEPROM save corruption.
  • Added: In the USB shell, ls now supports -l and -s arguments.
  • Changed: Updated translations: German (Generic), Spanish (Jurek), Japanese, etc. (bigmoonur).
  • Fixed: Remaining known issues in the RTC clock editor menu.
  • Fixed: Text glitches when using the USB shell upload command.

swanshell 1.2.3 (21st June 2026)

  • Fixed: Restored old cartridge image launch code. This solves an SRAM save regression introduced in swanshell 1.2.0.
  • Added: Factory reset settings option.
  • Changed: Cleaned up settings layout.
  • Changed: General performance improvements.
  • Changed: Slightly larger file icons in “Large list” mode.
  • Changed: The USB shell now relies on single and double quotes.
  • Fixed: Backspace not working correctly via the USB shell on some terminals.
  • Fixed: File selector top bar not showing the end of the current directory path for long paths.
  • Fixed: Further MCU communication instability problems.
  • Fixed: LCD display not initializing when loading non-PCv2 programs on PCv2.
  • Fixed: Reset on new storage card insert occuring too quickly.
  • Fixed: The Japanese language using small fonts for dialog descriptions.
  • Fixed: Text in dialogs not being centered correctly in some cases.

swanshell 1.2.1 (14th June 2026)

  • Added: Option to verify save data as it is written to the storage card.
  • Fixed: Loading cartridge images not working on FAT12 partitions.
  • Fixed: Status icon drawing glitches during/after opening .bmp file.
  • Fixed: Visual glitches when auto-rotating the screen within the settings menu.

swanshell 1.2.0 (31st May 2026)

  • Added: Vertical display orientation support.
    • By default, orientation is changed automatically by rotating the console at an angle. A horizontal or vertical display lock can be toggled in the settings.
    • For the time being, a few screens do not currently support the vertical display and will automatically revert to a horizontal display.
  • Added: New USB shell command: date - allows getting/setting RTC time.
  • Changed: Reworked cartridge image launch code for (hopefully) slightly higher internal RAM initialization accuracy.
  • Changed: Slightly larger .txt, .vgm files and XMODEM transfers are now supported.
  • Changed: Updated translations: German (Generic), Spanish (Aitor Ramajo Olazabal), Japanese, etc. (bigmoonur).
  • Fixed: Corrupt GD3 metadata display in .vgm music player UI.
  • Fixed: Error when trying to load Gzip-compressed files containing original filename information.
  • Fixed: Incorrect key prompts in PCv2 mode.
  • Fixed: Missing error messages for some cartridge image loading errors.

swanshell 1.1.7 (10th May 2026)

  • Fixed: PCv2 input layout mapping.

swanshell 1.1.6 (2nd May 2026)

  • Minor reliability improvements.

swanshell 1.1.5 (20th April 2026)

  • Fixed: Software launching regression on “mono” consoles.

swanshell 1.1.4 (29th March 2026)

  • Added: Japanese translation. (bigmoonur)
  • Added: Uxn virtual machine plugin.
  • Changed: Improved German translation. (Generic)
  • Changed: Improved Chinese (Simplified) translation. (bigmoonur, PECO)
  • Fixed: Startup state inconsistency for Color programs.
  • Fixed: Various RTC date/time settings menu issues.

swanshell 1.1.3 (20th March 2026)

  • Added: Option to erase a file’s related save data.
  • Fixed: Issue with new SRAM save file initialization.
  • Fixed: Issue with timer initialization when loading programs.

swanshell 1.1.2 (19th March 2026)

  • Added: New USB shell commands: cat, echo, pwd.
  • Added: Option to scroll long file names in the file selector. (WIP)
  • Fixed: Regression in swanshell 1.1.0 which led to slower XMODEM transfer start times.
  • Fixed: RTC date/time settings menu occasionally reading corrupt information.

swanshell 1.1.1 (4th March 2026)

  • Changed: Ctrl+C in the USB shell now activates interactive mode.
  • Changed: Updated Chinese (Simplified) translation. (PECO)
  • Fixed: Regression in EEPROM mode initialization.

swanshell 1.1.0 (4th March 2026)

  • Added: Enhanced system information menu.
  • Added: Enhanced USB shell:
    • New commands: cd, download, help, ls, mkdir, reboot, rm, upload.
    • The Ctrl+C keybind is now supported.
    • The launch command now accepts an optional path.
  • Added: On firmware 1.1.0, missing/low battery warnings.
  • Added: Saving /ram0 contents when loading .fx programs directly.
  • Added: Status icons - the cartridge’s status is now communicated visually in the bottom right corner.
  • Added: The option to hide save files.
  • Changed: On firmware 1.1.0+, inserting a removed storage card will trigger a cartridge reboot.
  • Changed: Slightly improved battery draw in the menu when no USB cable is connected.
  • Changed: Text viewer improvements:
    • Minor performance improvements.
    • The text viewer now shows an approximate percentage position in the file being read.
    • The text viewer now supports going back in a file.
    • The text viewer now supports both Shift-JIS and UTF-8 encoded files, with automatic detection.
  • Changed: Tweaked visual padding for pop-up dialogs.
  • Fixed: Certain memory initialization issues when launching a program.
  • Fixed: Reliability problems when using XMODEM file transfers within the USB shell.
  • Other minor improvements.

swanshell 1.0.4 (23rd February 2026)

  • Changed: A warning is now displayed for overdumped save data.
  • Fixed: A soft reset patch was incorrectly applied to certain cartridge images.

swanshell 1.0.3 (23rd February 2026)

  • Changed: Minor translation updates.
  • Fixed: Some cartridge images were incorrectly detected as containing on-board NOR flash.
  • Fixed: The text viewer should now correctly read files over 64 KiB.

swanshell 1.0.2 (14th February 2026)

  • Added: Input repeat delay and rate configuration.
  • Added: New translations:
    • Chinese (Simplified) (PECO)
  • Added: Simple text viewer.
  • Added: Support for Chinese and partial support for Korean characters.
  • Changed: On a new installation, the user is automatically prompted for their preferred language.
  • Changed: Question marks are now used for characters without a matching glyph in the font.
  • Changed: The display fonts are now stored in separate files.
  • Fixed: The “Hide icons” option not saving or loading correctly.
  • Minor performance and reliability improvements.

swanshell 1.0.1 (7th February 2026)

  • Added: New translations:
    • German (Generic)
    • French (zeroballoons)
    • Spanish (Fossil)
  • Changed: The file selector now remembers its position in the list after deleting a file.
  • Minor performance and reliability improvements.

swanshell 1.0.0 (3rd January 2026)

  • Initial release.