Tinker 3DS: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = Tinker | image = https://dlhb.gamebrew.org/3dshomebrew/Tinker.jpg|250px | type = Utilities | version = v1.0.2 | licence = Mixed | author = Hey...")
 
No edit summary
Line 3: Line 3:
| image = https://dlhb.gamebrew.org/3dshomebrew/Tinker.jpg|250px
| image = https://dlhb.gamebrew.org/3dshomebrew/Tinker.jpg|250px
| type = Utilities
| type = Utilities
| version = v1.0.2
| version = v1.0.2 (3 Jan 2016)
| licence = Mixed
| licence = Mixed
| author = HeyItsJono
| author = HeyItsJono
Line 10: Line 10:
| source = https://dlhb.gamebrew.org/3dshomebrew/Tinker.rar
| source = https://dlhb.gamebrew.org/3dshomebrew/Tinker.rar
}}
}}
<youtube>izljcyvozig</youtube>


= Tinker =
Tinker is a 3DS Homebrew Theme Manager for Shufflehax/Menuhax/Themehax. It is heavily inspired by [[Custom Home Menu Manager 2 3DS|CHMM2]] and made using Rinnegatamante's [https://github.com/Rinnegatamante/lpp-3ds lpp-3ds].


3DS Homebrew Theme Manager for Shufflehax/Menuhax/Themehax. Heavily inspired by CHMM2 and made using Rinnegatamante's [https://gbatemp.net/threads/release-lua-player-plus-3ds-lpp-3ds-lua-interpreter-for-3ds.384202/ lpp-3ds]. Please post bug reports or questions in [https://gbatemp.net/threads/tinker-shuffle-menuhax-theme-manager.407445/ the GBATemp development thread], I'm more likely to see them there.
==Installation==
Extract archive and copy the Tinker folder to the 3ds folder on your SD Card.


<p align="center">
Place your themes in a Themes folder at the root of your SD Card, just like you would for [[Custom Home Menu Manager 2 3DS|CHMM2]].  
<img src="https://i.imgur.com/751cheX.png">
</p>


== Installation ==
Themes should each have their own folder with their contents in them like so:


# [https://github.com/HeyItsJono/Tinker/releases/latest Download the .zip file here.]
Root
# Extract it to the 3ds folder on your SD Card; the path should look like this: <code>/3ds/Tinker/</code>
  |-3ds/  
# Place your themes in a Themes folder at the '''root''' of your SD Card, just like you would for CHMM2. Themes should each have their own folder with their contents in them like so:
  |  |-Tinker/
  |    |- .3dxs
  |    |- .smdh
  |    |- ...
  |    |- ...
  |-Themes/  
  |  |-Theme1/
  |  |-Theme2/
  |  |-Theme3/
Theme1, Theme2, etc are just examples of theme names, your theme folders can be named anything, as long as they are in the /Themes/ folder.


<pre>/Themes/Theme1/
'''Note:''' If you have a Japanese 3DS console, there is a bug in the 3dsx file which stops Tinker from running. You'll need to [http://www.mediafire.com/download/ble1n455ao2haoh/Tinker.3dsx download 15avaughn's patched Tinker.3dsx file] and replace /3ds/Tinker/Tinker.3dsx with that patched Tinker.3dsx. Furthermore, launching 3dsx files doesn't work either, meaning after you press A to install a theme from the popup, you need to manually exit out of Tinker, enter Menuhax Manager and select Install Theme. These problems are only present on Japanese 3DS's.
/Themes/Theme2/
etc </pre>
(Theme1, Theme2, etc are just examples of theme names, your theme folders can be named anything, as long as they are in /Themes/)


'''NOTE:''' If you have a Japanese 3DS console, there is a bug in the 3dsx file which stops Tinker from running. You'll need to [http://www.mediafire.com/download/ble1n455ao2haoh/Tinker.3dsx download 15avaughn's patched Tinker.3dsx file] and replace /3ds/Tinker/Tinker.3dsx with that patched Tinker.3dsx. Furthermore, launching 3dsx files doesn't work either, meaning after you press A to install a theme from the popup, you need to manually exit out of Tinker, enter Menuhax Manager and select Install Theme. These problems are only present on Japanese 3DS's.
==User guide==
===How to use===
Avilable themes are shown on the botton screen.


