HyprPanel

https://hyprpanel.com/
Admin
HyprPanel is a customizable panel/bar for Hyprland that provides system widgets and context menus...
Tokens:10,806
Snippets:169
Trust Score:6
Update:6 months ago
Show doc for...
Tokens:
Raw
### Start HyprPanel Command

Source: https://hyprpanel.com/help/faq.html

Run this command in your terminal to start HyprPanel after installation.

```bash
hyprpanel
```

--------------------------------

### Install HyprPanel from Source

Source: https://hyprpanel.com/getting_started/astal.html

Follow these steps to clone the repository, install Node.js dependencies, and build HyprPanel using Meson.

```bash
git clone https://github.com/Jas-SinghFSU/HyprPanel.git
cd HyprPanel
npm i
meson setup build
Meson compile -C build
Meson install -C build
```

--------------------------------

### Install All Arch Dependencies

Source: https://hyprpanel.com/getting_started/installation.html

Command to install all required and optional dependencies on Arch Linux.

```bash
yay -S --needed aylurs-gtk-shell-git wireplumber libgtop bluez bluez-utils btop networkmanager dart-sass wl-clipboard brightnessctl swww python upower pacman-contrib power-profiles-daemon gvfs gtksourceview3 libsoup3 grimblast-git wf-recorder-git hyprpicker matugen-bin python-gpustat hyprsunset-git
```

--------------------------------

### Install NerdFonts

Source: https://hyprpanel.com/getting_started/installation.html

Run the provided script to install required icon fonts.

```sh
# Installs the JetBrainsMono NerdFonts used for icons
./scripts/install_fonts.sh
```

--------------------------------

### Build and Install HyprPanel from Source

Source: https://hyprpanel.com/getting_started/installation.html

Clone the repository and build the project using Meson.

```bash
git clone https://github.com/Jas-SinghFSU/HyprPanel.git
cd HyprPanel
npm i
meson setup build
meson compile -C build
meson install -C build
```

--------------------------------

### Example hyprctl Clients Output

Source: https://hyprpanel.com/configuration/notifications.html

This is an example output from the 'hyprctl clients' command, showing the 'CLASS' column which should be used for the 'Ignored Applications' setting.

```bash
CLASS                     INITIAL TITLE         MONITOR
------------------------- -------------------- ------- 
Spotify                   Premium              2      
kitty                     -                    -      
discord                   Discord              2      
kitty                     -                    -      
zen-alpha                 Zen                  1
```

--------------------------------

### Volume Module Configuration Example

Source: https://hyprpanel.com/configuration/custom_modules.html

Example configuration for a custom volume module. It uses percentage-based icons, custom labels and tooltips, and defines actions for left-click and scrolling.

```json
{
    "custom/volume": {
        "icon": ["󰕿", "󰖀", "󰕾"],
        "label": "{percentage}%",
        "tooltip": "Current Volume: {percentage}%",
        "truncationSize": -1,
        "execute": "pactl get-sink-volume @DEFAULT_SINK@ | awk '{print $5}' | sed 's/[^0-9]*//g' | xargs -I{} echo '{\"percentage\": {}}'",
        "executeOnAction": "",
        "interval": 1000,
        "hideOnEmpty": true,
        "scrollThreshold": 1,
        "actions": {
            "onLeftClick": "menu:audio",
            "onRightClick": "",
            "onMiddleClick": "",
            "onScrollUp": "hyprpanel vol +5",
            "onScrollDown": "hyprpanel vol -5"
        }
    }
}
```

--------------------------------

### Install Fedora Dependencies

Source: https://hyprpanel.com/getting_started/installation.html

Install core system dependencies via DNF on Fedora.

```sh
sudo dnf install wireplumber upower libgtop2 bluez bluez-tools grimblast hyprpicker btop NetworkManager wl-clipboard swww brightnessctl gnome-bluetooth power-profiles-daemon gvfs nodejs gtksourceview3 libsoup3
```

--------------------------------

### Install GPU Screen Recorder via Flatpak

Source: https://hyprpanel.com/getting_started/installation.html

Install the GPU screen recorder utility using Flatpak.

```sh
flatpak install flathub --system com.dec05eba.gpu_screen_recorder
```

--------------------------------

### CPU Temperature Sensor Path Example

Source: https://hyprpanel.com/configuration/panel.html

Example file path value to be used in the CPU Temperature Sensor configuration field.

