blueutil
brew install blueutil
v2.13.0
MIT
Get/set bluetooth power and discoverable state
1.4k
30-day installs · #1127
4.3k
90-day · #1178
18.4k
365-day · #1106
1.3k
★ GitHub stars · updated 10mo ago
GitHub topics
bluetooth
blueutil
macos
objective-c
osx
Links
- https://github.com/toy/blueutil
- GitHub: toy/blueutil
- Brew formula source: Formula/b/blueutil.rb
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [],
"categories": [],
"caveats": null,
"conflicts_with": [],
"dependencies": [],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Get/set bluetooth power and discoverable state",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:35:55+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "blueutil",
"github_default_branch": "main",
"github_last_commit_at": "2025-10-12T15:27:05Z",
"github_readme_excerpt": "# blueutil\n\nCLI for bluetooth on OSX: power, discoverable state, list, inquire devices, connect, info, \u2026\n\n## Notes\n\nUses private API from IOBluetooth framework (i.e. `IOBluetoothPreference*()`).\n\nOpening Bluetooth preference pane always turns on discoverability if bluetooth power is on or if it is switched on when preference pane is open, this change of state is not reported by the function used by `blueutil`.\n\n## Alternative Method\n\nBy default, `blueutil` uses IOBluetooth framework APIs to query paired devices. As an alternative, you can set the `BLUEUTIL_USE_SYSTEM_PROFILER=1` environment variable to use the `system_profiler` command instead.\n\nThe system_profiler method resolves an issue where some multi-point Bluetooth devices (devices that can connect to multiple devices simultaneously) may not report their connection status correctly through the IOBluetooth APIs, but do show the correct status via system_profiler.\n\n**Note:** The system_profiler method is experimental and may have compatibility issues with some blueutil commands.\n\n## Usage\n\n\u003c!--USAGE[--\u003e\n```\nUsage:\n blueutil [options]\n\nWithout options outputs current state\n\n -p, --power output power state as 1 or 0\n -p, --power STATE set power state\n -d, --discoverable output discoverable state as 1 or 0\n -d, --discoverable STATE set discoverable state\n\n --favourites, --favorites\n list favourite devices; returns empty list starting with macOS 12/Monterey\n --inquiry [T] inquiry devices in range, 10 seconds duration by default excluding time for name updates\n --paired list paired devices\n --recent [N] list recently used devices, 10 by default, 0 to list all; returns empty list starting with macOS 12/Monterey\n --connected list connected devices\n\n --info ID show information about device\n --is-connected ID connected state of device as 1 or 0\n ",
"github_repo": "toy/blueutil",
"github_stars": 1258,
"github_topics": [
"bluetooth",
"blueutil",
"macos",
"objective-c",
"osx"
],
"homepage": "https://github.com/toy/blueutil",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 1444,
"installs_365d": 18433,
"installs_90d": 4270,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": null,
"llm_model": null,
"name": "blueutil",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 1127,
"rank_365d": 1106,
"rank_90d": 1178,
"raw_hash": "842364ab08be377d",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/b/blueutil.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "2.13.0",
"versioned_formulae": [],
"why_use_this": null
}