FAQ & troubleshooting
Requirements & support
| Question | Answer |
|---|---|
| Which Ableton versions? | Live 12 only (any edition). |
| Which OS? | Windows today. macOS coming soon. |
| Is it free? | Yes — free and open source under the MIT license. |
| Does Protocol 0 sell my data? | No. Protocol 0 runs 100% locally. No data is transmitted outside whatsoever. |
Troubleshooting
SmartScreen blocks the installer
Releases are code-signed (Azure Trusted Signing), so the installer shows a verified publisher. SmartScreen reputation still builds up over the first downloads, so it may warn for a while on a fresh release — click More info → Run anyway.
Shortcuts aren't firing (keyboard shortcuts not working)
- Check the control surface is loaded in Ableton: Preferences → Tempo & MIDI → Control Surface → Protocol 0.
- Confirm the binding exists in the web UI at
http://127.0.0.1:9010/shortcuts— it should be in the bindings table. - Make sure Ableton is the foreground window. Shortcuts are intentionally ignored everywhere else.
The web UI won't load
The UI is served by the agent — the background app on your machine, not Ableton. If http://127.0.0.1:9010/shortcuts doesn't load:
- Make sure the agent is running — look for the "P" icon in the system tray (left-click it to open the UI). If it's gone, launch Protocol 0 from the Start Menu.
- Check the agent log at
%APPDATA%\Protocol0\logs\agent.logfor a startup error (e.g. port9010already in use).
"Script HTTP failed" in the agent log
The agent couldn't reach the in-Ableton action API. Make sure Ableton is open and the control surface is enabled; then check the agent log for details.
The installer can't find Ableton
If your Live install is in a non-standard location, the wizard offers a step to point at the MIDI Remote Scripts folder manually — typically:
C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts
It doesn't start automatically after login
Autostart is a shortcut in your Startup folder (only created if you kept "Start at login" ticked during install). You can see and toggle it in Task Manager → Startup apps (look for "Protocol 0"), or open the folder directly:
%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup
If it's missing, reinstall with "Start at login" ticked, or launch Protocol 0 from the Start Menu whenever you need it.
My bindings disappeared after reinstalling
They shouldn't — bindings live in %APPDATA%\Protocol0\shortcuts.json, which installs and uninstalls leave alone. If the file got hand-edited into invalid JSON, the agent treats it as empty (no shortcuts) rather than crashing. Open the web UI and re-add the binding, or fix the JSON.
Still stuck?
Open an issue on GitHub or get in touch on Discord. Including the relevant lines from %APPDATA%\Protocol0\logs\agent.log helps a lot.