Skip to content

Latest commit

 

History

History
105 lines (78 loc) · 3.48 KB

README.md

File metadata and controls

105 lines (78 loc) · 3.48 KB
Raw

Wingpanel AirPods icon

Wingpanel AirPods

About

Wingpanel AirPods is a status indicator that displays Apple's AirPods status information in elementary OS Wingpanel.

Being this one of my first Vala applications I'm sure that the code can be improved, so:

  • If you find any problems while running the application please report it through an issue.
  • Pull requests and translations are welcome.
  • Feedback and suggestions are always welcome as well.

Features:

  • Displays AirPods connection status
  • Displays AirPods battery charge percentage in the indicator
  • Displays battery charge status per AirPod and also for the charging case in the popover
  • Notifys the user when the AirPods battery or case is running low
  • Supports media player playback control using AirPods in-ear detection:
    • Stop the audio: remove both AirPods from your ears, or if you’re wearing just one, remove it. If you return one to your ear within 15 seconds, play resumes automatically.
    • Pause the audio: while listening with both AirPods, remove one. When you return it to your ear, playback resumes automatically.
  • Supports battery saver mode to preserve battery life while the system is running on battery (e.g. laptops) *

* In order to preserve system battery life some indicator features (e.g. media player playback control using AirPods in-ear detection) will be disabled and AirPods battery level report may be less accurate

Requirements

  • elementary OS 5.1.7 Hera
  • elementary OS 6.0 Odin
  • Bluetooth 4.0 adapter with BLE support

Screenshots

Indicator

Screenshot Screenshot

Indicator (inc. battery charge percentage):

Screenshot

Popover:

Screenshot Screenshot Screenshot

Popover (inc. battery charge percentage):

Screenshot

Settings:

Screenshot

Building and installation from source

You'll need the following dependencies:

libglib2.0-dev
libnotify-dev
libgranite-dev
libgtk-3-dev
libwingpanel-2.0-dev (Hera)
libwingpanel-dev (Odin)
libhandy-1-dev (Odin)
meson
valac

You can install them in elementary OS Hera running:

sudo apt install libnotify-dev libgranite-dev libgtk-3-dev libwingpanel-2.0-dev meson valac

Or in elementary OS Odin running:

sudo apt install libnotify-dev libgranite-dev libgtk-3-dev libwingpanel-dev libhandy-1-dev meson valac

Run meson to configure the build environment and then ninja to build

meson build --prefix=/usr
cd build
ninja

To install, use ninja install

sudo ninja install
com.github.casasfernando.wingpanel-indicator-airpods

Installation using the deb package

You can also find a deb package available with every release in the releases page. To install it you just need to download the package for your elementary OS release and run:

sudo dpkg -i wingpanel-indicator-airpods_<release>_<hera|odin>_amd64.deb

Special thanks and credits

  • Federico Dossena for developing OpenPods and the beacon data decoding algorithm on which the beacon decoding code of this project is based on.