#!/usr/bin/env python3
"""Pedalboard Finder for MOD units (Dwarf, Duo, Duo X).
Browse every plugin installed on the unit, filter the list, click a plugin to
see the pedalboards that use it, click a pedalboard to load it on the unit.
python3 pedalboard_finder.py # MOD over USB at 192.168.51.1
python3 pedalboard_finder.py 192.168.1.50 # MOD at another address
python3 pedalboard_finder.py 192.168.51.1 9000 # another local port
Then open http://localhost:8099 (it opens by itself). Standard library only.
Why a local server: the MOD's web app (mod-ui) doesn't allow pages from other
sites to read its data, so this script serves the page and forwards its
requests to the unit. It uses mod-ui's internal HTTP routes, which are not an
official API and may change between MOD OS versions.
"""
import json
import sys
import urllib.error
import urllib.request
import webbrowser
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
DWARF = sys.argv[1] if len(sys.argv) > 1 else "192.168.51.1"
PORT = int(sys.argv[2]) if len(sys.argv) > 2 else 8099
PAGE = r"""
Pedalboard Finder
Pedalboard Finder
Pick a plugin to see the pedalboards that use it.
"""
class Handler(BaseHTTPRequestHandler):
def log_message(self, *args):
pass
def do_GET(self):
self.route()
def do_POST(self):
self.route()
def route(self):
if self.path in ("/", "/index.html"):
body = PAGE.replace("__DWARF__", json.dumps(DWARF)).encode("utf-8")
self.reply(200, "text/html; charset=utf-8", body)
elif self.path.startswith("/dwarf/"):
self.proxy(self.path[len("/dwarf"):])
else:
self.reply(404, "text/plain; charset=utf-8", b"not found")
def proxy(self, path):
data = None
if self.command == "POST":
data = self.rfile.read(int(self.headers.get("Content-Length") or 0))
req = urllib.request.Request(f"http://{DWARF}{path}", data=data, method=self.command)
if self.headers.get("Content-Type"):
req.add_header("Content-Type", self.headers["Content-Type"])
try:
with urllib.request.urlopen(req, timeout=60) as r:
self.reply(r.status, r.headers.get("Content-Type", "application/octet-stream"), r.read())
except urllib.error.HTTPError as e:
self.reply(e.code, e.headers.get("Content-Type", "text/plain"), e.read())
except Exception as e:
self.reply(502, "text/plain; charset=utf-8",
f"Can't reach the MOD at {DWARF}: {e}".encode("utf-8"))
def reply(self, code, ctype, body):
self.send_response(code)
self.send_header("Content-Type", ctype)
self.send_header("Content-Length", str(len(body)))
# Images can be cached for a while; data must always be fresh.
self.send_header("Cache-Control", "max-age=600" if ctype.startswith("image/") else "no-store")
self.end_headers()
self.wfile.write(body)
if __name__ == "__main__":
server = ThreadingHTTPServer(("127.0.0.1", PORT), Handler)
url = f"http://localhost:{PORT}"
print(f"Pedalboard Finder: {url} (MOD at {DWARF}). Ctrl+C to stop.")
try:
webbrowser.open(url)
except Exception:
pass
try:
server.serve_forever()
except KeyboardInterrupt:
print("\nStopped.")