Skip to content

maniacx/BudsLink

Repository files navigation

BudsLink (GJS Script / Flatpak)

Screenshot

BudsLink is a standalone GJS-based application that provides battery monitoring and feature control for supported Bluetooth earbuds. It can be used either as a plain GJS script or as a prebuilt Flatpak package compiled using Github Actions and distributed via GitHub Releases.


Features

  • Displays the battery level of the headset
  • Displays individual battery levels for earbuds (left, right, and charging case), if supported
  • Controls Active Noise Cancellation (ANC) and related listening modes, if supported
  • Supports additional device-specific features where available
  • Can be installed and run as a Flatpak app, or launched directly as a GJS script
  • Supports overriding the system default accent color and dark mode settings

Supported Devices

  • AirPods
  • Beats
  • Sony earbuds and headphones

Installation & Usage

BudsLink can be used in two different ways, depending on whether you want a ready-to-use application or a developer/debug-friendly script.

Flatpak App (Recommended)

The Flatpak version is a fully packaged, sandboxed application built automatically via GitHub Actions and distributed through GitHub Releases.

  • No manual dependency management
  • Works consistently across distributions
  • Best choice for end users

➡️ Install and run using Flatpak


GJS Script

The GJS script runs BudsLink directly on your system without sandboxing.

  • Intended for developers and advanced users
  • Easier debugging and logging
  • Requires system dependencies to be installed manually

➡️ Run as a GJS script

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages