Contributing

Contributing

Contributions can be device test results, bug reports, documentation, translations, or code.

Report a bug

Use the bug report template and include:

• EarA version
• Linux distribution and desktop/session
• exact earbuds model
• steps, expected result, and actual result
• output from eara doctor
• eara --json status when relevant

Redact private identifiers before posting.

Report device compatibility

Use the device support template. Confirm battery, ANC, EQ, bass, gestures, find-my, fit test, A2DP, and HFP individually when possible.

Submit code

1. Fork the repository and create a focused branch.
2. Match the existing style in eara/.
3. Add or update tests.
4. If adding translations, keep the English and Ukrainian key sets in sync.
5. Run:

python3 -m unittest discover -s tests -v
python3 -m compileall -q eara tests

6. Open a pull request describing the change and hardware testing.

Contributions are licensed under GPL-3.0-or-later. EarA is an unofficial community project and is not affiliated with Nothing Technology or CMF.

See CONTRIBUTING.md for the repository policy.