Sunshell 3DS

From GameBrew

Last Updated2016/02/07
TypeOperating systems

Sunshell is a multifunction shell for 3DS, inspired by Ahman's work on irShell for PSP.

This homebrew is coded in C and Lua, with the scripts run under lpp-3ds (Lua Player Plus 3DS) which provides a modules system for developers to easily add their homebrews (both C and Lua homebrews) to Sunshell modules, so their applications will be shown in Sunshell Main Menu. Final goal for this homebrew is to provide an universal alternative menu for 3DS.

Note: The project is deprecated and does not run on later firmwares (not incompatible with B9S).


Contains CIA, 3DSX and 3DS builds (use either one).

  • 3DSX - Copy .3dsx and .smdh to the /3ds/Sunshell/ folder on your SD card, launch with Homebrew Launcher.
  • CIA - Copy .cia to your SD card and install with CIA manager of your choice.
  • 3DS - Copy .3ds to your SD card.


  • Copy config.sun file from Common Files folder to the root of your SD card.
  • Open config.sun file with a Text Editor and set your preferred main_dir (default as /3ds/Sunshell for 3DSX).
  • Copy folders from Common Files to your main_dir.
  • Copy sun_index.lua file from Common Files to the same directory of your build executable (SD root for 3DS/CIA).

For video, music and photos:

  • Video files must be put in VIDEO folder.
  • Music files must be put in MUSIC folder (support subfolders as Music categorization system).
  • Photos must be put in DCIM folder (support also subfolders).

User guide


Sunshell contains the following pre-installed modules.

Video player Supports JPGV and BMPV.
Music player Supports WAV, OGG and AIFF.
Photo viewer Supports JPG, BMP and PNG.
Filebrowser With lots of features.
Console Info Displays info about your 3DS (Model, Kernel and System Version, Mac Address, etc).
Mail A mail sender application.
Calc Scientific/developers calculator like Windows ones.
CIA Manager A CIA manager.
Applications A 3DSX, imported CIA, Game Cartridge launcher.
Clock Cronometer, Countdown and Alarm clock utility.
FTP Server FTP Server utility.
Extdata Manager An extdata dumper/restorer.
Themes Manager Customize Sunshell with your themes.

Add homebrews to Sunshell

Since Sunshell runs under lpp-3ds, you can use Lua homebrews as pre-installed homebrews reducing the filesize of these homebrews by deleting the 3DSX/CIA/3DS executable.

To do this, create a folder in apps folder named as the Homebrew name and place all the homebrew contents inside it. At the end, create a data.lua file with these information inside:

app_desc = "Description of the homebrew"
app_author = "Homebrew author"

Some of the 3DS Lua homebrews can be found from the Homebrew Showcase list.


Start - Exit Sunshell

L - Take Screenshot


sunshell3.png sunshell4.png


SunShell en 3ds (Kronos2308)

Known issues

