Toggle search
Toggle menu
10.3K
13.2K
1.2K
203.4K
GameBrew
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

3DShell: Difference between revisions

From GameBrew
More actions
No edit summary
No edit summary
 
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = 3DShell
|title=3DShell
| image = https://dlhb.gamebrew.org/3dshomebrew/3DShell.png|250px
|image=3dshell2.png
| type = Utilities
|description=A multi purpose file manager, heavily inspired by the CyanogenMod/LineageOS file manager.
| version = v4.3.1
|author=joel16
| licence = Mixed
|lastupdated=2021/03/24
| author = joel16
|type=File Browsers
| website = https://github.com/joel16/3DShell
|version=5.1.0
| download = https://dlhb.gamebrew.org/3dshomebrew/3DShell-4.3.1.rar
|license=Mixed
| source = https://dlhb.gamebrew.org/3dshomebrew/3DShell-4.3.1.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/3dshell.7z
|website=https://github.com/joel16/3DShell
|source=https://github.com/joel16/3DShell/releases
|donation=https://www.paypal.me/Joel16IA
}}
}}
<youtube>uJeBaISd2WI</youtube>
3DShell (pronounced 3D-Shell) is a multi-purpose file manager for the Nintendo 3DS that aims towards handling media files.


= 3DShell=
Unlike [[FBI 3DS|FBI]] which specializes more in title management, 3DShell leans towards more of the file management features such as opening and managing various files types and includes the basic necessity of a standard file manager. This program's design elements are clearly inspired by CyanogenMod/LineageOS's built in file manager, and so all credits towards the design go to the CyanogenMod/LineageOS contributors.
 
== Purpose: ==
 
3DShell (pronounced 3D-Shell) - is a multi-purpose file manager for the Nintendo 3DS that aims towards handling media files. Unlike [https://github.com/Steveice10/FBI FBI] which specializes more in title management, 3DShell leans towards more of the file management features such as opening and managing various files types and includes the basic necessity of a standard file manager. This program's design elements are clearly inspired by CyanogenMod/LineageOS's built in file manager, and so all credits towards the design go to the CyanogenMod/LineageOS contributors.
 
<p align="center">
<img src="https://i.imgur.com/pNZ3gPh.png" alt="3DShell Screenshot"/>
</p>
 
== Current features: ==


==Features==
* Storage bar (at the very top, just beneath the current working directory).
* Storage bar (at the very top, just beneath the current working directory).
* Precise battery percentage using mcu::hwc.
* Precise battery percentage using mcu::hwc.
* 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.
** Support image formats - GIF (non animated), BMP, JPG, PCX, PNG, PGM, PPM and TGA.
* Creating new folders and files.
* Creating new folders and files.
* Renaming files/folders.
* Renaming files/folders.
Line 31: Line 28:
* Copy/Move files and folders.
* Copy/Move files and folders.
* Multi-select items for delete/cut/copy (using Y button).
* Multi-select items for delete/cut/copy (using Y button).
* FTP server (Press select or tap the ftp icon to toggle).
* Extract various archives such as ZIP, RAR, and 7Z.
* 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. Support for the following image formats -&gt; BMP, GIF - non animated, JPG, PCX, PNG, PGM, PPM and TGA)
* Searching for directories - Allows you to quickly visit a directory by tapping the search icon (top right of the bottom screen).
* Extract various archives such as ZIP, RAR, 7Z, ISO 9660, AR, XAR and others supported by libarchive.
* File properties - Lets you view info on current file/folder, such as size, modified time, parent folder etc.
* Searching for directories (allows you to quickly visit a directory by clicking the search icon on the top right (bottom screen).)
* Dir list sorting (alphabetical - ascending/descending; size - largest to smallest/smallest to largest).
* File properties - lets you view info on current file/folder, such as size, modified time, parent folder etc.
* Screenshots - Press (L + R) -&gt; (/screenshots/Screenshot_YearMonthDay-Num.bmp)
* Fast scroll - Use analog stick.
* File timestamps.
* Browsing CTRNAND and copying data to/from CTRNAND.
* Browsing CTRNAND and copying data to/from CTRNAND.
* Audio playback support for the following formats -&gt; IT, OGG, MOD, MP3, S3M, WAV and XM.
* Online updater.
* Dir list Sorting (alphabetical - ascending, alphabetical - descending, size - largest to smallest, and size - smallest to largest).
 
* Online updater (nightly/releases)
==Installation==
Available in 3DSX and CIA formats.
* 3DSX - Copy .3dsx to the 3ds folder on your SD card and run it via Homebrew Launcher.
* CIA - Copy .cia to your SD card and install it with a CIA installer, such as [[FBI 3DS|FBI]].
 
