ASAHI-BTSYNC(1)

🎀 NAME 🎀

okay bestie, meet asahi-btsync — she lists the bluetooth pairing keys that macOS set up on Apple Silicon Macs, and then syncs them over to a local configuration for bluez. it's giving "your AirPods remember you, and now Linux does too" 💖

the manual name for this one is ASAHI-BTSYNC(1), if you're keeping receipts.

✨ SYNOPSIS ✨

asahi-btsync [OPTIONS] [SUBCOMMAND]

that's it. that's the whole vibe check. 🦋

💅 OPTIONS 💅

• -d, --device <DEVICE> — the path to the nvram device. that's the little spot where all the juicy stuff lives. 🍓
• -h, --help — prints help information. she's helpful like that, no cap. 🫶
• -V, --version — prints version information. in case you gotta know which queen you're talking to. 👑

🌸 SUBCOMMANDS 🌸

• dump — dumps the binary bluetooth device info straight out of nvram. raw, unfiltered, main character energy. 💀
• help — prints the top-level help, or the help of whatever subcommand(s) you hand her. bestie will literally explain herself. 😭
• list — parses the shared bluetooth keys from nvram. the receipts, but for pairing. 🎀
• sync — syncs the bluetooth device information from nvram into a bluez configuration. default path is /var/lib/bluetooth. and listen, she accepts the option -c, --config <PATH> so you can point her at non-default configuration paths too. flexible icon behavior, fr fr. ✨

lowkey important: the default config path is /var/lib/bluetooth, so if your bluez setup lives somewhere else, that's your cue to use -c, --config <PATH>. 🙈

and that's the whole page, bestie — asahi-btsync, April 2025, slayed and archived. go sync those keys, periodt. 💜🌈