== Usage Guide ==
Theme preview will appear on the top screen. It will last about 5 seconds, then the bottom screen portion will appear. That will disappear after about 5 seconds and you should be able to move again.


* Browse the available themes on the bottom screen using the DPad arrow keys.
Every time you change theme, it brings up a confirmation dialogue:
* Press Y while over a theme to bring up a theme preview on the top screen. Once Y is pressed, the top screen portion of the preview should appear. It will last about 5 seconds, then the bottom screen portion will appear. That will disappear after about 5 seconds and you should be able to move again.
* Pressing A will open up Menuhax Manager, choose Install Custom Theme to install the theme.  
* Press A to apply the theme, this will bring up a confirmation dialogue. Pressing A will open up Menuhax Manager, choose Install Custom Theme to install the theme. Pressing B will close the dialogue box and the theme will not be applied.
* Pressing B will close the dialogue box and the theme will not be applied.
* Press the Start button to exit the application and return to the Homebrew Launcher. This glitches out if you're using the Gridlauncher so you'll have to hold Right Bumper+Left Bumper+Down Arrow+B button to exit.


== Things to note ==
Once you applied new theme, you can exit the application and return to the Homebrew Launcher by pressing Start. This glitches out if you're using the Gridlauncher so you'll have to hold R+L+Down+B to exit.


'''Note:''' This only works for Menuhax theme implementation, use [[Custom Home Menu Manager 2 3DS|CHMM2]] if you're looking for standard custom theme installation.
==Controls==
D-Pad - Browse available themes
Y - Theme preview
A - Apply theme, Install theme
B - Cancel
Start - Exit application and return to Homebrew Launcher (glitches if you use Gridlauncher, use R+L+Down+B instead)
==Screenshots==
https://i.imgur.com/751cheX.png
==Known issues==
* You can't use the touchscreen or circlepad to navigate, circlepad is planned for a future release but touchscreen support probably won't happen because effort.
* You can't use the touchscreen or circlepad to navigate, circlepad is planned for a future release but touchscreen support probably won't happen because effort.
* The Settings button (blue circle with the gear in it) is inaccessible for now, that'll be implemented later when I actually find settings worth implementing.
* The Settings button (blue circle with the gear in it) is inaccessible for now, that'll be implemented in the furture.
* No support for theme shuffling just yet, I'm looking into it to see if it's possible to implement.
* No support for theme shuffling just yet.
* This only works for Menuhax theme implementation, use CHMM2 if you're looking for standard custom theme installation.
* If you have a very large number of themes, the application will likely hang at a black screen on start up for a long time, as it loads them all.
* '''If you have a very large number of themes then the app will likely hang at a black screen on start up for a long time as it loads them all'''


== Changelog ==
==Changelog==
'''v1.0.2 3/1/2016'''
* Introduced proper error dialogue for when Tinker detects Menuhax Manager is not installed, rather than having it throw a Lua-style error.
* Added banners for use with Masher's Gridlauncher (a standard one which is used by default, and a 3dsflow one which can be used by renaming the standard one to something else, and renaming the 3dsflow one to "Tinker-banner-fullscreen.png").
* Added a .3ds file - this has not been tested at all, and have no idea if it works or what it does.


* v1.0.2 (3/1/16)
'''v1.0.1 1/1/2016'''
* Introduced proper error dialogue for when Tinker detects Menuhax Manager is not installed, rather than having it throw a Lua-style error.
* Added banners for use with Masher's Gridlauncher (a standard one which is used by default, and a 3dsflow one which can be used by renaming the standard one to something else, and renaming the 3dsflow one to &quot;Tinker-banner-fullscreen.png&quot;)
* Added a .3ds file - this has not been tested at all, I have no idea if it works or what it does. I don't have any means of testing it currently.
* v1.0.1 (1/1/16)
* Introduced proper error dialogue for when no themes are detected, rather than having it throw a Lua-style error.
* Introduced proper error dialogue for when no themes are detected, rather than having it throw a Lua-style error.
* v1.0.0 (31/12/15)
* Initial release


== Credits ==
'''v1.0.0 31/12/2015'''
* Initial release.
 
==Credits==
* Rinnegatamante for lpp-3ds and also for CHMM2 and Sunshell.
* ihaveamac for guidance and support in getting features like .3dsx launching working.
* 15avaughn for the patched Tinker.3dsx file which works on Japanese consoles.
 