==Controls==
'''Basics:'''
 
C-Pad - Quick scroll between files
 
Up/Down - Scroll between files
 
Left/Right - Page up/down
 
A - Enter a folder, Open file


== Building from source: ==
B - Exit a folder, Close file


# Ensure you have the devkitPro, ctrulib and citro3D and citro2D installed correctly. Make sure you have [https://github.com/profi200/Project_CTR makerom] and [https://github.com/Steveice10/bannertool bannertool] installed into your path as well.
Y - Select file
# Install the following dependecies from [https://devkitpro.org/viewtopic.php?f=13&t=8702 devkitPro's pacman]:


* <code>sudo dkp-pacman -Syu 3ds-dev --noconfirm --needed</code>
X - Open the action menu, View image properties
* <code>sudo dkp-pacman -Syu 3ds-curl --noconfirm --force</code>
* <code>sudo dkp-pacman -Syu 3ds-libogg --noconfirm</code>
* <code>sudo dkp-pacman -Syu 3ds-libvorbisidec --noconfirm</code>
* <code>sudo dkp-pacman -Syu 3ds-mpg123 --noconfirm</code>
* <code>sudo dkp-pacman -Syu 3ds-opusfile --noconfirm</code>
* <code>sudo dkp-pacman -Syu 3ds-flac --noconfirm</code>
* <code>sudo dkp-pacman -Syu 3ds-libarchive --noconfirm</code>


<ol start="3">
Start - Exit Homebrew
<li>Clone the 3DShell repository:</li></ol>


<source lang="bash">git clone --recursive https://github.com/joel16/3DShell.git
==Screenshots==
</source>
https://dlhb.gamebrew.org/3dshomebrews/3dshell3.png
<ol start="4">
https://dlhb.gamebrew.org/3dshomebrews/3dshell4.png
<li>Open the project diretory:</li></ol>


<source lang="bash">cd 3DShell/
https://dlhb.gamebrew.org/3dshomebrews/3dshell5.png
</source>
https://dlhb.gamebrew.org/3dshomebrews/3dshell6.png
<ol start="5">
<li>Build the binary using make:</li></ol>


<source lang="bash">make
==Changelog==
</source>
'''v5.1.0 2021/03/24'''
* Block NAND access if developer options is disabled.
* Fix selector going out of bounds when right/left (page up/page down) key is used.
* CIA builds are now available. The updater will also download/install updates based on the version you are updating from.
* Fix selector going out of bounds when returning from a folder with a long list of files.
* Fix width/height display in image properties.
* Account for images that fit both screens in image viewer and implement zoom/navigation functionalities when viewing images.
* Archive extraction is back and currently supports .7z, .rar and .zip.
* Fix alphabetical sorting for filenames with different case letters.
* Allow user to cancel a file copy or archive extraction by the use of the "B" button.
* Improvised on bottom screen status bar icons.
* Updater will now display the download progress.
* GUI will now trim the string appropriately if length of a file name/current directory goes beyond the screen.
* Touch controls are back for both file options and settings.
* Fixed issues copying certain files/folders due to the file names not being cleared and improper casting in progress bar.


== Credits: ==
'''v5.0.0 BETA 1 2021/02/08'''
* File browser now displays twice as many files as previous versions (5 -> 10).
* Selector now properly follows input and doesn't just stay at the bottom of the screen.
* 3DShell's screenshot feature has been completely removed. (Rosalina already has a screenshot function so we don't need this here).
* There are no longer any nightly updates. The updates option in settings will instead download and install the latest release from GitHub if your application is not up to date.
* Storage bar is back.
* When viewing an image you can press "X" to view some properties like the name, width and height.
* Removed many unused assets and compressed a few (file icons are a lot smaller now) icons.
* A lot of under the hood changes, clean-ups that aren't necessary to list here.