```sh
/sys/devices/pci0000:00/0000:00:18.3/hwmon/hwmon2/temp1_input
```

--------------------------------

### Install HyprPanel via AUR

Source: https://hyprpanel.com/getting_started/astal.html

Use this command to install HyprPanel if you are using an AUR helper like yay.

```bash
yay -S ags-hyprpanel-git
```

--------------------------------

### Install All Dependencies on Arch Linux (AUR)

Source: https://hyprpanel.com/getting_started/astal.html

Use this command with an AUR helper to install AUR-specific dependencies for HyprPanel.

```bash
yay -S --needed grimblast-git hyprpicker matugen-bin python-gpustat hyprsunset-git
```

--------------------------------

### Run HyprPanel

Source: https://hyprpanel.com/getting_started/astal.html

Execute this command to launch HyprPanel after installation. It can also be added to your startup applications.

```bash
hyprpanel

# Or add it to your startup via
exec-once = hyprpanel
```

--------------------------------

### Install Sass via NPM

Source: https://hyprpanel.com/getting_started/installation.html

Install the Sass compiler globally.

```sh
npm install -g sass
```

--------------------------------

### Install All Dependencies on Arch Linux (Pacman)

Source: https://hyprpanel.com/getting_started/astal.html

A convenient command to install all required and common optional dependencies using pacman on Arch Linux.

```bash
sudo pacman -S --needed wireplumber libgtop bluez bluez-utils btop networkmanager dart-sass wl-clipboard brightnessctl swww python upower pacman-contrib power-profiles-daemon gvfs wf-recorder
```

--------------------------------

### Autostart HyprPanel on Boot

Source: https://hyprpanel.com/help/faq.html

Add this line to your Hyprland configuration file to automatically start HyprPanel when your system boots.

```bash
exec-once = hyprpanel
```

--------------------------------

### CPU Temperature Sensor Output Example

Source: https://hyprpanel.com/configuration/panel.html

Example output generated by the sensor identification command.

```sh
nvme: Composite /sys/devices/pci0000:00/0000:00:01.1/0000:01:00.0/nvme/nvme0/hwmon0/temp1_input
nvme: Sensor 1 /sys/devices/pci0000:00/0000:00:01.1/0000:01:00.0/nvme/nvme0/hwmon0/temp2_input
nvme: Sensor 2 /sys/devices/pci0000:00/0000:00:01.1/0000:01:00.0/nvme/nvme0/hwmon0/temp3_input
nvme: Composite /sys/devices/pci0000:00/0000:00:01.2/0000:02:00.2/0000:03:00.0/0000:04:00.0/nvme/nvme1/hwmon1/temp1_input
nvme: Sensor 1 /sys/devices/pci0000:00/0000:00:01.2/0000:02:00.2/0000:03:00.0/0000:04:00.0/nvme/nvme1/hwmon1/temp2_input
k10temp: Tctl /sys/devices/pci0000:00/0000:00:18.3/hwmon/hwmon2/temp1_input
k10temp: Tccd1 /sys/devices/pci0000:00/0000:00:18.3/hwmon/hwmon2/temp3_input
```

--------------------------------

### Get Help for a Specific HyprPanel CLI Command

Source: https://hyprpanel.com/getting_started/astal.html

To get detailed information about a specific HyprPanel command, append the command name to 'explain'.

```bash
hyprpanel explain <command>
```

--------------------------------

### Install Optional Python Dependencies on Fedora

Source: https://hyprpanel.com/getting_started/installation.html

Install Python-based optional dependencies using pip.

```sh
sudo dnf install python python3-pip; pip install gpustat pywal
```

--------------------------------

### Rebuild HyprPanel after Git Pull

Source: https://hyprpanel.com/help/faq.html

After pulling the latest changes from the Git repository, run these commands to install dependencies, set up the build, compile, and install HyprPanel.

```bash
npm i
```

```bash
meson setup build
```

```bash
meson compile -C build
```

```bash
meson install -C build
```

--------------------------------

### Check HyprPanel Dependencies

Source: https://hyprpanel.com/getting_started/astal.html

This command helps verify which required and optional dependencies are currently installed or missing.

```bash
hyprpanel checkDependencies
```

--------------------------------

### Optional Dependencies for HyprPanel

Source: https://hyprpanel.com/getting_started/astal.html

These packages provide additional features for HyprPanel, such as GPU usage tracking, brightness control, and update checking. Install them based on your needs.

