Add BetterDSPControl: web UI, desktop app and Pi writer for t.racks DSP 204/408
- Python stdlib server with SSE live updates, PIN login, remote access - Vanilla JS web UI (English/German): mixer, channel, routing, links, limiter calculator - Preset file export/import with undo, settings backup, lock for the desktop app - Network (TCP 9761) and USB HID transport (Windows, macOS, Linux) - Desktop app via pywebview, Raspberry Pi SD card writer, simulator and protocol tests - README with import guide for Claude Code, CLAUDE.md, protocol documentation Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
ce02ae65a9
commit
fe13f261f7
31 files changed
+6445
No files matched your search
+172
@@ -0,0 +1,172 @@
|
||||
"""DSP Control desktop app: the web server runs inside the app and the UI opens in its own window.
|
||||
|
||||
The window logs in with a one-time token (no PIN). Other devices only get access when
|
||||
"Fernzugriff" is switched on in the settings - and then they need the PIN.
|
||||
|
||||
Runs on Windows and macOS. Build: python packaging/build.py
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
import base64
|
||||
import ctypes
|
||||
import json
|
||||
import logging
|
||||
import os
|
||||
import secrets
|
||||
import subprocess
|
||||
import sys
|
||||
import threading
|
||||
from pathlib import Path
|
||||
|
||||
import webview
|
||||
|
||||
import server
|
||||
|
||||
APP_NAME = "DSP Control"
|
||||
|
||||
|
||||
def data_dir() -> Path:
|
||||
if sys.platform == "darwin":
|
||||
d = Path.home() / "Library" / "Application Support" / APP_NAME
|
||||
else:
|
||||
d = Path(os.environ.get("APPDATA") or Path.home()) / APP_NAME
|
||||
d.mkdir(parents=True, exist_ok=True)
|
||||
return d
|
||||
|
||||
|
||||
# texts of this file and pywebview's own (menus, file dialogs); the page itself is translated in static/i18n.js
|
||||
TEXTS = {
|
||||
"en": {"running": "DSP Control is already running.", "failed": "DSP Control could not start:\n{error}",
|
||||
"timeout": "timeout"},
|
||||
"de": {"running": "DSP Control läuft bereits.", "failed": "DSP Control konnte nicht starten:\n{error}",
|
||||
"timeout": "Zeitüberschreitung"},
|
||||
}
|
||||
WEBVIEW_DE = {
|
||||
"global.quitConfirmation": "Wirklich beenden?", "global.ok": "OK", "global.quit": "Beenden", "global.cancel": "Abbrechen",
|
||||
"global.saveFile": "Datei speichern", "cocoa.menu.about": "Über", "cocoa.menu.services": "Dienste",
|
||||
"cocoa.menu.view": "Darstellung", "cocoa.menu.edit": "Bearbeiten", "cocoa.menu.hide": "Ausblenden",
|
||||
"cocoa.menu.hideOthers": "Andere ausblenden", "cocoa.menu.showAll": "Alle einblenden", "cocoa.menu.quit": "Beenden",
|
||||
"cocoa.menu.fullscreen": "Vollbild", "cocoa.menu.cut": "Ausschneiden", "cocoa.menu.copy": "Kopieren",
|
||||
"cocoa.menu.paste": "Einsetzen", "cocoa.menu.selectAll": "Alles auswählen", "windows.fileFilter.allFiles": "Alle Dateien",
|
||||
"windows.fileFilter.otherFiles": "Andere Dateitypen",
|
||||
}
|
||||
|
||||
|
||||
def ui_lang() -> str:
|
||||
"""Language chosen in the app (kept in config.json by the server), English by default."""
|
||||
try:
|
||||
lang = json.loads((data_dir() / "config.json").read_text(encoding="utf-8")).get("lang")
|
||||
except (OSError, ValueError, AttributeError):
|
||||
lang = None
|
||||
return lang if lang in TEXTS else "en"
|
||||
|
||||
|
||||
def text(key: str, **kw) -> str:
|
||||
return TEXTS[ui_lang()][key].format(**kw)
|
||||
|
||||
|
||||
_lock = None
|
||||
|
||||
|
||||
def single_instance() -> bool:
|
||||
"""False if the app is already running (Windows named mutex, elsewhere a locked file)."""
|
||||
global _lock
|
||||
if sys.platform == "win32":
|
||||
ctypes.windll.kernel32.CreateMutexW(None, False, "Local\\DSPControlDesktop")
|
||||
return ctypes.windll.kernel32.GetLastError() != 183 # ERROR_ALREADY_EXISTS
|
||||
import fcntl
|
||||
_lock = open(data_dir() / ".lock", "w") # held until the process ends
|
||||
try:
|
||||
fcntl.flock(_lock, fcntl.LOCK_EX | fcntl.LOCK_NB)
|
||||
except OSError:
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
def message(text: str):
|
||||
if sys.platform == "win32":
|
||||
ctypes.windll.user32.MessageBoxW(None, text, APP_NAME, 0x40)
|
||||
elif sys.platform == "darwin":
|
||||
subprocess.run(["osascript", "-e", "on run argv", "-e",
|
||||
f'display dialog (item 1 of argv) with title "{APP_NAME}" buttons {{"OK"}} default button 1',
|
||||
"-e", "end run", text], check=False)
|
||||
else:
|
||||
print(text)
|
||||
|
||||
|
||||
class Api:
|
||||
"""Called from the page (window.pywebview.api): native save/open dialogs for backups and presets."""
|
||||
|
||||
def __init__(self):
|
||||
self._window = None # underscore: not exposed to JavaScript
|
||||
|
||||
def save_file(self, name: str, text: str) -> bool:
|
||||
res = self._window.create_file_dialog(webview.FileDialog.SAVE, save_filename=name)
|
||||
path = res[0] if isinstance(res, (list, tuple)) else res
|
||||
if not path:
|
||||
return False
|
||||
Path(path).write_text(text, encoding="utf-8")
|
||||
return True
|
||||
|
||||
def open_file(self) -> dict | None:
|
||||
res = self._window.create_file_dialog(webview.FileDialog.OPEN)
|
||||
if not res:
|
||||
return None
|
||||
path = Path(res[0] if isinstance(res, (list, tuple)) else res)
|
||||
if path.stat().st_size > 5_000_000:
|
||||
raise ValueError("File is too large")
|
||||
return {"name": path.name, "data": base64.b64encode(path.read_bytes()).decode()}
|
||||
|
||||
|
||||
def main():
|
||||
if not single_instance():
|
||||
message(text("running"))
|
||||
return
|
||||
d = data_dir()
|
||||
logging.basicConfig(filename=d / "dsp-control.log", level=logging.INFO, encoding="utf-8",
|
||||
format="%(asctime)s %(name)s %(levelname)s %(message)s")
|
||||
app = server.App(d / "config.json")
|
||||
app.app_token = secrets.token_urlsafe(24)
|
||||
|
||||
loop = asyncio.new_event_loop()
|
||||
started = threading.Event()
|
||||
state: dict = {}
|
||||
|
||||
async def start():
|
||||
app.load()
|
||||
srv = await asyncio.start_server(app.handle, "127.0.0.1", 0)
|
||||
state["port"] = srv.sockets[0].getsockname()[1]
|
||||
await app.start_remote()
|
||||
|
||||
def run():
|
||||
asyncio.set_event_loop(loop)
|
||||
try:
|
||||
loop.run_until_complete(start())
|
||||
except Exception as e: # noqa: BLE001 - shown to the user below
|
||||
logging.exception("start failed")
|
||||
state["error"] = e
|
||||
started.set()
|
||||
loop.run_forever()
|
||||
|
||||
threading.Thread(target=run, daemon=True, name="server").start()
|
||||
started.wait(20)
|
||||
if "port" not in state:
|
||||
message(text("failed", error=state.get("error", text("timeout"))))
|
||||
return
|
||||
|
||||
api = Api()
|
||||
api._window = webview.create_window(APP_NAME, f"http://127.0.0.1:{state['port']}/app-login?t={app.app_token}",
|
||||
width=1280, height=840, min_size=(380, 560), background_color="#0b0c0f",
|
||||
js_api=api)
|
||||
webview.start(private_mode=False, storage_path=str(d / "webview"),
|
||||
localization=WEBVIEW_DE if ui_lang() == "de" else {})
|
||||
|
||||
# window closed: disconnect the DSPs cleanly so the next connection is accepted right away
|
||||
try:
|
||||
asyncio.run_coroutine_threadsafe(app.shutdown(), loop).result(5)
|
||||
except Exception: # noqa: BLE001
|
||||
logging.exception("shutdown")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in new issue
Block a user