[https://github.com/joel16/3DShell/releases Revision changelog.]
==Credits==
* deltabeard/MaK11-12 for the inital ctrmus code port.
* deltabeard/MaK11-12 for the inital ctrmus code port.
* mtheall for ftpd.
* mtheall for ftpd.
Line 81: Line 101:
* FrozenFire for the boot logo.
* FrozenFire for the boot logo.


You can update straight from 3DShell, by tapping the download icon (Updates menu) and updating via the official release build option which is found under &quot;Milestone builds&quot;.
==External links==
 
* GitHub - https://github.com/joel16/3DShell
* Re-uploaded with 94201c1 Properly free image data when loaded from SD/Memory.
* GBAtemp - https://gbatemp.net/threads/3dshell-multi-purpose-file-manager-for-the-3ds.471503
* Fix down-sampled MP3 files not being played properly, and providing inaccurate timings.
* Possible attempt at fixing scratchy audio with O3DS as reported by one user (needs more testing?)
* Fix crash with the CIA version (due to some resources not being freed properly) after you exit the app granted that you opened any of the supported audio files.
* Added support for extracting more archive formats such as 7z, ISO 9660, AR, XAR and other formats supported by libarchive.
* Next nightly/milestone releases will remove the .CIA file after updating from the .CIA version.

Latest revision as of 12:31, 21 November 2024

3DShell
3dshell2.png
General
Authorjoel16
TypeFile Browsers
Version5.1.0
LicenseMixed
Last Updated2021/03/24
Links
Download
Website
Source
Support Author

3DShell (pronounced 3D-Shell) is a multi-purpose file manager for the Nintendo 3DS that aims towards handling media files.

Unlike FBI which specializes more in title management, 3DShell leans towards more of the file management features such as opening and managing various files types and includes the basic necessity of a standard file manager. This program's design elements are clearly inspired by CyanogenMod/LineageOS's built in file manager, and so all credits towards the design go to the CyanogenMod/LineageOS contributors.

Features

  • Storage bar (at the very top, just beneath the current working directory).
  • Precise battery percentage using mcu::hwc.
  • 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.
    • Support image formats - GIF (non animated), BMP, JPG, PCX, PNG, PGM, PPM and TGA.
  • Creating new folders and files.
  • Renaming files/folders.
  • File/folder deletion.
  • Copy/Move files and folders.
  • Multi-select items for delete/cut/copy (using Y button).
  • Extract various archives such as ZIP, RAR, and 7Z.
  • Searching for directories - Allows you to quickly visit a directory by tapping the search icon (top right of the bottom screen).
  • File properties - Lets you view info on current file/folder, such as size, modified time, parent folder etc.
  • Dir list sorting (alphabetical - ascending/descending; size - largest to smallest/smallest to largest).
  • Browsing CTRNAND and copying data to/from CTRNAND.
  • Online updater.

Installation

Available in 3DSX and CIA formats.

  • 3DSX - Copy .3dsx to the 3ds folder on your SD card and run it via Homebrew Launcher.
  • CIA - Copy .cia to your SD card and install it with a CIA installer, such as FBI.

Controls

Basics:

C-Pad - Quick scroll between files

Up/Down - Scroll between files

Left/Right - Page up/down

A - Enter a folder, Open file

B - Exit a folder, Close file

Y - Select file

X - Open the action menu, View image properties

Start - Exit Homebrew

Screenshots

3dshell3.png 3dshell4.png

3dshell5.png 3dshell6.png

Changelog

v5.1.0 2021/03/24

  • Block NAND access if developer options is disabled.
  • Fix selector going out of bounds when right/left (page up/page down) key is used.
  • CIA builds are now available. The updater will also download/install updates based on the version you are updating from.
  • Fix selector going out of bounds when returning from a folder with a long list of files.
  • Fix width/height display in image properties.
  • Account for images that fit both screens in image viewer and implement zoom/navigation functionalities when viewing images.
  • Archive extraction is back and currently supports .7z, .rar and .zip.
  • Fix alphabetical sorting for filenames with different case letters.
  • Allow user to cancel a file copy or archive extraction by the use of the "B" button.
  • Improvised on bottom screen status bar icons.
  • Updater will now display the download progress.
  • GUI will now trim the string appropriately if length of a file name/current directory goes beyond the screen.
  • Touch controls are back for both file options and settings.
  • Fixed issues copying certain files/folders due to the file names not being cleared and improper casting in progress bar.

v5.0.0 BETA 1 2021/02/08

  • File browser now displays twice as many files as previous versions (5 -> 10).
  • Selector now properly follows input and doesn't just stay at the bottom of the screen.
  • 3DShell's screenshot feature has been completely removed. (Rosalina already has a screenshot function so we don't need this here).
  • There are no longer any nightly updates. The updates option in settings will instead download and install the latest release from GitHub if your application is not up to date.
  • Storage bar is back.
  • When viewing an image you can press "X" to view some properties like the name, width and height.
  • Removed many unused assets and compressed a few (file icons are a lot smaller now) icons.
  • A lot of under the hood changes, clean-ups that aren't necessary to list here.

Revision changelog.

Credits

  • deltabeard/MaK11-12 for the inital ctrmus code port.
  • mtheall for ftpd.
  • preetisketch for the banner.
  • FrozenFire for the boot logo.

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=3DShell&oldid=191635’

Advertising: