Skip to content

Custom Files

Mark Parker edited this page Jun 13, 2026 · 5 revisions

With version 0.12.0, a long requested capability has been added to allow a simple method to be able to add your own wake word, wake sound and alarm sounds. Prior to v0.12.0, this was a complicated process involving ADB use and only supported OpenWakeWord ONNX files.

Adding Custom Files

In your Home Assistant config directory (once you have updated to v0.12.0 or higher and rebooted), you will see a vaca directory and within that a custom directory with sub dirs for the custom files supported.

image

In order to use a custom file, you just need to drop it into the correct directory and each of your VACA devices will load all custom files on start. You can also use the Quick Actions setting option to access the Custom Files manager and sync at any time.

Once files have been downloaded to your device, you should be able to select them in the relevant selector in Home Assistant.

Important

You must store the correct files in the correct directory. MicroWakeWord you must store the tflite and json files. OpenWakeWord will accept an onnx file or a OWW tflite file (do not try to use MicroWakeWord tflite files with OpenWakeWord as they will not work and you must have the correct engine for the OpenWakeWord file type selected for it to show in the available wake words). Alarm and wake sounds must be wav or mp3 files.

Managing Custom Files

There is a screen on the VACA device to be able to see and manage the local custom files. If you are on the Waiting connection screen, select the cog button, from the webview screen use the QuickAction menu and select settings. Select Manage Custom Files option.

image

From here you can delete individual files, hold to select multiple files for deletion or click the sync button in the top right corner to redownload all available files.

Clone this wiki locally