# Install blueutil with Homebrew, MacPorts, Nix Get/set bluetooth power and discoverable state. Version 2.13.0 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:blueutil ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install blueutil ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install blueutil ``` Evidence: MacPorts ports tree: sysutils/blueutil/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#blueutil ``` Evidence: nixpkgs package indexes: pkgs/by-name/bl/blueutil/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:blueutil - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.13.0 - **Source summary:** Get/set bluetooth power and discoverable state - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - blueutil (cli) - blueutil (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.13.0 - Local data: ok - Upstream repository: https://github.com/toy/blueutil - Upstream latest detected: v2.13.0 (current) - info: No package-manager update timestamp was available. ## Project history and usage blueutil is a long-running macOS command-line utility for reading and changing Bluetooth state: power, discoverability, paired and connected devices, device info, pairing, connection, and output formats for scripts. ### Project history blueutil was originally written by Frederik Seiffert and later maintained by Ivan Kuchin, as recorded in the README copyright section. The GitHub repository dates back to 2011, with v1.0.0 tagged in 2012 and a continuing v2.x release line. The tool grew from simple power and discoverability controls into a broader Bluetooth scripting interface. The README documents private IOBluetooth framework use, root-user safeguards, JSON output formats, device connection operations, wait commands, and an experimental system_profiler fallback for some paired-device queries. ### Adoption history blueutil became the standard package-manager answer for 'control Bluetooth from a shell on macOS.' Its README documents Homebrew and MacPorts installs, and the input metadata also records a Nix package, reflecting adoption by both casual Mac users and reproducible-environment users. Its role persisted because macOS does not expose all of these Bluetooth controls through a stable, script-friendly built-in CLI, so package managers filled the gap with a small native utility. ### How it is used Users run blueutil with flags such as --power, --discoverable, --paired, --connected, --info, --connect, --disconnect, --pair, and --unpair. Output can be human-readable or JSON, making it useful in shell scripts, status bars, automation tools, and troubleshooting flows. The README warns that it uses private IOBluetooth preference APIs and documents macOS-version quirks such as favorite/recent-device behavior starting with macOS 12 Monterey. ### Why package nerds care blueutil is the classic tiny Mac systems package: one binary that unlocks automation around a GUI-controlled OS feature. Package nerds care because it has survived macOS Bluetooth API changes, packaging across Homebrew/MacPorts/Nix, architecture transitions, and years of shell-script dependence. It also illustrates the maintenance burden of packaging native Mac utilities: private frameworks, root behavior, TCC/API access failures, output formats for scripts, and compatibility notes all live in a very small command-line surface. ### Timeline - 2011: GitHub repository created for blueutil. - 2012: v1.0.0 tag published. - 2018: v2.0.0 tag published. - 2021: README documents macOS 12 Monterey behavior changes for favorite and recent devices. - 2025: v2.13.0 tag and README copyright show continued maintenance. ### Related projects - blueutil-tui is documented by the README as a text user interface built on top of blueutil. - Homebrew, MacPorts, and Nix are package-manager channels recorded for installation. - macOS IOBluetooth and system_profiler are the platform interfaces used or offered as alternatives. ### Sources - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** blueutil - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** macos, xcode - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - blueutil: normalized package name match | nixpkgs package indexes: pkgs/by-name/bl/blueutil/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - blueutil: normalized package name match | MacPorts ports tree: sysutils/blueutil/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [bluetoothconnector](https://www.automicvault.com/pkg/brew/bluetoothconnector/) - Shares av.db curated category or tags: bluetooth, cli, macos, system. - [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, macos, system. - [bluez](https://www.automicvault.com/pkg/brew/bluez/) - Shares av.db curated category or tags: bluetooth, cli, system. - [brightness](https://www.automicvault.com/pkg/brew/brightness/) - Shares av.db curated category or tags: cli, macos, system. - [cliclick](https://www.automicvault.com/pkg/brew/cliclick/) - Shares av.db curated category or tags: cli, macos, system. - [dark-mode](https://www.automicvault.com/pkg/brew/dark-mode/) - Shares av.db curated category or tags: cli, macos, system. - [ddcctl](https://www.automicvault.com/pkg/brew/ddcctl/) - Shares av.db curated category or tags: cli, macos, system. - [defaultbrowser](https://www.automicvault.com/pkg/brew/defaultbrowser/) - Shares av.db curated category or tags: cli, macos, system. - [screenresolution](https://www.automicvault.com/pkg/brew/screenresolution/) - Local package facts share a topical domain. Shared terms: cli, get, macos, set, system. - [infat](https://www.automicvault.com/pkg/brew/infat/) - Local package facts share a topical domain. Shared terms: cli, macos, set, system. ## Combined YAML source View the package source record on GitHub. [combined/blueutil.yml](https://github.com/automic-vault/db/blob/main/combined/blueutil.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph