Warning

YARG is not done yet! Expect incomplete features and bugs!

We DO NOT encourage, advocate, or promote PIRATING of songs, or of anything else. This game's intended use is for you, the player, to play songs that you already own. This means, ripping songs of a game YOU OWN for YOURSELF for PERSONAL USE, or downloading creative commons/public domain songs off of the internet.

YARG has nothing to do with pirates. It stands for "Yet Another Rhythm Game."

An official installation video is available here.
A community made one is available as well, here.

Windows:

1. Click here to view all releases.
2. Download the lastest zip file by clicking on the "Assets" dropdown and then clicking on YARG_vX.X.X.zip.
3. Extract the contents of the zip file by right clicking it and pressing "Extract All..."
4. Click "Extract".
5. Open the extracted folder and double-click YARG.exe (if you don't have file extensions on, it is called just YARG)
6. You may get a "Windows protected your PC" error. This is because not many people have ran the program before, so Windows does not know if it is harmful or not. Click on "More info" and then "Run anyway" to run YARG anyways. If you don't trust me, please feel free to scan the folder with an anti-virus. Please note that some anti-viruses may have the same problem as Windows.
7. Once you load in, click on "SETTINGS"
8. Then, click on "Open Song Folder Manager"
9. Next, click on "Add Folder." A new text box should pop-up. This is where your songs will come from.
10. Choose your song folder. You can browse folder by click on the folder icon.
11. Once you've chosen your folder, click on "Select Folder". Please be sure that the folder has at least one song in it.
12. YARG will cache all of the files in the folder you chose. Doing this may take a while depending on the amount of songs you have. If you ever add more songs, be sure to go to "SETTINGS" and then click on "Refresh All Caches".
13. Next click on "ADD/EDIT PLAYERS".
    1. Click on "Add Player"
    2. Then click on the device you will be playing with.
    3. Click on the dropdown and select what type of instrument you will be playing (i.e. "Five Fret", "Microphone", etc.)
    4. Depending on the input type, you may have to bind keys. To do this, click on each button and press the key of choice on your controller.
14. Finally, click on "QUICKPLAY".
15. Have fun!

Warning

If you would like to build the game yourself, please follow these instructions.

If you don't follow these instructions, YOU WILL NOT BE ABLE TO RUN THE GAME.

1. Make sure you have the latest version of Blender installed. This is for loading models, even if you don't plan on editing them.
2. Make sure you have Python (3.10) or greater installed. Be sure it is added to system path. This is required to downloading dependencies.
3. Clone the repository. If you don't know how to do this:
   1. Download Git. Be sure it is added to system path.
   2. Open the command prompt in the directory you want to store the repository.
   3. Type in git clone https://github.com/YARC-Official/YARG.git.
4. Install Unity Hub and Unity 2021.3.21f1 (LTS).
   1. Download and install Unity Hub.
   2. Sign-in/create an account with a personal license (free).
   3. In Unity Hub, click on "Install Editor" and select 2021.3.21f1 (LTS). It may be favourable to unselect Visual Studio if you are not using it.
   4. Click "Install"
5. Open the command prompt at the root of the repo, and type in:
   1. pip install requests
   2. python InstallLibraries/install.py. This may take a bit. Wait for the command prompt to say "Done!" before closing. This installs all needed dependencies for you.
6. Open the project in Unity (select "Open" and select YARG's repo's folder).
7. Load in without entering safe mode. Click "Ignore".
8. (You may need to) click on NuGet on the menu bar, then click on Restore Packages.
9. You're ready to go!

Note

If you plan on merging branches, I highly recommend following these instructions for easier merges.

Setup:

1. Open a command prompt to the repository (on VS Code you can do Terminal > New Terminal)
2. Type in git config --local --edit
3. In the file that gets opened, go to the bottom and paste this in: (You may need to change the file path depending on where you installed Unity to)

[merge]
    tool = unityyamlmerge
[mergetool "unityyamlmerge"]
    trustExitCode = false
    cmd = 'C:\\Program Files\\Unity\\Hub\\Editor\\2021.3.21f1\\Editor\\Data\\Tools\\UnityYAMLMerge.exe' merge -p "$BASE" "$REMOTE" "$LOCAL" "$MERGED"

4. Save and close the file.

Resolving conflicts:

1. Start the merge/cherry-pick which is causing conflicts.
2. If the conflict doesn't resolve automatically, open the command prompt and use git merge-tool.
3. Verify that the conflict was resolved correctly, then commit/continue the merge.

Note

If you plan on merging branches, I highly recommend following these instructions for easier merges.

Setup:

1. Open a command prompt to the repository (on VS Code you can do Terminal > New Terminal)
2. Type in git config --local --edit
3. In the file that gets opened, go to the bottom and paste this in: (You may need to change the file path depending on where you installed Unity to)

[merge]
    tool = unityyamlmerge
[mergetool "unityyamlmerge"]
    trustExitCode = false
    cmd = 'C:\\Program Files\\Unity\\Hub\\Editor\\2021.3.21f1\\Editor\\Data\\Tools\\UnityYAMLMerge.exe' merge -p "$BASE" "$REMOTE" "$LOCAL" "$MERGED"

4. Save and close the file.

Resolving conflicts:

1. Start the merge/cherry-pick which is causing conflicts.
2. If the conflict doesn't resolve automatically, open the command prompt and use git merge-tool.
3. Verify that the conflict was resolved correctly, then commit/continue the merge.

If you want to contribute, please feel free! Please join our Discord if you want your PR/Art merged.

YARG is licensed under the MIT License - see the LICENSE file for details.

Some libraries/assets are packaged with the source code have licenses that must be included.

Please note that other libraries are not packaged within the source code, and are to be install by NuGet.

BASS is the audio library for YARG. It has it's own license for release.

Some people have expressed interest in donating. This is an open-source project and therefore donating is not required. If you do want to still help out, spread the word or contribute!