https://github.com/nilicule/macbuds
A simple macOS menubar application to control your Bluetooth earbuds. It allows you to quickly connect and disconnect your earbuds directly from the menubar, with visual status indication.
https://github.com/nilicule/macbuds
bluetooth earbuds go golang osx
Last synced: 12 months ago
JSON representation
A simple macOS menubar application to control your Bluetooth earbuds. It allows you to quickly connect and disconnect your earbuds directly from the menubar, with visual status indication.
- Host: GitHub
- URL: https://github.com/nilicule/macbuds
- Owner: nilicule
- License: gpl-3.0
- Created: 2025-01-02T13:20:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-16T09:48:45.000Z (over 1 year ago)
- Last Synced: 2025-02-23T17:54:45.827Z (over 1 year ago)
- Topics: bluetooth, earbuds, go, golang, osx
- Language: Go
- Homepage: https://github.com/nilicule/macbuds
- Size: 29.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MacBuds
A simple macOS menubar application to control your Bluetooth earbuds. It allows you to quickly connect and disconnect your earbuds directly from the menubar, with visual status indication.
## Features
- Lives in your menubar with visual connection status (✓ connected, × disconnected)
- Quick connect/disconnect with one click
- Configurable target device (via MAC address)
- Optional launch at login
- Lightweight and native macOS experience
## Prerequisites
- macOS
- Go 1.16 or later
- [blueutil](https://github.com/toy/blueutil) (can be installed via Homebrew)
## Installation
1. Install blueutil:
```bash
brew install blueutil
```
2. Clone and build the application:
```bash
git clone https://github.com/nilicule/macbuds.git
cd macbuds
go build -o macbuds
```
3. Run the application:
```bash
./macbuds
```
## Configuration
1. Find your earbuds' MAC address:
```bash
blueutil --paired
```
2. Click the menubar icon and select "Configure MAC Address"
3. Enter your device's MAC address in the text editor that opens
4. Save and close the file
## Auto-start Configuration
To have MacBuds start automatically when you log in:
1. Click the menubar icon
2. Toggle "Launch at Login"
## Building from Source
```bash
# Clone the repository
git clone https://github.com/nilicule/macbuds.git
# Navigate to the directory
cd macbuds
# Get dependencies
go mod tidy
# Build the application
./build.sh 1.0.0
```
## License
This project is licensed under the GNU General Public License v3.0 - see [LICENSE](LICENSE) file for details.
GPL-3.0 is a copyleft license that requires anyone who distributes your code or a derivative work to make the source code available under the same terms. This ensures that modifications and larger works based on your code must also be free and open source.