```bash
## Used for Tracking GPU Usage in your Dashboard (NVidia only)
python
python-gpustat

## To control screen/keyboard brightness
brightnessctl

## Only if a pywal hook from wallpaper changes applied through settings is desired
pywal

## To check for pacman updates in the default script used in the updates module
pacman-contrib

## To switch between power profiles in the battery module
power-profiles-daemon

## To take snapshots with the default snapshot shortcut in the dashboard
grimblast

## To record screen through the dashboard record shortcut
wf-recorder

## To enable the eyedropper color picker with the default snapshot shortcut in the dashboard
hyprpicker

## To enable hyprland's very own blue light filter
hyprsunset

## To click resource/stat bars in the dashboard and open btop
btop

## To enable matugen based color theming
matugen

## To enable matugen based color theming and setting wallpapers
swww
```

--------------------------------

### Required Dependencies for HyprPanel

Source: https://hyprpanel.com/getting_started/astal.html

These are the essential packages required for HyprPanel to function correctly. Ensure all are installed before proceeding.

```bash
wireplumber
libgtop
bluez
bluez-utils
networkmanager
dart-sass
wl-clipboard
upower
gvfs
```

--------------------------------

### Get Application Class Names with hyprctl

Source: https://hyprpanel.com/configuration/notifications.html

Use this command to list running applications and their class names, which are needed for the 'Ignored Applications' setting. The output includes class, initial title, and monitor information.

```bash
hyprctl clients | grep -E "class:|initialTitle:|monitor:" | awk '{$1=""; print $0}' | paste - - - | awk '{class=($2 ? $2 : "-"); title=($4 ? $4 : "-"); monitor=($1 ? $1 : "-"); printf "% -25s % -20.20s % -7s\n", class, title, monitor}' | awk 'BEGIN {print "CLASS                     INITIAL TITLE         MONITOR"; print "------------------------- -------------------- ------- "} {print}'
```

--------------------------------

### Toggle HyprPanel Settings Dialog

Source: https://hyprpanel.com/configuration/settings.html

Use this command in the terminal to open or close the HyprPanel settings dialog. Ensure HyprPanel is installed and accessible in your PATH.

```bash
hyprpanel toggleWindow settings-dialog
```

--------------------------------

### Toggle HyprPanel Bars via CLI

Source: https://hyprpanel.com/configuration/cli.html

Toggle the bar on a specific monitor using `hyprpanel toggleWindow bar-#`, where '#' is the monitor's ID. Monitor IDs start at 0 and increment sequentially.

```bash
hyprpanel toggleWindow bar-0
```

--------------------------------

### Configure HyprPanel with home-manager

Source: https://hyprpanel.com/getting_started/installation.html

Use the programs.hyprpanel.settings attribute to define bar layouts, themes, and menu options. Note that GUI changes may overwrite the configuration file, requiring manual synchronization.

```nix
{ inputs, ... }:
{
  programs.hyprpanel = {
    # Configure and theme almost all options from the GUI.
    # See 'https://hyprpanel.com/configuration/settings.html'.
    # Default: <same as gui>
    settings = {

      # Configure bar layouts for monitors.
      # See 'https://hyprpanel.com/configuration/panel.html'.
      # Default: null
      layout = {
        bar.layouts = {
          "0" = {
            left = [ "dashboard" "workspaces" ];
            middle = [ "media" ];
            right = [ "volume" "systray" "notifications" ];
          };
        };
      };

      bar.launcher.autoDetectIcon = true;
      bar.workspaces.show_icons = true;

      menus.clock = {
        time = {
          military = true;
          hideSeconds = true;
        };
        weather.unit = "metric";
      };

      menus.dashboard.directories.enabled = false;
      menus.dashboard.stats.enable_gpu = true;

      theme.bar.transparent = true;

      theme.font = {
        name = "CaskaydiaCove NF";
        size = "16px";
      };
    };
  };
}
```

--------------------------------

### List System Tray Items

Source: https://hyprpanel.com/configuration/panel.html

Run this command to retrieve a list of all application IDs currently present in the system tray.

```sh
hyprpanel systrayItems
```

--------------------------------

### List Required Dependencies

Source: https://hyprpanel.com/getting_started/installation.html

Essential system packages required for HyprPanel functionality.

```sh
aylurs-gtk-shell-git
wireplumber
libgtop
bluez
bluez-utils
networkmanager
dart-sass
wl-clipboard
upower
gvfs
gtksourceview3
libsoup3
```

