Problems & questions

This is an early version, so things will go wrong. When something does, send feedback saying what you were doing right before it happened, and include the end of the app's log:

~/.config/unity3d/zayrix/VoidTuber/Player.log

Settings ▸ Files ▸ Logs ▸ Open opens its folder. The log is replaced each time the app starts, so grab it before restarting.

OBS

The avatar doesn't show up in OBS

Check Integrations ▸ OBS. Add the source again in OBS and pick the camera's exact name (VTuber Avatar unless you renamed it). If you renamed the camera, OBS needs to be pointed at the new name.

OBS has no "PipeWire Video" source

That one comes from an OBS plugin. Use Video Capture Device (PipeWire) instead; it's built into OBS and also transparent.

I can't hear the dance music in OBS

Add an Application Audio Capture (PipeWire) source and pick VoidTuber. See App sound in OBS.

Game Capture shows the interface, or a black background

Press Tab to hide the interface, and tick Allow Transparency in the Game Capture source. See Game Capture.

Tracking

The avatar looks to the side, or up or down, when I'm looking straight

Look straight at the camera and press Ctrl+R.

Turning my head turns the avatar the other way

Tracking ▸ Webcam ▸ Head direction: flip turn, nod or tilt.

The webcam doesn't start

Pick the camera under Tracking ▸ Webcam ▸ Camera. Other programs can keep using the webcam at the same time, but some older programs lock it; close those and toggle tracking off and on.

The mouth moves when I'm not talking

Raise Tracking ▸ Lip sync ▸ Ignore below until it stays still while you're quiet.

Virtual webcam

"Device is busy" or "can't set …"

Another program is writing to that virtual webcam, often OBS's own virtual camera. Pick another device or Automatic under Device.

It says to restart after installing

Your kernel was updated since you last restarted, so the new driver can't load yet. Restart the computer.

Performance

The app uses a lot of my graphics card

Settings ▸ Frame rate: pick 30 or 60. Hiding the interface (Tab) helps a little too.

Questions

Can I use a hat or item I have in VRChat?

Only if you have the item's own files. If you bought it (Booth, Gumroad, Jinxxy) or made it, you have them: open the model in Blender, export it as .glb and add it as a prop on the head, or keep it on the avatar when exporting it. Items that only exist inside VRChat (from its store or a world) can't be taken out. Pulling them out of the game breaks VRChat's rules and the creator's rights, and can get your VRChat account banned. Ask the creator whether they sell it as a download too.

Do I need VNyan or Unity to use the app?

No. .vsfavatar files work as they are. You only need Unity to export a VRChat avatar, once.

Does it work with Wayland? NVIDIA? AMD?

It's made for both Wayland and X11 and tested most on KDE Plasma with an NVIDIA card. AMD and Intel graphics should work too; send feedback if something looks wrong.

My avatar doesn't react to music

Check Integrations ▸ AudioLink: it has to be on, and its meter has to move while music plays. If you picked Chosen programs, the music program has to be ticked. The avatar's materials also have to use AudioLink.

A dance doesn't show up

Each dance needs its own folder in the dances folder with a .vmd motion and its music, unpacked (not a .zip or .rar). Press Settings ▸ Dances ▸ Rescan.

Where are my settings?

~/.config/vtube-linux (settings, automations, props and themes) and ~/.local/share/vtube-linux (avatars, props, sounds, dances). Copy both to move to another computer.

How do I uninstall it?

Switch off Settings ▸ About ▸ Show in the app menu, then delete the AppImage and the two folders above.