3DSExplorer: Difference between revisions

From GameBrew
No edit summary
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox-3DS-Homebrews
{{Infobox 3DS Homebrews
| title = 3DSExplorer
|title=3DSExplorer
| image = https://dlhb.gamebrew.org/3dshomebrew/3DSExplorer.jpg|250px
|image=3dsexplorer2.png
| type = PC Utilities
|description=Open-Source 3DS File Manager.
| version=v1.5.3
|author=elisherer
| lastupdated = 2013/08/21
|lastupdated=2013/08/21
| licence = Mixed
|type=File Operation
| author = elisherer
|version=1.5.3
| website = http://3dbrew.org/wiki/3DSExplorer
|license=GPL-3.0
| download = https://dlhb.gamebrew.org/3dshomebrew/3DSExplorer.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/3dsexplorer.7z
| source = https://code.google.com/archive/p/3dsexplorer/downloads
|website=http://3dbrew.org/wiki/3DSExplorer
|source=https://code.google.com/archive/p/3dsexplorer/downloads
}}
}}
<youtube>uXu-dHnTiJA</youtube>
{{Obsolete}}


3DSExplorer can explore various 3DS-related files and view the information as described on 3DBrew.
3DSExplorer is an open source 3DS File Manager that can explore various 3DS-related files and view the information as documented on 3DBrew.


== Usage ==
'''Note:''' This software is vastly outdated. Use [[Project CTR 3DS|ctrtool]] instead.