--------------------------------

### Migrate HyprPanel Configuration

Source: https://hyprpanel.com/getting_started/astal.html

Run this command after launching HyprPanel to migrate your old configuration files to the new format.

```bash
hyprpanel migrateConfig
```

--------------------------------

### Change HyprPanel Themes via CLI

Source: https://hyprpanel.com/configuration/cli.html

Apply a new theme by executing `hyprpanel useTheme` followed by the file path to the theme's JSON configuration. Any valid theme file path can be used.

```bash
hyprpanel useTheme "/usr/share/hyprpanel/themes/nord.json"
```

--------------------------------

### List All HyprPanel CLI Commands

Source: https://hyprpanel.com/configuration/cli.html

Run this command in your terminal to see a comprehensive list of all available HyprPanel CLI commands. HyprPanel must be running for this command to work.

```bash
hyprpanel explain
```

--------------------------------

### Advanced HyprPanel Bar Layout with Wildcards

Source: https://hyprpanel.com/configuration/panel.html

Configures HyprPanel bar layouts using a combination of monitor indices, connector names, and a wildcard ('*') for applying settings to all undefined monitors. The 'extends' key allows inheriting settings from a wildcard configuration.

```json
{
  "*": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": [
      "volume",
      "network",
      "bluetooth",
      "systray",
      "clock",
      "notifications"
    ]
  },
  "2": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": ["volume", "clock", "notifications"]
  },
  "HDMI-A-1": {
    "extends": "*",
    "middle": []
  }
}
```

--------------------------------

### State-Based Icons Configuration

Source: https://hyprpanel.com/configuration/custom_modules.html

Configure state-based icons using a JSON object where keys match the `alt` value from the command output. An optional `default` key can be used as a fallback.

```json
{
    "icon": {
        "arch": "󰣇",
        "nix": "󱄅",
        "ubuntu": "󰕈",
        "fedora": "󰣛"
    }
}
```

--------------------------------

### Configure HyprPanel development version via Flakes

Source: https://hyprpanel.com/getting_started/installation.html

Use the provided flake to track the latest development version of HyprPanel. Requires passing inputs to home-manager and overriding the package attribute.

```nix
# flake.nix
{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable"; # can be stable
    hyprpanel = {
      url = "github:Jas-SinghFSU/HyprPanel";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = inputs @ { ... }: let
    system = "x86_64-linux"; # change to whatever your system should be
  in {
    homeConfigurations."username@my-hostname" = home-manager.lib.homeManagerConfiguration {
      # you need this line
      extraSpecialArgs = { inherit inputs; };
    };
  };
}
```

```nix
{ inputs, pkgs, ...}: {
  programs.hyprpanel = {
    package = inputs.hyprpanel.packages.${pkgs.system}.default;
  };
}
```

--------------------------------

### Percentage-Based Icons

Source: https://hyprpanel.com/configuration/custom_modules.html

Use an array of strings for percentage-based icons. The output of the `execute` command must be JSON with a `percentage` key (0-100). The icon is selected based on the percentage range.

```json
["󰕿", "󰖀", "󰕾"]
```

--------------------------------

### Define Custom Module Path

Source: https://hyprpanel.com/configuration/custom_modules.html

Custom modules are configured in the `modules.json` file located in the HyprPanel configuration directory.

```bash
~/.config/hyprpanel/modules.json
```

--------------------------------

### Static Icon Configuration

Source: https://hyprpanel.com/configuration/custom_modules.html

Configure a static icon for a module by providing a single string value for the `icon` property.

```json
{
    "icon": ""
}
```

--------------------------------

### Configure Window Title Mappings

Source: https://hyprpanel.com/configuration/panel.html

Define an array of arrays to map original window titles to custom icons and display names.

```json
[
  ["kitty", "󰄛", "Kitty Terminal"],
  ["firefox", "󰈹", "Firefox"],
  ["microsoft-edge.*", "󰇩", "Edge"],
  ["discord", "", "Discord"],
  ["org.kde.dolphin", "", "Dolphin"]
]
```

--------------------------------

### Toggle HyprPanel Menus via CLI

Source: https://hyprpanel.com/configuration/cli.html

Use the `hyprpanel toggleWindow` or `hyprpanel t` command followed by the menu name to toggle dropdown menus. Ensure HyprPanel is running.

