Omarchpods

November 10, 2025 ยท View on GitHub

It's early in development, so there may be some bugs, feel free to report them by creating an issue. Ideas are also welcome.

Preview

Omarchpods

Note: This project is new and has only been tested with the my AirPods. While the supported devices list below is inherited from MagicPodsCore, not all devices have been verified to work with this fork. PRs for testing and fixing specific devices are welcome!

A fork of MagicPodsCore with a TUI, designed for Omarchy.

Install

git clone git@github.com:tomycostantino/omarchpods.git && \
cd omarchpods && \
bash install.sh

Heads up

It will take a little bit of time to compile the C++ code, so please be patient during this step.

The UI can be launched with:

omarchy-launch-omarchpods

Optional Configuration

Waybar Integration

To add Omarchpods to your waybar, add a custom module to your waybar config (~/.config/waybar/config):

At the top of the file add "custom/omarchpods" to the module you'd like the icon:

  "modules-left": [...],
  "modules-center": [...],
  "modules-right": [
    ...,
    "custom/omarchpods"
  ],

Then all the way to the bottom go:

"custom/omarchpods": {
    "format": " ๐ŸŽง ",
    "on-click": "omarchy-launch-omarchpods",
    "tooltip": false
}

Keyboard Binding (Hyprland)

To add a keyboard shortcut to open Omarchpods UI with SUPER + SHIFT + H (or any other you'd like), add this to your Hyprland config (~/.config/hypr/hyprland.conf):

bind = SUPER SHIFT, H, exec, omarchy-launch-omarchpods

๐ŸŽง Headphones supported

AppleBeatsSamsung
AirPods 1PowerBeats ProGalaxy Buds
AirPods 2PowerBeats Pro 2Galaxy Buds Plus
AirPods 3PowerBeats 3Galaxy Buds Live
AirPods 4PowerBeats 4Galaxy Buds Pro
AirPods 4 (ANC)Beats Fit ProGalaxy Buds 2
AirPods ProBeats Studio BudsGalaxy Buds 2 Pro
AirPods Pro 2Beats Studio Buds PlusGalaxy Buds Fe
AirPods Pro 3Beats Studio ProGalaxy Buds 3
AirPods MaxBeats Solo 3Galaxy Buds 3 Pro
AirPods Max 2024Beats Solo Pro
Beats Studio 3
Beats X
Beats Flex
Beats Solo Buds

Original MagicPodsCore developed by Aleksandr Maslov and Andrey Litvintsev

Fork developed by Tomas Costantino