Metadata-Version: 2.4
Name: pystray-freedesktop
Version: 0.19.6a1
Summary: A library to create system tray icons with freedesktop support (temporary fork).
Author-email: Moses Palmér <moses.palmer@gmail.com>, Sebastian Silva <sebastian@fuentelibre.org>
Maintainer-email: Sebastian Silva <sebastian@fuentelibre.org>
License: LGPL-3.0-or-later
Project-URL: Homepage, https://gtk-llm-chat.fuentelibre.org/
Project-URL: Repository, https://github.com/fuentelibre/gtk-llm-chat
Project-URL: Bug Reports, https://github.com/fuentelibre/gtk-llm-chat/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows :: Windows NT/2000
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: COPYING
License-File: COPYING.LGPL
Requires-Dist: Pillow
Requires-Dist: six
Dynamic: license-file

# pystray-freedesktop

This is a fork of the [pystray](https://github.com/moses-palmer/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](https://gtk-llm-chat.fuentelibre.org/), 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

```bash
pip install pystray-freedesktop
```

## Usage

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

```python
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
