LumaLocaleSwitcher 3DS: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = LumaLocaleSwitcher | image = https://dlhb.gamebrew.org/3dshomebrew/LumaLocaleSwitcher.jpg|250px | type = Utilities | version = v0.04 | licence...")
 
m (Text replacement - "Category:Homebrew utility applications on 3DS" to "")
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = LumaLocaleSwitcher
|title=LumaLocaleSwitcher
| image = https://dlhb.gamebrew.org/3dshomebrew/LumaLocaleSwitcher.jpg|250px
|image=Lumalocaleswitcher2.png
| type = Utilities
|description=A tool to manage the language of 3DS software.
| version = v0.04
|author=Possum
| licence = Mixed
|lastupdated=2017/04/23
| author = Possum
|type=Utilities
| website = https://github.com/Possum/LumaLocaleSwitcher
|version=0.04
| download = https://dlhb.gamebrew.org/3dshomebrew/LumaLocaleSwitcher.rar
|license=MIT
| source = https://dlhb.gamebrew.org/3dshomebrew/LumaLocaleSwitcher.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/lumalocaleswitcher.7z
|website=https://github.com/Possum/LumaLocaleSwitcher
|source=https://github.com/Possum/LumaLocaleSwitcher
}}
}}
<youtube>LVkZf2yM_UE&t=5s</youtube>
LumaLocaleSwitcher is a front end to the Luma built-in [https://github.com/LumaTeam/Luma3DS/wiki/Optional-features region emulation].
 
It is based off of FBI for UI and title listing features, can be used to manage per-title locales for [[Luma3DS|Luma3DS]] (and compatible forks such as SaltFW).
 
==Installation==
===Installing===
Both LumaLocaleSwitcher Nightly and Stable builds (v0.04) are identical with the exception that they have different defaults.
* Stable - If your Luma is 6.6 or lower.
* Nightly version - If your Luma is greater than 6.6 or Nightly.
 
Install either one of the .cia file using a CIA installer such as [[FBI 3DS|FBI]]. [https://github.com/Possum/LumaLocaleSwitcher QR code] is also available.
 
===Building===
Requires [http://sourceforge.net/projects/devkitpro/files/devkitARM devkitARM] and [https://github.com/fincs/citro3d citro3d] to build. You also need [[Libctru_3DS|Ctrulib 3DS]].


= LumaLocaleSwitcher =
To build, call <code>git submodule sync</code> (to pull in [https://github.com/aliaspider/svchax svchax] and [git://github.com/Steveice10/buildtools buildtools]) and <code>make</code> and you should be good. If you are running nightly Luma3DS, you can run <code>make LUMA_NIGHTLY=1</code> to get sane defaults.


LumaLocaleSwitcher can be used to manage per-title locales for Luma3ds (and compatible forks such as SaltFW).
==User guide==
===Set up===
If you use Luma3DS and downloaded the appropriate verison (nightly or stable) you can just select Titles and make your changes.  


== Installation ==
Otherwise, you can choose from the list in the app or write your own custom path to /locales.conf (the path for the TitleID for each specific title is /luma/titles/<titleID>/locale.txt).


Install the .cia file using a CIA installer such as [https://github.com/Steveice10/FBI/releases FBI]. If you are using the latest ''stable'' version of Luma3DS (6.6 at this time), scan the QR code below for the latest release (0.04): [[File:https://raw.githubusercontent.com/Possum/LumaLocaleSwitcher/master/qr/0.04.png|QR]] If you are using the ''nightly'' version of Luma3DS (or any version newer than 6.6), scan the QR code below for the latest nightly compatible release (0.04-NIGHTLY): [[File:https://raw.githubusercontent.com/Possum/LumaLocaleSwitcher/master/qr/0.04-NIGHTLY.png|QR]]
When choosing region and language settings, a separate folder is created using the title ID as it's name with a locale.txt file inside with the users settings.


== Compiling ==
'''Note:''' Also make sure to enable Game Patching from Luma3DS's configuration menu.


Requires [http://sourceforge.net/projects/devkitpro/files/devkitARM/ devkitARM] and [https://github.com/fincs/citro3d citro3d] to build. You also need [https://github.com/smealum/ctrulib ctrulib]. To build, just call <code>git submodule sync</code> (to pull in [https://github.com/aliaspider/svchax svchax] and [git://github.com/Steveice10/buildtools buildtools]) and <code>make</code> and you should be good. If you are running nightly Luma3DS, you can run <code>make LUMA_NIGHTLY=1</code> to get sane defaults.
===Limitations===
Currently requires the parent path of the locales directory to exist (i.e., it will not create the directory for you).  
* If it fails to set the region for a title, that is the most likely reason.  
* If you are using Luma, and everything is properly set up, this shouldn't affect you, since the /luma/ directory should exist anyway.  
* There is no file chooser built in, so if you need to use a custom directory for some reason, you will have to write the path to /locales.conf manually.  


== Set up ==
Changing the region emulation is not always a magic bullet, due to the way the 3ds services are set up.
* In particular, online play may not function even when the region emulation is set up properly.
* If you are receiving 003-0399, either give up or use a search engine to look for workarounds.


If you use Luma3DS and downloaded the appropriate verison (''nightly'' or ''stable'') you can just select &quot;Titles&quot; and make your changes. Otherwise, you can choose from the list in the app or write your own custom path to /locales.conf
==Media==
'''Changing game language with the Luma Locale Switcher''' ([https://www.youtube.com/watch?v=LVkZf2yM_UE sthetix]) <br>
<youtube>LVkZf2yM_UE&t=5s</youtube>


== Known Limitations ==
==Known issues==
Please see https://github.com/Possum/LumaLocaleSwitcher/issues


Currently requires the parent path of the locales directory to exist (i.e., it will not create the directory for you). If it fails to set the region for a title, that is the most likely reason. If you are using Luma, and everything is properly set up, this shouldn't affect you, since the &quot;/luma&quot; directory should exist anyway. There is no file chooser built in, so if you need to use a custom directory for some reason, you will have to write the path to /locales.conf manually. Changing the region emulation is not always a magic bullet, due to the way the 3ds services are set up. In particular, online play may not function even when the region emulation is set up properly. If you are receiving 003-0399, either give up or use a search engine to look for workarounds.
==Changelog==
'''v0.04'''
* Fixes typos in default paths.
* Fixes detection issues in the UI.
* Hide title IDs most people would not want to tweak (DS/system titles; they can be toggled on with the Y button).


== Bugs ==
'''v0.03'''
* Adds compatibility the Luma NIGHTLY paths.
* NOTE: there is no migration option, so you will have to migrate your files manually or start fresh.
* Adds more flexibility with path location.
* Handles non-existing directories more gracefully.
* Updates to build with the latest ctrulib.
* The builds below are identical with the exception that they have different defaults.


Please report bugs at https://github.com/Possum/LumaLocaleSwitcher/
'''v0.02'''
* Fixes compatibility issues with manually created files.
* Adds the new SaltFW directory.
* Updates to build with the latest ctrulib.


== Credits ==
'''v0.01'''
* Initial release.


This is largely based on [https://github.com/Steveice10/FBI FBI] by [https://github.com/Steveice10 Steveice10]. This also would not be possible without [https://github.com/AuroraWright AuroraWright]'s work on the region emulation feature in [https://github.com/AuroraWright/Luma3DS/ Luma3DS].
==Credits==
This is largely based on [[FBI 3DS|FBI]] by [https://github.com/Steveice10 Steveice10].  


=== Contributors ===
This also would not be possible without [https://github.com/AuroraWright AuroraWright]'s work on the region emulation feature in [[Luma3DS|Luma3DS]].


* [https://github.com/Possum Possum] - project maintainer
Contributors:
* CouldBeWolf - beta tester, bug reports
* [https://github.com/Possum Possum] - project maintainer.
* ericjwg - patches, testing, and building As always, big thanks to the 3DS homebrew/CFW community!
* CouldBeWolf - beta tester, bug reports.
* ericjwg - patches, testing, and building.


== License ==
As always, big thanks to the 3DS homebrew/CFW community.


This software is provided under the MIT license. Please see LICENSE.txt for full details for the license.
==External links==
* GitHub - https://github.com/Possum/LumaLocaleSwitcher
* Reddit - https://www.reddit.com/r/3dshacks/comments/4rwj51/comment/d54x88h/?utm_source=share&utm_medium=web2x&context=3

Latest revision as of 05:40, 6 May 2024

LumaLocaleSwitcher
Lumalocaleswitcher2.png
General
AuthorPossum
TypeUtilities
Version0.04
LicenseMIT License
Last Updated2017/04/23
Links
Download
Website
Source

LumaLocaleSwitcher is a front end to the Luma built-in region emulation.

It is based off of FBI for UI and title listing features, can be used to manage per-title locales for Luma3DS (and compatible forks such as SaltFW).

Installation

Installing

Both LumaLocaleSwitcher Nightly and Stable builds (v0.04) are identical with the exception that they have different defaults.

  • Stable - If your Luma is 6.6 or lower.
  • Nightly version - If your Luma is greater than 6.6 or Nightly.

Install either one of the .cia file using a CIA installer such as FBI. QR code is also available.

Building

Requires devkitARM and citro3d to build. You also need Ctrulib 3DS.

To build, call git submodule sync (to pull in svchax and buildtools) and make and you should be good. If you are running nightly Luma3DS, you can run make LUMA_NIGHTLY=1 to get sane defaults.

User guide

Set up

If you use Luma3DS and downloaded the appropriate verison (nightly or stable) you can just select Titles and make your changes.

Otherwise, you can choose from the list in the app or write your own custom path to /locales.conf (the path for the TitleID for each specific title is /luma/titles/<titleID>/locale.txt).

When choosing region and language settings, a separate folder is created using the title ID as it's name with a locale.txt file inside with the users settings.

Note: Also make sure to enable Game Patching from Luma3DS's configuration menu.

Limitations

Currently requires the parent path of the locales directory to exist (i.e., it will not create the directory for you).

  • If it fails to set the region for a title, that is the most likely reason.
  • If you are using Luma, and everything is properly set up, this shouldn't affect you, since the /luma/ directory should exist anyway.
  • There is no file chooser built in, so if you need to use a custom directory for some reason, you will have to write the path to /locales.conf manually.

Changing the region emulation is not always a magic bullet, due to the way the 3ds services are set up.

  • In particular, online play may not function even when the region emulation is set up properly.
  • If you are receiving 003-0399, either give up or use a search engine to look for workarounds.

Media

Changing game language with the Luma Locale Switcher (sthetix)

Known issues

Please see https://github.com/Possum/LumaLocaleSwitcher/issues

Changelog

v0.04

  • Fixes typos in default paths.
  • Fixes detection issues in the UI.
  • Hide title IDs most people would not want to tweak (DS/system titles; they can be toggled on with the Y button).

v0.03

  • Adds compatibility the Luma NIGHTLY paths.
  • NOTE: there is no migration option, so you will have to migrate your files manually or start fresh.
  • Adds more flexibility with path location.
  • Handles non-existing directories more gracefully.
  • Updates to build with the latest ctrulib.
  • The builds below are identical with the exception that they have different defaults.

v0.02

  • Fixes compatibility issues with manually created files.
  • Adds the new SaltFW directory.
  • Updates to build with the latest ctrulib.

v0.01

  • Initial release.

Credits

This is largely based on FBI by Steveice10.

This also would not be possible without AuroraWright's work on the region emulation feature in Luma3DS.

Contributors:

  • Possum - project maintainer.
  • CouldBeWolf - beta tester, bug reports.
  • ericjwg - patches, testing, and building.

As always, big thanks to the 3DS homebrew/CFW community.

External links

Advertising: