NX-Shell Switch

NX-Shell
General
Author	joel16
Type	File Browsers
Version	4.01
License	MIT License
Last Updated	2022/08/08
Links
Download
Website
Source
Support Author

NX Shell is a multi-purpose file manager for the Nintendo Switch that aims towards handling various file types while keeping the basic necessities of a standard file manager.

Initially, the project was inspired by LineageOS/CyanogenMod's file manager for android, and even had a similar design approach to that of the famous Android file manager. However, it has been re-written from scratch, now using more up to date tools and libraries.

NX Shell was presented in the GBAtemp Switch Homebrew Bounty 2018 (Switch application, 1st place).

Features

• Delete files and folders.
• Copy/Move files and folders.
• Rename files and folders (standard switch keyboard).
• Create files and folders (standard switch keyboard).
• Displays file properties such as size, time created, modified and accessed.
• Sorting options (Sort by name, date, size).
• Display various images formats (BMP, GIF, JPG/JPEG, PGM, PPM, PNG, PSD, TGA and WEBP).
• Browse devices such as safe, user, system and USB.

Screenshots

Known issues

https://github.com/joel16/NX-Shell/issues

Changelog

v4.01 2022/08/08

• Fixed rename bug introduced in v4.00.
• Added option to disable extended font support. (Initially disabled by default -- this boosts the application start up speed).
• After USB is unmounted via settings the device state will now be properly switch back to sdmc.

v4.0.0 2022/08/06

• FS:
  • Added support for browsing USB devices.
  • Switched back to libc to handle FS operations.
  • Brought back support for browsing other devices such as safe, user and system.
• GUI:
  • Update to imGui v1.88.
  • Switch to imGui's new keyEvent API.
  • The two views (File Browser and Settings) can now be navigated as tabs.
  • Switched from list view to a table view using imGui's table API.
  • Sorting is no longer applied from settings, it can be done directly by clicking on the table column headers.
  • A new selector has been added to allow the user to switch to different devices such as safe, user, USB etc.
  • Settings are no longer categorized by imGui's tree system.
  • No longer uses SDL2 as a backend, but instead uses opengl v3 directly (along with egl).
• Fixes:
  • Properly delete config file if the config file version is outdated.
  • Properly free textures after exiting application.
  • Fixed scrolling via the right joystick after zooming into an image.
  • Lots of code clean up and under the hood changes that are too many to list here.

v3.2.0 202/09/07

• Added support for extracting .ZIP archives.
• Fixed crashes when trying to exit the application after opening an image.
• Now uses Use libnsbmp to decode BMP files. (This fixes issues loading certain BMP files).
• Disabled window padding when displaying images so that the full screen images (1280x720) aren't bound to a scroll bar.
• Added a popup for viewing image properties such as filename, width and height. (Use the 'X' button to open this popup after opening an image).
• Added an option under settings to toggle filename display when viewing images.
• Added an option under settings to toggle logs. (Any failed FS functions will be logged if this option is enabled. *Useful for debugging purposes). A restart of the application is required if this is enabled/disabled.
• Initial implementation of a text reader for reading logs/configs (eventually to evolve into to an editor).
• Many other under the hood changes/cleanups and consistency changes.

v3.1.0 2020/08/25

