hi! if you’re using a Linux system and you plan to use veadotube but you’re not sure how to make it work, this is the page for you.

installing dependencies

veadotube should run in most recent distros without any intervention! it requires a minimum kernel version of 5.15 and minimum glibc version of 2.35, which means that if you’re on Ubuntu you gotta be using at least version 22.04, for Linux Mint that’s at least version 21, etc.

the app requires SDL3 to do the basics (open a window, get input, etc), but it already comes with it in case you don’t have it installed. it uses OpenGL to render things, so ensure your graphics drivers are up to date. the app also requires FreeType and HarfBuzz to render text, which should come with most distros nowadays.

the app also optionally uses ONNX Runtime for neural network support (e.g. Silero VAD) and Wine for running the Oculus plugin. installation instructions for these depend on which package manager your distro uses.

downloading the thing

for mini, visit the official download page over itch.io, and over the Download section, click on Download Now. it’ll prompt a donation window; feel free to tip! if you don’t want to, you can just press the No thanks, just take me to the downloads link.

this should take you to the download screen! select to download the Linux version.

opening the thing

veadotube comes inside a .zip file; don’t run the app directly from inside the .zip! extract it first.

you should be able to run veadotube-mini or veadotube now! your system might also not open it right away, treating it like as something other than an executable, and for that you might need to change its permissions. in most systems, the following steps should work:

1. open a Terminal window on the folder containing the executable;
2. run one of the following commands, depending on the version you downloaded:
   • veadotube mini: chmod +x ./veadotube-mini
   • veadotube mini 1.4 or older: chmod +x ./veadotube\ mini.x86_64
   • veadotube: chmod +x ./veadotube

now you should actually be able to run it :]

chromebooks and whatnot

if you’re using a ChromeOS device, you might be able to install veadotube on it by using the Linux environment in your machine. this blog post describes how to install veadotube mini 1.4, which should give you the general direction for more recent versions, too! beware that this is unofficial, as we don’t own a Chromebook, and have no intention to officially support it.