mirror of https://github.com/joel16/3DShell.git synced 2024-11-27 05:20:32 +00:00

3DShell - (Pronounced 3D Shell) is a multi purpose file manager for the Nintendo 3DS. Heavily inspired by the CyanogenMod/LineageOS file manager.

Go to file

Joel16 65212fecad Fix config not reading the last font colour entry		2017-12-31 00:31:44 -06:00
include	Minor improvements to recursive copy and	2017-12-30 01:32:10 -06:00
resources	Add new logo by FrozenFire	2017-12-28 17:05:31 -06:00
romfs/res	Improve radio_off texture thanks to preetisketch	2017-12-29 17:18:05 -06:00
source	Fix config not reading the last font colour entry	2017-12-31 00:31:44 -06:00
.gitignore	Add mp3 file support	2017-09-06 16:58:39 +01:00
.gitmodules	Add audio icon to status bar when music is being played	2017-12-20 19:52:10 -06:00
.travis.yml	Add travis-ci	2017-12-24 16:28:02 -06:00
LICENSE	Switch from MIT -> GNU	2017-07-03 16:24:46 -04:00
Makefile	Fix build error causes by new logo	2017-12-24 18:50:41 -06:00
README.md	Update README.md	2017-12-30 19:17:41 -06:00

README.md

3DShell

Purpose:

3DShell (pronounced 3D-Shell) - is a multi-purpose file manager GUI for the Nintendo 3DS. The program is currently in its early stages and lacks many features that are currently in development. More information will be given once the program matures. This program's design elements are clearly inspired by CyanogenMod's built in file manager, and so I take no credit for that.

Current features:

Storage bar (at the very top, just beneath the current working directory).
Precise battery percentage using mcu::hwc
Creating new folders
Renaming files/folders
File/folder deletion
Copy/Cut files and folders
FTP server (Press select or tap the ftp icon to toggle)
Image preview (If the image is around 400 * 480 which is the size of both screens, the image will be split in half and displayed. Have a look at the screenshots below). Support for the following image formats. PNG, JPG, GIF[un-animated], (untested ->) HDR, PIC, PNM, PSD, TGA)
Zip file extraction.
Searching for directories (allows you to quickly visit a directory by clicking the search icon on the top right (bottom screen).)
File properties - let's you view info on current file/folder.
Screenshots - Press (L + R) -> (/screenshots/Screenshot_YearMonthDay-Num.bmp)
Fast scroll - Use analog stick
File's time-stamp
Browsing CTRNAND
MP3, vorbis (ogg), flac and wav playback support. (All thanks to deltabeard/MaK11-12)
Dir list Sorting (alphabetical - ascending, alphabetical - descending, size - largest to smallest, and size - smallest to largest)
Recycle bin (Places files in /3ds/3DShell/bin instead of deleting them)

Building from source:

Ensure you have the devkitPro, ctrulib and citro3D installed correctly. Make sure you have makerom and bannertool in your path as well.
Install the following dependecies from devkitPro's portlibs: libogg and tremor - low mwmory branch.

Then use the unofficial (fork) of portlibs here to install libmpg123.

To compile mpg123, just run make mpg123 in the 3ds_portlibs folder. This will compile all that is required of mpg123. Installing the library has to be done manually though, and can be done by running the following commands:

cp mpg123-1.xx.x/src/libmpg123/.libs/libmpg123.a /opt/devkitpro/portlibs/armv6k/lib/
cp mpg123-1.xx.x/src/libmpg123/libmpg123.la /opt/devkitpro/portlibs/armv6k/lib/
cp mpg123-1.xx.x/libmpg123.pc /opt/devkitpro/portlibs/armv6k/lib/pkgconfig/
cp mpg123-1.xx.x/src/libmpg123/mpg123.h /opt/devkitpro/portlibs/armv6k/include/
cp mpg123-1.xx.x/src/libmpg123/fmt123.h /opt/devkitpro/portlibs/armv6k/include/

Clone the repo:

$ git clone --recursive https://github.com/joel16/3DShell.git

Build the program using make:

$ cd 3DShell/ && make

The binaries will be distributed in the "out" directory.

Credits:

deltabeard/MaK11-12 for sound support.
mtheall for ftpd.
Steveice10 for allowing me to use his screen.c C3D code as a template to build and make modifications on.
preetisketch for the banner.
FrozenFire for the boot logo.