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.0.

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.0)! 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 Catalina (10.15).

macOS says the application requires macOS 14.0 or later

due to a bug, mini 2.0 won’t let you run on versions lower than Sonoma (14). this will be fixed soon! for now, please use mini 1.4, or upgrade your Mac to Sonoma if it’s supported.

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.

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

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!
  • 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.

if you’re on a M-series Mac and the program crashes when trying to select the third option, that’s Oculus’s fault, apparently! they haven’t upgraded their plugin to Silicon and so the thing might just crash. we’re looking into a workaround, or at least something that won’t crash the entire program.

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!

on Windows it’s known that keyboard hotkeys including the Alt key are not working correctly. this is being worked on!

on M-series Macs it’s known that hotkeys might not work correctly – this is also being worked on!

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 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. also consider updating mini to 2.0, as it was never affected by this whatsoever!

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

the new engine is known to take a bit more CPU than Unity did. it’s a work in progress! we’ll be improving that as we update the app.

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 for now you can try a few things:

  • have less images loaded!
  • shrink your images a bit!
  • if you’re working with animated images (PNG, GIF), use less frames!

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.

the app won’t work if it’s minimised

this is a known bug in the new engine! we’re working on this, but for now, leave the app in the background without minimising!

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?

there are plans for a mobile version of veadotube! we can’t tell you yet what it’d be or when that’d happen, because the priority right now is the desktop version.

will there be a native Silicon/M-series macOS version?

yes, hopefully! we don’t have access to a newer Mac right now, which is why we focus on the Intel version and hope that it works correctly on M-series Macs, but hopefully this should change soon.

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?

we plan on having something by late 2024, but really it’s done when it’s done! it’s not steady work, we’re taking our time exploring features and redesigning things until they’re good enough.

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 the full version are all made with a custom engine written in C#! 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!