◀ return

troubleshooting

veadotube is a project coded by myself with the help of a few friends from time to time. as such, it’s impossible for me to support every platform out there. but i try my best! as the intention of the project is to make these digital puppets accessible for anyone.

before anything, make sure you’re on the latest version of the app! if unsure, try redownloading it.

note: the app is being developed in Unity, a game engine (that i can’t really recommend). most limitations veadotube has are linked to Unity limitations, and that’s the explanation i’ll have for most bugs, honestly :p

general issues

it won’t let me download mini without paying for it

just click on “No thanks, just take me to the downloads” and you can download the files just fine.

the app is free to use! donations are appreciated though.

i can’t open the app / how do i open the app?

…on windows

first make sure you install all requirements for windows; follow this guide for that.

the general steps to run on windows are:

  1. extract the zip file you downloaded. i recommend 7-Zip for that.
  2. inside the folder you just extracted, open veadotube mini, or veadotube (depending on which app you downloaded). that’s the executable with the deer icon on it.

note that you have to fully extract the zip file, it won’t work if you just open the app from inside the zip.

if the 64-bit version won’t run for you, try the 32-bit one :]

there’s a chance your computer will think veadotube is a virus; if you get a screen saying that windows protected your PC, click the “More info” button, and then “Run anyway”. this also varies depending on if you have some other anti-virus installed.

…on mac

note that veadotube requires at least High Sierra (10.13). any version below that won’t work. i can’t do anything about this, it’s Unity’s fault.

the general steps to run on mac are:

  1. open the dmg file you downloaded.
  2. open the disc that just mounted; drag the veadotube application to your Applications folder.
  3. (optional: you can eject the disc and delete the dmg now)
  4. run veadotube mini from Launchpad, or directly from your Applications folder.

if it says the app is damaged or anything similar when you try to open it, follow this guide.

…on linux

the general steps to run on linux are:

  1. extract the zip file you downloaded.
  2. inside the folder you just extracted, open veadotube mini, the executable with the .x86_64 extension.

note that you have to fully extract the zip file, it won’t work if you just open the app from inside the zip.

if that file won’t open for you, you might have to chmod it somehow. i rarely use linux and you probably know this better than i do.

the mac version is “damaged”

if it says the app is damaged or anything similar when you try to open it, here are the steps to fix it:

  1. make sure the app is in your Applications folder.
  2. open a Terminal window (open Spotlight with ⌘+space and look for “terminal”).
  3. paste this: xattr -cr /Applications/veadotube\ mini.app, press return.
  4. try opening the app again!

if it doesn’t work for you, google about it! it’s a common error in mac apps.

fun fact: this happens because i don’t pay Apple $99 a year to be an official Apple Developer. if i did, the app would run smoothly for you.

it only shows a black screen

that’s usually a graphics card issue. some old computers simply don’t like veadotube.

on windows & linux, make sure your graphics card driver is up to date!

on windows, also make sure you have DirectX updated; follow this guide for that.

also on windows, you can try applying specific DirectX commands to veadotube. check this section for the instructions.

my microphone doesn’t work

includes issues such as:

the Unity engine is awful at doing microphone stuff. half of the bugs here are because it isn’t telling me how to actually handle microphones, and i’m doing something wrong purely because i don’t know the right way. the other half are Unity bugs that i have no control over.

i’m working on the former bugs, since they’re the ones i can tackle, but even then it’s complicated and i can’t guarantee a fix yet. just please be patient!

one trick that works sometimes is restarting the app, sometimes twice. sometimes thrice.

the microphone captures way too much noise (keyboard keys, mouse clicks)

veadotube doesn’t have any noise suppression features, because that’s way too complicated for me to deal with right now. it’s definitely planned, just not now.

there should be programs that do that for you though :]

hotkeys won’t work

on windows, it could be a plugin issue that happens if you don’t have vc_redist installed; follow this guide to fix it. also, OBS and a few other games are known to capture the user’s hotkeys before veadotube can use them, and so the hotkeys won’t work properly. keeping OBS minimised and running veadotube as administrator tends to fix that though!

on mac, make sure to allow the app to use keyboard input! it’s somewhere in settings. the first time you try to setup a hotkey it might pop up a window asking you to give permissions for that, too.

on linux, make sure to run the app as root (the sudo thing you do on terminals) to get hotkeys to work!

sometimes the app freezes/crashes or doesn’t detect hotkeys at all, otherwise. that’s a known bug and it’ll be fixed eventually.

if you’re a developer

veadohook is the plugin that does all the hotkey things, and its source code is available here. if you have any clue on what could be breaking, feel free to collaborate :] i’m not an expert at these things, i just made them work as i could.

i have issues with OBS or other streaming apps

this is a catch-all section for streaming issues.

on OBS, add a Game Capture (or Window Capture if it doesn’t work), set it to capture a specific window, and select the veadotube window. toggle the transparency option to use the transparent (grey) background on veadotube.

