https://github.com/qzed/pbpctrl
Control Google Pixel Buds Pro from the Linux command line.
https://github.com/qzed/pbpctrl
cli linux pixel-buds-pro rust
Last synced: 12 months ago
JSON representation
Control Google Pixel Buds Pro from the Linux command line.
- Host: GitHub
- URL: https://github.com/qzed/pbpctrl
- Owner: qzed
- License: apache-2.0
- Created: 2022-12-11T02:50:31.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-28T23:14:52.000Z (over 1 year ago)
- Last Synced: 2025-03-31T06:01:33.385Z (about 1 year ago)
- Topics: cli, linux, pixel-buds-pro, rust
- Language: Rust
- Homepage:
- Size: 401 KB
- Stars: 98
- Watchers: 5
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# `pbpctrl`
Control Google Pixel Buds Pro from the Linux command line. Might or might not work on other Pixel Buds devices.
Allows reading of battery, hardware, software, and runtime information as well as reading and changing settings (ANC state, equalizer, ...).
## Installation
### Arch Linux
A [`pbpctrl`](https://aur.archlinux.org/packages/pbpctrl) package is provided via the AUR.
Alternatively, the [`pbpctrl-git`](https://aur.archlinux.org/packages/pbpctrl-git) package can be used to directly build from the latest state on the `main` branch.
### Installation via `cargo`
You will need to install the following dependencies:
- Ubuntu: `libdbus-1-dev pkg-config protobuf-compiler`
- Arch Linux: Please refer to the dependencies (`depends` and `makedepends` fields) in [this PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=pbpctrl).
To build install the binary via cargo, run
```sh
cargo install pbpctrl --git https://github.com/qzed/pbpctrl/
```
Use the `--tag` option if you want to install a specific tag instead of the latest `main` branch.
## Instructions
Pair and connect your Pixel Buds Pro before use.
Run `pbpctrl help` for more information.
## Notes on Battery Information
The Pixel Buds Pro support basic battery information via the AVCPR standard.
Support for this is still experimental in BlueZ and needs to be enabled manually by editing `/etc/bluetooth/main.conf` and setting
```
[General]
Experimental = true
```
or by starting BlueZ with the `--experimental` flag.
After this, battery status should be provided via UPower.
Note that this, however, will only provide a single battery meter for both buds combined, and none for the case.
For more detailed information, use `pbpctrl show battery`.
This also allows reading of the case battery as long as one bud is placed in the case (note that the case does not have a Bluetooth receiver itself).
## License
Licensed under either of
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or https://www.apache.org/licenses/LICENSE-2.0)
- MIT License ([LICENSE-MIT](LICENSE-MIT) or https://opensource.org/licenses/MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.