3dfetch 3DS: Difference between revisions

Revision as of 03:14, 7 July 2021

3dfetch is a 3DS homebrew application that can display varies information of your 3DS in pretty colors.

Similar to Linux's screenfetch script, but unsigned and executed on a Nintendo 3DS. RSF file based off of this dummy RSF. Mainly developed as a method for learning 3DS homebrew toolkits, libraries, and build environments.

Features

Pretty colors.
Cycle through text colors using the d-pad, and background colors using the L and R buttons.
Press the A button to take a screenshot, saved to the SD card root as 3dfetch_day_month_year_x.jpg.
All information dynamically grabbed from 3DS' hardware.
New 3DS and old 3DS compatible.
Press select for a configuration menu.
Use in tandem with imgurup-3ds for an easy sharing experience.

Installation

Installing

Latest release includes CIA file/QR code. Or you can get it on TitleDB within FBI.

Building

makerom to create the CIA.
3ds-tool to recompile the ROM filesystem.
bannertool to create the banner and icon files.
A fork of lpp-3ds found here which includes expanded functionality. The compiled binary (lpp-3ds.elf) is included in the repository, we strongly suggest against attempts to compile it yourself, if such necessity arises, visit the forks repository for instructions.

CIA - To compile, run make to build an installable CIA-file.

3DSX - If you wish to use 3dfetch inside the Homebrew Launcher, run make 3dfetch.3dsx instead and merge the /3ds/ folder with the one on your SD card.

Network-sent 3DSX - If you would like to have 3dfetch be sent via network to your console, open up Homebrew Launcher, press Y and run make 3dsx instead.

User guide

Configuration

3dfetch can optionally be configured by creating a file at the root of your SD card called 3dfetch.conf. At present, the following options are available:

showAnimation:true | false - Enable/disable the little shell animation on startup.
showSplash:true | false - Enable/disable the CFW splash on the bottom.
showCFW:true | false to Enable/disable CFW detection.

Controls

A - Take screenshots

D-Pad - Cycle through text colors

L/R - Change background colors

Screenshots

Running on a New 3DS with Luma CFW.

Screenshot generated by 3dfetch.

@@ Line 3: / Line 3: @@
 | image = https://dlhb.gamebrew.org/3dshomebrew/3dfetch.jpeg|250px
 | type = Utilities
-| version = 1.1
+| version = 1.1 (1 Jul 2017)
 | licence = Mixed
 | author = aliceinpalth
@@ Line 11: / Line 11: @@
 }}
-=3dfetch=
+http://i.imgur.com/49vYhos.png
-http://i.imgur.com/49vYhos.png
+dfetch is a 3DS homebrew application that can display varies information of your 3DS in pretty colors.
 Similar to Linux's screenfetch script, but unsigned and executed on a Nintendo 3DS. RSF file based off of [https://gist.github.com/mid-kid/d9c4ce50407c71ec9ef3 this dummy RSF]. Mainly developed as a method for learning 3DS homebrew toolkits, libraries, and build environments.
