VirtualHere Client Addon

hans99 · January 10, 2025, 7:37am

Just sharing an addon for VirtualHere Client (usbip solution). This can use multiple devices, possibility for manual config and uses supported container.
I have only tested this on amd64 and all feedback is appreciated.

https://github.com/hans99/home-assistant-addons

Megabyte927 · February 9, 2025, 1:08am

Hi, this plugin is great, however can you share some info on how to configure ?

hans99 · February 9, 2025, 5:24am

Gladly!
There is a DOCS.md that was supposed to be in the addon directory, but is now:

github.com

hans99/home-assistant-addons/blob/39a4d97c6bd12db76c619da99270e8e611bf2c44/vhclient/DOCS.md

# Home Assistant Add-on: VirtualHere Client

## About
Uses the client build in API with the -t argument.
For more information, see [[VirtualHere Client API documentation](https://www.virtualhere.com/client_api)].
Client configuration file is stored in home assistant config directory and named vhclient.ini, for easy access.

## How to use
Default this will use use the client build in server discovery and auto use all devices. To change this or handle configuration manually, use Configuration as descirbed.

## Configuration

### Option: 'AUTOUSE'
Turn auto-use all devices on / off. Corresponds to client API "AUTO USE ALL", but edits the vhclient.ini directly (Section AutoShare, value All)

### Option: 'AUTOFIND'
Turn auto-find on / off. Corresponds to client API "AUTOFIND", but edits the vhclient.ini directly (Section General, value AutoFind).

### Option: 'USB devices'
This present a list of all devices on the server, reload the page to get current updated list. Change 'use' to 'true/false' for devices to be used. Any device removed from the server permanently can be manually deleted here.

This file has been truncated. show original

You will need a VirtualHere Server running in your network, get it here under USB Servers:
https://www.virtualhere.com/
I hope this gives some info, or just keep asking

hamburglar · February 13, 2025, 4:04am

I just install this on my Home Assistant installed as a Hyper VM. I had to configure the manual hub address to be my Windows 11 host IP address and then it worked. Super easy to install. Thanks!

xlrate76 · February 28, 2025, 11:39pm

Thanks for this addon, easy to install and use !

hans99 · June 8, 2025, 6:00am

New version 0.3.1
Might need to restart the addon a couple of times to get all config to sync …

New discussion on a possible way to get some status sensor in Home Assistant.
Added on github: https://github.com/hans99/home-assistant-addons/discussions

fisch55 · July 10, 2025, 6:37am

Virtual Server runs on a PI3. I can’t buy a license, always says invalid serial. How do I do that…I want to connect more al a device?

Thank you

hans99 · July 10, 2025, 8:30pm

I think that would be something for the VirtualHere developer/support, this addon only runs it.

fisch55 · August 9, 2025, 2:03pm

Any changelog for the Update ?

hans99 · August 9, 2025, 4:44pm

Not more than what is included.

fernbank · October 1, 2025, 3:46pm

Hi having difficulty with this add-on. I am running HA as a hyper-vm. The VirtualHere server is running on the host PC and shows the connected USB devices. I have manually configured the client to use the host IP and port 7575. Autofind is turned on but no USB devices are listed as found. There is an option to add devices manually how would I specify the device to be added? Any help will be much appreciated

fernbank · October 2, 2025, 2:35pm

Sorted! The problem was due to an obscure setting needing to be changed in the network adapter… Now working with zigbee pass through on hyper-v home assistant installation

hans99 · October 5, 2025, 10:00am

Good you found the solution!