ActionRing - Linux

Action Ring is a “Quick Action Ring” that opens around the mouse cursor.
It gives you instant access to your favorite apps, saves time and is a pleasure to look at.

✨ Features

• Application ring design
• Quick access with shortcuts
• Customizable structure (icons and apps)
• Written in Python

Note

You can open the settings quickly by pressing the S key while the Action Ring is active.

📦 Requirements

The following packages must be installed for this application to work:

for Debian based:

sudo apt install -y \
  python3 python3-gi python3-gi-cairo \
  gir1.2-gtk-3.0 gir1.2-gtk-4.0 gir1.2-adw-1 \
  libgtk-4-dev libadwaita-1-dev pulseaudio-utils playerctl

for Arch based:

sudo pacman -Syu
sudo pacman -S \
  python python-pip python-gobject \
  gtk3 gtk4 libadwaita pulseaudio playerctl

Note: This version of the application also uses Brave, Webcord and Zapzap via Flatpak. If you want to add different shortcuts or delete existing shortcuts, you can make changes via settings.json.

Or you can install Brave, Zapzap and Webcord via Flathub if you don't have these apps.(Flatpak must be installed)

for Brave:

flatpak install flathub com.brave.Browser

for Webcord:

flatpak install flathub io.github.spacingbat3.webcord

for Zapzap:

flatpak install flathub com.rtosta.zapzap

🚀 Installation

git clone https://github.com/anlyetim/ActionRing.git
cd ActionRing
python3 action_ring.py

Important

This application was only tested on an Arch-based Hyprland desktop. I have no idea how it will work on KDE, Gnome, etc.

Tip

If you want to use this application on Hyprland like me, you can bind the executable in your hyprland.conf file by adding a line like this:

bind = MOD, <key>, exec, /full/path/to/actionring

Save the config and reload Hyprland to apply the changes.

Alternatively, if you'd like to run the executable file actionring, make sure it's marked as executable first:

chmod +x /home/(your_username)/ActionRing/actionring

Here’s the exact keybind I personally use:

bind = SUPER, F2, exec, /home/(your_username)/ActionRing/actionring