charliefoxtwo / ViLA

Virpil LED Automator - a tool for programmatically changing the LEDs on your Virpil USB device.
GNU General Public License v3.0
39 stars 10 forks source link

ViLA

.NET 6 CI build GitHub Discord

ViLA (Virpil LED Automator) is an extensible tool for configuring your Virpil usb device's LEDs to react to certain events. It can be extended via plugins written by anybody, which can do things like tail log files, pair with DCS-BIOS, and more. These plugins send messages to ViLA, which are parsed according to its configuration file.

Getting started

Check out the wiki for a getting started guide!

Recommended plugins

Running

Just double-click ViLA.exe to start ViLA. It's important to note that ViLA isn't very useful without plugins, so find some good ones!

What's next?

ViLA has a long way to go.

FAQ

Does ViLA offer any protections to make sure extensions don't do bad things to my computer?

No. It's very important to understand this. You and you alone are responsible for whatever happens to your computer as a result of extensions you install. Any code at all can be written in an extension. The developers of ViLA will not be held responsible for malicious plugins. When in doubt, DO NOT INSTALL a plugin.

Does ViLA support additional conditional logic like AND, OR, etc?

Yes! You can nest logical operators as deep as you like.

Does ViLA support more complex actions, like flashing a light in response to an action?

Not directly, no. You can get creative with the plugin and the Ids in your config.json file, but generally speaking this is not officially supported at this time. Maybe at some point in the future!

Local Development

If making package changes (highly discouraged) it is important to regenerate the plugin_manifest.xml file. There used to be a tool to do this, but development of it stopped with .NET 5 and so the file must now be maintained by hand. Hooray!

Acknowledgements