KillerBOSS2019 / SoundcoreDesktop

a way to communicate with Anker Soundcore Life headphones

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SoundcoreLifeAPI

Disclaimer

This is an unofficial API for the Anker SoundCore Life Headphones. I am not partnered with Soundcore or Anker in any way.

Supported Devices

The Anker Soundcore Life Q30 is the only device I currently own, making me only able to test this one. However, other devices such as the Q35 should still work properly despite this. If not, feel free to report an Issue or send a Pull Request.

Requirements

  • Python 3 (both the API and the application)
  • Tkinter (just the application)

The application has been confirmed to work at least under Windows and Linux (Xorg/X11 only). MacOS should also work.

The Soundcore Life API

This API allows you to control your device's :

  • Equalization Settings (Only Premade Equalizers are currently supported.)
  • Noise Cancellation Mode : Active Noise Cancellation (Transport, Indoor and Outdoor), Transparency and Normal.

Usage

python AnkerSoundcoreAPI.py -EQPresets "SoundCore Signature" 00:00:00:00:00:00

python AnkerSoundcoreAPI.py -AmbientSound "Transparency" 00:00:00:00:00:00

Available EQPresets and AmbientSound settings :

EQPresets AmbientSound
SoundCore Signature Transparency
Acoustic Normal
Base Booster ANC
Base Reducer Transport
Classical Indoor
Podcast Outdoor
Dance
Deep
Electronic
Flat
Hip-Hop
Jazz
Latin
Lounge
Piano
Pop
R&B
Rock
Small Speaker(s)
Spoken Word
Treble Booster
Treble Reducer

The SoundcoreDesktop Application

An example SoundcoreDesktop application is also bundled with the standalone API in the SoundcoreDesktop folder.

image image image

Installation

  • Download latest build (.zip Windows only currently) https://github.com/KillerBOSS2019/SoundcoreLifeAPI/releases
  • After downloading the zip file it requires you to unzip it
  • Then make sure that your headphone have connected to the mobile app before otherwise the desktop app wont work. After connecting headphone to mobile app and disconnect it.
  • Make sure you mobile device is disconnected from the headphone and then RUN the SoundcoreDesktop.exe in the SoundcoreDesktop folder
  • If you have any issues feel free make a issue on github!

Note that if the Soundcore Mobile Application is running and connected to your headphone, then the Desktop Application will NOT Work. The Soundcore Devices can only support one application controlling it at a time. Exiting out of the Mobile Application should solve the issue.

The images inside of the GUI come from the official Soundcore App for Android. They are copyrighted by Soundcore, and I do not recommend using them in your own projects.

Bug Reports / Contributions / Suggestions

You can report bugs or suggest features for both the API and the application by making an Issue, or you can contribute to the project by forking it and then sending a Pull Request. Any help will be very much appreciated. Thank you !

About

a way to communicate with Anker Soundcore Life headphones

License:GNU General Public License v3.0


Languages

Language:Python 100.0%