Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

3DShell: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 3: Line 3:
| image = https://dlhb.gamebrew.org/3dshomebrew/3DShell.png|250px
| image = https://dlhb.gamebrew.org/3dshomebrew/3DShell.png|250px
| type = Utilities
| type = Utilities
| version = v4.3.1
| version = v5.1.0 (23 Mar 2021)
| licence = Mixed
| licence = Mixed
| author = joel16
| author = joel16
| website = https://github.com/joel16/3DShell
| website = https://github.com/joel16/3DShell
| download = https://dlhb.gamebrew.org/3dshomebrew/3DShell-4.3.1.rar
| download = https://github.com/joel16/3DShell/releases
| source = https://dlhb.gamebrew.org/3dshomebrew/3DShell-4.3.1.rar
| source = https://github.com/joel16/3DShell/releases
}}
}}
<youtube>uJeBaISd2WI</youtube>
= 3DShell=
== 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.
3DShell (pronounced 3D-Shell) - is a multi-purpose file manager for the Nintendo 3DS that aims towards handling media files.  


<p align="center">
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.
<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.
Line 31: Line 23:
* 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).
* Image preview:
* 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)
** If the image is around 400 * 480 which is the size of both screens, the image will be split in half and displayed.  
* Extract various archives such as ZIP, RAR, 7Z, ISO 9660, AR, XAR and others supported by libarchive.
** Support image formats - BMP, GIF (non animated), JPG, PCX, PNG, PGM, PPM and TGA.
* Extract various archives such as ZIP, RAR, and 7Z.
* Searching for directories (allows you to quickly visit a directory by clicking the search icon on the top right (bottom screen).)
* Searching for directories (allows you to quickly visit a directory by clicking the search icon on the top right (bottom screen).)
* File properties - lets you view info on current file/folder, such as size, modified time, parent folder etc.
* 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.
* Dir list sorting (alphabetical - ascending or descending, size - largest to smallest, and size - smallest to largest).
* Dir list Sorting (alphabetical - ascending, alphabetical - descending, size - largest to smallest, and size - smallest to largest).
* Online updater.
* Online updater (nightly/releases)
 
==Installation==
===Installing===
Available as a 3DSX and CIA.
* 3DSX - Copy .3dxs to the 3ds folder on your SD card and launch it via homebrew loader.
* 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>
'''Home'''<br>
<ol start="4">
https://i.imgur.com/i4JcUud.png
<li>Open the project diretory:</li></ol>
 
'''Music Player'''<br>
https://i.imgur.com/M1jkQge.png
 
'''Sorting options'''<br>
https://i.imgur.com/1z8noB6.png
 
==Media==
<youtube>uJeBaISd2WI</youtube>


<source lang="bash">cd 3DShell/
==Changelog==
</source>
'''v5.1.0 24 Mar 2021'''
<ol start="5">
* Block NAND access if developer options is disabled.
<li>Build the binary using make:</li></ol>
* 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.


<source lang="bash">make
'''v5.0.0 BETA 1 8 Feb 2021'''
</source>
* 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.


== Credits: ==
[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 106:
* 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
* GBAtemp - https://gbatemp.net/threads/3dshell-multi-purpose-file-manager-for-the-3ds.471503


* Re-uploaded with 94201c1 Properly free image data when loaded from SD/Memory.
[[Category:3DS homebrew applications]]
* Fix down-sampled MP3 files not being played properly, and providing inaccurate timings.
[[Category:Homebrew utility applications on 3DS]]
* 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.

Revision as of 04:18, 9 July 2021

Template:Infobox 3DS homebrew

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.
  • 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).
  • 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 - BMP, GIF (non animated), JPG, PCX, PNG, PGM, PPM and TGA.
  • Extract various archives such as ZIP, RAR, and 7Z.
  • Searching for directories (allows you to quickly visit a directory by clicking the search icon on the top right (bottom screen).)
  • File properties - lets you view info on current file/folder, such as size, modified time, parent folder etc.
  • Browsing CTRNAND and copying data to/from CTRNAND.
  • Dir list sorting (alphabetical - ascending or descending, size - largest to smallest, and size - smallest to largest).
  • Online updater.

Installation

Installing

Available as a 3DSX and CIA.

  • 3DSX - Copy .3dxs to the 3ds folder on your SD card and launch it via homebrew loader.
  • 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

Home
i4JcUud.png

Music Player
M1jkQge.png

Sorting options
1z8noB6.png

Media

Changelog

v5.1.0 24 Mar 2021

  • 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 8 Feb 2021

  • 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

Advertising: