Turn Omarchy into a one-bit Macintosh-inspired workbench with one command.
One-Bit Bureau adds a real file desktop, a bottom dock, a shared Inspector, a window overview, original bitmap icons, retro fonts, and a matching black-and-white theme—without replacing Omarchy or Hyprland.
Install · What you get · Everyday use · Wiki
One-Bit Bureau is built for a current Omarchy Quattro installation. Its release is immutable on GitHub: the command below downloads the release record and archive, requires the immutability flag, checks the archive against GitHub's published SHA-256 digest, and only then runs the bundled installer.
bash <<'ONE_BIT_BUREAU_INSTALL'
set -Eeuo pipefail
release_tag="v1.2.4"
release_asset="one-bit-bureau-${release_tag}.tar.gz"
release_dir=$(mktemp -d)
trap 'rm -rf -- "$release_dir"' EXIT
curl --proto '=https' --proto-redir '=https' --tlsv1.2 --fail --location --silent --show-error --retry 3 --max-time 30 --max-filesize 1048576 \
-H 'Accept: application/vnd.github+json' \
-H 'X-GitHub-Api-Version: 2026-03-10' \
"https://api.github.com/repos/RegionallyFamous/one-bit-bureau/releases/tags/$release_tag" \
--output "$release_dir/release.json"
jq -e --arg tag "$release_tag" '.immutable == true and .tag_name == $tag' "$release_dir/release.json" >/dev/null
release_url=$(jq -er --arg name "$release_asset" '.assets[] | select(.name == $name) | .browser_download_url' "$release_dir/release.json")
release_sha256=$(jq -er --arg name "$release_asset" '.assets[] | select(.name == $name) | .digest | select(startswith("sha256:")) | ltrimstr("sha256:")' "$release_dir/release.json")
[[ $release_sha256 =~ ^[a-f0-9]{64}$ ]]
curl --proto '=https' --proto-redir '=https' --tlsv1.2 --fail --location --silent --show-error --retry 3 --max-time 300 --max-filesize 268435456 \
"$release_url" --output "$release_dir/$release_asset"
actual_sha256=$(sha256sum "$release_dir/$release_asset" | awk '{print $1}')
[[ $actual_sha256 == "$release_sha256" ]]
mkdir "$release_dir/payload"
tar --no-same-owner --no-same-permissions -xzf "$release_dir/$release_asset" -C "$release_dir/payload"
bash "$release_dir/payload/one-bit-bureau-$release_tag/install"
ONE_BIT_BUREAU_INSTALLThe verified installer stages the exact tagged Git commit, validates it with Omarchy, then adds and activates the plugin, theme, fonts, and One-Bit Bureau branding together. If setup fails, its ownership record drives rollback of every completed step. It keeps Omarchy's shell, tiling, launcher, controls, notifications, Quick Look, and normal Super navigation.
If you already use another desktop-icons, dock, overview, or active-window plugin, disable it first so the two interfaces do not overlap. See Installation and Trust before installing if you want the full compatibility and security details.
- A real desktop. Open, select, rename, arrange, preview, move, copy, Trash, and undo changes to files in your configured Desktop folder.
- Trash and connected drives. Their actual state and available actions appear on the desktop. If your XDG Desktop is disabled, One-Bit Bureau tells you instead of silently creating a new folder.
- A Macintosh-inspired dock. Launch apps, switch between their windows, pin favorites, reorder icons, preview windows, and turn on auto-hide.
- One shared Inspector. Use the same Get Info surface for desktop objects, applications, and windows.
- A searchable window overview. Find windows, switch workspaces, and move the selected window to another ordinary workspace on the same monitor.
- A complete one-bit look. Two original wallpapers, matching shell surfaces, notifications, terminal colors, unlock art, branding, and 32 original app icons.
- Useful icon fallbacks. Apps without a custom One-Bit icon keep a recognizable grayscale native icon; unresolved apps get the bundled Application mark instead of a blank square.
- Two bundled fonts. Choose practical Monaspace Krypton NF or the sharper Departure Mono.
- A reversible install. Removal restores the settings and branding One-Bit Bureau replaced while leaving your Desktop files and personal dock, icon, and layout choices alone.
 A calm, useful desktop—not a staged pile of junk files |
|
 Get Info in the shared Inspector |
 Clear file-operation results with Undo when available |
 Every open window for an app in one place |
 Search, switch, and move windows between workspaces |
| Action | Result |
|---|---|
| Single-click | Select a desktop object |
| Control-click or Shift-click | Add objects to the selection |
| Double-click or Return | Open the selected item |
| Space | Open the selected file in Quick Look |
| F2 | Rename one selected item |
| Control+I | Open Get Info in the Inspector |
| Control+A | Select every item on the desktop |
| Drag selected files onto a folder | Move them and show a result receipt |
| Open Desk in the top bar | Create a folder, arrange, tidy, select all, or undo the latest layout change |
| Move the pointer to the top-left corner | Open the searchable window overview |
The Everyday Use guide covers all keyboard controls, dock behavior, window management, and customization.
one-bit-bureau icon pack list
one-bit-bureau font list
one-bit-bureau font use krypton
one-bit-bureau motion reduce
one-bit-bureau motion full
one-bit-bureau overview
one-bit-bureau doctorThe dock's Manage Icons screen can use an automatic One-Bit match, another bundled role, the grayscale native icon, the original color icon, or your own local image. See Icons and App Associations.
one-bit-bureau app-chrome preview
one-bit-bureau app-chrome on
one-bit-bureau app-chrome offThe preview command explains the change without applying it. Opting in themes GTK3 apps at the user level. It does not alter GTK4/libadwaita apps, Qt apps, browser chrome, LibreOffice profiles, system packages, or /etc.
one-bit-bureau update
one-bit-bureau removeOne-Bit Bureau is MIT licensed. Font and imported-code notices are in THIRD_PARTY_NOTICES.md.