fls-helper v0.1.0

Native helper that lets fusionlocalserver drive the Autodesk Fusion
desktop client on your own machine.

You only need this if the server runs on a different computer.
When the browser, the server and Fusion are all the same machine,
the server talks to Fusion directly and there is nothing to install.

Install

1. Download the file for your machine below, and rename it to
   fls-helper (fls-helper.exe on Windows). Put it somewhere permanent
   first — registration records the path and the name, so moving or renaming
   it afterwards breaks the link.

   • Windows — %LOCALAPPDATA%\Programs\fls-helper\fls-helper.exe
   • macOS / Linux — /usr/local/bin/fls-helper (chmod +x it)

2. Register and pair. Use the exact server URL you open in the browser —
   scheme, host and port must all match. Settings → Connection shows this
   command with your server already filled in.

   fls-helper register              # per-user, no admin rights
   fls-helper pair https://your-server:8080
   fls-helper status                # scheme / pairing / Fusion — three preconditions
   

fls-helper help lists every command; unregister and unpair <url> reverse
the two above.

macOS may ask for Local Network access the first time you use a button —
allow it, or the helper cannot reach the server and a denial looks exactly like
the server being down.

If a button does nothing

fls-helper status names the missing precondition. The launch log it prints
(~/.config/fusionlocalserver/helper.log) is the tiebreaker: empty, while the
scheme says registered, means the click never arrived — the problem is the
registration or the browser, not Fusion. Other failures say which step refused
them: pairing (that server is not paired on this machine), certificate (the
server's cert was replaced — pair again), or ticket (expired or unreachable).

Security

The helper refuses any server you have not paired with from a terminal on that
machine, and pins that server's certificate. Nothing in a browser can add a
pairing, and nothing in a launch URL can bypass one. The fusionlocal:// URL
carries no document and nothing about you — only a ticket id and the server's
address; the ticket is bound to your session, expires in two minutes, and
redeems once.

Versions

The helper and the server release independently and their version numbers are
unrelated — a server upgrade does not imply a helper upgrade. They share only
the fusionlocal:// URL shape, which carries a version segment, so an older
helper meeting a newer server is told the version is unsupported rather than
misreading the request. A helper upgrade is only required when that segment
changes, which would be announced here.

These binaries are not code-signed. macOS quarantines the file
on first run (right-click → Open) and Windows SmartScreen warns
once ("More info" → "Run anyway").