Random flickering screens on 3DS/CIA build. Don't know why it happens. Also Calc Module is probably very bugged.



  • Solved flickering issues for 3DS/CIA builds and NH2 build.
  • Added Username and Birthday info in Console Info module.
  • Now both screens can be powered off during audio reproduction in Music module to save battery (Ninjhax 1/CFs).
  • Now bottom screen can be powered off during videos reproduction in Video module to save battery (Ninjhax 1/CFs).
  • Now an error occur if you try to open Music module with MUSIC folder empty.
  • Now Console Info correctly shows Firmware and Kernel builds.
  • Now Ninjhax 2 users cannot access to incompatible modules (like FTP Server).
  • Now Console Info correctly identify Ninjhax 2 build.
  • Removed old pre-build CHMM homebrew.
  • Solved some audio disturb effects during JPGV videos with Vorbis audiocodec and OGG audio files playback.
  • Huge speedup for the entire homebrew.
  • Solved a bug in Main Menu which could cause icon selector to point to a null icon.
  • Now Wifi status is correctly recognized (Low connection = 1 bar, Medium connection = 2 bars, Good connection = 3 bars).
  • Added possibility to transfer files between SD cards with Filebrowser (Only Ninjhax users) [Filesize must be 20 MB or lower].
  • Solved random freezing issues with non Stereo Vorbis video files.
  • Solved issue which cause titles parsing losing if you switch between modes in CIA Manager module.
  • Solved issue which cause titles parsing losing if an uninstallation is triggered in CIA Manager module.
  • Bugfix for screenshots, now bottom screen space borders (left/right) are always black.
  • Bugfix for Free Space detection in Console Info module. Now is correctly recognized.
  • Bugfix for IP Address detection in Console Info module. Now is correctly recognized.
  • Added 3D support for JPGV videos playback.


  • Added TTF Viewer to available softwares in Filebrowser Module.
  • Added support for OGG metadatas extraction (Title and Author).
  • Updated titles database for parsing feature.
  • Now statusbar on Video module updates its status in realtime and not by percentage changes.
  • Solved a bug in Extdata Module which causes crash if you open a file, exit module and re-enter it.
  • Solved random "error reading file" crashes bug.
  • Added icon on topbar when WiFi is off.
  • Added background icon system support to Clock module.
  • Solved Calc module issue which prevents you to append decimals to zero.
  • Solved Calc module issue which prevents you to append zeros as decimals.
  • Solved Calc module issue which causes crash if you try to delete a one-digit number.
  • Solved Calc module issue which causes crash if you click equal button before doing any operation.
  • Added Theme Manager module to apply Sunshell themes.
  • Solved screen flickering issue with errors and warnings.
  • Added CIA importing support to Filebrowser for 3DSX build.
  • Added imported CIA support to Applications for 3DSX build.
  • Added CIA Manager access to 3DSX build.
  • Added sound support to 3DSX build for N3DS users.
  • Added "Song" Cycle Mode in Music module to loop a single song.
  • Solved noise and overlap issues with big duration OGG files.
  • Solved random crashes issue with music playback.
  • Solved wrong audio end (with overlap) for OGG files.
  • Added Vorbis audiocodec support for JPGV videos in Filebrowser and Videos.
  • Solved stuttering issues if an OGG file is playing.
  • Solved random flickering screen issue with font usage.
  • Made controls triggering more reactive in Music module.
  • Now font printing will be used also in Extdata Manager, Filebrowser, Calc, Mail, FTP Server and Photo modules.
  • Changed default font with a more complete ones.
  • Now currently played song will be printed in blue in file list in Music module.
  • Solved wrong "&" char blending in Applications module.


  • Solved bad RAM managing by Applications module.
  • Solved bad RAM managing by Video module.
  • Little framerate speedup for JPGV videos.
  • Solved stuttering issue with Music module.
  • Solved stuttering issue with JPGV video files.
  • Enabled CIA files support on Filebrowser for .3DS build.
  • Improved CIA detection for .3DS build for Applications.
  • Enabled CIA Manager access for .3DS build.
  • Enabled sound support for .3DS build (Clock, Videos, Musics, Filebrowser).
  • Added possibility to hide bottom screen during video playback (could improve playback framerate).
  • Added background working modules icon showing on Sunshell topbar.
  • Improved customization level and shell graphics by adding TTF fonts usage for texts.
  • Solved a bug with 3DSX Launcher of Filebrowser module.
  • Added Game titles parsing in CIA Manager module.
  • Chronometer now is correctly named.
  • Added headset triggering for Music module autostart/autopause.
  • Solved an incompatibility bug between Musics and Photos modules.
  • Solved an incompatibility bug between Videos and Photos modules.
  • Solved an incompatibility bug between Musics and Videos modules.
  • Added OGG musics support to Musics Module and Filebrowser Module.
  • Updated Game Titles List.
  • Added digital pad + A buttons support on Main Menu.
  • Solved a little bug between Filebrowser module and Wifi status icon color.
  • Added Extdata Manager module.


  • Added CHMM as pre-installed homebrew.
  • Added pre-installed homebrews system to Applications for Lua homebrews.
  • Now screenshots are taken in JPG format (saving space on SD).
  • Now screenshots can be taken also in Filebrowser module.
  • Added controls information in Filebrowser module.
  • Changed controls for Filebrowser module.
  • Added Game titles parsing for imported CIAs in Applications module.
  • Added Wifi status icon to Sunshell topbar.
  • Solved a bug with Wifi status detection after disabling it.
  • Added controls information in Mail module.
  • Solved little bug with controls triggering in Mail module.
  • Blocked access to Mail service for CIA/3DS builds cause incompatibility.
  • Made boot.3dsx patch compatible with CIA/3DS builds.
  • Changed Banner for 3DS/CIA build (Thanks to Apache_Thunder).
  • Now you can take multiple screenshots without overwriting the old ones.
  • Now screenshots are saved in DCIM folder.
  • Solved a bug with calendar days printing.
  • Solved error if you try to use Music Module with an empty MUSIC folder.
  • Solved error if you try to use Video Module with an empty VIDEO folder.
  • Solved error if you try to take a screenshot with a non-existing DCIM/101NIN03 folder.

External links