Skip to content

Android app that shows if the headset is plugged in

License

Notifications You must be signed in to change notification settings

cweiske/headphoneindicator

Repository files navigation

Headphone indicator

Android app that shows a notification icon in the status bar when headphones are plugged into the phone.

Shows a different icon when a headset is attached. Both 3.5mm audio jack devices and USB headphones/headsets are supported.

The app aims to be a tiny as possible.

Runs on Android 4.4+.

Usage

After installation, you have to start the application at least once. Then it will be running as a background service that shows the headset status icon whenever the headphones are plugged in.

You can close the app, and the status icon will still work - even after rebooting your phone.

Why was it written?

I wrote the headphone indicator app because I was immensely unsatisfied with apps like susomena's Headphones Indicator which are over 2 MiB in size, but 99% of their code is only related to advertisement.

My task was to show that you can make it much, much better.

Installation

You have several installation options:

  1. Install from F-Droid
  2. Pay on Google Play
  3. Download .apk from Github
  4. Build it yourself

Building

$ ./gradlew build

Releasing

Modify the version in AndroidManifest.xml`.

Disable resource file optimization in gradle.properties:

android.enableResourceOptimizations=false

Build it normally, then sign the generated package file:

$ gradle assembleRelease

To sign the release with your key, put the path to the signing configuration file into gradle.properties:

signingconfigfile=/path/to/signing-config.gradle

The signing configuration file should look like shown in Handling signing configs with Gradle

Dependencies

  • gradle 8.5.2 (earlier will probably work, too)
  • Android SDK 34 (compiles for SDK 19 - Android 4.4)

Meta data

The code repository contains the meta data needed for the Google Play store: Text, icons, screenshots.

They follow the Triple-T gradle publisher, which are also ingested by F-Droid.

The meta data directory is src/main/play/ - with main even though this app has no flavors, but it's required by f-droid.

About headphone indicator

Source code

Headphone indicators's source code is available from http://git.cweiske.de/headphoneindicator.git or the mirror on github.

License

Headphone indicator is licensed under the GPL v3 or later.

Author

Headphone indicator was written by Christian Weiske.