How to install own Plugins

With a little help from AI, I created my first plugin for Volumio:

To get it running, I copied a number of files to the Raspberry Pi and modified some XML configuration files.

Now I have a problem: I’m unable to perform a software update. The update process detects my manual changes and aborts the installation. I’ve searched for a guide on how to properly install custom plugins, but so far I haven’t had any luck.

Could someone please point me to an article or tutorial that explains the correct way to install custom plugins?

Thanks!

Nobody knows how to install a custom plugin correctly?

Hey @matzemedia,

There is no supported method for installing a plugin by manually copying files onto the device and editing system XML by hand. That is precisely why your updates now abort: the update process verifies system integrity, and hand-placed files and modified configuration are detected as unexpected changes.

The correct path is documented here:

That covers structuring the plugin, the required files the installer expects, packaging, and submission through the established process and the plugin store. A plugin built and installed that way registers through the plugin system, survives updates, and does not trip the integrity check.

To recover the update capability on your current system, you will need to revert the manual changes: remove the files you copied in and restore the XML files you edited to their original state. Without knowing exactly which files you touched, I cannot tell you which to undo, so list what you copied and what you modified if you want help identifying them. If you do not hold such record, factory reset or fresh flash are your only options.

For reference, the only user-editable boot configuration file is /boot/userconfig.txt. Anything written into system-managed files will conflict with updates.

Kind Regards,

Hey,
Have you had a look at https://developers.volumio.com ?
If yes and your plugin is conform to volumio requirements, from the plugin folder a

volumio plugin install

Should do the trick. If you can’t update volumio after a plugin install, it’s because it modifies system files.
This not allowed.
But I you followed indication it should be ok…

Thanks for your help. That was exactly what I was searching for. I will give it a try!
Best regards