#cli #linux #tool #live #cli-tool #control

app earbuds

Control your galaxy buds live via cli

7 releases

new 0.1.7 Nov 22, 2020
0.1.6 Oct 22, 2020

#858 in Command line utilities

48 downloads per month

GPL-3.0 license

77KB
2K SLoC

PRs ci/cd crates earbuds earbuds-git

LiveBudsCli

A cli tool to control your Galaxy buds live

Features

  • Equalizer, touchpad-lock and anc control
  • Buds status (battery, anc, current equalizer setting, ...)
  • Auto music play/pause on bud remove (via mpris)
  • Desktop notification for low battery
  • Connect/Disconnect your earbuds easily with a subcommand
  • Multiple device support
  • Individual device configs
  • Automatic sink switch (pulseaudio) [feature: pulse-sink, used by default]
  • Bash completion (for every shell)
  • Change touchpad tap action
  • Change config options from cli
  • Json output for scripts (via jq)

Install

Pacman repo

You can get it precompiled from my pacman repository

AUR

yay -S earbuds

Compilation

Run following command:

cargo install earbuds

Polybar

Polybar
You can display the status of your buds live in your polybar with this script
To achieve this, you have to add following to your polybar config and move the script into your polybar script folder. Don't forget to add buds to the modules section.

[module/buds]
type = custom/script
interval = 8
label = %output%
exec = ~/.config/polybar/scripts/polybar.sh
click-middle = earbuds toggle anc
click-right = earbuds toggle touchpadlock

Usage

To get most of the features listed above, you need to have a daemon instance running (earbuds -d). If you run one of the commands listed below, the daemon automatically gets started.

Status informations:

earbuds status

Set equalizer to Bass boost

earbuds set equalizer bass

Toggle noise reduction or the touchpad lock

earbuds toggle anc/touchpad

Get Status in json format

earbuds status -o json

Set the left touchpad tap command to spotify

earbuds set tap-action spotify left

Connect/Disconnect:

earbuds connect/disconnect

To debug the daemon run:

earbuds -k -d --no-fork

This kills the currently running daemon, creates a new one and starts it in the foreground.

Dependencies

~7–9.5MB
~182K SLoC