Overview

Ansible playbooks for installing vapoursynth, it's dependencies, select plugins and scripts on Ubuntu focal and jammy. Instructions for running against VirtualBox VMs are also included, primarily for test purposes.

The installation includes a sample script to confirm that your vapoursynth stack is successfully setup. The sample file is a black blank clip that is filtered by bm3d and processed through smoothlevels to verify a couple of complicated filter/script stacks. To run the sample script:

vspipe ~/samples/sample_script.py .

or

vsedit

and open the sample script in the vseditor.

Ansible

To install ansible on ubuntu:

sudo apt install ansible

Running playbooks locally.

Run from focal or jammy branch
$ ansible-playbook -i hosts_local install_all.yml --ask-become-pass
or:
$ ansible-playbook -i hosts_local install_vapoursynth.yml --ask-become-pass
or:
$ ansible-playbook -i hosts_local install_plugins.yml --ask-become-pass
or:
$ ansible-playbook -i hosts_local install_utilities.yml --ask-become-pass

Using with a VirtualBox VM:

1. create vm:

• iso can be found here: https://releases.ubuntu.com/focal/ubuntu-20.04-desktop-amd64.iso

2. allow ssh to guest via port forwarding

• install ssh: sudo apt install ssh
• virtualbox settings -> network -> adapter 1 -> advanced:
  • Under Port Forwarding: create a rule with host ip:port - 127.0.0.1:2222 and guest ip:port = blank:22

3. Add local key to guest, to avoid having to use a password.

• scp -P 2222 ~/.ssh/ssh_user_ed25519_key.pub my-virtualbox-user@127.0.0.1:~/.ssh/authorized_keys

4. Switch to /bionic/ansible or /focal directory.
5. Run playbook:

• ansible-playbook -i hosts_virtualbox install_vapoursynth.yml --ask-become-pass

FAQ

1. Where are vapoursynth and the supporting scripts installed?

• They have been put here: /usr/local/lib/{your_python_3_version}/site-packages. Based on this: https://wiki.debian.org/Python#Deviations_from_upstream

2. SSH key validation: For VirtualBox VMs, ssh key validation isn't necessary as they're ephemeral, as such we've included the following line in an ansible.cfg file:

[defaults]
host_key_checking = False

This should not be used for persistent hosts.

Troubleshooting:

• Problems with vapoursynth compilation? Look for libraries and paths in this thread: https://forum.doom9.org/showthread.php?t=175522

• "Failed to initialize Vapoursynth environment". Your environment can't read vapoursynth.so. Do one of the following:

  • Set the PYTHONPATH variable to the location of vapoursynth.so
  • Create a link to vapoursynth.so in python's standard path, like /usr/local/lib/python3.6/dist-packages/

To-Dos:

1. focal: address apt items deprecation warning message
2. more instructive messages when ansible checks (like ld.so.conf) fail.