README.md

gnome-shell-extension-mumble-ping

---

Gnome Shell Extension to see how many people are online on your mumble server of choice.

📝 Table of Contents

• gnome-shell-extension-mumble-ping
  • 📝 Table of Contents
  • 🧐 About
  • 🏁 Getting Started
  • 🔧 Testing the extension
  • 🎈 Usage
  • 🎉 Acknowledgements
  • Licensing

🧐 About

This extensions adds an indicator to your gnome shell to see how many users are currently online on a specified mumble server. This should work for all servers that have the allowping setting set to true in their configuration (which is the default). You can configure which server/port to ping and how often this should be done.

🏁 Getting Started

Prerequisites

This extension requires one of the following Gnome Shell versions:

• 3.38
• 40
• 41
• 42
• 43
• 44
• 45
• 46

Installation

It's recommended to install this extension through extensions.gnome.org. You can visit this extensions install page using the button below.

Installation from source

git clone https://github.com/maweil/gnome-shell-extension-mumble-ping.git
cd gnome-shell-extension-mumble-ping
./scripts/deploy.sh

After performing these steps, it is necessary to restart your GNOME Shell (or log out and log in again).

You can then enable the extension using either GNOME's Extension app or using the following command:

gnome-extensions enable [email protected] 

🔧 Testing the extension

If you want to try out this extension without reloading your GNOME Shell, you can try it in a nested session. First, make sure the latest version is installed and enabled if you have done some changes:

./scripts/deploy.sh
gnome-extensions enable [email protected]

Then start a nested gnome shell session:

Using Wayland

# Start a nested gnome shell
dbus-run-session -- gnome-shell --nested --wayland

🎈 Usage

By default, this extension tries to ping a mumble server on your local machine and the default port. You can change this in the extension settings (see screenshot below).

🎉 Acknowledgements

• A big thanks to the Papirus Development Team for designing the Mumble icon that was used (with small modifications) for this extension

Licensing

This project is licensed under the terms specified in LICENSE.

The folder icons contains versions of the mumble icon originally designed by PapirusDevelopmentTeam under the terms of the GPLv3. For the use in this extension, colors and size of the icon was modified.