help

welcome to the veadotube help page! this is an effort to aggregate everything you might need to know about the app in one, indexable place, instead of keeping it lost in a Discord chat.

unless stated otherwise, everything in here is written with the latest versions in mind, which for mini is currently 2.1.

we’re working on redesigning this page to make it more complete, easy to read, with search functions and more images and proper guides for the full version!

installation guides

downloading & installing on Windows

downloading & installing on macOS

downloading & installing on Linux

veadotube mini guides

creating and preparing images

using the app and building your avatar with it

[1.4 and older] using the app and building your avatar with it

streaming with mini and OBS

changing states with Stream Deck

collabing with friends using vdo.ninja

advanced guides

finding (and changing) the data folder

creating and installing language packs

connecting to the websocket server

anatomy of a .veado file

common issues & questions

veadotube is programmed by a single person, as such it’s impossible to support every platform or device or anything out there. we still try our best though, as the intention of the project is to make these digital puppets accessible for anyone!

if you’re having issues, before anything, make sure you’re on the latest version (for mini that’s 2.1)! if unsure, try redownloading it.

running the app

i can’t download veadotube mini for free, it asks me to pay for it

just click on the link on top that says “No thanks, just take me to the downloads”!

Windows tells me the app is a virus

we guarantee you it’s not! as long as you’re downloading from the official source (the link in the home page), of course. refer to the opening guide.

VirusTotal tells me the app is a virus

it’s a false positive! that website is full of false positives, too. again, if you downloaded the app from the official source (the link in the home page), you’re safe.

the app does not open on Windows

remember to unzip the file you downloaded first, instead of opening the app directly from inside the zip! in any case, refer to the opening guide.

i’m using mini 1.4 and Windows tells me UnityPlayer.dll cannot be found

remember to unzip the file you downloaded first, instead of opening the app directly from inside the zip! running as administrator might help you, too. in any case, refer to the opening guide!

i’m getting a black/blank screen on Windows/Spout2

that’s usually a graphics card issue. update your drivers! also look into updating your DirectX. you can also try to run the app as administrator!

macOS says the app is damaged / made by an unverified developer

refer to the opening guide to fix that. if that doesn’t work, try googling it, honestly! it’s a surprisingly common error amongst non-store apps, unfortunately.

macOS says there are no mountable file systems / the app won’t run

you’re probably running on an old version of macOS! mini requires at least Monterey (12).

my Linux system can’t open the executable

remember to install all the dependencies and to do the chmod trick – refer to the opening guide! you can also try to update your kernel version – the minimum required is 5.15.

i’m using mini 1.4 and my Linux system crashes the app at startup

Unity has weirdly poor support on Linux, and so versions prior to 2.0 can just do that. for these old versions, we heard that running the Windows version through Proton works a lot better!

using veadotube mini

i see no text in the app

if you’re on Linux, you might be missing some dependencies, or they might not be correctly linked. refer to the opening guide!

if you’re on Windows, this is a known issue for some users. we’re looking into that!

my microphone doesn’t work with the app

microphones are weird! they sometimes don’t work, or might not even show up on the microphone list for a few people. here’s a few things you can try:

  • make sure the microphone sensitivity slider isn’t too high!
  • if you’re not using push-to-talk, ensure use websocket is turned off in the microphone settings and that there are no shortcuts set in there as well!
  • unplug your microphone and plug it back again!
  • restart the app! maybe twice!
  • on Windows, remember to install all the requirements, or maybe run the app as administrator!
  • on macOS, ensure that the app has the microphone access permission!
  • if you’re using 1.4, consider upgrading to 2.0, which supports microphones a lot better!

my microphone captures way too much noise

you can filter noise through the microphone menu ! this way it’s also easier to set the slider .

microphone noise filters won’t work

if you’re on Linux, remember to install all dependencies! refer to the opening guide.

shortcuts won’t work

if the app doesn’t detect shortcuts, you can try a few things:

  • Windows: run the app as administrator!
  • macOS: let the app use keystrokes over your privacy settings on System Preferences!
  • Linux: run the app with root access! if you’re on Wayland, configure your system so that applications can use legacy global hotkeys.

i can’t select any images / it only lets me select .veadomini files

