# FFXV Radio Tuner
### by Lulech23



# README - No, seriously.

Radio Tuner is a simple application for Final Fantasy XV: Windows Edition to completely customize your roadtrip audio experience. Listen to built-in tunes outside the game, export them to your own MP3s, or add your own music library into the game via file replacement--all in a few clicks with a simple GUI.

Now, you can also operate Radio Tuner on the commandline to quickly handle multiple files, individually or in batches! (Using CMD--PowerShell is currently not supported.)

Available command arguments are as follows:
* **-i "C:\file.sab"** | Imports a .sab or .mab file
* **-e "C:\file.mp3"** | Exports the imported file in the desired format (e.g. MP3, OGG, FLAC, WAV, and many more)
* **-r "C:\file.m4a"** | Replaces the imported file with the desired audio file of virtually any format
* **-b** | Replaces the imported file with the backup automatically created by Radio Tuner
* **-v** | Shows the Radio Tuner log when the process is complete

With the exception of the backup argument, all arguments can be input simultaneously in a single command. For example:

```FFXVRT.exe -i "C:\Program Files (x86)\Steam\SteamApps\common\FINAL FANTASY XV\datas\sound\resources\20000music\jp\bgm_afrojack.win.sab" -e "C:\Users\Lulech23\Music\afrojack.mp3" -r "C:\Users\Lulech23\Music\The Beatles\Hey Jude.mp3" -v```

To restore the original file after running this command, simply import the file again and restore the backup:

```FFXVRT.exe -i "C:\Program Files (x86)\Steam\SteamApps\common\FINAL FANTASY XV\datas\sound\resources\20000music\jp\bgm_afrojack.win.sab" -b```

You can also check the log by itself without performing any new operations:

```FFXVRT.exe -v```

On its own, Radio Tuner can only process one file at a time. However, with a little extra code, you can 'loop' through multiple files:

```for %%f in (*.sab) do ( FFXVRT.exe -i "%%f" -b )```

This will take every .sab file in the current folder, replace "%%f" with the name and path of the file, and restore the original audio from a previous Radio Tuner replacement. This is a quick way to reset your game to the default soundtrack.

Unfortunately, a loop isn't so good at replacing specific files with specific audio tracks. This is where a batch file can come in handy. Simply take the first example above, copy it into a text editor, and duplicate the line once for each file you want to replace. (Make sure you ONLY use -v on the last line here.)

When you're done, save the text file as "FFXVRT.bat" (or any name ending in .bat you wish) in the same folder as FFXVRT.exe. Make sure the extension is really just .bat, not .bat.txt. The icon will change from a text file to an executable script. Double-click to run it, and a command window will appear and automatically process each file in sequence.

**Warning:** Commandline execution is an advanced feature and has the potential to execute code that may break your game or worse. Exercise caution, and use at your own risk!



# CHANGELOG:

### 1.0.7
* Added command-line arguments for batch processing
* Added DPI awareness for better scaling at 4K and beyond
* Added warning message if unpacking libraries failed
* Improved library management speed
* Improved log details
* Updated export filename to default to source filename
* Miscellaneous code updates and improvements

### 1.0.6
* Extended time limit for all files to 18 minutes max (audio will no longer be cut off in-game below this duration).
* Fixed audio files with sample rates other than 44.1 KHz playing too slow/fast.
* Updated logging functionality and added a built-in button for opening the log. (Shift-click deletes the log.)
* Fixed replacements reporting "replace complete" when the operation actually failed. Now an error message indicates failed replacement operations.

### 1.0.5
* Added a proper play button icon
* Added a "restore" button (only appears when a backup is available for the imported track)
* Fixed tracks only being replaceable if no backup exists
* Replacements are now logged to "tuner.log" in the target directory for reference

### 1.0.4
* Improved procedural header detection accuracy
* Added experimental support for .mab and OGG-based .sab/.mab files (not guaranteed to work in-game)
* Added support for unicode filenames
* Improved export audio quality

### 1.0.0
* Initial release