• Fixed crash when last open directory is a TitleID.
• A storage bar is displayed below the current working directory indicator. (Based on the current active file system)
• NX-Shell can now open various images formats (BMP, GIF, JPG/JPEG, PGM, PPM, PNG, PSD, TGA and WEBP).
• A progress bar will be displayed when files are being copied.
• Added checkboxes to select multiple files for copying/moving and deleting. (Only works if you're working from one directory).
  • Added an option to select all checkboxes in a directory.
  • Added an option to clear all selected files in a directory (Note this also clears the copy/move path in the clipboard).
• Minor UI adjustments. (Alignment fixes, popups/windows being out of place, better spacing between buttons, etc.)
• Now based on Dear ImGui v1.7.8.
• Disabled Dear ImGui's inifilename config.
• Further improvements to overall system stability and other minor adjustments have been made to enhance the user experience. (No but really though, there have been many under the hood changes, clean-ups and improvements).

v3.01 2020/04/21

• Please delete the imgui.ini file before running this version, it will be regenerated with the accurate window size. This should fix the weird window issue introduced in the last release.
• This build is currently in beta to gather feedback and improve the current codebase. A lot of NX-Shell's old features and functionalities are missing in this version. Some features may be deprecated entirely, and new ones may be introduced.

v3.00 2020/04/15

• This build is currently in beta to gather feedback and improve the current codebase. A lot of NX-Shell's old features and functionalities are missing in this version. Some features may be deprecated entirely, and new ones may be introduced.

v2.11 2019/10/01

• This is a hot fix for v2.10 which resulted in issues with file deleting, copy/move etc. This also addresses the system version 9.00 fix.
• Fix FS logic which resulted in files not being deleted, copied or moved.
• Display a message when deleting a file until it has been removed. (A progress bar is shown for deleting multiple files).

v2.10 2019/09/30

• Please note: The ebook reading feature has been removed, for more information look here. This is a minor release only updated for the urgent system version 9.00+ fix.
• Fix for system version v9.00+.
• Cleaned up audio decoder functions and updated dr_libs (flac/wav decoders).
• Only log data if developer options are enabled.
• Cleaned up FS functions and fix read/write for libnx v2.3.0.
• Removed some unused textures and unnecessary scaling.
• Conserve zoom and rotation when navigating images (Vuelos).
• Disable sleep for FTP mode, some FS functions (Cut/Copy) and in audio player.
• Close the menu-bar when a device is selected.
• Handle mounting other devices better (No more redundant functions calls).
• Fix cancel button not reverting option menu in the second page.
• Remove many redundant calls, and overall code clean up.

v2.00 2019/07/05

• Please note: The ebook reading feature has been removed, for more information look here.
• Updated SDL_FontCache as well as SDL2 to latest revisions available.
• Major music player changes:
  • Added support for the following formats: IT, FLAC, MOD, OPUS, S3M and XM.
  • All audio files now display timestamps (current and duration) as well as a progress bar.
  • All audio formats display metadata (album, artist, title, etc) if found. Formats such as MP3, FLAC, OPUS will display a cover image if found.
  • All audio formats are seekable via the touch screen. Simply drag your finger across the progress bar to select a location to seek to.
• Implemented libarchive support:
  • Allows for the extraction of .7z, AR, ISO 9660, RAR, ZIP, AR, XAR as well as some other formats supported by libarchive.
  • Display a dialog asking for the user's confirmation before extracting an archive since some can take a while.
• Remove usbComm service initialization which wasn't used and caused a crash on FW 7.0X+.
• Properly make use of transparency when displaying dialogs, progress bars, and the menu bar.
• Added support for viewing .webp images.
• Default to 'No' for file deletion.
• Cleanup fake heap when setting a custom heap which caused RetroArch to crash if it was opened after closing NX-Shell.
• Display a simple error dialog for failed file system functions (an error code as well as the function that failed would be displayed).
• Fixed use of blend mode under SDL2 which caused transparency issues in some cases.

v1.20 2019/01/19

• Now uses official software keyboard with text validation for creating/renaming folders and files.
• Refactored FS code to support copying to/from other mount points (copying files now uses internal fs functions).
• Properly get free/max storage for each partition using FS rather than NS.
• Fixed progress bar from incorrectly blending into the background.
• Update SDL_FontCache to v0.10 and revert back to using the Roboto font - which now properly displays accented characters such as é.
• Display MP3 id3v2 cover art image if found.

Release notes.

Credits

• Preetisketch for the banner.
• Dear ImGui developers and contributors for the GUI.
• devkitPro maintainers and contributors for libnx, devkitA64, and many other packages used by this project.
• DarkMatterCore for libusbhsfs.

External links

• GitHub - https://github.com/joel16/NX-Shell
• GBAtemp - https://gbatemp.net/threads/nx-shell-multipurpose-file-manager-for-nintendo-switch.505332/