Metadata-Version: 2.5
Name: steam-ungarbage
Version: 0.1.0
Summary: A utility to clean up Steam created link files.
Project-URL: Homepage, https://codeberg.org/hexzii/steam-ungarbage
Project-URL: Repository, https://codeberg.org/hexzii/steam-ungarbage
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: colorama
Description-Content-Type: text/markdown

# steam-ungarbage

This is a utility to clean steam created URL links and uninstall info on Windows, Linux and macOS.

This tool **does not** prevent Steam from creating those links, but is a great tool to clean these things up.

Currently tested on Windows and macOS.

## Why I am making this

Steam creates shortcut URLs (and uninstall info on Windows) that launches Steam upon clicking.

For me it offers no convenience and may cause more misclicks in daily usage. However, Steam does not offer an option to disable this.

After all, steam itself is a launcher, though.

## What are being cleaned

- **Windows**: Steam desktop & Start Menu `.url` shortcuts, Epic desktop `.url` shortcuts (`com.epicgames.launcher://`, Epic only writes to the desktop), and Steam `Steam App <appid>` uninstall entries in the registry
- **Linux**: `.desktop` files and icons created in the home data folders, and Desktop icons
- **macOS**: Pseudo `.app` files created under `~/Applications`

## Running

```bash
# Run from PIP
uvx steam-ungarbage # (or uv tool run steam-ungarbage)

# Run locally
uv run steam-ungarbage
```
