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

# yambar-modules-removables(5)

This module detects removable drives

## NAME

removables - This module detects removable drives

## DESCRIPTION

This module detects removable drives (USB sticks, CD-ROMs) and instantiates the provided *content* particle for each detected drive.

## TAGS

| | | |
| --- | --- | --- |
| **Name** | **Type** | **Description** |
| vendor | string | Name of the drive vendor |
| model | string | Drive model name |
| optical | bool | True if the drive is an optical drive (CD-ROM, DVD-ROM etc) |
| audio | bool | True if an optical drive has an audio CD inserted (i.e. this property is always false for non-optical drives). |
| device | string | Volume device name (typically **/dev/sd?**) |
| size | range | The volume's size, in bytes. The tag's maximum value is set to the underlying block device's size |
| label | string | The volume's label, or its size if it has no label |
| mounted | bool | True if the volume is mounted |
| mount\_point | string | Path where the volume is mounted, or **""** if it is not mounted |

## CONFIGURATION

| | | | |
| --- | --- | --- | --- |
| **Name** | **Type** | **Req** | **Description** |
| left-spacing | int | no | Space, in pixels, in the left side of each rendered volume |
| right-spacing | int | no | Space, in pixels, on the right side of each rendered volume |
| spacing | int | no | Short-hand for setting both *left-spacing* and *right-spacing* |
| ignore | list of strings | no | List of device paths that should be ignored (e.g. /dev/mmcblk0, or /dev/mmcblk0p1) |

## EXAMPLES

```
bar:
  right:
    - removables:
        content:
          map:
            conditions:
              ~mounted:
                string:
                  on-click: udisksctl mount -b {device}
                  text: "{label}"
              mounted:
                string:
                  on-click: udisksctl unmount -b {device}
                  text: "{label}"
                  deco: {underline: {size: 2, color: ffffffff}}
```

## 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)