Themely 3DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox-3DS-Homebrews
| title = Themely
| title = Themely
| image = https://dlhb.gamebrew.org/3dshomebrew/Themely3ds-01.png|250px
| image = https://dlhb.gamebrew.org/3dshomebrew/Themely3ds-01.png|250px
| type = Utilities
| type = Utilities
| version = v1.3.1-i1 (5 Sept 2017)
| version=v1.3.1
| licence = Mixed
| lastupdated = 2017/09/05
| author = ihaveamac, erman1337
| licence = GNU GPLv3
| author = ihaveamac
| website = https://github.com/ihaveamac/Themely
| website = https://github.com/ihaveamac/Themely
| download = https://github.com/ihaveamac/Themely/releases
| download = https://dlhb.gamebrew.org/3dshomebrew/Themely.rar
| source = https://github.com/ihaveamac/Themely/releases
| source = https://github.com/ihaveamac/Themely
}}
}}
https://dlhb.gamebrew.org/3dshomebrew/themely3ds02.png


https://github.com/ihaveamac/Themely/raw/master/meta/banner_3ds.png
Themely is a theme manager for the 3DS, similar to [[Anemone3DS|Anemone3DS]] and [[Custom Home Menu Manager 2 3DS|CHMM2]], which allows you to apply custom themes to your Nintendo 3DS system.


Themely is a theme manager for the 3DS, similar to [[Custom Home Menu Manager 2 3DS|CHMM2]] which allows you to apply custom themes to your Nintendo 3DS system.
This is an open source fork of Themely originally made by Erman (aka erman1337), and is based off v1.3.1 before the project become closed source.


==Features==
==Features==
Line 31: Line 33:
===Installing===
===Installing===
Available as a 3DSX and CIA.
Available as a 3DSX and CIA.
* 3DSX - Copy .3dxs to the 3ds folder on your SD card and launch it via homebrew loader.
* 3DSX - Copy .3dsx to the 3ds folder on your SD card and launch it via homebrew loader.
* CIA - Copy .cia to your SD card and install it with the CIA manager of your choice.
* CIA - Copy .cia to your SD card and install it with the CIA manager of your choice.


