<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>README.md - collab/focustab @ main</title>
<meta name="description" content="README.md in collab/focustab at main.">
<meta property="og:title" content="README.md - collab/focustab @ main">
<meta property="og:description" content="README.md in collab/focustab at main.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="main" data-tip="7e4fb0e01051900a8f822ed3d65c5428e30db82a">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>collab/focustab</h1>
<p class="desc">extension/plugin for fuzzy finding browser tabs</p>
</div>
<pre class="clone">git clone https://git.julia.blue/collab/focustab</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Julia Ryan</span><span class="commit-message" data-commit="7e4fb0e01051900a8f822ed3d65c5428e30db82a">docs: more notes and fix typo</span><span class="snapshot-sha sha" data-commit="7e4fb0e01051900a8f822ed3d65c5428e30db82a">7e4fb0e</span><time datetime="2026-09-29T00:13:07-07:00" title="2026-09-29 00:13:07 -0700">2026-09-29</time></p>
<header class="topbar"><details class="switcher"><summary>main</summary><div class="menu"><strong>branches</strong><a class="current" href="/collab/focustab/ref/main/">main</a><a class="all" href="/collab/focustab/refs">all refs →</a></div></details><nav class="crumbs"><a href="/collab/focustab/">focustab</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>3.6 KiB</span><span>63 lines</span></span><span class="actions"><a class="raw" href="/collab/focustab/raw/31f1d7d0754b2aa3c87998b506605157d794cf24/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Focustab</h1>
<p>A browser extension with a native daemon to enable fuzzy searching and focusing of your (way too many) open tabs.</p>
<p>links:</p>
<ul>
<li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_messaging">native messaging</a></li>
<li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests">native manifests</a></li>
<li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json">extension manifest</a></li>
<li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension#installing">installing extensions</a> (local development)</li>
<li><a href="https://github.com/Wox-launcher/Wox.Plugin.Arc">similar project</a>, wox+arc+macos</li>
<li><a href="https://github.com/epilande/alfred-browser-tabs">another similar project</a>, alfred+chrome+macos, and <a href="https://github.com/deanishe/alfred-firefox">firefox version</a></li>
</ul>
<p>components:</p>
<ul>
<li>extension(s)?
<ul>
<li>for now: just firefox</li>
<li>eventually? chrome</li>
</ul>
</li>
<li>native extension
<ul>
<li>just one, for now just: linux binary</li>
<li>eventually? macOS?</li>
</ul>
</li>
<li>"frontend" integrations:
<ul>
<li><input disabled="" type="checkbox"/>
terminal CLI guy with fzf/skim</li>
<li><input disabled="" type="checkbox"/>
rofi/rofi-wayland</li>
<li><input disabled="" type="checkbox"/>
gnome search thing</li>
<li><input disabled="" type="checkbox"/>
spotlight (flashlight? deprecated 😢) on macOS? see <a href="https://github.com/phmullins/awesome-macos?tab=readme-ov-file#application-launchers">this list</a> of macos launchers, maybe pick an open source one like sol</li>
</ul>
</li>
<li>^ means, window switcher support for:
<ul>
<li>no special handling (i.e. just call browser focus) — sufficient for X (and macOS?)
<ul>
<li>note: on <code>i3</code>, requires <a href="https://i3wm.org/docs/userguide.html#focus_on_window_activation"><code>focus-on-activation</code></a> to be set appropriately</li>
</ul>
</li>
<li>wayland via <a href="https://wayland.app/protocols/wlr-foreign-toplevel-management-unstable-v1"><code>wlr-foreign-toplevel-management</code></a> protocol (see <a href="https://github.com/lbonn/rofi/blob/5df2d3a13725a3c7ee3fdb9d2dcd6bdca19115fd/source/modes/wayland-window.c">here</a>)
<ul>
<li>TODO(julia): what do other switchers like anyrun, tofi, wofi, bemenu, fuzzel... use?</li>
</ul>
</li>
<li>for GNOME: special GNOME extension via <a href="https://github.com/hseliger/window-calls-extended"><code>window-calls-extended</code></a></li>
<li>macOS windowserver? does it just work automatically like in X?</li>
</ul>
</li>
</ul>
<h2>TODOs</h2>
<ul>
<li>
<p>multiple instances of the browser extension; have the "client" ask all of them for info? (i.e. chrome, firefox; multiple firefox profiles, etc.)</p>
</li>
<li>
<p>support story for gnome...</p>
<ul>
<li><a href="https://github.com/hseliger/window-calls-extended"><code>window-calls-extended</code></a></li>
<li>plugin for gnome's search functionality? like:
<ul>
<li><a href="https://github.com/xelad0m/just-another-search-bar"><code>just-another-search-bar</code></a></li>
<li><a href="https://github.com/icedman/search-light"><code>search-light</code></a></li>
<li>this is instead of rofi...</li>
</ul>
</li>
</ul>
</li>
<li>
<p>current plan for favicon support:</p>
<ul>
<li>have the daemon keep a content-addressed store for favicons</li>
<li>native extension should:
<ul>
<li>for b64 blobs:
<ul>
<li>figure out file ext from mime-type</li>
<li>hash content and store in XDG_CACHE_DIR (CAS)</li>
</ul>
</li>
<li>for URLs: TBD
<ul>
<li>should just fetch; may need to keep a URL-&gt;hash mapping w/TTLs?</li>
</ul>
</li>
</ul>
</li>
<li>clients should handle rendering, different filetypes, resizing, etc.
<ul>
<li>we will provide the abs path to the icon's image file</li>
</ul>
</li>
</ul>
</li>
<li>
<p>for tab -&gt; window mapping:</p>
<ul>
<li>query from extension on demand
<ul>
<li>rationale is that <code>FocusWindow</code> info is rather big; would be noisy to keep up to date in the native extension</li>
</ul>
</li>
<li>maybe try using something like <a href="https://git.sr.ht/~brocellous/wlrctl">wlrctl</a> to be more general</li>
</ul>
</li>
<li>
<p>try different message passing that'd work on macos like</p>
<ul>
<li>http</li>
<li>varlink</li>
<li>raw unix socket with some rust serialization framework</li>
</ul>
</li>
</ul>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Focustab</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">A browser extension with a native daemon to enable fuzzy searching and focusing of your (way too many) open tabs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">links:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"><a-p>  - </a-p>[native messaging](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_messaging)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">  <a-p>- </a-p>[native manifests](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">  <a-p>- </a-p>[extension manifest](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text">  <a-p>- </a-p>[installing extensions](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension#installing) (local development)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text">  <a-p>- </a-p>[similar project](https://github.com/Wox-launcher/Wox.Plugin.Arc), wox+arc+macos</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text">  <a-p>- </a-p>[another similar project](https://github.com/epilande/alfred-browser-tabs), alfred+chrome+macos, and [firefox version](https://github.com/deanishe/alfred-firefox)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>components:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>  - extension(s)?</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>    + for now: just firefox</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>    + eventually? chrome</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>  - native extension</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>    + just one, for now just: linux binary</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>    + eventually? macOS?</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>  - &quot;frontend&quot; integrations:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>    + [ ] terminal CLI guy with fzf/skim</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>    + [ ] rofi/rofi-wayland</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>    + [ ] gnome search thing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>    + [ ] spotlight (flashlight? deprecated 😢) on macOS? see [this list](https://github.com/phmullins/awesome-macos?tab=readme-ov-file#application-launchers) of macos launchers, maybe pick an open source one like sol</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>  - ^ means, window switcher support for:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>    + no special handling (i.e. just call browser focus) — sufficient for X (and macOS?)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>      * note: on `i3`, requires [`focus-on-activation`](https://i3wm.org/docs/userguide.html#focus_on_window_activation) to be set appropriately</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>    + wayland via [`wlr-foreign-toplevel-management`](https://wayland.app/protocols/wlr-foreign-toplevel-management-unstable-v1) protocol (see [here](https://github.com/lbonn/rofi/blob/5df2d3a13725a3c7ee3fdb9d2dcd6bdca19115fd/source/modes/wayland-window.c))</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>      * TODO(julia): what do other switchers like anyrun, tofi, wofi, bemenu, fuzzel... use?</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>    + for GNOME: special GNOME extension via [`window-calls-extended`](https://github.com/hseliger/window-calls-extended)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>    + macOS windowserver? does it just work automatically like in X?</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>## </a-p><a-tt>TODOs</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>  - multiple instances of the browser extension; have the &quot;client&quot; ask all of them for info? (i.e. chrome, firefox; multiple firefox profiles, etc.)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>  - support story for gnome...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>    + [`window-calls-extended`](https://github.com/hseliger/window-calls-extended)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>    + plugin for gnome&#39;s search functionality? like:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>      * [`just-another-search-bar`](https://github.com/xelad0m/just-another-search-bar)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>      * [`search-light`](https://github.com/icedman/search-light)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>      * this is instead of rofi...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>  - current plan for favicon support:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>    + have the daemon keep a content-addressed store for favicons</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>    + native extension should:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>      * for b64 blobs:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>        - figure out file ext from mime-type</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>        - hash content and store in XDG_CACHE_DIR (CAS)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>      * for URLs: TBD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>        - should just fetch; may need to keep a URL-&gt;hash mapping w/TTLs?</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>    + clients should handle rendering, different filetypes, resizing, etc.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>      * we will provide the abs path to the icon&#39;s image file</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>  - for tab -&gt; window mapping:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>    + query from extension on demand</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>      * rationale is that `FocusWindow` info is rather big; would be noisy to keep up to date in the native extension</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>    + maybe try using something like [wlrctl](https://git.sr.ht/~brocellous/wlrctl) to be more general</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>  - try different message passing that&#39;d work on macos like</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>    + http</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>    + varlink</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>    + </a-p>raw unix socket with some rust serialization framework</span></span></pre></div></div>
</main>
</body>
</html>
