Display Your Avatar

From exporting your avatar to displaying it in the Viewer

This page has been machine translated and may contain inaccuracies.
VRC Avatar Viewer
VRC Avatar Viewer
1

Download

Download the viewer itself (VRC Avatar Viewer) from the BOOTH download page. You'll install the exporter from VCC (VRChat Creator Companion) in Step 2.

  1. Go to the BOOTH download page
  2. Download the viewer
  3. Extract the downloaded ZIP file
BOOTH download page
BOOTH download page
Downloaded files
Downloaded files
Tips
  • Just extract the ZIP and the viewer is ready to launch (no installation required)
  • You'll install the exporter from VCC (VRChat Creator Companion) in Step 2
2

Install the Exporter

The exporter is a Unity editor extension (something like a plugin). Install it from VCC (VRChat Creator Companion).

  1. Open VCC and click Settings → Packages → Add Repository
Settings button in VCC
Click "Settings" in the lower left
Packages tab in the Settings screen
Click the "Packages" tab
Add Repository button
Click "Add Repository"
  1. Enter the following URL and add it https://vrcavatarviewer.com/vpm/index.json
Entering the URL
Enter (copy and paste) the URL and click "Add"
Repository added
The repository has been added
  1. In the VCC project list, open Manage Project for your avatar project
Manage Project button
Click "Manage Project" for your project
  1. Find "VRC Avatar Viewer Exporter" in the package list and install it with the + button
Installing VRC Avatar Viewer Exporter
Click the "+" button for "VRC Avatar Viewer Exporter"
Installation complete
Installation complete
Note: If NDMF / Modular Avatar is installed, the exporter works with it automatically. It's fine if they aren't installed.
3

Export Your Avatar

VRC Avatar Viewer handles avatars in its own dedicated format, .avab. Use the exporter to convert your avatar to this format. Your original avatar data is never modified, so you can work without worry.

  1. In Unity's Hierarchy (the object list on the left side of the screen), select the avatar you want to export Click the avatar's root (the topmost parent object)
  2. With it selected, right-click → VRC Avatar Viewer → Export Avatar (.avab)
  3. A save dialog appears. Choose a location and file name, then click "Save"
  4. A progress bar appears while the export runs
  5. When "Export succeeded." is displayed, you're done
Selecting the avatar in the Hierarchy
Select the avatar in the Hierarchy
Selecting Export Avatar from the right-click menu
Select Export Avatar from the right-click menu
Save dialog
Save dialog
Progress bar during export
Exporting...
Export succeeded dialog
Export succeeded dialog
Tips
  • You can save the exported .avab file anywhere you like, and even take it to another PC.
  • If you change your avatar, export it again (overwriting the old file is fine)
  • The viewer can list all avatars in a folder you choose, so it's handy to keep them in one folder
4

View Your Avatar in the Viewer

Let's open the exported .avab file in the viewer. .vrm files are supported too. There are three ways to do this.

Welcome screen right after launching the viewer
Welcome screen right after launching the viewer

Method A: Drag and drop (easiest, recommended)

  1. Launch VRC Avatar Viewer
  2. Drag and drop the .avab file directly onto the viewer window
  3. Your avatar appears
Dragging and dropping an .avab file onto the viewer
Drag and drop an .avab file onto the viewer

Method B: The "Open Avatar File" button

  1. Launch VRC Avatar Viewer
  2. Click the "Open Avatar File" button at the bottom of the screen
  3. In the file dialog, select the .avab file and click "Open"
  4. Your avatar appears

Method C: Pick from a folder list

  1. Keep your .avab files together in one folder
  2. Launch VRC Avatar Viewer
  3. Click the "Select from Folder" button at the bottom of the screen
  4. Select the folder containing your .avab files
  5. The avatar list screen opens, showing your avatars with thumbnails
  6. If needed, narrow down by avatar name using the search box in the upper right
  7. Click the avatar you want to view
Avatar list screen
Avatar list screen
Avatar displayed in the viewer
Your avatar is displayed
Tips
  • The folder you select in Method C is remembered, so you can open the avatar list right away the next time you launch the viewer
  • In the avatar list, use "Back" or "Reselect Folder" at the bottom of the screen to return to the previous screen or choose a different folder
  • While searching, "Filter active" is shown below the folder display. Click the "×" on the right side of the search box to clear your input
  • If you export over an existing .avab file, the viewer reloads it automatically (no need to open it again)
  • Files in .vrm format are also supported
5

Basic Controls

Once your avatar is displayed, use the mouse to move around and take a look.

Camera Controls

Input Action
Left-drag Rotate the avatar
Right-drag Pan the camera (swaying parts like hair react)
Mouse wheel Zoom in/out
Double-click Reset the camera

Other Features

From the toolbar, you can also use "background transparent mode," which makes the background transparent so only your avatar appears on the desktop, play animations from .anim / .vrma files, and open settings menus for lighting, background color, and more.