exelix11 / QuestSongManager

Song and playlist manager for beat saber custom maps on the Meta Quest
GNU General Public License v3.0
11 stars 1 forks source link

Quest Song Manager

This is a simple song manager for the Quest version of Beat Saber. Starting with 1.4 an experimental build for Windows is also available.

Features

Getting Started

1) Download the APK and install it on your Quest 2) Start the app, allow file access and let it scan your songs 3) Enjoy!

Details

This started as a personal project from my unsatisfaction with the other song management options available on the Quest. I made it public hoping it can be useful to others but I don't plan to offer support or major updates.

I tested this app only on my own device where I use a limited number of mods, use at your own risk.

The app will scan the beat saber ModData folder in the quest internal storage. It can load and save json playlists in a way that is compatible with BMBF.

Additionally, the app caches the song hashes to files called .bsq_hash_cache in each song folder. These files can be safely deleted and this feature can be disabled in the settings, but it will make the app start much slower.

The Windows version works mostly fine, however it does not implement all the common playlist json fields so it may lose some metadata when saving playlists.

Screenshots

Video recorded on a Quest

Main screen

Main screen

Download manager

Download manager

Playlist editor

Playlist editor

Development

The app is written using the flutter framework. To build it, you need to have flutter installed and a working android development environment.

Testing on the quest is rather annoying, for development purposes the app also run on Windows and Linux with most features working, you need to change the hardcoded path in lib/main.dart to a folder that has the same file structure as the quest internal storage. The webview feature is only available on Android though, for testing that you can run the app on an emulator or a simple android phone.