==External links==
* GitHub - https://github.com/HeyItsJono/Tinker
* GBAtemp - https://gbatemp.net/threads/tinker-shuffle-menuhax-theme-manager.407445


* [https://gbatemp.net/members/rinnegatamante.356821/ Rinnegatamante] for lpp-3ds and also for their incredible work on CHMM2 and Sunshell. Without all of those things this project would not be possible.
[[Category:3DS homebrew applications]]
* [https://gbatemp.net/members/ihaveamac.364799/ ihaveamac] for guidance and support in getting features like .3dsx launching working.
[[Category:Homebrew utility applications on 3DS]]
* [https://gbatemp.net/members/15avaughn.376361/ 15avaughn] for his patched Tinker.3dsx file which works on Japanese consoles.

Revision as of 08:36, 13 July 2021

Template:Infobox 3DS homebrew

Tinker is a 3DS Homebrew Theme Manager for Shufflehax/Menuhax/Themehax. It is heavily inspired by CHMM2 and made using Rinnegatamante's lpp-3ds.

Installation

Extract archive and copy the Tinker folder to the 3ds folder on your SD Card.

Place your themes in a Themes folder at the root of your SD Card, just like you would for CHMM2.

Themes should each have their own folder with their contents in them like so:

Root 
 |-3ds/ 
 |  |-Tinker/
 |     |- .3dxs
 |     |- .smdh
 |     |- ...
 |     |- ...
 |-Themes/ 
 |  |-Theme1/
 |  |-Theme2/
 |  |-Theme3/

Theme1, Theme2, etc are just examples of theme names, your theme folders can be named anything, as long as they are in the /Themes/ folder.

Note: If you have a Japanese 3DS console, there is a bug in the 3dsx file which stops Tinker from running. You'll need to download 15avaughn's patched Tinker.3dsx file and replace /3ds/Tinker/Tinker.3dsx with that patched Tinker.3dsx. Furthermore, launching 3dsx files doesn't work either, meaning after you press A to install a theme from the popup, you need to manually exit out of Tinker, enter Menuhax Manager and select Install Theme. These problems are only present on Japanese 3DS's.

User guide

How to use

Avilable themes are shown on the botton screen.

Theme preview will appear on the top screen. It will last about 5 seconds, then the bottom screen portion will appear. That will disappear after about 5 seconds and you should be able to move again.

Every time you change theme, it brings up a confirmation dialogue:

  • Pressing A will open up Menuhax Manager, choose Install Custom Theme to install the theme.
  • Pressing B will close the dialogue box and the theme will not be applied.

Once you applied new theme, you can exit the application and return to the Homebrew Launcher by pressing Start. This glitches out if you're using the Gridlauncher so you'll have to hold R+L+Down+B to exit.

Note: This only works for Menuhax theme implementation, use CHMM2 if you're looking for standard custom theme installation.

Controls

D-Pad - Browse available themes

Y - Theme preview

A - Apply theme, Install theme

B - Cancel

Start - Exit application and return to Homebrew Launcher (glitches if you use Gridlauncher, use R+L+Down+B instead)

Screenshots

751cheX.png

Known issues

  • You can't use the touchscreen or circlepad to navigate, circlepad is planned for a future release but touchscreen support probably won't happen because effort.
  • The Settings button (blue circle with the gear in it) is inaccessible for now, that'll be implemented in the furture.
  • No support for theme shuffling just yet.
  • If you have a very large number of themes, the application will likely hang at a black screen on start up for a long time, as it loads them all.

Changelog

v1.0.2 3/1/2016

  • Introduced proper error dialogue for when Tinker detects Menuhax Manager is not installed, rather than having it throw a Lua-style error.
  • Added banners for use with Masher's Gridlauncher (a standard one which is used by default, and a 3dsflow one which can be used by renaming the standard one to something else, and renaming the 3dsflow one to "Tinker-banner-fullscreen.png").
  • Added a .3ds file - this has not been tested at all, and have no idea if it works or what it does.

v1.0.1 1/1/2016

  • Introduced proper error dialogue for when no themes are detected, rather than having it throw a Lua-style error.

v1.0.0 31/12/2015

  • Initial release.

Credits

  • Rinnegatamante for lpp-3ds and also for CHMM2 and Sunshell.
  • ihaveamac for guidance and support in getting features like .3dsx launching working.
  • 15avaughn for the patched Tinker.3dsx file which works on Japanese consoles.

External links

Advertising: