# VelbusLink on linux/macos

**URL:** <https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138>\
**Category:** For developers\
**Created:** [April 3, 2023, 9:52am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138 "2023-04-03T09:52:06Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [April 3, 2023, 9:52am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/1 "2023-04-03T09:52:06Z")

</div>

I did some homework and looks like currently there is no VelbusLink version for linux/macos. I consider that a shame 🙂 as one of the things that pushed me from KNX to Velbus was that KNX requires running windows + using proprietary ETS stuff.

I’m a hobbyist software developer (linux kernel contributor, FreeCAD (\*) + some other stuff) and I’d be happy to offer my time for free to help to create VelbusLink that we could compile on linux. I’m not windows/mac specialist, but I assume once we have open source code we would find someone to work on that part.

I’m not expecting that it’ll happen over night, but I’d love to start discussion how we can make [VelbusLink for linux reality.](https://github.com/velbus/velbuslink/issues/2) What toolkit/language would be preferred by the current team that is writing VelbusLink for windows? What software licence should be used? I assume external contributors wouldn’t have to sign an NDA due to the nature of the project, but potentially, depending on licence they might need to sign some contributor agreement. Is code migration considered, or a start from scratch (my preferred option)?  
Again, I’m not expecting a massive progress, but setting some frames would allow to try to gather a team of potential contributors/testers.

(\*) FreeCAD supports windows/linux and mac, so I have access to vast team knowledge about writing code that supports 3 systems.

---

<div class="post-metadata">

**Author:** ![MDAR](https://forum.velbus.eu/user_avatar/forum.velbus.eu/mdar/32/4215_2.png) [@MDAR](https://forum.velbus.eu/u/MDAR)\
**Post date:** [April 3, 2023, 9:05pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/2 "2023-04-03T21:05:48Z")

</div>

> [@PrzemoF](#):
>
> I’m not expecting that it’ll happen over night, but I’d love to start discussion how we can make [VelbusLink for linux reality.](https://github.com/velbus/velbuslink/issues/2)

I’m told there is a plan to move Velbuslink to an agnostic programming language so that it can be compiled for other OS.

However I’m sure you’re aware that is a major undertaking.

Hopefully one of the core Velbus team will be in touch directly with you and discuss it further.

If…

UK contractors come to me / us to buy hardware & they only have a MAC, I give them a cheap Windows laptop (subject to their order value)

---

<div class="post-metadata">

**Author:** ![pdhoogh](https://forum.velbus.eu/user_avatar/forum.velbus.eu/pdhoogh/32/4124_2.png) [@pdhoogh](https://forum.velbus.eu/u/pdhoogh)\
**Post date:** [April 7, 2023, 9:00am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/3 "2023-04-07T09:00:01Z")

</div>

Docker is the answer.

Instead of a Windows Exec, VelbusLink could be a docker module. That should be agnostic and stable enough.

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [April 20, 2023, 10:41pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/4 "2023-04-20T22:41:14Z")

</div>

I have VelbusLink working on fedora linux under WINE / Lutris 😍  
USB not working yet, so I can’t test anything else now.

 ![Screenshot from 2023-04-20 23-31-07](https://forum.velbus.eu/uploads/default/original/2X/1/1b40f96e8eedab600849dac9901a0a8f533f5591.png)  
Lutris settings:  
 ![Screenshot from 2023-04-20 23-37-12](https://forum.velbus.eu/uploads/default/original/2X/b/bcb4b3d38c46eef5ef56b635ef0cae4f4b03a0cb.png)  
 ![Screenshot from 2023-04-20 23-37-23](https://forum.velbus.eu/uploads/default/original/2X/4/4c97096deb85c0c884bb53a4eb51be4eca423539.png)

---

<div class="post-metadata">

**Author:** ![VEL524](https://forum.velbus.eu/user_avatar/forum.velbus.eu/vel524/32/4069_2.png) [@VEL524](https://forum.velbus.eu/u/VEL524)\
**Post date:** [April 21, 2023, 6:24am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/5 "2023-04-21T06:24:49Z")

</div>

There are some other topics around this on the forum. It should definitely be possible to run this through Wine, but we don’t actively support that.

Protocol documentation is available from: [GitHub - velbus/moduleprotocol: Protocol manuals for Velbus modules](https://github.com/velbus/moduleprotocol)  
Packet documentation is available from: [GitHub - velbus/packetprotocol: Velbus packet protocol](https://github.com/velbus/packetprotocol)

The Signum also has an API available which is documented in the Signum itself.

For a rewrite, since we are backwards compatible, it takes time for us to get there.  
We’re looking for web technologies that can be optionally embedded within a multi-platform technology such as Electron, Maui or Tauri.

If you look around on Github, you may find open-source libraries that alread speak the Velbus Protocol.

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [April 21, 2023, 12:54pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/6 "2023-04-21T12:54:56Z")

</div>

😍 I got it nailed!

1. Add used to group dialout to allow using USB.

```auto
sudo usermod -a -G dialout [username]

```

1. Connect the velbus gatewaty. Check the system sees it:

```auto
$ lsusb | grep Vel
Bus 001 Device 010: ID 10cf:0b1b Velleman Components, Inc. VMB1USB Velbus USB interface

```

1. Check what’s the name of the port under wine:

```auto
$ ls -asl ~/.wine/dosdevices/ | grep tty
4 lrwxrwxrwx. 1 przemo przemo 12 04-21 13:30 com33 -> /dev/ttyACM0

```

1. Start VelbusLink form lutris (installator file WIP, but the setting as per screenshots in the OP. When the program asks for post type whatever you got in point 4 above. In my case it was com33

There are some visual glitches, but it’s workable:

 ![Screenshot from 2023-04-21 13-53-02](https://forum.velbus.eu/uploads/default/original/2X/e/e9addd3d3703caa4d74941673ec1f9818c9b5b0c.png)

---

<div class="post-metadata">

**Author:** ![MDAR](https://forum.velbus.eu/user_avatar/forum.velbus.eu/mdar/32/4215_2.png) [@MDAR](https://forum.velbus.eu/u/MDAR)\
**Post date:** [April 21, 2023, 6:20pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/7 "2023-04-21T18:20:25Z")

</div>

> [@PrzemoF](#):
>
> USB not working yet, so I can’t test anything else now.

Your welcome to connect via a TCP port to a model here, if you want to test Velbuslink functionality from within Wine.

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [April 21, 2023, 10:23pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/8 "2023-04-21T22:23:35Z")

</div>

Thank you! I got it (mostly) working 🙂 How do you use text file to configure the system? The xlp file is a text, but it doesn’t looks like editing it is a good idea 🙂

P.S. Is it safe to connect a new device to live bus?

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [April 21, 2023, 10:35pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/9 "2023-04-21T22:35:47Z")

</div>

I’ll send a PM - thanks!

---

<div class="post-metadata">

**Author:** ![MDAR](https://forum.velbus.eu/user_avatar/forum.velbus.eu/mdar/32/4215_2.png) [@MDAR](https://forum.velbus.eu/u/MDAR)\
**Post date:** [April 22, 2023, 8:27am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/10 "2023-04-22T08:27:24Z")

</div>

> [@PrzemoF](#):
>
> How do you use text file to configure the system? The xlp file is a text, but it doesn’t

I think there is a little confusion.

Velbus modules can only be commissioned using Velbuslink.

When I spoke of text files, I was referring to openHAB.

---

<div class="post-metadata">

**Author:** ![MDAR](https://forum.velbus.eu/user_avatar/forum.velbus.eu/mdar/32/4215_2.png) [@MDAR](https://forum.velbus.eu/u/MDAR)\
**Post date:** [April 22, 2023, 8:30am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/11 "2023-04-22T08:30:55Z")

</div>

> [@PrzemoF](#):
>
> Is it safe to connect a new device to live bus?

That very much depends on your approach.

Clearly, if we apply strict electrical safety rules, then “please power down and isolate everything”

However

If you’re only talking about connecting a module to the bus, then yes, it’s fine, as long as you observe all the normal precautions.

Glass panels are plug and socketed for exactly this reason.

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [August 11, 2024, 7:05pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/12 "2024-08-11T19:05:06Z")

</div>

lutris-0.5.17 on fedora. I don’t know how to export/import settings into lutris  
Edit: It works for me, but I’m struggling with a fresh install of VelbusLink  
VelbusLinks works, but there are some visual artefacts.

 ![Screenshot from 2024-08-11 20-54-01](https://forum.velbus.eu/uploads/default/original/2X/2/21454133471b478d30826d8e056f3ccd72eb481b.png)  
 ![Screenshot from 2024-08-11 20-53-56](https://forum.velbus.eu/uploads/default/original/2X/1/190808762f6e4d2a1c60775bd8a9ff46503839df.png)  
 ![Screenshot from 2024-08-11 20-53-49](https://forum.velbus.eu/uploads/default/original/2X/e/ec3ac95b3f0141efec11dd360e0133168cd09176.png)  
 ![Screenshot from 2024-08-11 20-53-44](https://forum.velbus.eu/uploads/default/original/2X/3/3fc313346acd7f0c957a23826b0cae7c22fff4ab.png)  
 ![Screenshot from 2024-08-11 20-53-37](https://forum.velbus.eu/uploads/default/original/2X/8/8c0679fb21f6649c97b3f29f6f1a3d56e20c962c.png)

 ![Screenshot from 2024-08-11 20-59-37](https://forum.velbus.eu/uploads/default/original/2X/0/020653622f5b46e45ba9b384545b975c762719c3.png)  
 ![Screenshot from 2024-08-11 20-59-33](https://forum.velbus.eu/uploads/default/original/2X/1/1ffc370d5b0f30e363f6d7859bde0fe245ec00aa.png)  
 ![Screenshot from 2024-08-11 20-59-27](https://forum.velbus.eu/uploads/default/original/2X/e/eb623dbbc454150dbe1eed537c09f1e4858342ff.png)  
 ![Screenshot from 2024-08-11 20-59-18](https://forum.velbus.eu/uploads/default/original/2X/8/861d56abc6700b665dca3b7f33422ec6375d29cd.png)  
 ![Screenshot from 2024-08-11 20-54-05](https://forum.velbus.eu/uploads/default/original/2X/e/e4eaef173095a09f640a0849eac07bb26356789e.png)  
 ![Screenshot from 2024-08-11 21-00-21](https://forum.velbus.eu/uploads/default/original/2X/3/3aef00f3326889091a0e0380e986a663baee816e.png)

---

<div class="post-metadata">

**Author:** ![nagisa](https://forum.velbus.eu/letter_avatar_proxy/v4/letter/n/3da27b/32.png) [@nagisa](https://forum.velbus.eu/u/nagisa)\
**Post date:** [November 15, 2024, 11:47am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/13 "2024-11-15T11:47:30Z")

</div>

The more recent installers won’t work due to “could not expand {autopf}”. After some experiments the only way I figured how to work-around that was to decompile the installer\[1\], modify the innosetup configuration to remove the reference to this variable and recompile the installer again. It is also necessary to create some files for translation strings as the decompilation isn’t exactly lossless.

That said, I’m also seeing visual artifacts. What worked best for me is to use `bottles` with soda-7.0 runtime and to enable Gamescope. With it the main window renders okay (unlike in sway, where there’s a white opaque window in front of the rendered window behind, just like reported [here](https://github.com/bottlesdevs/Bottles/issues/3467)), but there are still problems with various popup windows. These visual artifacts are likely an unfortunate interaction between the UI library that velbuslink uses and wine, so it isn’t likely that developers at velleman will be able to do much to address this even if they wanted. It would be neat to know what is the library that they are using, though.

Any wine versions past 7.0 series will abort with an assertion in font rendering which I had reported here: [https://bugs.winehq.org/show\_bug.cgi?id=55518](https://bugs.winehq.org/show_bug.cgi?id=55518).

Unfortunately, that makes setting up a minimal windows VM roughly the only reasonable option if you want to run velbuslink today.

* * *

1. this is a challenge on its own, as very recent version of inno are used to package velbus and decompilers need to be updated routinely for the more recent versions; and both `innounp` and `innoextract` unfortunatelly stopped keeping up. I was able to find some fork out there, but it will likely become outdated soon as well.

---

<div class="post-metadata">

**Author:** ![Golfy](https://forum.velbus.eu/user_avatar/forum.velbus.eu/golfy/32/4985_2.png) [@Golfy](https://forum.velbus.eu/u/Golfy)\
**Post date:** [August 7, 2025, 9:24am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/14 "2025-08-07T09:24:14Z")

</div>

Thanks @nagisa !  
I was feeling very uncompetent with multiples tries on Wine, Bottles, Lutris… I’ve the same message. It’s very disappointing to be OS dependant like this 😔

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [August 16, 2025, 4:42pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/15 "2025-08-16T16:42:19Z")

</div>

Can you share the solution? Maybe it can be scripted? I’m OK with compiling and that kind of stuff on linux, but I know nothing about windows installers, etc.  
From your description I understand we could make script to :

1. download the original binary
2. decomplile
3. modify the code with awk/sed/python/perl whatever is needed
4. recompile

P.S. Sharing the script should be legal, we would not share the recompiled binary.

---

<div class="post-metadata">

**Author:** ![MDAR](https://forum.velbus.eu/user_avatar/forum.velbus.eu/mdar/32/4215_2.png) [@MDAR](https://forum.velbus.eu/u/MDAR)\
**Post date:** [August 16, 2025, 8:10pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/16 "2025-08-16T20:10:09Z")

</div>

Please don’t put too much effort into this.

There is a platform agnostic solution in the pipe line, but it won’t be ready for a year or so.

---

<div class="post-metadata">

**Author:** ![nagisa](https://forum.velbus.eu/letter_avatar_proxy/v4/letter/n/3da27b/32.png) [@nagisa](https://forum.velbus.eu/u/nagisa)\
**Post date:** [August 17, 2025, 12:04am UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/17 "2025-08-17T00:04:20Z")

</div>

> [@PrzemoF](#):
>
> Can you share the solution? Maybe it can be scripted?

I won’t spend time on this again, but the gist is:

1. Find that one fork of `innoextract` that has support for the new-enough version of innosetup stuff and extract the installer with it;
2. `rg {autopf}`and remove instances of this occurring (and/or replace with `C:\Program Files` or something);
3. Use `iscc` to find it barfs on locale files;
4. Work some `mv` and `cp` magic to make up some locale files;
5. Use `iscc` again.

As said above, I wouldn’t really bother too much with it as velbuslink nowadays doesn’t work well with Wine anyway.

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [August 17, 2025, 2:57pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/18 "2025-08-17T14:57:16Z")

</div>

OK, thank you! I’ll try to do something, but without putting too much effort 🕶

---

<div class="post-metadata">

**Author:** ![PrzemoF](https://forum.velbus.eu/user_avatar/forum.velbus.eu/przemof/32/4758_2.png) [@PrzemoF](https://forum.velbus.eu/u/PrzemoF)\
**Post date:** [August 17, 2025, 3:19pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/19 "2025-08-17T15:19:05Z")

</div>

innoextract compiled from source, no problem. I do not see anything that looks like autopf yet.

---

<div class="post-metadata">

**Author:** ![pdhoogh](https://forum.velbus.eu/user_avatar/forum.velbus.eu/pdhoogh/32/4124_2.png) [@pdhoogh](https://forum.velbus.eu/u/pdhoogh)\
**Post date:** [December 17, 2025, 4:39pm UTC](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138/20 "2025-12-17T16:39:43Z")

</div>

It should be a Velbus supported solution. People are moving away from Windows. I have, Linux Mint is my daily driver. I need to go back to Windows for photo and video editing, but my plan is to run MacOS in a VM and use the MacOS versions of these. As long as there is no Linux version. Luckily, Da Vinci Resolve has a native Linux version. I will NEVER yield to Win11. So Velbus is soon going to be the only reason I’ll be going back to Windows. And as soon as you stop supporting Win10 I won´t be able to use Velbus Link any more. That is a big downer for me.

[Next page](https://forum.velbus.eu/t/velbuslink-on-linux-macos/17138.md?page=2)
