---
name: "yambar-modules-pipewire"
section: "5"
platform: "linux"
package: "yambar"
version: "1.11.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/yambar-modules-pipewire"
---

# yambar-modules-pipewire(5)

Monitors pipewire for volume, mute/unmute, device change

## NAME

pipewire - Monitors pipewire for volume, mute/unmute, device change

## TAGS

| | | |
| --- | --- | --- |
| **Name** | **Type** | **Description** |
| type | string | Either "source" (capture) or "sink" (speaker) |
| name | string | Current device name |
| description | string | Current device description |
| form\_factor | string | Current device form factor (headset, speaker, mic, etc) |
| bus | string | Current device bus (bluetooth, alsa, etc) |
| icon | string | Current device icon name |
| muted | bool | True if muted, otherwise false |
| linear\_volume | range | Linear volume in percentage (with 0 as min and 100 as max) |
| cubic\_volume | range | Cubic volume (used by pulseaudio) in percentage (with 0 as min and 100 as max) |

## CONFIGURATION

| | | | |
| --- | --- | --- | --- |
| **Name** | **Type** | **Req** | **Description** |
| content | particle | yes | Unlike other modules, *content* is a template particle that will be expanded twice (i.e. into a list of two elements). The first element is the 'sink', and the second element the 'source'. |

## EXAMPLES

```
bar:
  left:
    - pipewire:
        anchors:
          volume: &volume
            conditions:
              muted: {string: {text: "{linear_volume}%", foreground: ff0000ff}}
              ~muted: {string: {text: "{linear_volume}%"}}
        content:
          list:
            items:
              - map:
                  conditions:
                    type == "sink":
                      map:
                        conditions:
                          icon == "audio-headset-bluetooth":
                            string: {text: "🎧  "}
                        default:
                          - ramp:
                              tag: linear_volume
                              items:
                                - string: {text: "🔈  "}
                                - string: {text: "🔉  "}
                                - string: {text: "🔊  "}
                    type == "source":
                      - string: {text: "🎙  "}
              - map:
                  <<: *volume
```

## SEE ALSO

[**yambar-modules**(5)](/yambar-modules/5.md), [**yambar-particles**(5)](/yambar-particles/5.md), [**yambar-tags**(5)](/yambar-tags/5.md), [**yambar-decorations**(5)](/yambar-decorations/5.md)