---
name: "picom-trans"
section: "1"
platform: "linux"
package: "picom"
version: "13-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/picom-trans"
---

# picom-trans(1)

an opacity setter tool

## NAME

picom-trans - an opacity setter tool

## SYNOPSIS

**picom-trans** \[-w *WINDOW\_ID*\] \[-n *WINDOW\_NAME*\] \[-c\] \[-s\] *OPACITY*

## DESCRIPTION

**picom-trans** is a bash script that sets *\_NET\_WM\_WINDOW\_OPACITY* attribute of a window using standard X11 command-line utilities, including [**xprop**(1)](/xprop/1.md) and [**xwininfo**(1)](/xwininfo/1.md). It is similar to [**transset**(1)](/transset/1.md) or [**transset-df**(1)](/transset-df/1.md).

## OPTIONS

- **-w**, **--window**=*WINDOW\_ID*

  Specify the window id of the target window.

- **-n**, **--name**=*WINDOW\_NAME*

  Specify and try to match a window name.

- **-c**, **--current**

  Specify the currently active window as target. Only works if EWMH '\_NET\_ACTIVE\_WINDOW' property exists on root window.

- **-s**, **--select**

  Select target window with mouse cursor. This is the default if no window has been specified.

- **-o**, **--opacity**=*OPACITY*

  Specify the new opacity value for the window. This value can be anywhere from 1-100. If it is prefixed with a plus or minus (+/-), this will increment or decrement from the target window’s current opacity instead.

- **-g**, **--get**

  Print the target window’s opacity instead of setting it.

- **-d**, **--delete**

  Delete opacity of the target window instead of setting it.

- **-t**, **--toggle**

  Toggle the target window’s opacity: Set opacity if not already set, and delete if already set.

- **-r**, **--reset**

  Reset opacity for all windows instead of setting it.

## EXAMPLES

• Set the opacity of the window with specific window ID to 75%:

```
picom-trans -w "$WINDOWID" 75
```

• Set the opacity of the window with the name "urxvt" to 75%:

```
picom-trans -n "urxvt" 75
```

• Set current window to opacity of 75%:

```
picom-trans -c 75
```

• Select target window and set opacity to 75%:

```
picom-trans -s 75
```

• Increment opacity of current active window by 5%:

```
picom-trans -c +5
```

• Decrement opacity of current active window by 5%:

```
picom-trans -c -- -5
```

• Delete current window’s opacity:

```
picom-trans -c --delete
```

• Toggle current window’s opacity between 90 and unset

```
picom-trans -c --toggle 90
```

• Reset all windows:

```
picom-trans --reset
```

## BUGS

Please submit bug reports to  \<https://github.com/yshui/picom\>.

## SEE ALSO

[**picom**(1)](/picom/1.md), [**xprop**(1)](/xprop/1.md), [**xwininfo**(1)](/xwininfo/1.md)

## AUTHOR

Yuxuan Shui