[PR #356] Feature/linux cli #377

New issue

Open

opened 2026-03-02 12:40:55 +03:00 by kerem · 0 comments

kerem commented

2026-03-02 12:40:55 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/kavishdevar/librepods/pull/356
Author: @meerzulee
Created: 12/6/2025
Status: 🔄 Open

Base: main ← Head: feature/linux-cli

📝 Commits (3)

e4c4262 linux: add CLI support for querying status and controlling AirPods
d3b60cc linux: fix crash on tray Open/Settings and add Fusion style fallback
bc25f08 linux: add input validation and fix memory leak in IPC handler

📊 Changes

4 files changed (+496 additions, -45 deletions)

View changed files

📝 linux/CMakeLists.txt (+5 -0)
➕ linux/cli.cpp (+236 -0)
➕ linux/cli.h (+26 -0)
📝 linux/main.cpp (+229 -45)

📄 Description

Linux: Add CLI support and fix Qt theme compatibility

Features

CLI Interface

Query status and control AirPods from the command line while the app is running in the background.

# Status queries
librepods --status              # Show connection status and battery
librepods --status --json       # JSON output
librepods --waybar              # Waybar custom module format

# Control
librepods --set-noise-mode transparency
librepods --set-noise-mode nc   # noise-cancellation
librepods --set-conversational-awareness on
librepods --set-adaptive-level 50

Waybar integration example:

  "custom/airpods": {
      "exec": "librepods --waybar",
      "interval": 10,
      "return-type": "json"
  }

Bug Fixes

Qt Theme Compatibility

Fix crash when clicking "Open" or "Settings" in tray menu on some systems
Add Fusion style fallback for systems with incomplete Qt theme modules (e.g., kvantum without kvantum-qt6)

The app now works on X11, Wayland, KDE, GNOME, and other desktop environments regardless of theme configuration.

Summary by CodeRabbit

New Features
- Added a command-line interface to control LibrePods without opening the GUI.
- Status reporting in text, JSON, and Waybar-compatible formats.
- CLI commands to set noise control mode, conversational awareness, and adaptive noise level.
- Detects and communicates with a running instance to apply commands or show status.
Bug Fixes / Improvements
- More robust startup/instance handling and clearer CLI error/status messages.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/kavishdevar/librepods/pull/356 **Author:** [@meerzulee](https://github.com/meerzulee) **Created:** 12/6/2025 **Status:** 🔄 Open **Base:** `main` ← **Head:** `feature/linux-cli` --- ### 📝 Commits (3) - [`e4c4262`](https://github.com/kavishdevar/librepods/commit/e4c4262cfe6d254fe98cc5324eee9ba6f785c96e) linux: add CLI support for querying status and controlling AirPods - [`d3b60cc`](https://github.com/kavishdevar/librepods/commit/d3b60cc5f1c32e85f600589a90308fe2f07750a0) linux: fix crash on tray Open/Settings and add Fusion style fallback - [`bc25f08`](https://github.com/kavishdevar/librepods/commit/bc25f082b84683800fbfbc391e5942a30f780064) linux: add input validation and fix memory leak in IPC handler ### 📊 Changes **4 files changed** (+496 additions, -45 deletions) <details> <summary>View changed files</summary> 📝 `linux/CMakeLists.txt` (+5 -0) ➕ `linux/cli.cpp` (+236 -0) ➕ `linux/cli.h` (+26 -0) 📝 `linux/main.cpp` (+229 -45) </details> ### 📄 Description ## Linux: Add CLI support and fix Qt theme compatibility ### Features **CLI Interface** Query status and control AirPods from the command line while the app is running in the background. ```bash # Status queries librepods --status # Show connection status and battery librepods --status --json # JSON output librepods --waybar # Waybar custom module format # Control librepods --set-noise-mode transparency librepods --set-noise-mode nc # noise-cancellation librepods --set-conversational-awareness on librepods --set-adaptive-level 50 ``` Waybar integration example: ```json "custom/airpods": { "exec": "librepods --waybar", "interval": 10, "return-type": "json" } ``` Bug Fixes Qt Theme Compatibility - Fix crash when clicking "Open" or "Settings" in tray menu on some systems - Add Fusion style fallback for systems with incomplete Qt theme modules (e.g., kvantum without kvantum-qt6) The app now works on X11, Wayland, KDE, GNOME, and other desktop environments regardless of theme configuration.  ## Summary by CodeRabbit * **New Features** * Added a command-line interface to control LibrePods without opening the GUI. * Status reporting in text, JSON, and Waybar-compatible formats. * CLI commands to set noise control mode, conversational awareness, and adaptive noise level. * Detects and communicates with a running instance to apply commands or show status. * **Bug Fixes / Improvements** * More robust startup/instance handling and clearer CLI error/status messages. <sub>✏️ Tip: You can customize this high-level summary in your review settings.</sub>  --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>