K-YOU v0.5 Beta by LiorMods
Your music as a real San Andreas radio station.
==========================================================================================

K-YOU turns GTA San Andreas' "User Track Player" into K-YOU, a live radio station for the
music player already running on your PC: Spotify, YouTube Music, a browser tab and others.

  * Get in a car, tune to K-YOU, and your music plays. The game's own radio goes quiet.
  * The music pauses when you leave the car, change station, open the menu or Alt+Tab,
    and resumes at the same second.
  * The song name appears under the station name, in any language.
  * The music drops while characters talk, just like the game's own radio.
  * The next car you get into stays on K-YOU.
  * Your own volume keys for the music, separate from the game's sound.
  * Your choice for police cars, ambulances and other emergency vehicles (they have no
    radio in the game): stay quiet, or keep playing K-YOU. See SETTINGS.

No account, no login, no extra program.

BETA: K-YOU was developed and tested on Windows 11 with GTA San Andreas 1.0 US.
Other setups are still being tested. If something doesn't work on yours, please tell us
(see CONTACT at the end).


REQUIREMENTS
------------------------------------------------------------------------------------------
  * GTA San Andreas PC, version 1.0 US. Steam and Rockstar Launcher copies need a downgrade.
    The Definitive Edition is not supported.
  * Windows 11 (developed and tested on it). Windows 10 should work but hasn't been
    tested yet.
  * A music player. Spotify is best. YouTube in a browser tab works but skips more slowly.


INSTALL
------------------------------------------------------------------------------------------
Already use mods like CLEO, Mod Loader or SilentPatch? Then you have an ASI loader: skip step 1.

1. ASI loader (lets the game load plugins)
   a. Open https://github.com/ThirteenAG/Ultimate-ASI-Loader/releases
   b. The latest release lists many files. You need exactly one: vorbisFile.dll in the
      Win32 column. Ignore the others.
   c. In your GTA San Andreas folder (the one with gta_sa.exe), rename the existing
      vorbisFile.dll to vorbisHooked.dll. That keeps the original as a backup.
   d. Put the downloaded vorbisFile.dll in the same folder.

2. MoonLoader (runs the script)
   a. Download the MoonLoader zip straight from the official site. This link starts the
      download at once, so you don't have to find your way around their Russian page:
         https://www.blast.hk/moonloader/download.php?archive
      (Official page: https://www.blast.hk/moonloader/. K-YOU was tested with v.026.5.)
   b. Extract everything from that zip into your GTA San Andreas folder.
   c. If it asks to overwrite bass.dll and you already have one, answer No.

3. DirectX 9 runtime (only if MoonLoader doesn't start, see TROUBLESHOOTING)
   Most PCs already have it. If not, run Microsoft's "DirectX End-User Runtime Web Installer":
      https://www.microsoft.com/en-us/download/details.aspx?id=35
   While it installs, one screen offers the "Bing Bar". Untick that box. It isn't needed.

4. K-YOU
   Copy the "moonloader" folder from this zip into your GTA San Andreas folder.
   Result: GTA San Andreas\moonloader\k-you.lua


PLAY
------------------------------------------------------------------------------------------
  1. Open your music player. Paused is fine.
  2. Start the game. A few seconds in, a hint appears: "K-YOU is ready".
  3. Get in a car and scroll the radio to K-YOU.

  Keys (only while on K-YOU):   ]  next     [  previous     '  play / pause
                                -  volume down            =  volume up


SETTINGS
------------------------------------------------------------------------------------------
After the first run: GTA San Andreas\moonloader\config\k-you.ini (edit with the game closed).
  * Keys               any letter, digit, F1-F24, NUMPAD0-9, [ ] ' ; , . / \ - = ` and more
  * TuneInDelayMs      how long the radio rests on K-YOU before the music starts (default 600)
  * ShowSongNames      song name on screen, 1 = on
  * PauseOnAltTab      pause while the game is in the background, 1 = on
  * AutoTuneOnEnter    0 = game picks the station, 1 = stay on K-YOU if you were on it (default),
                       2 = always start on K-YOU
  * DuckDuringDialogue lower the music while characters talk, 1 = on
  * Volume             K-YOU volume, in percent of your player's own volume (default 100).
                       The - and = keys change it in game and it is saved here.
  * EmergencyVehicles  police cars, ambulances, fire trucks and other emergency vehicles:
                       0 = stay quiet in them, like the game (default),
                       1 = keep playing K-YOU if you were listening to it


TROUBLESHOOTING
------------------------------------------------------------------------------------------
  * No hint and no K-YOU: look for GTA San Andreas\moonloader\moonloader.log
      - No log file: MoonLoader isn't loading. Check step 1 (ASI loader) and step 3 (DirectX).
      - Log file exists: open it and search for "K-YOU".
  * Skips feel slow: YouTube in a browser tab loads each video. Spotify and YouTube Music are instant.
  * You hear the game's music together with yours on K-YOU, and at startup a message says
    "this is not GTA SA 1.0 US": your copy of the game is a different version. K-YOU still
    plays and controls your music, but it can only silence the game's music on version 1.0 US.
    Downgrading the game to 1.0 US fixes it.
  * If the game crashes, your music keeps playing. Pause it in your player.


LICENSE
------------------------------------------------------------------------------------------
K-YOU (c) LiorMods. Free to download and use. Do not reupload, modify for redistribution,
or sell without permission. Videos and streams showing the mod are welcome.

CONTACT
------------------------------------------------------------------------------------------
Website, install guide with pictures, and news:  https://liormods.com/mods/k-you
Questions, bugs, or just want to say hey?       hey@liormods.com

CREDITS
------------------------------------------------------------------------------------------
MoonLoader (c) BlastHack Team, https://www.blast.hk/moonloader/
LuaJIT (c) Mike Pall
Ultimate ASI Loader (c) ThirteenAG
Spotify, YouTube and other names belong to their owners. K-YOU is not affiliated with them.
