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...")
 
m (Text replacement - "Category:3DS homebrew applications" to "")
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = Tinker
|title=Tinker
| image = https://dlhb.gamebrew.org/3dshomebrew/Tinker.jpg|250px
|image=Tinker.png
| type = Utilities
|description=3DS Homebrew Theme Manager for Shufflehax/Menuhax/Themehax.
| version = v1.0.2
|author=HeyItsJono
| licence = Mixed
|lastupdated=2016/01/03
| author = HeyItsJono
|type=Utilities
| website = https://github.com/HeyItsJono/Tinker
|version=1.0.2
| download = https://dlhb.gamebrew.org/3dshomebrew/Tinker.rar
|license=Mixed
| source = https://dlhb.gamebrew.org/3dshomebrew/Tinker.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/tinker.7z?k33p0fil35
|website=https://github.com/HeyItsJono/Tinker
|source=https://github.com/HeyItsJono/Tinker
}}
}}
<youtube>izljcyvozig</youtube>
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 [[Lua Player Plus 3DS|lpp-3ds]].


= Tinker =
'''Note from developer:'''


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.
For user with SysNAND+EmuNAND (CtrBootManager+Menuhax), please note that Tinker will only apply themes to SysNAND. To apply themes to EmuNAND you can safely use [[Custom Home Menu Manager 2 3DS|CHMM2]] after launching HBL from within EmuNAND (via .cia or some other method).


<p align="center">
==Installation==
<img src="https://i.imgur.com/751cheX.png">
Extract archive and copy the Tinker folder to the 3ds folder on your SD Card.
</p>


== Installation ==
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]].


# [https://github.com/HeyItsJono/Tinker/releases/latest Download the .zip file here.]
Themes should each have their own folder with their contents in them like so:
# Extract it to the 3ds folder on your SD Card; the path should look like this: <code>/3ds/Tinker/</code>
# 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:


<pre>/Themes/Theme1/
Root
/Themes/Theme2/
  |-3ds/  
etc </pre>
  |  |-Tinker/
(Theme1, Theme2, etc are just examples of theme names, your theme folders can be named anything, as long as they are in /Themes/)
  |  |  |-Tinker.3dxs (*)
  |  |  |-Tinker.smdh
  |  |  |-...etc
  |-Themes/  
  |  |-Theme1/
  |  |-Theme2/
  |  |-Theme3/


'''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.
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.


== Usage Guide ==
'''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] (included) 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.


* Browse the available themes on the bottom screen using the DPad arrow keys.
==User guide==
* 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.
===How to use===
* 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.
Avilable themes are shown on the botton screen.
* 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 ==
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 [[Custom Home Menu Manager 2 3DS|CHMM2]] if you're looking for standard custom theme installation.
===Create a theme===
A theme is composed by several files:
* body_LZ.bin - Contains background images and some theme settings.
* BGM.bcstm - Contains theme BGM sound.
* Preview.png/.jpg/.bmp - Preview screenshot/image.
* BGM.ogg - Contains theme BGM preview sound.
* info.smdh - Contains icon, author, description and title of the theme.
Recommended tools:
* For the theme, you can use [https://github.com/usagirei/3DS-Theme-Editor Usagi] (theme editor), [http://gbatemp.net/threads/release-yet-another-theme-application-plus-yata-3ds-theme-editor.393355 YATA+] (no .smdh) and [https://gbatemp.net/threads/release-the-smdh-creator-make-your-own-icon-pack.396765 SMDH Creator] (.smdh only).
* For the audio, you can use [http://audacityteam.org Audacity] (music editor) and [https://github.com/libertyernie/LoopingAudioConverter/releases Looping Audio Converter] (converter to .bcstm).
==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://dlhb.gamebrew.org/3dshomebrews/tinker2.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 (Menuhax/etc doesn't support shuffling).
* 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 2016/01/03'''
* 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 2016/01/01'''
* 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 2015/12/31'''
* 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.


* [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.
==External links==
* [https://gbatemp.net/members/ihaveamac.364799/ ihaveamac] for guidance and support in getting features like .3dsx launching working.
* GitHub - https://github.com/HeyItsJono/Tinker
* [https://gbatemp.net/members/15avaughn.376361/ 15avaughn] for his patched Tinker.3dsx file which works on Japanese consoles.
* GBAtemp - https://gbatemp.net/threads/tinker-shuffle-menuhax-theme-manager.407445

Latest revision as of 11:10, 6 May 2024

Tinker
Tinker.png
General
AuthorHeyItsJono
TypeUtilities
Version1.0.2
LicenseMixed
Last Updated2016/01/03
Links
Download
Website
Source

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

Note from developer:

For user with SysNAND+EmuNAND (CtrBootManager+Menuhax), please note that Tinker will only apply themes to SysNAND. To apply themes to EmuNAND you can safely use CHMM2 after launching HBL from within EmuNAND (via .cia or some other method).​

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/
 |  |  |-Tinker.3dxs (*)
 |  |  |-Tinker.smdh
 |  |  |-...etc
 |-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 (included) 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.

Create a theme

A theme is composed by several files:

  • body_LZ.bin - Contains background images and some theme settings.
  • BGM.bcstm - Contains theme BGM sound.
  • Preview.png/.jpg/.bmp - Preview screenshot/image.
  • BGM.ogg - Contains theme BGM preview sound.
  • info.smdh - Contains icon, author, description and title of the theme.

Recommended tools:

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

tinker2.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 (Menuhax/etc doesn't support shuffling).
  • 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 2016/01/03

  • 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 2016/01/01

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

v1.0.0 2015/12/31

  • 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: