VoidTuber

Dances & sounds

MMD dances

The avatar can dance to MMD dances: the dance's own motion, music, camera and lyrics. Dances are started by your redeems and chat commands, so viewers make the avatar dance.

Adding dances

Put each dance in its own folder inside ~/.local/share/vtube-linux/dances (Settings ▸ Dances ▸ Open dances folder). A dance folder holds:

The folder's name is the dance's name. Unpack downloaded .zip or .rar files first, then press Rescan.

Playing them

Use the Play dance action in Redeems: a named dance, or random. With {args} as the dance name, chat can pick one, for example !dance caramell. The triggers Dance started and Dance finished run when a dance starts or ends. To try one without going live, click the trigger and press Test with a fake event.

Dances with several dancers

Some dance folders have a motion file for each dancer. The app finds them by what's in the files, plays the main one on your avatar, and brings in other avatars for the rest. They stand in formation, are scaled to your avatar's height, and leave when the dance ends. Only you see them, not your collab partners.

In Settings ▸ Dances, Extra dancers turns this on or off, and Use copies of my avatar uses less memory and loads faster. Otherwise they're random avatars from ~/.local/share/vtube-linux/dance-avatars (Open dance avatars folder), or from your avatar folder if that's empty.

A dance stops when its motion and camera end, even if the song is longer. Stage and prop models in a dance folder aren't shown yet.

Dance settings

Settings ▸ Dances: Music volume (also for songs the avatar plays itself, like SyncDances and GoGo Loco), Show lyrics (drawn into the picture, so OBS shows them), Use the dance's camera, and Stop the dance while one is playing.

To hear the music in OBS, see App sound in OBS.

Soundboard

Sounds is a soundboard: click a sound to play it. Several can play at once, and Stop all stops them.