Stash-tray-linux

Plugins Other Projects
,
1
:placard: Summary A small Linux/XFCE tray controller for an existing Stash server install.
:link: Repository https://github.com/thelamewizard/stash-tray-linux

stash-tray-linux

A small Linux/XFCE tray controller for an existing Stash server install.

It keeps the original simple behavior:

  • starts Stash if it is not already running
  • attaches to Stash if it is already running
  • shows a tray icon while Stash is running
  • Open Stash opens http://localhost:9999/scenes
  • Quit Stash stops Stash and closes the tray icon
  • if Stash stops outside the tray app, the tray icon closes too

Scope

This version targets Linux/XFCE first. It uses GTK 3 plus AppIndicator/Ayatana AppIndicator.

Requirements

Debian/Ubuntu/Xubuntu/XFCE:

sudo apt install python3-gi gir1.2-gtk-3.0 gir1.2-ayatanaappindicator3-0.1

Fedora:

sudo dnf install python3-gobject gtk3 libappindicator-gtk3

Arch/Manjaro:

sudo pacman -S python-gobject gtk3 libappindicator-gtk3

Install

From the project folder:

chmod +x install.sh
./install.sh

The installer will:

  1. check runtime dependencies
  2. look for a running stash-linux or stash process and save its binary path
  3. fall back to stash-linux or stash from your PATH
  4. finally ask you for the full Stash binary path if needed
  5. optionally enable autostart on login

Run

After install:

stash-tray-linux

Or launch Stash Tray Linux from the XFCE application menu.

Autostart

Autostart is offered during install. It creates:

~/.config/autostart/stash-tray-linux.desktop

To disable autostart, delete that file.

Configuration

The saved Stash binary path lives at:

~/.config/stash-tray-linux/config.json

Example:

{
  "stash_binary": "/home/you/apps/stash/stash-linux"
}

You can edit that file if your Stash binary moves.

URL

The tray opens:

http://localhost:9999/scenes

If you need a different URL, run with:

STASH_TRAY_URL="http://localhost:9999" stash-tray-linux

Uninstall

./uninstall.sh