Display an Avatar

From exporting your avatar to displaying it in the viewer

This page has been machine translated and may contain inaccuracies.
In this guide, the avatar display app of VRC Avatar Viewer is referred to as the "Viewer App", and the motion capture app (Motion Capture for VRC Avatar Viewer) is referred to as the "Capture App".
VRC Avatar Viewer
VRC Avatar Viewer
1

Download

Download the viewer (VRC Avatar Viewer) from the BOOTH distribution page. The exporter will be installed via VCC (VRChat Creator Companion) in the next Step 2.

  1. Visit the BOOTH distribution page
  2. Download the viewer
  3. Extract the downloaded ZIP file
BOOTH distribution page
BOOTH distribution page
BOOTH distribution page
Downloaded file
Tips
  • The viewer can be launched immediately after extracting the ZIP (no installation required)
  • The exporter will be installed via VCC (VRChat Creator Companion) in the next Step 2
2

Install the Exporter

The exporter is a Unity editor extension (similar to a plugin). Install it via VCC (VRChat Creator Companion).

  1. Open VCC and click Settings → Packages → Add Repository
VCC Settings button
Click "Settings" in the bottom-left
Packages tab in Settings screen
Click the "Packages" tab
Add Repository button
Click "Add Repository"
  1. Enter the following URL to add it https://vrcavatarviewer.com/vpm/index.json
Enter URL
Enter (paste) the URL and click "Add"
Repository added
Repository has been added
  1. From the project list in VCC, open Manage Project for your avatar project
Manage Project button
Click "Manage Project" of the project
  1. Find "VRC Avatar Viewer Exporter" in the package list and install it with the + button
Install VRC Avatar Viewer Exporter
Click the "+" button next to "VRC Avatar Viewer Exporter"
Installation complete
Installation complete
Note: If NDMF / Modular Avatar is installed, it will integrate automatically. It works fine even without them installed.
3

Export the Avatar

VRC Avatar Viewer handles avatars in its own dedicated format called .avab. Use the exporter to convert your avatar into this format. The original avatar data is not modified at all, so you can work with peace of mind.

  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 → select Export Avatar (.avab)
  3. A save dialog will appear; choose the save location and file name, then click "Save"
  4. A progress bar will appear and the export will proceed
  5. Done when "Export succeeded." is displayed
Select avatar in Hierarchy
Select avatar in Hierarchy
Select Export Avatar from right-click menu
Select Export Avatar from right-click menu
Save dialog
Save dialog
Progress bar during export
Exporting...
Export succeeded dialog
Export succeeded dialog
Tips
  • The exported .avab file can be saved anywhere you like, and you can also bring it to another PC.
  • If you modify the avatar, please export it again (overwriting is also possible)
  • The viewer has a feature to specify a folder and display a list, so it's convenient to keep them all in one folder
4

Display the Avatar in the Viewer

Open the exported .avab file in the viewer. .vrm files are also supported. There are three methods.

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

Method A: Drag & Drop (Easiest, Recommended)

  1. Launch VRC Avatar Viewer
  2. Drag and drop the .avab file directly onto the viewer window
  3. The avatar will be displayed
Drag and drop the .avab file onto the Viewer
Drag and drop the .avab file onto the Viewer

Method B: From 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 selection dialog, select the .avab file and click "Open"
  4. The avatar will be displayed

Method C: Select from 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 the .avab files
  5. The avatar list screen will appear, displaying avatars with thumbnails
  6. Click the avatar you want to display
Avatar displayed
Avatar displayed
Tips
  • The folder selected via Method C is remembered, so you can quickly open the avatar list on next launch
  • When you overwrite-export a .avab file, the Viewer will automatically reload it (no need to reopen)
  • .vrm format files are also supported
5

Basic Controls

Once the avatar is displayed, try moving it around freely with your mouse.

Camera Controls

Action Behavior
Left Drag Rotate the avatar
Right Drag Pan the camera (dynamic bones will react)
Mouse Wheel Zoom in/out
Double-click Zoom to the clicked location (double-click again to return)

Other Features

From the toolbar, you can also use "Desktop Mascot Mode" which makes the background transparent and displays only the avatar on your desktop, animation playback and playlist features using .anim / .vrma files, and a settings menu for lighting, background color, and more.