i don’t know about other apps, but in general it should be a similar approach.

that’s an issue with OBS and laptop graphics cards, apparently. check out this topic from their forums: https://obsproject.com/forum/threads/laptop-black-screen-when-capturing-read-here-first.5965/

try maximizing the veadotube window!

that’s both on OBS not knowing how to capture Unity screens and on Unity not knowing how to import images tbh

known bug, their fault.

running veadotube and a game at the same time lags everything

veadotube was made in a game engine, and computers sometimes don’t understand how to run two “games” at once.

on windows, you can try the DirectX trick.

file & image loading

nothing happens, or an error appears, when i click to open files or images

on windows, you might have to install vc_redist; follow this guide for that.

on mac, if you’re on one of the newer machines (with the Apple Silicon processor), try running veadotube with Rosetta 2. if you’re on an older machine, then that’s a mystery for me too; i tried everything i could to fix that.

the file dialog doesn’t let me select my images

try using the expression buttons on the top to load images instead of the file buttons on the left!

the top buttons are for images, and the left ones are for .veadomini files, which are collections of images (aka complete avatars).

images won’t load, error occurs / images look weird

this includes:

if the image looks like it has a weird outline, that’s a known bug (thanks Unity), and will be fixed eventually.

otherwise, i kindly ask you to contact me about it! i wrote most of the image importers in veadotube by hand, and most of the time they break with specific files. if you’re comfortable with it, do send me said specific files! it would help a lot. (contact info is in the end of this page)

btw i recommend creating your animated GIFs and PNGs on ezgif! it tends to create files that veadotube likes.

it says my .veadomini file couldn’t be loaded

first make sure you’re on the latest version. older versions of mini cannot load files from newer versions. otherwise, the file is probably corrupt :[

it says my images are larger than 2048x2048 / which image size is best?

veadotube has a 2048x2048 limit for images, because you don’t need more than that, honestly! images when loaded to RAM tend to be heavy, and honestly no one will notice anything larger than that; you’re likely streaming at 1080p anyway.

if you work on a large canvas and you got an image that’s larger than the limit, don’t be afraid of resizing it! you can try a few different ways of doing that on your art program until it looks good enough for you.

as for best image size, that depends! the default avatars are roughly at 900x900, and i tend to recommend 1024x1024 whenever i get asked that question.

other questions

i don’t use windows/mac/linux, are there other options?

PC (windows, mac and linux) is the main platform for veadotube. if you’re using a chromebook, you might be able to install the linux version on it; i have no idea how that works though! you’ll have to google that one.

mobile apps aren’t planed, as i honestly have no idea how that would work; i don’t use my phone that much tbh. are there mobile streaming apps? how do i make an app that integrates with them? what are the expected features? i’d have to do a lot of research on that since i’m not the kind of person who would use it, and there are no plans to do that anytime soon.

i do dream of a companion app for the full version that runs on android/iOS, and a web version that serves as a demonstration of what the full app can do, but it really depends on how much time i wanna spend developing veadotube.

guides

installing windows requirements

Unity apparently needs two funny little guys for the app to run. chances are you won’t need to install these, as they’re often already installed automatically by other apps/games such as Steam, but if you’re having issues with veadotube then these might help you.

forcing DirectX on windows

this can help conflicts with other games, and it can also help your app to run at all. that’s Unity’s fault, btw

first make sure that DirectX is up to date with this guide.

  1. create a shortcut for veadotube, by right-clicking the exe file and selecting to create a shortcut
  2. right-click the shortcut and go to Properties
  3. add -force-d3d12 to the end of the target, with a space before it. the target should look like "...veadotube.exe" -force-d3d12
  4. run the app through the shortcut by double-clicking it!

depending on your computer, you can also try switching -force-d3d12 to -force-d3d11 and -force-d3d10.

finding the log file

the log file is this weird text file that says what’s going on behind the scenes, and what’s exactly happening when something fails to work or straight up crashes.

Unity hides its log files in weird places inside your computer, so here’s a quick guide on how to find it.

windows

open the Run window. you can do that by pressing Windows + R, or by right-clicking the start button and selecting Run.

now paste one of these on the dialog box, depending on which app you’re using:

press enter. a folder should open, and the file Player.log is the log file! (it might be called just Player depending on your machine.)

mac

open Finder and open the Go to Folder window. you can do that by pressing Command + Shift + G, or by going to the menu bar (the one with the apple logo), selecting Go, and then Go to Folder.

now paste this on the dialog box: ~/Library/Logs/olmewe/veadotube mini

press return. a folder should open, and the file Player.log is the log file! (it might be called just Player depending on your machine.)

linux

the file is at ~/.config/unity3d/olmewe/veadotube mini/Player.log. if you’re a linux user i’m assuming you know how to get there :]

didn’t find your issue?

get in touch with the community about it! our discord server has a bunch of people willing to help you, the invite is at the home page.