Arise Python Commander

What it does

The four action types

• Run Script — triggers a Python file on key press and updates the key with a visual result when the script finishes. Use this for one-shot tasks: opening tools, sending a request, running a conversion.
• Multi-State — maps up to five explicit output values to five distinct key visuals. Your script prints one of the mapped values and the key shows the matching state. Use this for status dashboards and toggles.
• Loop — runs a script on a repeating timer and keeps it alive automatically. Use this for background polling services that check external status or maintain a connection.
• Stream — displays the script's live output text directly on the key as it runs. Use this for live counters, progress indicators, or real-time sensor readouts.

Setup

• Install Arise Python Commander from the Elgato Marketplace.
• Drag an action type onto a key.
• Open the key settings and enter the full path to your Python script (e.g. C:\Users\you\scripts\myscript.py).
• If your Python installation is not on the system PATH, enter the full Python executable path in the plugin's global settings.
• For Multi-State actions, define the expected output values and assign each to a visual state.
• Press the key to trigger the script.

Requirements

• Windows or macOS (13.0 or later)
• Python 3.x installed
• Elgato Stream Deck hardware
• Stream Deck software

Troubleshooting

• Script doesn't run — Confirm the script path in the key settings is the full absolute path, not a relative one.
• Wrong Python version executes — Specify the full path to the correct Python executable in the plugin's global settings (e.g. C:\Python311\python.exe).
• Run Script shows error state — Check the Stream Deck log or the plugin's log panel for the exact error message printed by your script.
• Multi-State key shows the default unmapped state — Your script must print the mapped output value exactly to standard output, matching capitalization and without extra whitespace.
• Loop action stops unexpectedly — If the script exits with an error, the loop stops. Add error handling inside your script so it does not exit on unexpected conditions.
• Stream action shows stale data — Make sure your script continuously flushes output. Add sys.stdout.flush() after each print statement in Python.
• Script does not run inside a virtual environment — Enter the full path to the Python executable inside your venv instead of the system Python (e.g. C:\project\.venv\Scripts\python.exe). The plugin's global Python executable setting must point to the venv interpreter, not the system one.