Metadata-Version: 2.4
Name: rutracker-games
Version: 5.0.1
Summary: RuTracker Games Browser — A TUI for browsing RuTracker.org game torrents
Author-email: Troli <contato@pablotroli.com>
Maintainer: rutracker-games contributors
License: MIT
License-File: LICENSE
Keywords: browser,cli,cross-platform,games,rutracker,terminal,torrent,tui
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Requires-Python: >=3.10
Requires-Dist: aiofiles>=23.2.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: certifi
Requires-Dist: rich>=13.7.0
Requires-Dist: urllib3>=2.0.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Description-Content-Type: text/markdown

# RuTrackGames — RuTracker Games Browser

Interactive TUI for browsing and searching torrents on [RuTracker.org](https://rutracker.org/forum/).

[![License](https://img.shields.io/pypi/l/rutracker-games)](LICENSE)
[![Downloads](https://static.pepy.tech/badge/rutracker-games)](https://pepy.tech/project/rutracker-games)

**Author:** DevTroli · **License:** MIT · **Version:** 5.0

<sub><a href="README.md">🇺🇸 English</a> | <a href="README_pt.md">🇧🇷 Português</a></sub>

---

## Installation

**Global (recommended):**
```bash
pip install rutracker-games
rutracker-games
```

**Development:**
```bash
git clone https://github.com/DevTroli/RuTrackGames.git && cd RuTrackGames
uv venv && uv pip install -r requirements.txt
uv run rl/rtgames.py
```

## Usage

```bash
rutracker-games                    # Interactive mode
rutracker-games -g "NieR"          # Direct search
rutracker-games --forum linux      # Linux-native only
rutracker-games -c                 # Full catalog
rutracker-games -r                 # Force refresh
```

## TUI Commands

| Command | Action |
|---------|--------|
| `<text>` | Search by name |
| `Enter` | List catalog |
| `s seeds|size|date|name` | Sort |
| `f linux|windows|mac` | Filter by platform |
| `n` / `p` | Next / previous page |
| `!info <n>` | Game details |
| `!open <n>` | Open torrent |
| `!refresh` | Refresh cache |
| `h` | Help · `q` | Quit |

## Features

- ⚡ Async: 24 concurrent connections (aiohttp)
- 📦 XDG cache in `~/.cache/rl/`
- 🔒 SSL/TLS + SSRF protection
- 🎨 Rich-colored TUI interface
- 🔍 Smart search: substring/AND matching

---

> Not affiliated with RuTracker.org. Use subject to [ToS](https://rutracker.org/forum/rules.php).
