From 97dd8da17861c33cb8d4543a2c46f68260bbbf71 Mon Sep 17 00:00:00 2001 From: Timothy Kim Date: Wed, 21 Oct 2026 20:40:39 -0400 Subject: [PATCH] initial commit --- .gitignore | 4 + 22d0e17ada8245a4bc80-1.0.0.xpi | Bin 0 -> 11813 bytes README.md | 27 +++++ extension/background.js | 58 ++++++++++ extension/common.js | 54 ++++++++++ extension/icons/fallback.svg | 5 + extension/manifest.json | 28 +++++ extension/options.html | 32 ++++++ extension/options.js | 64 ++++++++++++ host/install.sh | 22 ++++ host/quick_profile_host.py | 186 +++++++++++++++++++++++++++++++++ 11 files changed, 480 insertions(+) create mode 100644 .gitignore create mode 100644 22d0e17ada8245a4bc80-1.0.0.xpi create mode 100644 README.md create mode 100644 extension/background.js create mode 100644 extension/common.js create mode 100644 extension/icons/fallback.svg create mode 100644 extension/manifest.json create mode 100644 extension/options.html create mode 100644 extension/options.js create mode 100755 host/install.sh create mode 100755 host/quick_profile_host.py diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..8aec54b --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +.*.swp +web-ext-artifacts/ +extension/.amo-upload-uuid +dist/quick-profile.xpi diff --git a/22d0e17ada8245a4bc80-1.0.0.xpi b/22d0e17ada8245a4bc80-1.0.0.xpi new file mode 100644 index 0000000000000000000000000000000000000000..e4f06c693911aa910c42472e518f57fa40409591 GIT binary patch literal 11813 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 Ibbnp_f8dH=+5i9m literal 0 HcmV?d00001 diff --git a/README.md b/README.md new file mode 100644 index 0000000..af189d7 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +# Quick Profile + +Toolbar button that opens (or focuses) a chosen Firefox profile in one click. The button shows that profile's avatar in its theme colors. + +Extensions cannot launch profiles, so a small native messaging host (`host/quick_profile_host.py`) does the work. Firefox spawns it per click; it runs `firefox --profile --profiles-activate`, the same command Firefox's own profile switcher uses. + +## Install + +1. Register the native host (once per user): + + host/install.sh + +2. Install the extension **in each profile** that should have the button. + - Development: `about:debugging` → This Firefox → Load Temporary Add-on → `extension/manifest.json` (removed on restart). + - Permanent: release Firefox requires a signed add-on. Sign it as unlisted (private, not published on AMO): + + npx web-ext sign --source-dir extension --channel unlisted \ + --api-key "$AMO_JWT_ISSUER" --api-secret "$AMO_JWT_SECRET" + + Keys: https://addons.mozilla.org/developers/addon/api/key/. Install the resulting `.xpi` via `about:addons` → gear → Install Add-on From File. + +3. Choose the target: `about:addons` → Quick Profile → Preferences, or click the button before configuring it. + +## Notes + +- The icon is refreshed at startup and whenever the target changes. If you change a profile's avatar, reselect it or restart to update the button. +- Linux only (`~/.mozilla/firefox`, `/proc`). diff --git a/extension/background.js b/extension/background.js new file mode 100644 index 0000000..12f925a --- /dev/null +++ b/extension/background.js @@ -0,0 +1,58 @@ +"use strict"; + +async function getTarget() { + const { targetPath } = await browser.storage.local.get("targetPath"); + return targetPath || null; +} + +async function resetButton(title) { + await browser.action.setIcon({ path: "icons/fallback.svg" }); + await browser.action.setTitle({ title }); +} + +async function refreshButton() { + const targetPath = await getTarget(); + if (!targetPath) { + return resetButton("Quick Profile: choose a profile"); + } + let profiles; + try { + profiles = await listProfiles(); + } catch (e) { + return resetButton(`Quick Profile: ${e.message}`); + } + const profile = profiles.find(p => p.path === targetPath); + if (!profile) { + return resetButton("Quick Profile: configured profile no longer exists"); + } + try { + const [i16, i32] = await Promise.all([renderIcon(profile, 16), renderIcon(profile, 32)]); + await browser.action.setIcon({ imageData: { 16: i16, 32: i32 } }); + } catch (e) { + await browser.action.setIcon({ path: "icons/fallback.svg" }); + } + await browser.action.setTitle({ title: `Open ${profile.name}` }); +} + +browser.action.onClicked.addListener(async () => { + const targetPath = await getTarget(); + if (!targetPath) { + return browser.runtime.openOptionsPage(); + } + try { + await callHost({ cmd: "launch", path: targetPath }); + } catch (e) { + await browser.action.setTitle({ title: `Quick Profile: ${e.message}` }); + await browser.action.setBadgeText({ text: "!" }); + setTimeout(() => browser.action.setBadgeText({ text: "" }), 3000); + } +}); + +browser.storage.onChanged.addListener((changes, area) => { + if (area === "local" && "targetPath" in changes) { + refreshButton(); + } +}); + +browser.runtime.onStartup.addListener(refreshButton); +browser.runtime.onInstalled.addListener(refreshButton); diff --git a/extension/common.js b/extension/common.js new file mode 100644 index 0000000..55a458e --- /dev/null +++ b/extension/common.js @@ -0,0 +1,54 @@ +"use strict"; + +const HOST = "quick_profile"; + +async function callHost(msg) { + const reply = await browser.runtime.sendNativeMessage(HOST, msg); + if (!reply || !reply.ok) { + throw new Error(reply?.error || "no reply from native host"); + } + return reply; +} + +async function listProfiles() { + return (await callHost({ cmd: "list" })).profiles; +} + +// Firefox's avatar SVGs paint the badge circle with context-fill and the +// glyph with context-stroke; chrome CSS supplies those from the profile +// theme. Outside chrome we substitute the colors directly. +function avatarDataURL(profile, size) { + const svg = profile.images?.[size]; + if (!svg) { + return profile.images?.custom || null; + } + const colored = svg + .replaceAll("context-fill", profile.themeBg) + .replaceAll("context-stroke", profile.themeFg); + return "data:image/svg+xml;charset=utf-8," + encodeURIComponent(colored); +} + +function loadImage(src) { + return new Promise((resolve, reject) => { + const img = new Image(); + img.onload = () => resolve(img); + img.onerror = () => reject(new Error("failed to load avatar image")); + img.src = src; + }); +} + +async function renderIcon(profile, px) { + const canvas = document.createElement("canvas"); + canvas.width = canvas.height = px; + const ctx = canvas.getContext("2d"); + const isCustom = !profile.images?.["16"]; + const img = await loadImage(avatarDataURL(profile, px <= 16 ? "16" : "48")); + if (isCustom) { + // Custom avatars are plain images: clip to a circle like Firefox does. + ctx.beginPath(); + ctx.arc(px / 2, px / 2, px / 2, 0, 2 * Math.PI); + ctx.clip(); + } + ctx.drawImage(img, 0, 0, px, px); + return ctx.getImageData(0, 0, px, px); +} diff --git a/extension/icons/fallback.svg b/extension/icons/fallback.svg new file mode 100644 index 0000000..a9bcd56 --- /dev/null +++ b/extension/icons/fallback.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/extension/manifest.json b/extension/manifest.json new file mode 100644 index 0000000..c2e3d74 --- /dev/null +++ b/extension/manifest.json @@ -0,0 +1,28 @@ +{ + "manifest_version": 3, + "name": "Quick Profile", + "version": "1.0.0", + "description": "One-click toolbar button that opens a chosen Firefox profile.", + "browser_specific_settings": { + "gecko": { + "id": "quick-profile@timothykim", + "strict_min_version": "138.0" + } + }, + "permissions": ["nativeMessaging", "storage"], + "background": { + "scripts": ["common.js", "background.js"] + }, + "action": { + "default_title": "Quick Profile: choose a profile", + "default_icon": "icons/fallback.svg" + }, + "icons": { + "48": "icons/fallback.svg", + "96": "icons/fallback.svg" + }, + "options_ui": { + "page": "options.html", + "open_in_tab": false + } +} diff --git a/extension/options.html b/extension/options.html new file mode 100644 index 0000000..18db63d --- /dev/null +++ b/extension/options.html @@ -0,0 +1,32 @@ + + + + + Quick Profile + + + +