```bash
# Dashboard Menu
dashboardmenu
# Audio Menu (Volume levels/devices)
audiomenu
# Media Menu (Media playback controls)
mediamenu
# Network Menu
networkmenu
# Bluetooth Menu
bluetoothmenu
# Notifications Menu
notificationsmenu
# Calendar Menu
calendarmenu
# Battery menu
energymenu
# Power Actions Menu
powerdropdownmenu

# The settings dialog
settings-dialog
```

```bash
# To open the settings dialog
hyprpanel toggleWindow settings-dialog
# To open the audio menu
hyprpanel t audiomenu
```

--------------------------------

### Configure Workspace Icons

Source: https://hyprpanel.com/configuration/panel.html

Assign custom icons to workspaces using simple key-value pairs or objects with color properties.

```json
{
  "1": "󰄛",
  "2": "",
  "3": "󰙯",
  "4": "󰓇",
  "5": ""
}
```

```json
{
  "1": { "icon": "󰄛", "color": "red" },
  "2": { "icon": "", "color": "#94e2d5" },
  "3": { "icon": "󰙯", "color": "rgb(166, 227, 161)" },
  "4": { "icon": "󰓇", "color": "green" },
  "5": { "icon": "", "color": "yellow" }
}
```

```json
{
  "1": "󰄛",
  "2": { "icon": "", "color": "#94e2d5" },
  "3": { "icon": "󰙯", "color": "rgb(166, 227, 161)" },
  "4": "󰓇",
  "5": ""
}
```

--------------------------------

### Configure Fedora COPR Repositories

Source: https://hyprpanel.com/getting_started/installation.html

Enable necessary COPR repositories for HyprPanel dependencies on Fedora.

```sh
sudo dnf copr enable solopasha/hyprland
sudo dnf copr enable heus-sueh/packages
sudo dnf config-manager --save --setopt=copr:copr.fedorainfracloud.org:heus-sueh:packages.priority=200
```

--------------------------------

### Identify CPU Temperature Sensors

Source: https://hyprpanel.com/configuration/panel.html

Command to list available hardware temperature sensors on the system.

```sh
for i in /sys/class/hwmon/hwmon*/temp*_input; do echo "$(<$(dirname $i)/name): $(cat ${i%_*}_label 2>/dev/null || echo $(basename ${i%_*})) $(readlink -f $i)"; done
```

--------------------------------

### Retrieve Window Information

Source: https://hyprpanel.com/configuration/panel.html

Use this command to identify the class and title of currently active windows for mapping purposes.

```bash
hyprctl clients
```

--------------------------------

### Custom Stylesheet Path

Source: https://hyprpanel.com/configuration/custom_modules.html

Custom styling for modules can be defined in the `modules.scss` file within the HyprPanel configuration directory.

```bash
~/.config/hyprpanel/modules.scss
```

--------------------------------

### Extend Layouts Configuration

Source: https://hyprpanel.com/configuration/panel.html

Inherit configuration from a base layout using the extends property to override specific sections for individual monitors.

```json
{
  "*": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": [
      "volume",
      "network",
      "bluetooth",
      "systray",
      "clock",
      "notifications"
    ]
  },
  "DP-1": {
    "extends": "*",
    "right": ["volume", "clock", "notifications"]
  },
  "HDMI-A-1": {
    "extends": "*",
    "left": ["workspaces"],
    "middle": []
  }
}
```

--------------------------------

### Define Custom System Tray Icons

Source: https://hyprpanel.com/configuration/panel.html

Use a JSON map to assign custom icons, colors, and sizes to specific application IDs or regex patterns.

```typescript
{
    "appId_or_regex" : {
        "icon": "󰙯",
        "color": "#b4befe",
        "size": "1.3em"
    }
}
```

```typescript
{
  "steam": { "icon": "󰓓", "color": "#89b4fa" },
  "spotify-client": { "icon": "󰓇", "color": "#94e2d5" }
}
```

--------------------------------

### Enable Focus on Activate for Notification Workspaces

Source: https://hyprpanel.com/help/faq.html

Ensure notifications correctly direct users to the intended workspace by enabling this Hyprland configuration option.

```HOCON
misc {
    focus_on_activate = true
}
```

--------------------------------

### Map Workspaces to Application Icons

Source: https://hyprpanel.com/configuration/panel.html

Define a JSON object to map window classes or titles to specific icons for the workspace indicator module.

