Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Sys-tune Switch: Difference between revisions

From GameBrew
(Created page with "{{Infobox Switch Homebrews |title=sys-tune |image=systuneswitch.png |description=A background audio player with overlay. |author=HookedBehemoth |lastupdated=2023/02/26 |type=Media players |version=1.2.2 |license=Mixed |download=https://dlhb.gamebrew.org/switchhomebrews/systuneswitch.7z |website=https://gbatemp.net/threads/sys-tune-background-audio-player-with-overlay.562797/ |source=https://github.com/HookedBehemoth/sys-tune |donation= }} {{#seo: |title=Switch Homebrew A...")
 
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox Switch Homebrews
{{Infobox Switch Homebrews
|title=sys-tune
|title=sys-tune
|image=systuneswitch.png
|image=systunenx.png
|description=A background audio player with overlay.
|description=A background audio player with overlay.
|author=HookedBehemoth
|author=HookedBehemoth
|lastupdated=2023/02/26
|lastupdated=2023/09/07
|type=Media players
|type=Overlays
|version=1.2.2
|version=2.0.0
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/switchhomebrews/systuneswitch.7z
|download=https://dlhb.gamebrew.org/switchhomebrews/systunenx.7z
|website=https://gbatemp.net/threads/sys-tune-background-audio-player-with-overlay.562797/
|website=https://gbatemp.net/threads/sys-tune-background-audio-player-with-overlay.562797/
|source=https://github.com/HookedBehemoth/sys-tune
|source=https://github.com/HookedBehemoth/sys-tune
|donation=
|donation=https://ko-fi.com/HBehemoth
}}
}}
{{#seo:
Background audio player for the Nintendo Switch + Tesla overlay.
|title=Switch Homebrew Apps (Media players) - GameBrew
 
|title_mode=append
==Installation==
|image=systuneswitch.png
* Download the release zip from [https://github.com/HookedBehemoth/sys-tune/releases here].
|image_alt=sys-tune
* Extract the zip to the root of your SD card.
}}
* Put mp3/flac or wav files to your SD card.
{{cleanup|article|Needs cleanup}}
 
A background audio player with overlay.
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.
 
==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==
Y - Shuffle


==Media==
X - Play/Pause
<youtube></youtube>


ZR/ZL - Seek


==Screenshots==
==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/systunenx5.png
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/systunenx4.png
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-03.png
 
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-04.png
==Media==
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-05.png
'''Play Music On Switch Home Menu | sys-tune TUTORIAL''' ([https://www.youtube.com/watch?v=O9ryU7GVDes Manito]) <br>
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-06.png
<youtube>O9ryU7GVDes</youtube>
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-07.png
https://dlhb.gamebrew.org/switchhomebrews/systuneswitch-08.png


==Changelog==
==Changelog==
'''v.1.0'''
'''v2.0.0'''
* First Release.
* 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'''
*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:
*[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.
 
==References==
<references />


== External links ==
== External links ==
* Gbatemp - https://gbatemp.net/threads/sys-tune-background-audio-player-with-overlay.562797/
* Author's Patreon - https://www.patreon.com/HookedBehemoth
* Github - https://github.com/HookedBehemoth/sys-tune
* GitHub - https://github.com/HookedBehemoth/sys-tune
* Reddit -
* GBAtemp - https://gbatemp.net/threads/sys-tune-background-audio-player-with-overlay.562797/

Latest revision as of 07:40, 11 February 2024

sys-tune
Systunenx.png
General
AuthorHookedBehemoth
TypeOverlays
Version2.0.0
LicenseMixed
Last Updated2023/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

systunenx5.png systunenx4.png

Media

Play Music On Switch Home Menu | sys-tune TUTORIAL (Manito)

Changelog

v2.0.0

  • What's Changed:
    • Bulk song queuing by @lucasdepetrisd in #32.
    • add some config options by @ITotalJustice in #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 #10.
      • The list of games can be configured in "/config/sys-tune/blacklist.ini".
[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:

References

External links

Advertising: