Avatars

The app loads two kinds of avatar file from ~/.local/share/vtube-linux/avatars. New files show up in the Avatar window by themselves, or press Rescan.

File	Where it comes from
`.vsfavatar`	VNyan and VSeeFace avatars. Copy the file in as it is.
`.vtav`	Exported from a Unity project with the VoidTuber exporter: VRChat avatars and VRM avatars.

Exporting a VRChat avatar

The exporter is a Unity package. Ask Zayrix for VoidTuber-Exporter.unitypackage.

Open your avatar's Unity project (Unity 2022.3, the version VRChat uses). In Unity Hub, add Linux Build Support (Mono) to that Unity version (Installs ▸ ⚙ ▸ Add modules).
Drag the .unitypackage into the project and click Import.
Open the avatar's scene, then Tools ▸ VoidTuber ▸ Avatar Exporter…
Pick the avatar, read the checks and click Export. The file goes straight into the app's avatars folder.

The first export of an avatar takes a few minutes while its shaders are compiled for Linux. Later exports are quicker. The exporter only compiles what the app uses, so it's much faster than an upload build.

Exporting on Windows

The exporter works in Windows Unity too (it also needs Linux Build Support (Mono)). On Windows it asks where to save the file each time. Copy the .vtav file to your Linux PC (USB stick, Discord, cloud drive…), then in the app use Avatar ▸ Add an avatar file….

What comes along

Poiyomi and other shaders, PhysBones and their colliders, VRChat constraints
The expressions menu: toggles, radial sliders, gestures and emotes
Visemes (mouth shapes), blinking and eye movement
VRCFury and Modular Avatar. Their build steps run on a copy, the same way they do for an upload.
VRM avatars (UniVRM 0.x): expressions, visemes, blink, eyes and VRM spring bones

Your project isn't changed. Every export works on a temporary copy of the avatar, which is deleted afterwards. The exporter doesn't upload anything or connect to the internet.

Size

Avatar ▸ Size makes the avatar bigger or smaller. The size is saved for each avatar, and collab partners see it too. The camera doesn't move with it, so reframe with the mouse (right-drag, wheel) or Alt+C. Redeems can change the size for a while with the Avatar size action.

Toggles and the expressions menu

Avatar ▸ Toggles lists every on/off toggle and slider from the avatar's VRChat expressions menu: outfits, accessories, ear size and so on, grouped like the menu. Search it with the box at the top. Reset all puts everything back to how the avatar was uploaded.

Press R to open the round expressions menu just like in VRChat. It also has the buttons and puppets that the Toggles tab can't show.

Face expressions

Avatar ▸ Face lists the avatar's own facial expressions, grouped into face, eyes, eyebrows, mouth and so on. Click one to hold it, and click again to let go. Release all lets go of everything. Redeems can hold an expression for a few seconds with the Expression action.