More actions
m (HydeWing moved page Sys-Tune Switch to Sys-tune Switch without leaving a redirect) |
|||
| (4 intermediate revisions by the same user not shown) | |||
| Line 4: | Line 4: | ||
|description=A background audio player with overlay. | |description=A background audio player with overlay. | ||
|author=HookedBehemoth | |author=HookedBehemoth | ||
|lastupdated=2023/ | |lastupdated=2023/09/07 | ||
|type= | |type=Overlays | ||
|version= | |version=2.0.0 | ||
|license=Mixed | |license=Mixed | ||
|download=https://dlhb.gamebrew.org/switchhomebrews/systunenx.7z | |download=https://dlhb.gamebrew.org/switchhomebrews/systunenx.7z | ||
| Line 19: | Line 19: | ||
* Extract the zip to the root of your SD card. | * Extract the zip to the root of your SD card. | ||
* Put mp3/flac or wav files to your SD card. | * Put mp3/flac or wav files to your SD card. | ||
Make sure you have [[Tesla Menu Switch|Tesla Menu]] and [[NX-ovlloader Switch|nx-ovlloader]] installed. | |||
You can manage playback via the Tesla overlay in the release. | You can manage playback via the Tesla overlay in the release. | ||
==User guide== | |||
How to play music only on the home menu<ref>TotalJustice. [https://gbatemp.net/threads/sys-tune-background-audio-player-with-overlay.562797/page-6#post-10240912 sys-tune - background audio player with overlay.] GBAtemp, 2023-09-27</ref>: | |||
* Launch sys-tune overlay. | |||
* Scroll down to "Play / Pause" section and click on "Tune (default)" once until it says "Pause". | |||
* Whilst on the home menu and without a game launched in the background, scroll down to "Play / Pause" section and click on "Tune" twice until it says "Play". | |||
*(it will say "Play" by default, but you need to click the option at least once for it to be saved to the config file). | |||
Certain games crash when using sys-tune due to resource limits<ref>ITotalJustice. [https://github.com/HookedBehemoth/sys-tune/issues/10 IAudioRendererManager resource exhaustion in several games · Issue #10 · HookedBehemoth/Sys-Tune.] GitHub, 2023-09-07</ref>, you can manually create a blacklist by configuring the /config/sys-tune/blacklist.ini file: | |||
<pre> | |||
[blacklist] | |||
0100F2300D4BA000 = false | |||
</pre> | |||
==Controls== | ==Controls== | ||
| Line 38: | Line 53: | ||
==Changelog== | ==Changelog== | ||
'''v2.0.0''' | |||
* What's Changed: | |||
** Bulk song queuing by @lucasdepetrisd in [https://github.com/HookedBehemoth/sys-tune/pull/32 #32]. | |||
** add some config options by @ITotalJustice in [https://github.com/HookedBehemoth/sys-tune/pull/35 #35]. | |||
** Retain settings after restarts. | |||
** Game audio volume settings for per game volume control. | |||
** Playback based on titleID. | |||
*** Can be used for home menu background music. | |||
* Fixes: | |||
** Playback will stop instead of crashing on certain games [https://github.com/HookedBehemoth/sys-tune/issues/10 #10]. | |||
*** The list of games can be configured in "/config/sys-tune/blacklist.ini". | |||
<pre> | |||
[blacklist] | |||
0100F2300D4BA000 = false | |||
</pre> | |||
'''v1.2.2''' | '''v1.2.2''' | ||
*Fix for 16.0.0. | *Fix for 16.0.0. | ||
| Line 78: | Line 109: | ||
*[http://mackron.github.io/ mackron] who made the awesome [https://github.com/mackron/dr_libs/ audio decoders used here]. | *[http://mackron.github.io/ mackron] who made the awesome [https://github.com/mackron/dr_libs/ audio decoders used here]. | ||
*[https://werwolv.net/ WerWolv] for making libtesla, the UI library used for the control overlay. | *[https://werwolv.net/ WerWolv] for making libtesla, the UI library used for the control overlay. | ||
==References== | |||
<references /> | |||
== External links == | == External links == | ||
Latest revision as of 07:40, 11 February 2024
| sys-tune | |
|---|---|
 | |
| General | |
| Author | HookedBehemoth |
| Type | Overlays |
| Version | 2.0.0 |
| License | Mixed |
| Last Updated | 2023/09/07 |
| Links | |
| Download | |
| Website | |
| Source | |
| Support Author | |
Background audio player for the Nintendo Switch + Tesla overlay.
Installation
- Download the release zip from here.
- Extract the zip to the root of your SD card.
- Put mp3/flac or wav files to your SD card.
Make sure you have Tesla Menu and nx-ovlloader installed.
You can manage playback via the Tesla overlay in the release.
User guide
How to play music only on the home menu[1]:
- Launch sys-tune overlay.
- Scroll down to "Play / Pause" section and click on "Tune (default)" once until it says "Pause".
- Whilst on the home menu and without a game launched in the background, scroll down to "Play / Pause" section and click on "Tune" twice until it says "Play".
- (it will say "Play" by default, but you need to click the option at least once for it to be saved to the config file).
Certain games crash when using sys-tune due to resource limits[2], you can manually create a blacklist by configuring the /config/sys-tune/blacklist.ini file:
[blacklist] 0100F2300D4BA000 = false
Controls
Y - Shuffle
X - Play/Pause
ZR/ZL - Seek
Screenshots
Media
Play Music On Switch Home Menu | sys-tune TUTORIAL (Manito)
Changelog
v2.0.0
- What's Changed:
- Fixes:
- Playback will stop instead of crashing on certain games #10.
- The list of games can be configured in "/config/sys-tune/blacklist.ini".
- Playback will stop instead of crashing on certain games #10.
[blacklist] 0100F2300D4BA000 = false
v1.2.2
- Fix for 16.0.0.
v1.2.1
- Fix the music browser if the folder sdmc:/music/ isn't used.
v1.2.0
- Add option to shut down service.
- This is to work around an issue with some games that use up all audio renderer sessions.
- The next time you open the overlay it will start the service again.
- Playlist now shows everything.
- Drop Atmosphere-libs in favor of p-sam's IPC server used in sys-clk.
- Frees up some memory.
- Lowers compilation time by a lot.
- Recompiled overlay with latest libtesla.
- An bug in earlier versions could cause a crash if too many overlays were opened.
v1.1.2
- Implemented flac and wav support.
- Implement seeking in tracks.
- mp3's are now fully scanned.
- This fixed an issue where some songs with varying compression levels showed a wrong total length.
- Switched to audrv/audren.
- This fixed an issue where sleep worsened audio output quality.
- Now utilizes ams::fs.
- This reduced memory usage slightly.
At devs:
- API version bump.
- files are now mapped with sdmc:/.
- new call added for seeking.
- CurrentStats struct changed.
v1.0.0
- Initial release.
Credits
Special thanks to:
- mackron who made the awesome audio decoders used here.
- WerWolv for making libtesla, the UI library used for the control overlay.
References
- ↑ TotalJustice. sys-tune - background audio player with overlay. GBAtemp, 2023-09-27
- ↑ ITotalJustice. IAudioRendererManager resource exhaustion in several games · Issue #10 · HookedBehemoth/Sys-Tune. GitHub, 2023-09-07