Metadata-Version: 2.4
Name: ksteamtrayicon
Version: 1.0.5.post1
Summary: Updates the Steam tray icon to match the current Plasma color scheme.
Project-URL: Homepage, https://github.com/marcotuliomatos/ksteamtrayicon
Project-URL: Repository, https://github.com/marcotuliomatos/ksteamtrayicon
Project-URL: Issues, https://github.com/marcotuliomatos/ksteamtrayicon/issues
Author: Marco Matos
License-Expression: MIT
License-File: LICENSE
Keywords: color,dark,kde,light,plasma,scheme,steam,theme,tray
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: dbus-next>=0.2.3
Description-Content-Type: text/markdown

# KSteamTrayIcon

*KSteamTrayIcon* is a small Python background application for KDE Plasma 6 that keeps the Steam tray icon in sync with the desktop color scheme.

## How does it work?

By default, Steam displays a tray icon that looks fine on dark panels, but is hard to see on light Plasma themes.

The application listens for changes on the current desktop color scheme and then acts as follows:

- if it detects that the current theme has a light color scheme, it overrides the default Steam tray icon by placing a dark-colored variant in `$HOME/.local/share/icons/steam_tray_mono.png`.
- if it detects that the current theme has a dark color scheme, it removes the dark-colored file, which prompts Steam to change its tray icon back to the default light-colored one.

## Requirements

- KDE Plasma 6
- Python 3
- `dbus-next` (python library)
- `pipx`*

*Note:* by default, `pipx` is **not** required on Arch Linux and its derivatives if you run `setup.sh install` without specifying the `--force-pypi` flag (more information below).

## Install

First, check the contents of [setup.sh](https://raw.githubusercontent.com/marcotuliomatos/ksteamtrayicon/main/setup.sh) and if everything seems ok for you, simply run the following command:

```text
curl -fsSL https://raw.githubusercontent.com/marcotuliomatos/ksteamtrayicon/main/setup.sh | bash -s -- install
```

The installation script will check if all required dependencies are available in your system and will guide you through the setup process.

For all distributions except Arch Linux (and distros based on it), the `setup.sh install` command will install the [*KSteamTrayIcon* PyPI package](https://pypi.org/project/ksteamtrayicon/) using `pipx`.

For Arch Linux and Arch-based distro, the `setup.sh install` command defaults to install the [*KSteamTrayIcon* AUR package](https://aur.archlinux.org/packages/ksteamtrayicon), which doesn't require `pipx` at all. If, for whatever reason, you prefer to install the package from PyPI instead, just use the `setup.sh install-from-pypi` command:

```text
curl -fsSL https://raw.githubusercontent.com/marcotuliomatos/ksteamtrayicon/main/setup.sh | bash -s -- install-from-pypi
```

## Uninstall
Check the contents of [setup.sh](https://raw.githubusercontent.com/marcotuliomatos/ksteamtrayicon/main/setup.sh) and if everything seems ok for you, simply run the following command:

```text
curl -fsSL https://raw.githubusercontent.com/marcotuliomatos/ksteamtrayicon/main/setup.sh | bash -s -- uninstall
```

## License

MIT
