Skip to content

Commit

Permalink
we do a little documenting
Browse files Browse the repository at this point in the history
  • Loading branch information
float3 committed Feb 11, 2024
1 parent a935b92 commit f28c353
Showing 1 changed file with 17 additions and 21 deletions.
38 changes: 17 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,50 +51,46 @@ The per-frequency audio amplitude data is first read briefly into Udon using Uni
1. In a file browser, delete the "Assets/AudioLink" folder and the "AudioLink.meta" file.
2. Follow the "First time setup" steps for avatar projects described below.


## Installation
Looking to test out an avatar? See the "For Avatar Testing" section. Otherwise, see the "For Worlds" section below. After installation, check the "Getting Started" section for some tips.

### Windows
### VRC
Looking to test out an avatar? See the ["For VRC Avatar Testing"](#for-vrc-avatar-testing) section. Otherwise, see the ["For VRC Worlds and other usecases"](#for-vrc-worlds-and-other-usecases) section after installation.

#### VCC (Windows Only)
1. Download and install the [VRChat Creator Companion](https://vrchat.com/download/vcc) (VCC), open it up.
2. Add your project to the VCC:
- If you want to create a new project, use the "New" option in the "Projects" tab and follow the steps there.
- If you want to use an existing project, use the "Add" option in the "Projects" tab and follow the steps there.
3. Open the Projects tab and select your project. If you have never used the VCC with the project, use the "Migrate" button to upgrade it.
4. On the right side, find the AudioLink package and add it. If it doesn't show up, make sure you have the "Curated" toggle enabled in the top-right drop-down.
5. At this point, the installation is done. To open your project, you can use the "Open Project" button in the VCC.

#### For Worlds
5. At this point, the installation is done. To open your project, you can use the "Open Project" button in the VCC. If you want to view the example scene, use the "AudioLink -> Open AudioLink Example Scene" button in the top menu of the editor.

#### For Avatar Testing
5. Use the "Tools/AudioLink/Add AudioLink Prefab to Scene" menu item.
6. Under AudioLinkAvatar/AudioLinkInput, add a music track to the AudioClip in the AudioSource.
- If you need it louder, duplicate the AudioLinkInput object and increase the volume on that one. Make sure Not to adjust the volume on the main AudioLinkInput object - it needs to stay at 0.01.
7. Enter playmode to test your avatar.
#### Commandline (Linux/macOs/Windows)
For installing on Linux and macOS, and for Windows users who prefer the command line, we recommend using `vrc-get`. This is because it is open-source and, at the time of writing, `vpm` has unresolved bug(s) that might stop it from working on some systems.

### Linux/macOs/Windows

For installing on Linux and macOS, and for Windows users who prefer the command line, we recommend using `vrc-get`. This is because, at the time of writing, `vpm` has unresolved bug(s) that might stop it from working on some systems.

#### vrc-get
##### vrc-get
1. Install [vrc-get](https://github.com/anatawa12/vrc-get?tab=readme-ov-file#installation)
2. Open a console and `cd /path/to/your/project`
3. Run `vrc-get i audiolink`

#### vpm
##### vpm
1. Install [vpm](https://vcc.docs.vrchat.com/vpm/cli/#installation--updating/) and follow their setup instructions
2. Run `vpm add package com.llealloo.audiolink -p /path/to/your/unity/project`

#### For non-VRChat uses (including CVR)
### General (non VRC, including CVR)
1. Download and Import the latest **UnityPackage** AudioLink Release at https://github.com/llealloo/vrc-udon-audio-link/releases.
2. Use the "Tools/AudioLink/Add AudioLink Prefab to Scene" menu item. It should work out of the box.

## Getting started
After installation, to use AudioLink:
1. Use the "Tools/AudioLink/Add AudioLink Prefab to Scene" menu item.
2. Click the "Link all sound reactive objects..." button to link everything up.
1. If you want to view the example scene, use the "AudioLink/Open AudioLink Example Scene" button in the top menu of the editor or use the "Tools/AudioLink/Add AudioLink Prefab to Scene" menu item.

#### For VRC Avatar Testing
2. Under AudioLinkAvatar/AudioLinkInput, add a music track to the AudioClip in the AudioSource.
3. Enter playmode to test your avatar.

If you want to see an example of a scene with AudioLink set up, press the "AudioLink -> Open AudioLink Example Scene" in the top menu of the editor.
#### For VRC Worlds and other usecases
2. Click the "Link all sound reactive objects..." button on the AudioLink MonoBehaviour to link everything up.

## Compatible tools / assets
- [Silent Cel Shading Shader](https://gitlab.com/s-ilent/SCSS) by Silent
Expand Down

0 comments on commit f28c353

Please sign in to comment.