A calm, private browser built on Zen: ad and tracker blocking built into the browser, stricter privacy settings, Tor tabs, and a search of your own.
Download · What it changes · Privacy test results · Release notes · Build from source
Live: gitguy268.github.io/xiao · xiao-lilac.vercel.app
| Blocks ads and trackers | Built into the browser, not an extension. Ghostery's open-source engine with EasyList, EasyPrivacy and uBlock Origin's lists, prebuilt and refreshed daily, including hiding empty ad slots. Switch it off per site from the Xiao button. |
| Uses less memory | With six busy sites open, the add-on process holds 39 MB instead of 0.1's 290 MB, even after Firefox frees what it can. The whole browser uses 2,179 MB instead of 3,193 MB after a minute, and 1,821 MB instead of 2,026 MB after freeing memory. These are medians of three runs; how it was measured. |
| Hardens 82 settings | No telemetry or studies, strict tracking protection, HTTPS only, DNS over HTTPS, no early connections, WebRTC without local addresses. Six more settings keep idle processes and tabs from holding memory. Strict mode adds 10, including Tor Browser's fingerprinting resistance. Full list. |
| Tor tabs | A "Tor" container whose tabs go through Tor, with a circuit per site (and a new one from the Xiao button) and WebRTC removed. If Tor stops, they fail; they never fall back to a direct connection. |
| Searches with SearXNG | searx.ononoki.org by default, then priv.au, then Brave Search: a search one of them refuses or can't answer is sent on to the next with the same words. Or pick DuckDuckGo, Mullvad Leta, Startpage, Brave or your own. |
| Xiao Search | Optional: your own SearXNG, in Xiao's style, on this computer only and running only while Xiao does. |
| A Library of your files | One searchable place for your downloads, the folders you give it, your notes, collections and closed tabs, in Xiao's own look, built from OpenFinder. Downloads keep the name they came with, so a renamed file is still found; tidy names are proposed and reviewed, never applied blindly, and every rename can be undone. Private windows and Tor tabs never reach it. |
| Arc- and Dia-style helpers | Auto-archive of old tabs (reopened in their own space), Boards of links and quotes, a quick window for links from other apps, Copy as Markdown (a quote links to its own words on the page), a calendar preview with a Join button, !top to open the top results in a folder, a blocking pause for one tab, "Always mute this site", and closing new tabs left empty. All tabs lists every tab in every space to search and act on many at once, or takes a command in words ("close all youtube tabs", "move github tabs to Work") and shows the tabs before anything happens. What Zen already does (spaces, split view, Glance, Boosts, routing, Arc and Dia import) is checked to work, not rebuilt: the ledger, with every feature of the Arc/Dia rebuild pack by ID. |
| Assist | Off until you turn it on. Tidy tab titles, tab groups, and "Ask about this page" with the passages that answer; with the local AI (MiniCPM5 on this computer) an answer that cites them. Mention other tabs or a folder to ask across them, save instructions as Skills (/kids), give it a style, and keep answers in a note. Questions asked while it writes wait their turn. Nothing leaves your computer, and nothing it writes can act. |
| Firefox's own about:pdf and viewer (reorder, merge, sign, comment), plus Xiao's PDF tools for what the viewer doesn't do: booklets, pages per sheet, page numbers, crop, passwords, attachments, keeping, removing or turning some pages, and the PDFs downloaded lately. | |
| Features you add | All off until you turn them on in the start page's Features; the big ones download only then. The Library, a sticky note (shared with textarea through a folder) with #tags and writing tools, Send to a device over your Wi-Fi, clipboard history, an EPUB and PDF reader, a blank camera for sites you choose, sorting your notes into a board by voice with AI on this computer, Boards, a quick window, auto-archive, a file converter, PDF tools and tab sleep. Spaces, collections and settings export to one file and import back, with every address shown first; Zen's importer brings in Arc (macOS, Windows) and Dia (macOS). |
| Silent mode | A switch: Xiao connects to nothing by itself, only the pages and downloads you ask for. A 10-minute idle test logs every connection and finds none. Its cost is that certificate and phishing lists go out of date and updates wait for your click. What normal mode connects to. |
| Varies your fingerprint | Audio, canvas and WebGL readings get tiny noise, and the core count varies, differently on each site and after each restart, the idea Brave calls farbling. Firefox's own protection handles screen size, graphics card and fonts. On by default, with a switch per site. |
| Bangs | !gh cats goes straight to that site's search, from a list of about 13,000 names on this computer, so no search engine sees it. Your own too. |
| Plays DRM video | Widevine, as in Firefox. Encrypted test video has played in Xiao's copy of Zen on macOS. It is the software level (L3), so streaming services may cap the picture quality. |
| Updates itself | Once at launch, signed with Xiao's own key, installed at the next start and undone by itself if that start fails. |
| Start page | Opens with every new tab (Ctrl+T included) and when Xiao starts, with search, your sites, and what was blocked. Four styles (Normal, Liquid glass, Terminal, Retrofind), each light or dark. Its settings can switch back to Zen's floating address bar or to reopening your tabs. |
The Library and Boards, in pictures
All tabs and PDF, in pictures
Xiao comes as a kit that makes Xiao's own copy of the Zen you already have, with Xiao's code inside and a profile of its own. Your normal Zen and its profile aren't touched.
On macOS, Homebrew does all of this (it installs Zen too):
brew trust gitguy268/tap
brew install --cask gitguy268/tap/xiaoOr by hand:
- Download
xiao-kit.zipfrom the latest release and unzip it. - Run the installer:
| macOS and Linux | Windows (PowerShell) |
|---|---|
sh install.sh --tor --search |
powershell -ExecutionPolicy Bypass -File install.ps1 -Tor |
- Open Xiao from
~/Applications, the Start menu or your applications menu.
| Option | What it does |
|---|---|
--tor / -Tor |
Downloads Tor 16.0 (hash pinned) for Tor tabs. Tor runs only while Xiao is open. |
--search |
Installs Xiao Search: SearXNG at a pinned commit (hash checked) on 127.0.0.1:8890, run only while Xiao is open. Needs uv or Python 3.10+. Not on Windows. !top (instant links) needs it. |
--strict / -Strict |
Adds fingerprinting resistance, DNS over HTTPS only, and clears cookies on quit. |
--uninstall / -Uninstall |
Removes Xiao's copy of Zen, its profile, Tor, Xiao Search and the launcher. |
On Linux with no Zen to copy, or only the Flatpak, the installer downloads Zen's own tarball (hash pinned), and Xiao's updates keep it current. Coming from 0.1? Run the new installer. It removes the old extension and any uBlock Origin it added, and renames xiao.app to Xiao.app. The start page's links and settings start fresh.
Full builds from Zen's source are set up in fork/.
- Not anonymity. Tor tabs hide your IP address from sites, but Xiao doesn't look like Tor Browser, so sites can still recognise the browser. Use Tor Browser when that matters.
- Kit Tor is a container, not a window. Tor tabs are a container in your normal window. Zen lets you give a Space a container; choose Tor to keep Tor tabs together. Open one from the Xiao button.
- Fingerprint noise isn't invisibility. The EFF's Cover Your Tracks calls 0.5's fingerprint randomized where 0.4's was unique (results). It stops a measurement following you between sites and restarts, but a determined tracker may still manage some of that. Web workers aren't covered, and sites can sometimes notice noise. Tor Browser is the choice when that matters.
- Silent mode has a cost. Newly known bad sites and revoked certificates stop being caught, security fixes wait until you check, Tor tabs fail, Xiao Search stops and translation can't fetch its language files.
- Send to a device shows this computer's local network address to sites in other tabs while its page is open, and macOS's firewall can block it between two copies on the same Mac.
- Liquid glass blurs and highlights. Firefox's engine can't bend what is behind a pane the way Chromium can.
- Linux is tested on each distribution's libraries in containers, not on its own sandbox rules, such as Ubuntu 24.04's AppArmor limits. NixOS and Alpine aren't supported.
- The kit is a copy of Zen. Xiao's code lives in its own copy, so Zen's own updater doesn't touch it. When Zen has updated, the next start of Xiao rebuilds the copy first, which takes a few seconds (on Windows, a little longer). macOS may then ask again for camera or microphone access.
- Builds are early. The overlay applies to Zen's source and its patches import, but no full build has been compiled yet, and builds don't include Tor.
- Windows is tested only by CI, and has no Xiao Search (SearXNG doesn't support it). Its Start menu shortcut has Xiao's icon, but the taskbar shows Zen's while Xiao runs.
- Downloads need a writable app folder. Features you add are stored in Xiao's own copy of Zen, the only folder Firefox's content sandbox lets their pages read. A fork build installed in a system folder can't take them.
- The voice organiser is slow in Firefox. Firefox's WebGPU runs its model about ten times slower than the processor does, so Xiao uses the processor: about a minute or two per board. Its first use downloads 1.8 GB from Hugging Face.
- Writing tools are only as good as a small model. MiniCPM5 2B on the processor takes about half a minute per note, and its tools can come out alike: "Shorten" may fix a note's grammar and barely shorten it.
- The converter is single-threaded in Xiao, so long videos convert more slowly than on its website.
- Commands in words are rules, not AI. All tabs understands close, archive, move, mute and group, with a site or word, "older than", or "duplicate". Anything else gets examples back, never a guess.
- Instant links need Xiao Search. Public search engines refuse scripted requests, so
!topworks only with--search. - Sharing a Boost or a space goes through Zen's server, and silent mode blocks it like every other connection Xiao doesn't make for a page.
- Filter lists come with the release and then, when Xiao starts, at most once a day, from the repository's
enginerelease on GitHub. Until that release exists, Xiao keeps the engine it was installed with.
Measured with npm run e2e:audit: 10 idle minutes on the start page, logging every HTTP request inside the browser and every socket its processes hold.
| Mode | Connects by itself to |
|---|---|
| Silent mode | Nothing. No request and no socket beyond this computer. |
| Normal | GitHub, for Xiao's update and filter check at start. Your calendar address every 15 minutes, if you set one. Mozilla's Remote Settings, for certificate revocation lists and blocklists. Google's Safe Browsing, for phishing and malware lists. Mozilla, Google and Cisco, for Widevine and the OpenH264 video codec. Your encrypted DNS provider. |
Anything else fails the test. Using your notes makes no connection in either mode.
How it works
shared/prefs/*.yamlhold the settings in Zen's own format. The kit turns them intouser.js, the fork copies them into Zen'sprefs/, and the website's privacy page is generated from them.core/is Xiao's browser code, loaded by Firefox's AutoConfig (core/loader/) from the app folder before any window opens:Blocker.mjsmatches every request against Ghostery's engine in the parent process (http-on-opening-request), with a per-site allowlist. The engine is serialised at build time (engine.bin), so the browser never parses raw lists.actors/XiaoChild.sys.mjsruns in each frame: cosmetic filtering, where the generic hiding sheet is parsed once per process and shared; removing WebRTC from Tor pages; and the start page's only bridge to Xiao.Tor.mjsis a proxy channel filter: Tor-container requests go to SOCKS on 127.0.0.1:9160, with a SOCKS username and connection isolation key per site and remote DNS. Anything it can't place fails closed.Search.mjsgives the start page's search choice to the address bar and, for the default chain, loads a refused or failed search on the next engine (failoverinstart/links.mjs).Silent.mjsis silent mode:shared/prefs/zero.yaml, plus a check that cancels every request the browser makes for itself, because release builds ignore some of those prefs.Bangs.mjsresolves bangs frombangs.json(npm run bangs), in the address bar and on the start page.Shield.mjsandXiaoChildadd the fingerprint noise (lib/farble.mjs) before a page's scripts run, and the blank camera.Updater.mjschecksupdates.jsonagainst the release key and leaves a verified kit in<data>/update/.xiao-launchinstalls it at the next start, and rerunning the previous kit undoes a release whose first start fails.Send.mjsserves the Send page from a 127.0.0.1 server on a secret path while it is open, because Firefox doesn't start WebRTC onresource://pages.Packs.mjsdownloads the features you add, listed inpacks.jsonwith a size and SHA-256 for every file, into<app>/xiao-packs/and serves each asresource://xiao-<id>/. Models come from Hugging Face at a pinned revision, by byte range.npm run packsbuilds the catalogue and the code zips (packs/, plus textarea's speech and writing code and convert's build).Notes.mjsis the sticky note: a panel on its own toolbar button over a folder of markdown files, keeping any front matter textarea wrote.StartPage.mjsandToolbar.mjsset the start page as the new tab and home page, add the one Xiao button with its panel, and putchrome.css(Xiao's typefaces, no empty extensions button) in every window.
- The kit's
make-app.shcopies Zen (an APFS clone on macOS), adds the loader andcore/, swaps in Xiao's name and icons, and removes the updater. The launcher rebuilds the copy when Zen's BuildID changes, then starts tor and Xiao Search, runs the copy on Xiao's profile, and stops them when Xiao quits. - Xiao Search is SearXNG downloaded at a pinned commit. The installer adds one stylesheet link (
kit/search/xiao.css) and Xiao's mark to the installed copy only. fork/overlay.mjsrenames Zen, swaps the branding, merges the settings and puts the same loader andcore/into the build. See fork/README.md.
Develop and test
Needs Node 22 and, for --search, uv or Python 3.10+.
npm ci
npm test # unit tests
npm run build # dist/core/, dist/kit/, dist/xiao-kit.zip, dist/engine/
npm run e2e # real Zen, throwaway home: blocking, prefs, new tab, WebRTC, Tor, fail-closed, restart
E2E_SEARCH=1 npm run e2e # also Xiao Search
npm run e2e:new # 0.5's features: ONLY=shield,bangs,styles,packs,extras,drm,updates picks some
npm run e2e:audit # every connection Xiao makes when idle, both modes (20 minutes)
node test/e2e/privacy-check.mjs # the EFF's Cover Your Tracks on its public site, twice, for reading
npm run bangs # core/bangs.json from Kagi's list at a pinned commit
npm run packs # the downloadable features: core/packs.json, dist-packs/ (needs textarea and convert-gitguy268)
AI=1 npm run e2e # also download the voice organiser and sort notes with the real models
node test/e2e/memory.mjs # memory with six busy sites open
npm run site:dev # website at http://localhost:4321/xiao/
node test/e2e/site-shots.mjs # the built website in Zen, desktop and phone, light and darknpm run e2e installs the kit into a temporary home folder, starts Xiao through its launcher and drives it over Marionette. Its Tor uses port 9170, so it can run while your own Xiao is open. Set ZEN=/path/to/zen to pick a Zen, and E2E_TOR=0 to skip Tor. CI runs it on macOS, Linux and Windows against Zen 1.23.3b.
Xiao is free software under the Mozilla Public License 2.0, built on Zen Browser and Firefox. The website follows Zen's website. Blocking is Ghostery's engine; Xiao Search is SearXNG. Settings draw on Mullvad Browser, Tor Browser, Waterfox, arkenfox, Betterfox and rapidfox. The typefaces are Bricolage Grotesque and Junicode. NOTICE has the details.
Xiao is not affiliated with or endorsed by Zen, Mozilla, Mullvad, the Tor Project, Ghostery, SearXNG or The Browser Company.
Contributing · Design · Security · Code of Conduct · Changelog