Profile to open

+

Clicking the toolbar button opens (or focuses) this profile.

+ +
+ + + + diff --git a/extension/options.js b/extension/options.js new file mode 100644 index 0000000..b82a173 --- /dev/null +++ b/extension/options.js @@ -0,0 +1,64 @@ +"use strict"; + +const list = document.getElementById("profiles"); +const status = document.getElementById("status"); + +function showError(text) { + status.className = "error"; + status.textContent = text; +} + +async function init() { + let profiles; + try { + profiles = await listProfiles(); + } catch (e) { + showError( + `Cannot reach the native host (${e.message}). Run host/install.sh, then reload this page.` + ); + return; + } + if (!profiles.length) { + showError("No profiles found in ~/.mozilla/firefox/Profile Groups."); + return; + } + + const { targetPath } = await browser.storage.local.get("targetPath"); + + for (const profile of profiles) { + const li = document.createElement("li"); + const label = document.createElement("label"); + + const radio = document.createElement("input"); + radio.type = "radio"; + radio.name = "target"; + radio.value = profile.path; + radio.checked = profile.path === targetPath; + radio.addEventListener("change", async () => { + await browser.storage.local.set({ targetPath: profile.path }); + status.className = ""; + status.textContent = `Saved: ${profile.name}`; + }); + + const img = document.createElement("img"); + img.alt = ""; + const src = avatarDataURL(profile, "48"); + if (src) { + img.src = src; + } + + const text = document.createElement("div"); + const name = document.createElement("div"); + name.textContent = profile.name; + const path = document.createElement("div"); + path.className = "path"; + path.textContent = profile.path; + text.append(name, path); + + label.append(radio, img, text); + li.append(label); + list.append(li); + } +} + +init(); diff --git a/host/install.sh b/host/install.sh new file mode 100755 index 0000000..87dcf6d --- /dev/null +++ b/host/install.sh @@ -0,0 +1,22 @@ +#!/usr/bin/env bash +# Register the native messaging host with Firefox for the current user. +set -euo pipefail + +HOST_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +HOST_SCRIPT="$HOST_DIR/quick_profile_host.py" +MANIFEST_DIR="$HOME/.mozilla/native-messaging-hosts" + +chmod +x "$HOST_SCRIPT" +mkdir -p "$MANIFEST_DIR" + +cat > "$MANIFEST_DIR/quick_profile.json" < $HOST_SCRIPT" diff --git a/host/quick_profile_host.py b/host/quick_profile_host.py new file mode 100755 index 0000000..71b0103 --- /dev/null +++ b/host/quick_profile_host.py @@ -0,0 +1,186 @@ +#!/usr/bin/env python3 +"""Native messaging host for the Quick Profile extension. + +Firefox spawns this once per message: read one request, write one reply, exit. + +Requests: + {"cmd": "list"} -> {"ok": true, "profiles": [...]} + {"cmd": "launch", "path": "..."} -> {"ok": true} +""" + +import base64 +import glob +import json +import mimetypes +import os +import shutil +import sqlite3 +import struct +import subprocess +import sys +import zlib + +FIREFOX_DIR = os.path.expanduser("~/.mozilla/firefox") +GROUPS_DIR = os.path.join(FIREFOX_DIR, "Profile Groups") +AVATAR_PREFIX = "chrome/browser/content/browser/profiles/assets/" + +# Mirrors STANDARD_AVATARS in SelectableProfile.sys.mjs; anything else is a +# custom image stored in "Profile Groups/avatars/". +STANDARD_AVATARS = { + "barbell", "bike", "book", "briefcase", "canvas", "craft", + "default-favicon", "diamond", "flower", "folder", "hammer", "heart", + "heart-rate", "history", "leaf", "lightbulb", "makeup", "message", + "musical-note", "palette", "paw-print", "plane", "present", "shopping", + "soccer", "sparkle-single", "star", "video-game-controller", +} + + +def read_message(): + raw_len = sys.stdin.buffer.read(4) + if len(raw_len) < 4: + sys.exit(0) + (length,) = struct.unpack("@I", raw_len) + return json.loads(sys.stdin.buffer.read(length)) + + +def send_message(msg): + data = json.dumps(msg).encode() + sys.stdout.buffer.write(struct.pack("@I", len(data))) + sys.stdout.buffer.write(data) + sys.stdout.buffer.flush() + + +def firefox_binary(): + """The Firefox that spawned us, so we launch the same build.""" + try: + exe = os.readlink(f"/proc/{os.getppid()}/exe") + if os.path.basename(exe).startswith("firefox"): + return exe + except OSError: + pass + return shutil.which("firefox") or "firefox" + + +def read_jar(jar_path, names): + """Extract `names` from a Mozilla jar. + + omni.ja is an "optimized" jar: the central directory sits at the front of + the file, after a 4-byte readahead header, so zipfile rejects it. Walk the + central directory ourselves instead. + """ + wanted = set(names) + out = {} + with open(jar_path, "rb") as f: + data = f.read() + pos = data.find(b"PK\x01\x02") + while pos != -1 and data[pos:pos + 4] == b"PK\x01\x02" and wanted: + (method, csize, name_len, extra_len, comment_len, local_off) = ( + struct.unpack_from(" {"16": svg, "48": svg} or {"custom": data URL}.""" + images = {} + standard = [a for a in avatars if a in STANDARD_AVATARS] + if standard: + app_dir = os.path.dirname(os.path.realpath(firefox_binary())) + omni = os.path.join(app_dir, "browser", "omni.ja") + try: + files = read_jar( + omni, + [f"{AVATAR_PREFIX}{size}_{a}.svg" for a in standard for size in (16, 48)], + ) + except OSError: + files = {} + for a in standard: + images[a] = { + size: files[f"{AVATAR_PREFIX}{size}_{a}.svg"].decode() + for size in ("16", "48") + if f"{AVATAR_PREFIX}{size}_{a}.svg" in files + } + for a in avatars: + if a in STANDARD_AVATARS: + continue + path = os.path.join(GROUPS_DIR, "avatars", a) + try: + with open(path, "rb") as f: + mime = mimetypes.guess_type(path)[0] or "image/png" + images[a] = { + "custom": f"data:{mime};base64,{base64.b64encode(f.read()).decode()}" + } + except OSError: + images[a] = {} + return images + + +def list_profiles(): + profiles = {} + for db in sorted(glob.glob(os.path.join(GROUPS_DIR, "*.sqlite"))): + try: + conn = sqlite3.connect(f"file:{db}?mode=ro", uri=True) + rows = conn.execute( + "SELECT path, name, avatar, themeFg, themeBg FROM Profiles ORDER BY id" + ).fetchall() + conn.close() + except sqlite3.Error: + continue + for path, name, avatar, fg, bg in rows: + abspath = path if os.path.isabs(path) else os.path.join(FIREFOX_DIR, path) + profiles.setdefault(abspath, { + "path": abspath, + "name": name, + "avatar": avatar, + "themeFg": fg, + "themeBg": bg, + }) + result = list(profiles.values()) + images = avatar_images({p["avatar"] for p in result}) + for p in result: + p["images"] = images.get(p["avatar"], {}) + return result + + +def launch(path): + # Same arguments as SelectableProfileService.launchInstance. If the + # profile is already running, Firefox's remoting service focuses it. + if not os.path.isdir(path): + raise ValueError(f"profile directory not found: {path}") + subprocess.Popen( + [firefox_binary(), "--profile", path, "--profiles-activate"], + stdin=subprocess.DEVNULL, + stdout=subprocess.DEVNULL, + stderr=subprocess.DEVNULL, + start_new_session=True, + ) + + +def main(): + msg = read_message() + try: + cmd = msg.get("cmd") + if cmd == "list": + send_message({"ok": True, "profiles": list_profiles()}) + elif cmd == "launch": + launch(msg["path"]) + send_message({"ok": True}) + else: + send_message({"ok": False, "error": f"unknown command: {cmd}"}) + except Exception as e: + send_message({"ok": False, "error": str(e)}) + + +if __name__ == "__main__": + main()