3dfetch 3DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = 3dfetch
|title=3dfetch
| image = https://dlhb.gamebrew.org/3dshomebrew/3dfetch.jpeg|250px
|image=3dfetch3.png
| type = Utilities
|description=Displays various information about your Nintendo 3DS in pretty colors.
| version = 1.1
|author=aliceinpalth
| licence = Mixed
|lastupdated=2017/07/01
| author = aliceinpalth
|type=Utilities
| website = https://github.com/yyualice/3dfetch/
|version=1.10/11
| download = https://dlhb.gamebrew.org/3dshomebrew/3dfetch-3DS.rar
|license=Mixed
| source = https://dlhb.gamebrew.org/3dshomebrew/3dfetch-3DS.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/3dfetch.7z
|website=https://github.com/yyualice/3dfetch
|source=https://github.com/yyualice/3dfetch
}}
}}
3dfetch is a 3DS homebrew application that can display varies information of your 3DS in pretty colors.


=3dfetch=
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.


http://i.imgur.com/49vYhos.png
==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.


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.
==Installation==
===Installing===
Available as a CIA/QR code.
 
Copy .cia to your SD card and install it with the CIA manager of your choice. Or you can get it on TitleDB within [[FBI 3DS|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. It is advised to use the compiled binary (lpp-3ds.elf) included in the repository.
 
To compile:
* CIA - Run <code>make</code> to build an installable CIA-file.
* 3DSX - Run <code>make 3dfetch.3dsx</code> instead and merge the <code>/3ds</code> 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 <code>Y</code> and run <code>make 3dsx</code> instead.


== Features ==
==User guide==
* Pretty colors!
===Configuration===
* Cycle through text colors using the d-pad, and background colors using the L and R buttons
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:
* Press the A button to take a screenshot, saved to the SD card root as <code>3dfetch_day_month_year_x.jpg</code>
* showAnimation:true | false - Enable/disable the little shell animation on startup.
* All information dynamically grabbed from 3DS' hardware
* showSplash:true | false - Enable/disable the CFW splash on the bottom.
* New 3DS and old 3DS compatible
* showCFW:true | false to Enable/disable CFW detection.
* Press select for a configuration menu
* Use in tandem with [https://github.com/Pirater12/imgurup-3ds imgurup-3ds] for an easy sharing experience


== Screenshots ==
You can also use the configuration menu within the homebrew. All changes to the configuration are saved in a config file.
http://i.imgur.com/OWcdNhB.jpg


3dfetch running on a New 3DS with Luma CFW.
==Controls==
A - Take screenshots


http://i.imgur.com/qhMDawH.png
D-Pad - Cycle through text colors


A screenshot generated by 3dfetch on a New 3DS with Luma CFW.
L/R -  Change background colors


Select - Config menu


===Where to get it===
==Screenshots==
Check the [releases page](https://github.com/yyualice/3dfetch/releases) for a CIA file / QR code. Or get it on TitleDB within FBI.
https://dlhb.gamebrew.org/3dshomebrews/3dfetch4.png


===Optional configuration===
==Changelog==
3dfetch can optionally be configured by creating a file at the root of your SD card called
'''v1.10/11 2017/07/01'''
* `3dfetch.conf`. At present, the following options are available:
* (1.11) Fixed white background not being properly available.
* `showAnimation:true | false` to enable/disable the little shell animation on startup.
* Added a pretty animation to simulate typing a shell command.
* `showSplash:true | false` to enable/disable the CFW splash on the bottom
* Cycling left text colors now additionally cycles the CFW logo color.
* `showCFW:true | false` to enable/disable CFW detection
* Exact battery percentage is shown.
===Reporting issues===
* Luma CFW now displays the version number with it.
Is your CFW not being recognized properly? Is the amount of free space reported incorrectly? Or maybe you came across an error.
* Added detection for Cakes CFW.
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.
* Added detection for Corbenik CFW.
==Building from source==
* Added detection for RX Tools CFW.
=== Requirements===
* Added detection for Rei CFW.


* - [`makerom`](https://github.com/profi200/Project_CTR/releases) to create the CIA.
==External links==
* - [`3ds-tool`](https://github.com/dnasdw/3dstool/releases) to recompile the ROM filesystem.
* GitHub - https://github.com/aliceinpalth/3dfetch
* - [`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 applications]]
== 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.

Latest revision as of 22:38, 5 November 2022

3dfetch
3dfetch3.png
General
Authoraliceinpalth
TypeUtilities
Version1.10/11
LicenseMixed
Last Updated2017/07/01
Links
Download
Website
Source

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

Available as a CIA/QR code.

Copy .cia to your SD card and install it with the CIA manager of your choice. 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. It is advised to use the compiled binary (lpp-3ds.elf) included in the repository.

To compile:

  • CIA - Run make to build an installable CIA-file.
  • 3DSX - 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.

You can also use the configuration menu within the homebrew. All changes to the configuration are saved in a config file.

Controls

A - Take screenshots

D-Pad - Cycle through text colors

L/R - Change background colors

Select - Config menu

Screenshots

3dfetch4.png

Changelog

v1.10/11 2017/07/01

  • (1.11) Fixed white background not being properly available.
  • Added a pretty animation to simulate typing a shell command.
  • Cycling left text colors now additionally cycles the CFW logo color.
  • Exact battery percentage is shown.
  • Luma CFW now displays the version number with it.
  • Added detection for Cakes CFW.
  • Added detection for Corbenik CFW.
  • Added detection for RX Tools CFW.
  • Added detection for Rei CFW.

External links

Advertising: