Skip to content

Commit

Permalink
Merge pull request #297 from llealloo/cli-instructions
Browse files Browse the repository at this point in the history
document cli installation method
  • Loading branch information
pema99 authored Feb 11, 2024
2 parents 682b11b + 8537f6f commit e99a27c
Showing 1 changed file with 25 additions and 19 deletions.
44 changes: 25 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,40 +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.

## First time setup
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.
## Installation

### For Worlds
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. If you want to view the example scene, use the "AudioLink -> Open AudioLink Example Scene" button in the top menu of the editor.
### 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.

### For Avatar Testing
#### 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. 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.
5. At this point, the installation is done. To open your project, you can use the "Open Project" button in the VCC.

#### 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.

##### 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`

### For non-VRChat uses (including CVR)
##### 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`

### 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 e99a27c

Please sign in to comment.