Virtual Devices



Virtual Devices can simulate anything without using an actual interface. Well… of course within the limits that Homey provides.

There is more information, including How-to’s on GitHub Pages:

Please report bugs on github:

Questions can be asked here or on Slack (@arielaxed)


Note that the old forum can be found here:


Hi New user here. Just added the VD app, great, good job.
Also made a small donation for your effort.
I have a question if you can answer, i saw somewhere that somebody said they added there own icons to your app and loaded it onto the Homey. I get how to load the app onto Homey, but how do I add icons to the VD file?


Hi Adrian,

Thank you very much for your kind donation!

I’ll try to set-up a help-page with instructions for this, but in short it will be something like:

  1. Download the Virtual Device code from GitHub

  2. Determine which driver to add an icon: mode, multi, or virtual_switch

  3. Add an icon in .svg format to the assets directory of that driver

  4. Add a line with 'getIconNameAndLocation('switch’),’ to the driver.js of the chosen driver. You’ll see where to put it.

  5. Load your version of Virtual Devices like a developer does, i.e. from the command-line:

See but skip step 4 (you don’t need to create a new project).

Let me know if and where you get stuck.

With kind regards,



Many thanks. I’ll try this out this week when I get some spare time. Cheers.


Hi, any reason the Virtual Devices are not available through Alexa SmartHome Skill? Is this a Homey issue?


Not that I know of. I don’t use Alexa (yet).

Are other Homey devices available in Alexa skills? Or only certain types?

Virtual Devices are just like regular devices, except for the physical device itself :smiley:

On the other hand: I didn’t do anything special for Alexa, but I would be surprised if that’s needed.



Thanks Arjan, had a reply from Homey support and they said it is the Virtual Device App issue, not a Homey issue.
Any chance of fixing this, I find the Virtual devices great, but need them to be functional via Alexa for voice control. Happy to make a donation so you can buy one to test with, or I can order one and send it to you.

Kind Regards


That’s very kind of you but let me investigate a bit first.

I assume you installed the Homey-skill? I read here that it already works for switches:

Switch is not a capability in Homey, so I guess he means an onoff-capability. It could very well be that the Homey-skill does not support all capabilities, but onoff should be the first to support.

It could also be that it discovers only certain classes of devices, e.g. lights or sockets. Did you try it with those?

And here I read that the language matters, of both Alexa’s and Homey’s:


Hi Arie,
Done some more investigation myself.
So it seems that on/off plugs and lights virtual devices will work and are displayed within Alexa Smart Home Homey skill. But other VD devices such as TV, Blinds, Buttons, Virtual Modes or Multi Modes, do not.
You are right, this seems to be Homey related, as we have added Somfy RTS blinds to Homey and these do not show within Alexa either.
I’ll get in contact with Homey again and find out why or how you can add functionality for, Especially for AV (tv and receiver) and Blind support with Alexa. Blind (window coverings) support is essential for us.
Thanks Arie for you quick response.

ps if you havent tried using an Amazon Alexa you really should. A couple of these thoughout a home are amazing for voice control, intercom solution and mulitroom music control (Spotify premium account needed)


How can I set a value when I created a virtual device with a measured temperature?


You mean this?

use the tag from your temp meter


Thanks, it’s now working. Just needed to select the correct sensor and device.