Skip to main content

A library to create system tray icons with freedesktop support (temporary fork).

Project description

pystray-freedesktop

This is a fork of the pystray library with enhanced freedesktop.org support for Linux systems.

What's different in this fork?

This fork includes patches that improve compatibility with Linux desktop environments that follow freedesktop.org standards, particularly enhancing system tray icon functionality in modern Linux desktop environments.

Why this fork?

While working on GTK LLM Chat, we needed better Linux system tray support. The patches in this fork provide:

  • Enhanced freedesktop.org compatibility
  • Better integration with modern Linux desktop environments
  • Improved system tray icon handling

Installation

pip install pystray-freedesktop

Usage

This fork maintains full API compatibility with the original pystray library:

import pystray
from pystray import MenuItem as item
from PIL import Image

# Your existing pystray code works unchanged
def quit_action(icon):
    icon.stop()

image = Image.open("icon.png")
menu = pystray.Menu(item('Quit', quit_action))
icon = pystray.Icon("test", image, menu=menu)
icon.run()

Contributing

This is a temporary fork maintained for the GTK LLM Chat project. We aim to contribute these improvements back to the upstream pystray project.

For issues related to this fork, please report them at: https://github.com/fuentelibre/gtk-llm-chat/issues

For the original pystray project, visit: https://github.com/moses-palmer/pystray

License

This project maintains the same LGPL-3.0-or-later license as the original pystray library.

Maintainer

This fork is maintained by Sebastian Silva (sebastian@fuentelibre.org) as part of the GTK LLM Chat project.

Original pystray author: Moses Palmér

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pystray_freedesktop-0.19.6a1.tar.gz (38.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pystray_freedesktop-0.19.6a1-py2.py3-none-any.whl (47.4 kB view details)

Uploaded Python 2Python 3

File details

Details for the file pystray_freedesktop-0.19.6a1.tar.gz.

File metadata

  • Download URL: pystray_freedesktop-0.19.6a1.tar.gz
  • Upload date:
  • Size: 38.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for pystray_freedesktop-0.19.6a1.tar.gz
Algorithm Hash digest
SHA256 9365d13847110d7c3a28315c8108b724cc7308d7af4f85ecf34edd296bc78e62
MD5 baf441002fc0773a852387f9edce513d
BLAKE2b-256 7922bb6340208bb5f934a129ccad1c1f426cb5f5c83fd858b41a0030db972c85

See more details on using hashes here.

File details

Details for the file pystray_freedesktop-0.19.6a1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pystray_freedesktop-0.19.6a1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 aea62e27cc9ef08c8822b6c6c1e94113e49eee2173e2007bdb874c6ca7a3d418
MD5 f1ed6ac8a220306b59548ad092ca4168
BLAKE2b-256 90da5288d3c601ce20a6417419ab8c67220869fb22f9d6ac281a65ad822c4b92

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page