try using the face buttons on the state editor on the right, instead of the avatar button !

some images don’t appear correctly

a few image file formats aren’t fully supported! for a full list of supported files, refer to the image guide.

my avatar appears too blurry / i have a pixel avatar and it looks awful

try changing the image mode to pixel, under the state properties , as well as changing the avatar scale on the display settings !

my avatar has a weird border on veadotube mini when using transparency

it’s on purpose! this way OBS can capture it with correct transparency.

my avatar has a weird border when i capture it on my streaming software

check out the OBS guide for some tricks to avoid that!

the app didn’t autosave my avatar and i lost it

the autosave is being constantly improved on, though that bug might still happen in rare circumstances! you can see if there are any remains of your autosaved avatar on the data folder.

in general, always remember to keep a copy of your avatar as a .veado file!

i’m using mini 1.4 on mac and i can’t click anything

Apple introduced this bug in macOS 14 (Sonoma) in M-series Macs, and every Unity app was affected by this! they fixed it in macOS 14.4.1, so be sure to update your Mac if you can.

if you’re stuck with an older version of both Sonoma and mini: it seems if you fullscreen the app, tab to another window, then tab back to the app, you should be able to click the buttons again. you’ll only be able to click on stuff in fullscreen unfortunately, but once you’re done editing your avatar you can exit fullscreen and resize the window again!

the interface won’t hide automatically

to make sure the interface won’t show up, click on hide UI under the program settings button ! you can double-click on the app screen later to display the interface back again.

the app is taking up too much CPU

at certain moments, the new engine is known to take a bit more CPU than Unity did. it’s a work in progress! we’re continuously updating the app with performance improvements.

the app is taking up too much RAM

images take a lot of space in RAM, despite the file size itself! we’re constantly trying to keep veado from using too many resources, but you can try a few things too:

  • have less images loaded!
  • shrink your images a bit!
  • if you’re working with animated images, use less frames!
  • turn off keep all states loaded under program settings !

for more information, refer to the image guide.

the app runs really badly alongside other games

sometimes your system assumes veadotube is a game, and it might be confused as to why there are two games running! this is often a GPU driver issue, or something that you can configure in your system/GPU settings.

i’m using mini 1.4 and the app is full screen for some reason

press alt + enter and you should be out!

what’s the default size for the app window?

960 x 540!

how do i use my avatar in video calls?

for now refer to the OBS guide! OBS lets you create a virtual webcam, thus letting you use your avatar in Discord video calls, for example.

is there a way to listen to a Discord user instead of a microphone?

you’re probably looking for something that behaves like Discord Reactive Images by FugiTech, and that’s probably your best alternative if you’re willing to have simpler talksprites!

if you wanna use mini nonetheless, check out the vdo.ninja guide.

general

will the app be available on Android/iOS/iPad?

our priority is the desktop version. however we do have plans for a mobile version, but we can’t tell you yet what it’d be or when that’d happen!

will you add more features to mini?

there aren’t greater plans for mini apart from being a simple PNGTuber application. so apart from QoL stuff, the answer is No, Probably! we’re saving more advanced features to the full version.

what’s different in the full version?

the full version is essentially a playground for connecting images together and move them, show/hide them, based on external input like microphones, webcams, so on.

it should let you create things ranging from PNGTubers with accessories and advanced state machines & conditions, to full-on avatars with webcam tracking and whatnot! all while keeping things simpler than it would usually be.

it will also have more features for streaming, such as collabing through Discord and whatnot!

when will the full version come out?

a full release is expected in 2025! we’re reaching what could be called an “alpha” soon, which is cool! but we wanna ensure everything works fine before doing a proper release.

is there any way to test versions in development?

glad you asked! we have some private testing channels on our Discord called veadotube labs, which you can fill this form to try and enter. we also have an early access ko-fi which is essentially a backdoor to the labs, if you cannot wait!

what is the app made in?

mini 2.0 and newer and the full version are all made with a custom engine written in C#, using .NET and Native AOT, with the help of SDL3! mini 1.4 and older were unfortunately made in Unity.

still having trouble?

if you can’t find what you’re looking for, get in touch with the community about it! someone in our Discord server might have an answer for you. the invite is in the home page!