CLI Reference

CLI Reference

Use --device with a Bluetooth address or device name when more than one compatible device is paired. Add --json to commands that return structured results.

Status and connection

eara --version
eara doctor
eara status
eara --json status
eara connect
eara connect --mic
eara disconnect
eara reset
eara gui

ANC and sound

eara anc transparency
eara anc high
eara anc off
eara eq balanced
eara eq more_bass
eara custom-eq 2 0 1
eara graphic-eq 0 0 0 0 0 0 0 0
eara bass on --level 3
eara bass off

Available modes depend on the detected model. Run eara COMMAND --help for accepted values.

Audio profiles and codecs

eara audio music
eara audio mic
eara audio hfp
eara codec list
eara codec aac

Codec switching succeeds only when the codec is exposed by the local PipeWire/PulseAudio Bluetooth card.

Device features

eara latency on
eara inear on
eara personal-anc on
eara listening normal
eara ring left
eara ring right
eara ring both
eara ring off
eara fit

Gesture mapping

eara gesture left double-pinch skip-forward

Use eara gesture --help to list the gesture types and actions supported by the current CLI version.

Selecting a device

eara --device "Nothing Ear (a)" status
eara --json --device AA:BB:CC:DD:EE:FF status

Do not publish a real full Bluetooth address in screenshots or issue reports.