trayer

Lightweight standalone system tray panel

TLDR

Run trayer

$ trayer

Position to edge

$ trayer --edge [left|right|top|bottom]

Set dimensions

$ trayer --width [10] --height [32]

Set width type and size

$ trayer --widthtype [pixel|percent] --width [72]

Align panel

$ trayer --align [left|center|right]

Set icon spacing

$ trayer --iconspacing [10]

trayer is a lightweight GTK-2 based system tray panel. It provides a standalone systray that can be used with minimalist window managers that don't include their own system tray implementation.The panel displays system tray icons from applications and can be positioned and sized according to user preferences.

PARAMETERS

--edge POSITION

Position panel at left, right, top, bottom, or none (default: bottom)

--align DIRECTION

Align icons: left, center, right, or none (default: center)

--widthtype TYPE

Width interpretation: request, pixel, percent, or none (default: percent)

--width N

Panel width as a number, interpreted per --widthtype (default: 100)

--heighttype TYPE

Height interpretation: request, pixel, percent, or none (default: pixel)

--height N

Panel height value (default: 26)

--margin N

Margin from the screen edge in pixels (default: 0)

--distance N

Distance between trayer's window and screen edge in pixels (default: 0)

--distancefrom EDGE

Edge to measure --distance from: top, bottom, left, right (default: top)

--padding N

Extra pixel spacing between frame and icons (default: 0)

--iconspacing N

Spacing between icons in pixels

--monitor N

Target monitor by index (0..N) or primary (default: 0)

--transparent BOOL

Enable transparency: true or false (default: false)

--alpha N

Transparency level (0 = opaque, 255 = fully transparent; default: 127)

--tint COLOR

Background tint as a hex value, e.g. 0xFFFFFFFF

--expand BOOL

Allow trayer to expand to use extra space (default: true)

--SetDockType BOOL

Identify panel window as a dock type window (default: true)

--SetPartialStrut BOOL

Reserve panel space so other windows do not overlap it (default: false)

INSTALL

sudo apt install trayer

nix profile install nixpkgs#trayer

CAVEATS

Requires GTK-2. May not support all modern tray icon features. Transparency requires compositor support. Some window managers may conflict with positioning.

HISTORY

trayer was developed as a standalone system tray for use with tiling and minimal window managers that lack built-in system tray support.