Skip to main content
Demo phasevenfree is still being built.
venfree/Documentation/How venfree handles your project files

How venfree handles your project files

venfree reads files like .knxproj and .loxone locally in your browser. The original file never leaves your computer. Only your own planning is saved, in the open .venfree format.

Three steps venfree takes. And one it does not.

When you open a project file in venfree, exactly three things happen: venfree loads the file into your browser memory. It then reads the structure to display your devices, rooms and functions. Finally, it transfers your planning to the open .venfree format.

What venfree does not do: write back to the original file or store it on a server. A .knxproj file exists only in your browser memory and is never touched again. You always export .venfree, never a modified .knxproj.

Why this matters especially for project files

A .knxproj file contains more than just your planning. It also contains embedded product databases from device manufacturers: Siemens, MDT, Gira and others have stored their application programs there. This data belongs to the manufacturers.

venfree reads this data to display device names and functions to you. It does not extract or store it separately. What appears in the .venfree file is exclusively your planning decisions: which rooms, which functions, which devices you chose.

This is the same principle by which a PDF viewer may display a PDF without redistributing the manufacturer's fonts.

The .venfree format belongs to you

The .venfree format is openly specified and in the public domain (CC0). Anyone can read, write and implement it. No manufacturer can make it proprietary.

What a .venfree file contains is your planning: rooms, functions, chosen devices, prices at the time of planning. This data belongs to you. venfree is only the tool that creates it.

You can download your .venfree file, open it on another device, or send it to your electrician. Your planning work is not locked into venfree.

Technical background (for developers)

venfree parses .knxproj files on the basis of §69e UrhG (EU Software Directive Art. 6): the interoperability privilege allows analysing format structure for compatibility purposes. Parsing is limited to what is necessary: display and conversion to .venfree.

Writing back to the original format (.knxproj) is not implemented and will remain so until a separate legal review clears this step. The complete .venfree format specification including legal basis is available at legal/FORMAT-SPEC.md in the venfree repository.

Tips

  • Your .knxproj never leaves your browser, not even during conversion
  • .venfree is public domain: you can open your file with any tool that implements the spec
  • Export planning data: Export dialog in Viewer → download .venfree

Try it now

Open the venfree Workbench and plan your KNX project: free, no account required.

Open Workbench