-== Features ==
+==Features==
-* Pretty colors!
+* Pretty colors.
-* Cycle through text colors using the d-pad, and background colors using the L and R buttons
+* Cycle through text colors using the d-pad, and background colors using the L and R buttons.
-* Press the A button to take a screenshot, saved to the SD card root as <code>3dfetch_day_month_year_x.jpg</code>
+* Press the A button to take a screenshot, saved to the SD card root as <code>3dfetch_day_month_year_x.jpg</code>.
-* All information dynamically grabbed from 3DS' hardware
+* All information dynamically grabbed from 3DS' hardware.
-* New 3DS and old 3DS compatible
+* New 3DS and old 3DS compatible.
-* Press select for a configuration menu
+* Press select for a configuration menu.
-* Use in tandem with [https://github.com/Pirater12/imgurup-3ds imgurup-3ds] for an easy sharing experience
+* Use in tandem with [https://github.com/Pirater12/imgurup-3ds imgurup-3ds] for an easy sharing experience.
-== Screenshots ==
+==Installation==
-http://i.imgur.com/OWcdNhB.jpg
+===Installing===
+Latest release includes CIA file/QR code. Or you can get it on TitleDB within FBI.
+===Building===
+* [https://github.com/profi200/Project_CTR/releases makerom] to create the CIA.
+* [https://github.com/dnasdw/3dstool/releases 3ds-tool] to recompile the ROM filesystem.
+* [https://github.com/Steveice10/bannertool bannertool] to create the banner and icon files.
+* A fork of lpp-3ds found [https://github.com/daedreth/lpp-3ds here] which includes expanded functionality. The compiled binary (lpp-3ds.elf) is included in the repository, we strongly suggest against attempts to compile it yourself, if such necessity arises, visit the forks repository for instructions.
+'''CIA''' - To compile, run <code>make</code> to build an installable CIA-file.
+'''3DSX''' - If you wish to use 3dfetch inside the Homebrew Launcher, run <code>make 3dfetch.3dsx</code> instead and merge the /3ds/ folder with the one on your SD card.
-dfetch running on a New 3DS with Luma CFW.
+'''Network-sent 3DSX''' - If you would like to have 3dfetch be sent via network to your console, open up Homebrew Launcher, press Y and run <code>make 3dsx</code> instead.
-http://i.imgur.com/qhMDawH.png
+==User guide==
+===Configuration===
+dfetch can optionally be configured by creating a file at the root of your SD card called 3dfetch.conf. At present, the following options are available:
+* showAnimation:true | false - Enable/disable the little shell animation on startup.
+* showSplash:true | false - Enable/disable the CFW splash on the bottom.
+* showCFW:true | false to Enable/disable CFW detection.
-A screenshot generated by 3dfetch on a New 3DS with Luma CFW.
+==Controls==
+A - Take screenshots
+D-Pad - Cycle through text colors
-===Where to get it===
+L/R -  Change background colors
-Check the [releases page](https://github.com/yyualice/3dfetch/releases) for a CIA file / QR code. Or get it on TitleDB within FBI.
-===Optional configuration===
+==Screenshots==
-dfetch can optionally be configured by creating a file at the root of your SD card called
+'''Running on a New 3DS with Luma CFW.'''<br>
-* `3dfetch.conf`. At present, the following options are available:
+http://i.imgur.com/OWcdNhB.jpg
-* `showAnimation:true | false` to enable/disable the little shell animation on startup.
-* `showSplash:true | false` to enable/disable the CFW splash on the bottom
-* `showCFW:true | false` to enable/disable CFW detection
-===Reporting issues===
-Is your CFW not being recognized properly? Is the amount of free space reported incorrectly? Or maybe you came across an error.
-Create an issue on GitHub. Don't forget to add your CFW, what version you are on and which 3dfetch version/commit you were using.
-==Building from source==
-=== Requirements===
-* - [`makerom`](https://github.com/profi200/Project_CTR/releases) to create the CIA.
+'''Screenshot generated by 3dfetch.'''<br>
-* - [`3ds-tool`](https://github.com/dnasdw/3dstool/releases) to recompile the ROM filesystem.
+http://i.imgur.com/qhMDawH.png
-* - [`bannertool`](https://github.com/Steveice10/bannertool) to create the banner and icon files.
-* - A fork of lpp-3ds found [here](https://github.com/daedreth/lpp-3ds) which includes expanded
-functionality. The compiled binary (`lpp-3ds.elf`) is included in the repository, we strongly suggest against attempts to compile it yourself, if such necessity arises, visit the forks repository for instructions.
+[[Category:3DS homebrew application]]
-== Compiling==
+[[Category:Homebrew utility applications on 3DS]]
-=== CIA===
-Run `make` to build an installable CIA-file.
-=== 3dsx===
-If you wish to use 3dfetch inside the Homebrew Launcher and thus require a 3dsx file, run `make 3dfetch.3dsx` instead and merge the `/3ds` folder with the one found on your SD card.
-=== Network-sent 3dsx===
-If you would like to have 3dfetch be sent via network to your console, open up the Homebrew Launcher, press `Y` and run `make 3dsx` instead.