Line 50: Line 52:
===Custom themes===
===Custom themes===
'''Option 1:'''
'''Option 1:'''
* Download your preferred custom themes from [https://themeplaza.eu Theme Plaza].
* Download your preferred custom themes from [https://themeplaza.eu Theme Plaza], or [https://www.gamebrew.org/wiki/Themely_3DS#Create_a_theme make your own custom theme].
* Create a folder called Themes on the root of your SD Card if it does not already exist.
* Create a folder called Themes on the root of your SD Card if it does not already exist.
* Place the ZIP file you downloaded to the Themes folder on your SD Card (no need to extract it).  
* Put the ZIP file, or folder contains your custom theme, to the Themes folder on your SD Card (no need to extract the ZIP file).


'''Option 2:'''
'''Option 2:'''
Line 69: Line 71:
Once completed you should see the the Custom Theme you on your Home Menu.
Once completed you should see the the Custom Theme you on your Home Menu.


To install a new theme, download a new theme from [https://themeplaza.eu Theme Plaza] and install it using Themely.
===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==
==Controls==
Line 81: Line 93:


==Screenshots==
==Screenshots==
https://github.com/ihaveamac/Themely/raw/master/screenshot.png
https://dlhb.gamebrew.org/3dshomebrew/themely3ds03.png


==Media==
==Media==
Line 88: Line 100:


==Changelog==
==Changelog==
'''v1.3.1-i1 5 Sep 2017'''
'''v1.3.1-i1 2017/09/05''' (by ihaveamac)
* Change urls in the interface to themeplaza.eu.
* Change urls in the interface to themeplaza.eu.
* Dutch translation (thanks @QuaserEatingATaco).
* Dutch translation (thanks @QuaserEatingATaco).
* Notice about new theme manager when no themes are found.
* Notice about new theme manager when no themes are found.


'''v1.3.1-i0 30 Jul 2017'''
'''v1.3.1-i0 2017/07/30''' (by ihaveamac)
* The automatic updater has been changed away to prevent it from being updated to the new closed-source releases.
* The automatic updater has been changed away to prevent it from being updated to the new closed-source releases.
* Special thanks to javimadgit for helping fix compile issues.
* Special thanks to javimadgit for helping fix compile issues.


'''v1.3.1 28 Jun 2017'''
'''v1.3.1 2017/06/28'''
* Fixed softlock when Themes folder only contains invalid files.
* Fixed softlock when Themes folder only contains invalid files.
* Fixed crash when Content-Disposition is not formatted like usual.
* Fixed crash when Content-Disposition is not formatted like usual.
Line 103: Line 115:
* Fixed overlapping text in the French translation.
* Fixed overlapping text in the French translation.


'''1.3.0 15 June, 2017'''
'''1.3.0 2017/06/15'''
* Added QR Code reader - scan QR codes from 3DSThem.es to download.
* Added QR Code reader - scan QR codes from 3DSThem.es to download.
* HUGE performance boost for n3DS.
* HUGE performance boost for n3DS.
Line 113: Line 125:
* Other stuff can't fit in here.
* Other stuff can't fit in here.


'''v1.2.1 5 May 2017'''
'''v1.2.1 2017/05/05'''
* Fixed 3DSX version not working.
* Fixed 3DSX version not working.


'''v1.2.0 5 May 2017'''
'''v1.2.0 2017/05/05'''
* Added theme shuffling.
* Added theme shuffling.
* Added theme deletion.
* Added theme deletion.
Line 126: Line 138:
* Other small improvements, thanks Dylan G. (Brickway V1) for testing the bugfixes.
* Other small improvements, thanks Dylan G. (Brickway V1) for testing the bugfixes.


'''v1.1.2 30 April 2017'''
'''v1.1.2 2017/04/30'''
* Support for the new 11.4 payloads.
* Support for the new 11.4 payloads.
* Shutdown screen only triggered if a theme is installed.
* Shutdown screen only triggered if a theme is installed.


'''v1.1.1 29 April 2017'''
'''v1.1.1 2017/04/29'''
* Fixed a bug where going to the "Change Theme" option on the Home Menu after installing a theme with Themely would cause the theme to disappear.
* Fixed a bug where going to the "Change Theme" option on the Home Menu after installing a theme with Themely would cause the theme to disappear.
* Use preview as icon if no SMDH is available.
* Use preview as icon if no SMDH is available.
Line 136: Line 148:
* Long descriptions are now truncated.
* Long descriptions are now truncated.


'''v1.1.0 27 April 2017'''
'''v1.1.0 2017/04/27'''
* Fixed crashes that occurred when there were more than 17~ themes (added lazy loading);
* Fixed crashes that occurred when there were more than 17~ themes (added lazy loading);
* Added installing without BGM.
* Added installing without BGM.
Line 143: Line 155:
* Other small changes.
* Other small changes.


'''v1.0.0 25 April 2017'''
'''v1.0.0 2017/04/25'''
* First release.
* First release.



Revision as of 13:55, 11 September 2021

Template:Infobox-3DS-Homebrews themely3ds02.png

Themely is a theme manager for the 3DS, similar to Anemone3DS and CHMM2, which allows you to apply custom themes to your Nintendo 3DS system.

This is an open source fork of Themely originally made by Erman (aka erman1337), and is based off v1.3.1 before the project become closed source.

Features

  • Native code, up to 380% speed increase from CHMM2.
  • ZIP support (ignores invalid ZIPs).
  • BGM preview support.
  • Instant theme preview.
  • Fullscreen preview.
  • QR Code reader.
  • Install without BGM.
  • Theme shuffle.
  • Theme dumping.
  • Multilingual (French, German, Italian, Portuguese, Russian, Spanish and Dutch).
  • Self updater.

Installation

Installing

Available as a 3DSX and CIA.

  • 3DSX - Copy .3dsx to the 3ds folder on your SD card and launch it via homebrew loader.
  • CIA - Copy .cia to your SD card and install it with the CIA manager of your choice.

Building

  • DevkitARM r46.
  • master branch of ctrulib.
  • next branch of ctrulib.
  • Latest version of sf2dlib.
  • Latest version of sftdlib.
  • Latest version of sfillib.
  • zlib, libpng, libjpeg-turbo, freetype, libogg, and tremor from 3ds-portlibs.

You can run the deps.sh script to install sf2dlib, sftdlib, sfillib, and 3ds-portlibs automatically.

Run make to build the 3DSX, CIA, and ZIP files, make run to build & run on Citra. A debug build with debugging symbols will be built by default, append DEBUG=0 to the make command to build a production build.

User guide

Custom themes

Option 1:

  • Download your preferred custom themes from Theme Plaza, or make your own custom theme.
  • Create a folder called Themes on the root of your SD Card if it does not already exist.
  • Put the ZIP file, or folder contains your custom theme, to the Themes folder on your SD Card (no need to extract the ZIP file).

Option 2:

  • Tap the QR Code button on the Touch Screen to open the QR Code scanner.
  • Go to Theme Plaza, hover over the preview for the theme you want to download.
  • Position your 3DS camera in front of the QR Code. Re-position it until all of the QR Code is visible on the 3DS's screen.
  • The theme will begin downloading after the QR Code is scanned.

How to use

Start Themely (it may black screen the first time you start it. If it does, force the 3DS/2DS to shut down by holding the Power Button and try again).

Find the theme you downloaded in the list. If there is only one theme in your Themes folder, there will not be a list.

Choose the theme you want to install.

Once completed you should see the the Custom Theme you on your Home Menu.

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

A - Install theme

Hold R+A - Install theme without BGM

Start - Exit Themely

HOME - Return to Home Menu

Screenshots

themely3ds03.png

Media

How to Install Custom Themes on 3DS with Themely (T3CHNOLOG1C)

Changelog

v1.3.1-i1 2017/09/05 (by ihaveamac)

  • Change urls in the interface to themeplaza.eu.
  • Dutch translation (thanks @QuaserEatingATaco).
  • Notice about new theme manager when no themes are found.

v1.3.1-i0 2017/07/30 (by ihaveamac)

  • The automatic updater has been changed away to prevent it from being updated to the new closed-source releases.
  • Special thanks to javimadgit for helping fix compile issues.

v1.3.1 2017/06/28

  • Fixed softlock when Themes folder only contains invalid files.
  • Fixed crash when Content-Disposition is not formatted like usual.
  • Fixed SMDH parsing, which also fixed some crashes.
  • Fixed overlapping text in the French translation.

1.3.0 2017/06/15

  • Added QR Code reader - scan QR codes from 3DSThem.es to download.
  • HUGE performance boost for n3DS.
  • Themes are now scanned asynchronously.
  • Themes are now sorted alphabetically (by filename).
  • Translations for FR, DE, IT, PT, RU, and ES (Thanks ZetaDesigns, theheroGAC, Jubash, Ann0ying, umbjolt).
  • Fixed 3DSX updater.
  • Fixed crashes & bugs.
  • Other stuff can't fit in here.

v1.2.1 2017/05/05

  • Fixed 3DSX version not working.

v1.2.0 2017/05/05

  • Added theme shuffling.
  • Added theme deletion.
  • Added theme dumping.
  • Design revamp.
  • Fixed crashes.
  • Fixed a bug where installation would fail at opening/writing to cache.
  • Fixed a bug where some themes wouldn't show up.
  • Other small improvements, thanks Dylan G. (Brickway V1) for testing the bugfixes.

v1.1.2 2017/04/30

  • Support for the new 11.4 payloads.
  • Shutdown screen only triggered if a theme is installed.

v1.1.1 2017/04/29

  • Fixed a bug where going to the "Change Theme" option on the Home Menu after installing a theme with Themely would cause the theme to disappear.
  • Use preview as icon if no SMDH is available.
  • Warn if no DSP dump is available.
  • Long descriptions are now truncated.

v1.1.0 2017/04/27

  • Fixed crashes that occurred when there were more than 17~ themes (added lazy loading);
  • Added installing without BGM.
  • Optimized the theme scanning.
  • Quitting the app now refreshes the theme cache (thx marcuzd).
  • Other small changes.

v1.0.0 2017/04/25

  • First release.

Credits

Thanks to:

  • People at Nintendo Homebrew discord #dev channel (especially MarcusD).
  • DevkitPro contributors.
  • ctrulib contributors.
  • xerpi for sf2dlib and sftdlib.
  • ZetaDesigns for German translation.
  • theheroGAC for Italian translation.
  • Jubash for Portuguese translation.
  • Ann0ying for Russian translation.
  • umbjolt for Spanish translation.
  • QuaserEatingATaco for Dutch translation.

Advertising: