#!/usr/bin/env python3 """VLC iOS Browser - a local web app for the files in VLC for iOS "Sharing via Wi-Fi". Run: python3 vlc_web.py (opens http://localhost:8099) Python 3.8+ standard library only. Works on macOS, Windows, Linux. The Mac runs this helper; the browser page talks to it, and it talks to the phone. (A hosted page cannot reach a LAN IP: browsers block https->http and VLC sends no CORS.) VLC's server can only list, download and upload. It has no delete/rename/move/mkdir. """ import http.client, json, os, re, sys, threading, time, urllib.parse, urllib.request, webbrowser import xml.etree.ElementTree as ET from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer PORT = int(os.environ.get("PORT", "8099")) DEFAULT_DEST = os.path.join(os.path.expanduser("~"), "Downloads", "VLC") S = {"host": None, "files": [], "job": None} # shared state LOCK = threading.Lock() def safe_name(n): n = re.sub(r'[<>:"/\\|?*\x00-\x1f]', "_", n).rstrip(" .") return n or "unnamed" def fetch(path, headers=None, timeout=30): req = urllib.request.Request("http://" + S["host"] + path, headers=headers or {}) return urllib.request.urlopen(req, timeout=timeout) def load_library(host, passcode=None): S["host"] = host if passcode: try: fetch("/public/auth.html?code=" + urllib.parse.quote(passcode)).read() except Exception: pass root = ET.fromstring(fetch("/libMediaVLC.xml").read()) files, seen = [], set() for m in root.iter("Media"): for attr, sub in (("pathfile", False), ("pathSubtitle", True)): u = m.get(attr) if not u or u in seen: continue seen.add(u) p = urllib.parse.urlsplit(u).path name = safe_name(urllib.parse.unquote(p.rsplit("/", 1)[-1])) thumb = urllib.parse.urlsplit(m.get("thumb") or "").path if not sub else "" files.append({"id": len(files), "name": name, "path": p, "thumb": thumb, "size": int(m.get("size") or 0) if not sub else 0, "duration": m.get("duration") or "", "subtitle": sub, "title": m.get("title") or name}) S["files"] = files return files def unique(dest, name, used): stem, ext = os.path.splitext(name) c, n = name, 1 while c.lower() in used: n += 1 c = "%s (%d)%s" % (stem, n, ext) used.add(c.lower()) return os.path.join(dest, c) def run_save(ids, dest): job = S["job"] os.makedirs(dest, exist_ok=True) used = set(x.lower() for x in os.listdir(dest)) if False else set() for i in ids: if job["cancel"]: break f = S["files"][i] path = unique(dest, f["name"], used) job["current"] = f["name"] job["cur_done"], job["cur_total"] = 0, f["size"] for attempt in range(5): have = os.path.getsize(path) if os.path.exists(path) else 0 if f["size"] and have == f["size"]: break try: hdr = {"Range": "bytes=%d-" % have} if have else {} with fetch(f["path"], hdr, timeout=60) as r: resume = have and r.status == 206 done = have if resume else 0 with open(path, "ab" if resume else "wb") as out: while not job["cancel"]: b = r.read(1 << 20) if not b: break out.write(b) done += len(b) job["cur_done"] = done break except Exception as e: job["errors"].append("%s: %s" % (f["name"], e)) time.sleep(2 * (attempt + 1)) else: job["failed"] += 1 continue job["finished"] += 1 job["state"] = "cancelled" if job["cancel"] else "done" def upload_to_phone(name, length, rfile): """Stream a raw request body to the phone as multipart/form-data -> /upload.json.""" boundary = "----vlcweb%d" % int(time.time() * 1000) name = safe_name(name) head = ('--%s\r\nContent-Disposition: form-data; name="files[]"; filename="%s"\r\n' 'Content-Type: application/octet-stream\r\n\r\n' % (boundary, name)).encode() tail = ("\r\n--%s--\r\n" % boundary).encode() host, _, port = S["host"].partition(":") c = http.client.HTTPConnection(host, int(port or 80), timeout=300) c.putrequest("POST", "/upload.json") c.putheader("Content-Type", "multipart/form-data; boundary=" + boundary) c.putheader("Content-Length", str(len(head) + length + len(tail))) c.endheaders() c.send(head) left = length while left: b = rfile.read(min(1 << 20, left)) if not b: raise IOError("client closed during upload") c.send(b) left -= len(b) c.send(tail) r = c.getresponse() r.read() c.close() return r.status class H(BaseHTTPRequestHandler): protocol_version = "HTTP/1.1" def log_message(self, *a): pass def json(self, obj, code=200): b = json.dumps(obj).encode() self.send_response(code) self.send_header("Content-Type", "application/json") self.send_header("Content-Length", str(len(b))) self.end_headers() self.wfile.write(b) def body(self): n = int(self.headers.get("Content-Length") or 0) return json.loads(self.rfile.read(n) or b"{}") def proxy(self, path, name=None, attach=False): hdr = {} if self.headers.get("Range"): hdr["Range"] = self.headers["Range"] try: r = fetch(path, hdr, timeout=60) except urllib.error.HTTPError as e: self.send_response(e.code); self.send_header("Content-Length", "0"); self.end_headers(); return except Exception: self.send_response(502); self.send_header("Content-Length", "0"); self.end_headers(); return self.send_response(r.status) for k in ("Content-Length", "Content-Range", "Accept-Ranges"): if r.headers.get(k): self.send_header(k, r.headers[k]) ctype = "application/octet-stream" if attach else (r.headers.get("Content-Type") or "application/octet-stream") self.send_header("Content-Type", ctype) if attach: self.send_header("Content-Disposition", "attachment; filename*=UTF-8''" + urllib.parse.quote(name)) self.end_headers() try: while True: b = r.read(1 << 18) if not b: break self.wfile.write(b) except (BrokenPipeError, ConnectionResetError): pass finally: r.close() def do_GET(self): u = urllib.parse.urlsplit(self.path) if u.path == "/": b = PAGE.encode() self.send_response(200) self.send_header("Content-Type", "text/html; charset=utf-8") self.send_header("Content-Length", str(len(b))) self.end_headers(); self.wfile.write(b) elif u.path == "/api/state": self.json({"host": S["host"], "files": S["files"], "dest": DEFAULT_DEST, "job": S["job"]}) elif u.path == "/api/progress": self.json(S["job"] or {}) elif u.path.startswith("/api/thumb/"): f = S["files"][int(u.path.rsplit("/", 1)[-1])] if f["thumb"]: self.proxy(f["thumb"]) else: self.send_response(404); self.send_header("Content-Length", "0"); self.end_headers() elif u.path.startswith("/api/file/"): f = S["files"][int(u.path.rsplit("/", 1)[-1])] self.proxy(f["path"], f["name"], attach="dl=1" in u.query) else: self.send_response(404); self.send_header("Content-Length", "0"); self.end_headers() def do_POST(self): u = urllib.parse.urlsplit(self.path) try: if u.path == "/api/connect": d = self.body() host = d["host"].replace("http://", "").strip().rstrip("/") files = load_library(host, d.get("passcode")) self.json({"ok": True, "count": len(files)}) elif u.path == "/api/refresh": load_library(S["host"]); self.json({"ok": True}) elif u.path == "/api/save": d = self.body() with LOCK: if S["job"] and S["job"]["state"] == "running": return self.json({"ok": False, "error": "A download is already running"}, 409) ids = d.get("ids") or [f["id"] for f in S["files"]] dest = os.path.expanduser(d.get("dest") or DEFAULT_DEST) S["job"] = {"state": "running", "total": len(ids), "finished": 0, "failed": 0, "current": "", "cur_done": 0, "cur_total": 0, "errors": [], "cancel": False, "dest": dest} threading.Thread(target=run_save, args=(ids, dest), daemon=True).start() self.json({"ok": True, "dest": dest}) elif u.path == "/api/cancel": if S["job"]: S["job"]["cancel"] = True self.json({"ok": True}) elif u.path == "/api/upload": q = urllib.parse.parse_qs(u.query) st = upload_to_phone(q["name"][0], int(self.headers["Content-Length"]), self.rfile) self.json({"ok": st < 400, "status": st}) else: self.json({"ok": False}, 404) except Exception as e: self.json({"ok": False, "error": str(e)}, 500) PAGE = r""" VLC iOS Browser

VLC iOS Browser

Drop files here to upload them to the phone
NameSizeLength
Turn on Sharing via Wi-Fi in VLC, enter the address above, and press Connect.

VLC's Wi-Fi server can list, download and upload only. It cannot delete, rename, move or create folders on the phone.

""" if __name__ == "__main__": srv = ThreadingHTTPServer(("127.0.0.1", PORT), H) url = "http://localhost:%d" % PORT print("VLC iOS Browser running at", url, " (Ctrl+C to stop)") threading.Timer(0.6, lambda: webbrowser.open(url)).start() try: srv.serve_forever() except KeyboardInterrupt: pass