```json
{
  "[dD]iscord": "󰙯",
  "title:YouTube": "",
  "class:wezterm$": ""
}
```

--------------------------------

### Plain Text Output for Label/Tooltip

Source: https://hyprpanel.com/configuration/custom_modules.html

If the `execute` command outputs plain text, use `{}` in the label or tooltip to display the raw output.

```text
Hello World
```

--------------------------------

### Update HyprPanel from Git Repository

Source: https://hyprpanel.com/help/faq.html

Navigate to your HyprPanel directory and use these commands to pull the latest changes from the Git repository.

```bash
git pull
```

```bash
git stash
```

--------------------------------

### Enable Custom Module in Bar Layout

Source: https://hyprpanel.com/configuration/custom_modules.html

Add the custom module identifier to the monitor layout configuration in the HyprPanel settings.

```json
{
    "0": {
        "left": ["dashboard"],
        "middle": ["workspaces"],
        "right": ["custom/volume"]
    }
}
```

--------------------------------

### JSON Output for Label/Tooltip Templating

Source: https://hyprpanel.com/configuration/custom_modules.html

Provide JSON output with keys like `percentage` or nested objects for use in label and tooltip templates.

```json
{
    "percentage": 75,
    "server": {
        "status": "up"
    }
}
```

--------------------------------

### State-Based Icon Expected Output

Source: https://hyprpanel.com/configuration/custom_modules.html

The shell command for state-based icons should output JSON with an `alt` key matching one of the configured icon keys.

```json
{
    "alt": "arch"
}
```

--------------------------------

### Ignore System Tray Icons

Source: https://hyprpanel.com/configuration/panel.html

Specify an array of case-sensitive application names to exclude from the system tray.

```bash
["spotify-client"]
```

--------------------------------

### Define Custom Module Structure

Source: https://hyprpanel.com/configuration/custom_modules.html

Use this JSON structure to define a custom module in `modules.json`. Replace `<module-name>` with your module's unique identifier.

```json
{
    "custom/module-name": {
        // Module configuration
    }
}
```

--------------------------------

### Default HyprPanel Bar Layout

Source: https://hyprpanel.com/configuration/panel.html

Defines the default arrangement of modules on the HyprPanel bar for different monitors. This JSON structure specifies which modules appear on the left, middle, and right sections of the panel for monitor indices 0, 1, and 2.

```json
{
  "0": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": [
      "volume",
      "network",
      "bluetooth",
      "systray",
      "clock",
      "notifications"
    ]
  },
  "1": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": ["volume", "clock", "notifications"]
  },
  "2": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": ["volume", "clock", "notifications"]
  }
}
```

--------------------------------

### Style Custom Volume Module with SCSS

Source: https://hyprpanel.com/configuration/custom_modules.html

Use the styleModule mixin to override specific visual properties of a custom module. Ensure the class name matches the module name with the cmodule- prefix.

```scss
/* ##################################
 * #  Custom Volume Module Styling  #
 * ################################## */
@include styleModule(
    // class name
    'cmodule-volume',
    // styling properties
    (
            'text-color': #cba6f7,
            'icon-color': #242438,
            'icon-background': #cba6f7,
            'label-background': #242438,
            'inner-spacing': 0.5em,
            'border-enabled': false,
            'border-color': #cba6f7,
            'icon-size': 1.2em
        )
);
```

--------------------------------

### Ignore Applications in HyprPanel

Source: https://hyprpanel.com/configuration/notifications.html

Specify applications to ignore notifications from by listing their case-insensitive class names in this array.

```bash
["discord", "slack"]
```

--------------------------------

### Weather API Key JSON Format

Source: https://hyprpanel.com/configuration/panel.html

The required JSON structure for providing a weather API key via a file path.

```json
{
  "weather_api_key": "your_api_key_goes_here"
}
```

--------------------------------

### Hide Bar on Specific Monitors

Source: https://hyprpanel.com/configuration/panel.html

Disable the bar on specific monitors by assigning empty arrays to the left, middle, and right sections.

```json
{
  "0": {
    "left": ["dashboard", "workspaces", "windowtitle"],
    "middle": ["media"],
    "right": [
      "volume",
      "network",
      "bluetooth",
      "systray",
      "clock",
      "notifications"
    ]
  },
  "1": {
    "left": [],
    "middle": [],
    "right": []
  },
  "2": {
    "left": [],
    "middle": [],
    "right": []
  }
}
```
Tokens:
Raw