Needs '''.NET Framework 4.0''', you can get it [http://www.microsoft.com/download/en/details.aspx?id=17851 here].
==User guide==
 
This requires [https://www.microsoft.com/en-us/download/details.aspx?id=17851 .NET Framework 4.0]. For Mac, Linux, or FreeBSD, you should install the latest version of Wine with Wine Mono.
Note: If you want to install this program for Mac, Linux, or FreeBSD, you should install the latest version of Wine with Wine Mono.
 
It runs well on Linux, but I haven't tested it on Mac OS X.


Opens:
Opens:
* CTR Cartridge Image files ([[NCSD|CCI]]/[[NCSD|CSU]]) (NCSD)
* CTR Cartridge Image files ([http://3dbrew.org/wiki/NCSD CCI]/[http://3dbrew.org/wiki/NCSD CSU]) (NCSD).
* CTR eXecutable Image files ([[NCCH#CXI|CXI]]) (NCCH)
* CTR eXecutable Image files ([http://3dbrew.org/wiki/NCCH#CXI CXI]) (NCCH).
* CTR File Archives ([[NCCH#CFA|CFA]]) (NCCH)
* CTR File Archives ([http://3dbrew.org/wiki/NCCH#CFA CFA]) (NCCH).
* CTR Importable Archives ([[CIA]])
* CTR Importable Archives ([http://3dbrew.org/wiki/CIA CIA]).
* CTR Icons ([[SMDH|ICN]]) (SMDH)
* CTR Icons ([http://3dbrew.org/wiki/SMDH ICN]) (SMDH).
* CTR Banners (BNR) (CBMD + BCWAV)
* CTR Banners (BNR) (CBMD+BCWAV).
* CTR Waves ([[BCWAV]])
* CTR Waves ([http://3dbrew.org/wiki/BCWAV BCWAV]).
* CTR Banner Model Data ([[CBMD]])
* CTR Banner Model Data ([http://3dbrew.org/wiki/CBMD CBMD]).
* CTR Graphics ([[CBMD|CGFX]]) (CBMD)
* CTR Graphics ([http://3dbrew.org/wiki/CBMD CGFX]) (CBMD).
* [[DARC]] (file containers) / [[BCMA]] CTR-Manuals
* [http://3dbrew.org/wiki/DARC DARC] (file containers)/[http://3dbrew.org/wiki/BCMA BCMA] CTR-Manuals.
* Save Flash binaries ([[Savegames|SAV]]) (decrypted or encrypted)
* Save Flash binaries ([http://3dbrew.org/wiki/Savegames SAV]) (decrypted or encrypted).
* Title meta data files ([[TMD]]),
* Title meta data files ([http://3dbrew.org/wiki/TMD TMD]).
* Multi-Picture Objects ([[MPO]]) , (3D Images)
* Multi-Picture Objects ([http://3dbrew.org/wiki/MPO MPO]), (3D Images).


Converts:
Converts:
* Videos to 2D/3D MJPG AVI files for the 3DS (can download directly from YouTube)
* Videos to 2D/3D MJPG AVI files for the 3DS (can download directly from YouTube). Some of the file formats can be saved with replaced contents.
 
Some of the file formats can be saved with replaced contents.


== Option for reading 3DS/CCI/CSU files from ZIP/7Z files ==
==Reading 3DS/CCI/CSU files from ZIP/7Z files==
Just compress your 3DS/CCI/CSU file into a 7Z or ZIP (with any other file you want like NFO file).


Just compress your 3DS/CCI/CSU file into a 7Z or ZIP (with any other file you want like NFO file)
Then you can open it from 3DSExplorer. But be aware that only the first CXI will be loaded and saving capabilities will not be available.


Then you can open it from 3DSExplorer. '''But be aware that only the first CXI will be loaded and saving capabilities will not be available.'''
(3DSExplorer looks for the first file with the proper extension and reads the first 0x5000 bytes.)


(3DSExplorer looks for the first file with the proper extension and reads the first 0x5000 bytes)
==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/3dsexplorer3.png


== Upcoming features ==
==Compatibility==
It runs well on Linux (not tested on Mac OS X).


for v1.6
==Changelog==
* Extracting binaries from CIA like ctrtool does.
'''v1.5.3'''
 
* Revert supertrim from deleting the last partition record.
== Change log ==
'''v1.5.2'''
 
* Added Trim, Un-Trim and SuperTrim for CCI by 3DSGuy (aka ps3hen).
v1.5.3
* (Open up a CCI file and a new menu "CCI" will appear.)
*Revert supertrim from deleting the last partition record.
'''v1.5.1'''
 
* MPO: Added some info found by Thib.
v1.5.2
* Added Trim, Un-Trim and SuperTrim for CCI by 3DSGuy (aka ps3hen)
+ (Open up a CCI file and a new menu "CCI" will appear.)
 
v1.5.1
* MPO: Added some info found by Thib
* Fixed: title.db update process.
* Fixed: title.db update process.
* Parentool 3ds algorithm fixed (was wrong)
* Parentool 3ds algorithm fixed (was wrong).
v1.5
'''v1.5'''
* Added: QR Tool
* Added: QR Tool.
* Added: Parental Control Unlocker (for 3DS as found by neimod, and for the DSi/Wii as on marcan's site)
* Added: Parental Control Unlocker (for 3DS as found by neimod, and for the DSi/Wii as on marcan's site).
v1.4
'''v1.4'''
* Added: support for BCMA/DARC files/containers.
* Added: support for BCMA/DARC files/containers.
* Added: DSDecmp GUI for compression/decompression of LZ-10/11/Ovl & Huffman4/8.
* Added: DSDecmp GUI for compression/decompression of LZ-10/11/Ovl & Huffman4/8.
* Updated: XOR Tool's file text boxes accept drag&drop (DSDecmp GUI's also).
* Updated: XOR Tool's file text boxes accept drag&drop (DSDecmp GUI's also).
v1.3 (3DSGuy)
'''v1.3 (3DSGuy)'''
* Added *.cfa as an openable file (associated with CXI module)
* Added *.cfa as an openable file (associated with CXI module).
* Used more general terms for CXI/CFA and 3DS/CCI/CSU with NCCH and NCSD respectively, while the general terms are more broad, they are correct, as a CFA file is not a CXI file.
* Used more general terms for CXI/CFA and 3DS/CCI/CSU with NCCH and NCSD respectively, while the general terms are more broad, they are correct, as a CFA file is not a CXI file.
* Fixed the Number of NCCH from 13 to 8 in the CCI module
* Fixed the Number of NCCH from 13 to 8 in the CCI module.
* Changed the NCSD header readings to match the current specs on 3DBrew, with the exception of the "ExHeader size/Exheader Hash", as they are always zero in every NCSD.
* Changed the NCSD header readings to match the current specs on 3DBrew, with the exception of the "ExHeader size/Exheader Hash", as they are always zero in every NCSD.
* Made the ExHeader an extractable file from NCCH files.
* Made the ExHeader an extractable file from NCCH files.
v1.2.1
'''v1.2.1'''
* fixed opening of cia files (thanks 3dsguy)
* Fixed opening of cia files (thanks 3dsguy).
* updated title.db up to release #183
* Updated title.db up to release #183.
v1.2
'''v1.2'''
* Added: The product codes and maker codes are now in a file called title.db
* Added: The product codes and maker codes are now in a file called title.db.
* Added: 3ds/cci/csu can be opened from zip/7z files with limited information (cci,1st cxi & crc32)
* Added: 3ds/cci/csu can be opened from zip/7z files with limited information (cci,1st cxi & crc32).
v1.1.1
'''v1.1.1'''
* fixed file tree activation bugs
* Fixed file tree activation bugs.
* fixed some typos
* Fixed some typos.
* CCI: added an option to save cxi file (right click the CXI node in the file tree)
* CCI: added an option to save cxi file (right click the CXI node in the file tree).
v1.1 - Happy Holidays
'''v1.1 - Happy Holidays'''
* New opens CXI files
* New opens CXI files.
* New opens CSU files (CTR System update - same as CCI)
* New opens CSU files (CTR System update - same as CCI).
* New opens ICN files (CTR Icons)
* New opens ICN files (CTR Icons).
* Added QuickCRC32 tool to check for authenticity (also added CRC32 to hash tool)
* Added QuickCRC32 tool to check for authenticity (also added CRC32 to hash tool).
* Generalized the explorer (the source code of the explorer is general, now it would be easier to add more file formats)
* Generalized the explorer (the source code of the explorer is general, now it would be easier to add more file formats).
* 3D Video converter: Progress is working, fixed a lot, now works almost flawlessly.
* 3D Video converter: Progress is working, fixed a lot, now works almost flawlessly.
* CCI: Added more information to the header.
* CCI: Added more information to the header.
* MPO: Added Nintendo's MakerNote structure.
* MPO: Added Nintendo's MakerNote structure.
v1.0
'''v1.0'''
* Better late then ever...update to v1.0 so I can continue with the regular
* Better late then ever...update to v1.0 so I can continue with the regular.
version giving.
version giving.
* Added MPO support (3D Images taken by the 3ds camera)
* Added MPO support (3D Images taken by the 3ds camera).
* 3D Video Conversion tool to convert youtube 3d videos to 3DS-3D MJPG videos...
* 3D Video Conversion tool to convert youtube 3d videos to 3DS-3D MJPG videos.
* more bug fixes (as always)
* More bug fixes (as always).
v0.96
'''v0.96'''
* Moved to .NET Framework 4.0 (because of OpenGL Support)
* Moved to .NET Framework 4.0 (because of OpenGL Support).
* Improved SRAM key search algorithm (fixes Starfox 3D)
* Improved SRAM key search algorithm (fixes Starfox 3D).
* Added initial support for CWAV, CGFX
* Added initial support for CWAV, CGFX.
* New nifty about screen (3d logo)
* New nifty about screen (3d logo).
* Preparations made for wav (CWAV) & 3d model (CMDL) decoding (WIP)
* Preparations made for wav (CWAV) & 3d model (CMDL) decoding (WIP).
* Now the application needs 2 external DLLs for SharpGL
* Now the application needs 2 external DLLs for SharpGL.
v0.9
'''v0.9'''
* Now checks for update on startup (can be disabled)
* Now checks for update on startup (can be disabled).
* Added link to the Google-code site
* Added link to the Google-code site.
* CIA: Can replace icons with any picture you want (Saving enabled)
* CIA: Can replace icons with any picture you want (Saving enabled).
* More bug fixes
* More bug fixes.
v0.89
'''v0.89'''
* CIA: Icons color mapping corrected (It's RGB565)
* CIA: Icons color mapping corrected (It's RGB565).
* ImageBox now has a zoom button.
* ImageBox now has a zoom button.
* XOR Tool: New features: Xor byte arrays, AES-ctr sandbox.
* XOR Tool: New features: Xor byte arrays, AES-ctr sandbox.
* More bug fixes and mostly source code redesign
* More bug fixes and mostly source code redesign.
v0.83
'''v0.83'''
* CIA: Fix: Correct Ticket
* CIA: Fix: Correct Ticket.
* CIA: Icon color mapping fixed (RGB -> GBR)
* CIA: Icon color mapping fixed (RGB -> GBR).
v0.82
'''v0.82'''
* CIA: Added Banner icons viewing (Double click an icon to show it in the Banner's Metadata section)
* CIA: Added Banner icons viewing (Double click an icon to show it in the Banner's Metadata section).
v0.81
'''v0.81'''
* Fix bug when opening TMD files
* Fix bug when opening TMD files.
v0.8
'''v0.8'''
* CIA support
* CIA support.
* Changed GUI + Skin
* Changed GUI + Skin.
* Fixed some bugs
* Fixed some bugs.
v0.7
'''v0.7'''
* More information on sav files
* More information on sav files.
* Now all information is grouped
* Now all information is grouped.
* Bug fixes for all contexts
* Bug fixes for all contexts.
* Hash tool supports HMAC
* Hash tool supports HMAC.
* Source code rewritten for optimization..
* Source code rewritten for optimization..
* [Experimental] Can now replace original files into sav image and save it to a new created sav file.
* [Experimental] Can now replace original files into sav image and save it to a new created sav file.
v0.62
'''v0.62'''
* Bug fixes
* Bug fixes.
* Rearranged the gui
* Rearranged the gui.
* Now the exe file is a release and not a debug.
* Now the exe file is a release and not a debug.
* Context menu for files in the filesystem list.
* Context menu for files in the filesystem list.
v0.61
'''v0.61'''
* Fix for DATA partitions files save (wrong offsets)...
* Fix for DATA partitions files save (wrong offsets)...
* Can now be associated with sav/bin/3ds/tmd files to open files from the explorer...
* Can now be associated with sav/bin/3ds/tmd files to open files from the explorer...
* Hashtool and XORtool can be opened while working with the explorer part of the program.
* Hashtool and XORtool can be opened while working with the explorer part of the program.
v0.6
'''v0.6'''
* New GUI
* New GUI.
* Improved algorithms (SAV files mainly)
* Improved algorithms (SAV files mainly).
* More information shown
* More information shown.
* NEW and improved Hash Tool.
* NEW and improved Hash Tool.
v0.55
'''v0.55'''
* Works with most save files.
* Works with most save files.
* More of the save structure understood
* More of the save structure understood.
* Saving of files from the sav image fixed.
* Saving of files from the sav image fixed.
v0.53
'''v0.53'''
* Fix for the tmd (now has certificates)
* Fix for the tmd (now has certificates).
* TMD: Still not supporting SHA1 type
* TMD: Still not supporting SHA1 type.
v0.52
'''v0.52'''
* TMD now works
* TMD now works.
* Save opening was improved
* Save opening was improved.
* No question rather it's encrypted or not (autodetect)
* No question rather it's encrypted or not (autodetect).
 
'''v0.51'''
v0.51
* Fix for save files from save image.
* fix for save files from save image
* Feature: save image file from sav binary.
* feature: save image file from sav binary
'''v0.5'''
 
* New GUI now has file box.
v0.5
* Fix for a few save files.
* new GUI now has file box
* Now can save files from save and 3ds (from 3ds still encrypted) by double clicking a file.
* fix for a few save files
* When opening a crypted save you can save the key to a file.
* now can save files from save and 3ds (from 3ds still encrypted) by double clicking a file.
* Now on google code using SVN (moved from github).
* when opening a crypted save you can save the key to a file
'''v0.3'''
* now on google code using SVN (moved from github)
* Changed the name of the application.
 
* Initial work on opening save binary files.
v0.3
* Already opens save binary files, decrypts them and shows some info.
* changed the name of the application
* I'll be happy to get some help from you guys on this.
* initial work on opening save binary files
'''v0.1'''
* already opens save binary files, decrypts them and shows some info
* Opens 3DS files and creates a treeview with the information.
 
* Can't decrypt the ExeFS (as no key yet to be found).
* I'll be happy to get some help from you guys on this...
 
v0.1
* opens 3DS files and creates a treeview with the information
* can't decrypt the ExeFS (as no key yet to be found)
 
== Latest Build ==


You can download the latest build [http://3dsexplorer.googlecode.com/svn/trunk/3DSExplorer/bin/3DSExplorer.exe here].
==External links==
* Google Code - https://code.google.com/archive/p/3dsexplorer
* 3dbrew.org - http://3dbrew.org/wiki/3DSExplorer
* GBAtemp - https://gbatemp.net/threads/3dsexplorer.308971


Notice that this version may have unexpected output (broken files, corrupted data, broken dreams, etc.), as it is the latest development version available...
[Category:3DS homebrew applications]
[Category:PC utilities for 3DS homebrew]

Latest revision as of 09:08, 5 February 2023

3DSExplorer
3dsexplorer2.png
General
Authorelisherer
TypeFile Operation
Version1.5.3
LicenseGPL-3.0
Last Updated2013/08/21
Links
Download
Website
Source

3DSExplorer is an open source 3DS File Manager that can explore various 3DS-related files and view the information as documented on 3DBrew.

Note: This software is vastly outdated. Use ctrtool instead.

User guide

This requires .NET Framework 4.0. For Mac, Linux, or FreeBSD, you should install the latest version of Wine with Wine Mono.

Opens:

  • CTR Cartridge Image files (CCI/CSU) (NCSD).
  • CTR eXecutable Image files (CXI) (NCCH).
  • CTR File Archives (CFA) (NCCH).
  • CTR Importable Archives (CIA).
  • CTR Icons (ICN) (SMDH).
  • CTR Banners (BNR) (CBMD+BCWAV).
  • CTR Waves (BCWAV).
  • CTR Banner Model Data (CBMD).
  • CTR Graphics (CGFX) (CBMD).
  • DARC (file containers)/BCMA CTR-Manuals.
  • Save Flash binaries (SAV) (decrypted or encrypted).
  • Title meta data files (TMD).
  • Multi-Picture Objects (MPO), (3D Images).

Converts:

  • Videos to 2D/3D MJPG AVI files for the 3DS (can download directly from YouTube). Some of the file formats can be saved with replaced contents.

Reading 3DS/CCI/CSU files from ZIP/7Z files

Just compress your 3DS/CCI/CSU file into a 7Z or ZIP (with any other file you want like NFO file).

Then you can open it from 3DSExplorer. But be aware that only the first CXI will be loaded and saving capabilities will not be available.

(3DSExplorer looks for the first file with the proper extension and reads the first 0x5000 bytes.)

Screenshots

3dsexplorer3.png

Compatibility

It runs well on Linux (not tested on Mac OS X).

Changelog

v1.5.3

  • Revert supertrim from deleting the last partition record.

v1.5.2

  • Added Trim, Un-Trim and SuperTrim for CCI by 3DSGuy (aka ps3hen).
  • (Open up a CCI file and a new menu "CCI" will appear.)

v1.5.1

  • MPO: Added some info found by Thib.
  • Fixed: title.db update process.
  • Parentool 3ds algorithm fixed (was wrong).

v1.5

  • Added: QR Tool.
  • Added: Parental Control Unlocker (for 3DS as found by neimod, and for the DSi/Wii as on marcan's site).

v1.4

  • Added: support for BCMA/DARC files/containers.
  • Added: DSDecmp GUI for compression/decompression of LZ-10/11/Ovl & Huffman4/8.
  • Updated: XOR Tool's file text boxes accept drag&drop (DSDecmp GUI's also).

v1.3 (3DSGuy)

  • Added *.cfa as an openable file (associated with CXI module).
  • Used more general terms for CXI/CFA and 3DS/CCI/CSU with NCCH and NCSD respectively, while the general terms are more broad, they are correct, as a CFA file is not a CXI file.
  • Fixed the Number of NCCH from 13 to 8 in the CCI module.
  • Changed the NCSD header readings to match the current specs on 3DBrew, with the exception of the "ExHeader size/Exheader Hash", as they are always zero in every NCSD.
  • Made the ExHeader an extractable file from NCCH files.

v1.2.1

  • Fixed opening of cia files (thanks 3dsguy).
  • Updated title.db up to release #183.

v1.2

  • Added: The product codes and maker codes are now in a file called title.db.
  • Added: 3ds/cci/csu can be opened from zip/7z files with limited information (cci,1st cxi & crc32).

v1.1.1

  • Fixed file tree activation bugs.
  • Fixed some typos.
  • CCI: added an option to save cxi file (right click the CXI node in the file tree).

v1.1 - Happy Holidays

  • New opens CXI files.
  • New opens CSU files (CTR System update - same as CCI).
  • New opens ICN files (CTR Icons).
  • Added QuickCRC32 tool to check for authenticity (also added CRC32 to hash tool).
  • Generalized the explorer (the source code of the explorer is general, now it would be easier to add more file formats).
  • 3D Video converter: Progress is working, fixed a lot, now works almost flawlessly.
  • CCI: Added more information to the header.
  • MPO: Added Nintendo's MakerNote structure.

v1.0

  • Better late then ever...update to v1.0 so I can continue with the regular.

version giving.

  • Added MPO support (3D Images taken by the 3ds camera).
  • 3D Video Conversion tool to convert youtube 3d videos to 3DS-3D MJPG videos.
  • More bug fixes (as always).

v0.96

  • Moved to .NET Framework 4.0 (because of OpenGL Support).
  • Improved SRAM key search algorithm (fixes Starfox 3D).
  • Added initial support for CWAV, CGFX.
  • New nifty about screen (3d logo).
  • Preparations made for wav (CWAV) & 3d model (CMDL) decoding (WIP).
  • Now the application needs 2 external DLLs for SharpGL.

v0.9

  • Now checks for update on startup (can be disabled).
  • Added link to the Google-code site.
  • CIA: Can replace icons with any picture you want (Saving enabled).
  • More bug fixes.

v0.89

  • CIA: Icons color mapping corrected (It's RGB565).
  • ImageBox now has a zoom button.
  • XOR Tool: New features: Xor byte arrays, AES-ctr sandbox.
  • More bug fixes and mostly source code redesign.

v0.83

  • CIA: Fix: Correct Ticket.
  • CIA: Icon color mapping fixed (RGB -> GBR).

v0.82

  • CIA: Added Banner icons viewing (Double click an icon to show it in the Banner's Metadata section).

v0.81

  • Fix bug when opening TMD files.

v0.8

  • CIA support.
  • Changed GUI + Skin.
  • Fixed some bugs.

v0.7

  • More information on sav files.
  • Now all information is grouped.
  • Bug fixes for all contexts.
  • Hash tool supports HMAC.
  • Source code rewritten for optimization..
  • [Experimental] Can now replace original files into sav image and save it to a new created sav file.

v0.62

  • Bug fixes.
  • Rearranged the gui.
  • Now the exe file is a release and not a debug.
  • Context menu for files in the filesystem list.

v0.61

  • Fix for DATA partitions files save (wrong offsets)...
  • Can now be associated with sav/bin/3ds/tmd files to open files from the explorer...
  • Hashtool and XORtool can be opened while working with the explorer part of the program.

v0.6

  • New GUI.
  • Improved algorithms (SAV files mainly).
  • More information shown.
  • NEW and improved Hash Tool.

v0.55

  • Works with most save files.
  • More of the save structure understood.
  • Saving of files from the sav image fixed.

v0.53

  • Fix for the tmd (now has certificates).
  • TMD: Still not supporting SHA1 type.

v0.52

  • TMD now works.
  • Save opening was improved.
  • No question rather it's encrypted or not (autodetect).

v0.51

  • Fix for save files from save image.
  • Feature: save image file from sav binary.

v0.5

  • New GUI now has file box.
  • Fix for a few save files.
  • Now can save files from save and 3ds (from 3ds still encrypted) by double clicking a file.
  • When opening a crypted save you can save the key to a file.
  • Now on google code using SVN (moved from github).

v0.3

  • Changed the name of the application.
  • Initial work on opening save binary files.
  • Already opens save binary files, decrypts them and shows some info.
  • I'll be happy to get some help from you guys on this.

v0.1

  • Opens 3DS files and creates a treeview with the information.
  • Can't decrypt the ExeFS (as no key yet to be found).

External links

[Category:3DS homebrew applications] [Category:PC utilities for 3DS homebrew]

Advertising: