pakt 0.1.0__tar.gz

pakt-0.1.0/.claude/CLAUDE.md

@@ -0,0 +1,83 @@
+# Pakt - Plex-Trakt Sync Tool
+
+Python CLI/web app that syncs watched status and ratings between Plex and Trakt using batch API operations.
+
+## Architecture
+
+- **sync.py** - SyncEngine with 4-phase sync (fetch, index, compare, apply)
+- **cli.py** - Click-based CLI
+- **web/app.py** - FastAPI endpoints
+- **web/templates/index.html** - Single-page web UI
+- **trakt.py** - Async Trakt API client with VIP limit handling
+- **plex.py** - PlexAPI wrapper with media metadata extraction
+- **config.py** - Pydantic settings with env file support
+- **scheduler.py** - APScheduler-based automatic sync
+- **tray.py** - pystray system tray integration (Windows)
+
+## Implemented Features
+
+- CLI commands: sync, login, logout, setup, status, libraries, serve, clear-cache
+- Web UI with tabbed interface (Sync, Stats, Settings views)
+- Batch API operations for Trakt (single calls for all watched/ratings)
+- Batch episode fetch from Plex (searchEpisodes() instead of per-show calls)
+- Bidirectional sync: movies watched, movie ratings, episode watched, episode ratings
+- Library selection (CLI and web UI)
+- File logging to ~/.config/pakt/sync.log
+- OAuth device flow for Trakt auth
+- Progress reporting to web UI console
+- **Collection sync** (Plex → Trakt) with full media metadata:
+  - Resolution (4K, 1080p, 720p, etc.)
+  - HDR type (Dolby Vision, HDR10, HDR10+, HLG)
+  - Audio codec (Atmos, TrueHD, DTS-X, DTS-HD MA, etc.)
+  - Best quality version scoring when multiple versions exist
+- **Watchlist sync** (bidirectional):
+  - Plex → Trakt watchlist
+  - Trakt → Plex watchlist (uses Plex Discover for items not in library)
+- **Scheduled sync** via APScheduler:
+  - Configurable interval (hours)
+  - Enable/disable via web UI
+  - Automatic startup with server
+- **System tray icon** (Windows, optional):
+  - Double-click to open web UI
+  - Right-click menu: Open Web UI, Sync Now, Exit
+  - `pakt serve --tray` or `--no-tray` flags
+- **Trakt VIP/Free account handling**:
+  - Detects VIP status via `/users/settings` endpoint
+  - Free users limited to 100 items in collection/watchlist
+  - Warns and skips sync if at limit (prevents HTTP 420 errors)
+  - Catches `TraktAccountLimitError` gracefully with upgrade URL
+  - API endpoint `/api/trakt/account` returns VIP status and limits
+
+## Trakt Account Limits (Jan 2025)
+
+Free users have 100 item limit on:
+- Collection (movies + shows combined)
+- Watchlist
+- Personal lists (2 lists max, 100 items each)
+
+VIP users have unlimited. Sync will:
+1. Check limits before attempting collection/watchlist sync
+2. Skip sync with warning if already at limit
+3. Catch HTTP 420 errors and log upgrade URL
+
+## Current State
+
+All features implemented including VIP handling. Ready for testing.
+
+## Next Steps
+
+1. Test collection sync with real data (VIP and non-VIP)
+2. Test watchlist sync bidirectionally
+3. Test scheduler functionality
+4. Show ratings sync (currently only episode ratings, not show-level)
+5. Add VIP status indicator to web UI
+
+## Testing
+
+```bash
+pip install -e .              # Basic install
+pip install -e ".[tray]"      # With system tray support
+pakt serve                    # Web UI at http://localhost:8080
+pakt serve --tray             # With system tray icon
+pakt sync --dry-run
+```

pakt-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Cache/config (user-specific)
+.env
+*.db
+*.sqlite
+
+# OS
+.DS_Store
+Thumbs.db

pakt-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: pakt
+Version: 0.1.0
+Summary: Fast, efficient Plex-Trakt sync using batch API operations
+Project-URL: Repository, https://github.com/MikeSiLVO/pakt
+Author: MikeSiLVO
+License: MIT
+Keywords: media,plex,scrobble,sync,trakt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: apscheduler>=3.10.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: plexapi>=4.15.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: uvicorn>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Provides-Extra: tray
+Requires-Dist: pillow>=10.0.0; extra == 'tray'
+Requires-Dist: pystray>=0.19.0; extra == 'tray'
+Description-Content-Type: text/markdown
+
+# <img src="src/pakt/assets/icon.png" width="32" alt=""> Pakt
+
+Sync watched status, ratings, and collections between Plex and Trakt.
+
+## Installation
+
+```bash
+pip install pakt
+```
+
+With system tray support (Windows):
+```bash
+pip install pakt[tray]
+```
+
+## Quick Start
+
+```bash
+pakt setup    # Interactive setup wizard
+pakt sync     # Run sync
+```
+
+## Commands
+
+```bash
+pakt setup              # Configure Plex and Trakt
+pakt sync               # Sync everything
+pakt sync --dry-run     # Preview without changes
+pakt sync --verbose     # Show detailed item list
+pakt serve              # Start web interface
+pakt serve --tray       # Web interface with system tray (Windows)
+pakt status             # Show configuration
+pakt libraries          # Manage library selection
+pakt login              # Authenticate with Trakt
+pakt logout             # Clear Trakt authentication
+```
+
+## Web Interface
+
+Start the web UI:
+```bash
+pakt serve
+```
+
+Open http://localhost:8080 in your browser.
+
+Features:
+- Run syncs with progress display
+- Configure sync options
+- View Trakt account status
+- Set up scheduled syncs
+- Select which libraries to sync
+
+## Background Mode (Windows)
+
+Run without a console window:
+```bash
+pythonw -m pakt serve --tray
+```
+
+## What Gets Synced
+
+| Data | Plex → Trakt | Trakt → Plex |
+|------|:------------:|:------------:|
+| Watched status | ✓ | ✓ |
+| Ratings | ✓ | ✓ |
+| Collection | ✓ | - |
+| Watchlist | ✓ | ✓ |
+
+Collection sync includes media info (resolution, HDR, audio codec).
+
+## Configuration
+
+Config location:
+- Windows: `%APPDATA%\pakt`
+- Linux/macOS: `~/.config/pakt`
+
+## Trakt Account Limits
+
+Free Trakt accounts have a 100-item limit on collections and watchlists. Pakt will warn you if you hit these limits. Upgrade to [Trakt VIP](https://trakt.tv/vip) for unlimited.
+
+## License
+
+MIT

pakt-0.1.0/README.md

@@ -0,0 +1,84 @@
+# <img src="src/pakt/assets/icon.png" width="32" alt=""> Pakt
+
+Sync watched status, ratings, and collections between Plex and Trakt.
+
+## Installation
+
+```bash
+pip install pakt
+```
+
+With system tray support (Windows):
+```bash
+pip install pakt[tray]
+```
+
+## Quick Start
+
+```bash
+pakt setup    # Interactive setup wizard
+pakt sync     # Run sync
+```
+
+## Commands
+
+```bash
+pakt setup              # Configure Plex and Trakt
+pakt sync               # Sync everything
+pakt sync --dry-run     # Preview without changes
+pakt sync --verbose     # Show detailed item list
+pakt serve              # Start web interface
+pakt serve --tray       # Web interface with system tray (Windows)
+pakt status             # Show configuration
+pakt libraries          # Manage library selection
+pakt login              # Authenticate with Trakt
+pakt logout             # Clear Trakt authentication
+```
+
+## Web Interface
+
+Start the web UI:
+```bash
+pakt serve
+```
+
+Open http://localhost:8080 in your browser.
+
+Features:
+- Run syncs with progress display
+- Configure sync options
+- View Trakt account status
+- Set up scheduled syncs
+- Select which libraries to sync
+
+## Background Mode (Windows)
+
+Run without a console window:
+```bash
+pythonw -m pakt serve --tray
+```
+
+## What Gets Synced
+
+| Data | Plex → Trakt | Trakt → Plex |
+|------|:------------:|:------------:|
+| Watched status | ✓ | ✓ |
+| Ratings | ✓ | ✓ |
+| Collection | ✓ | - |
+| Watchlist | ✓ | ✓ |
+
+Collection sync includes media info (resolution, HDR, audio codec).
+
+## Configuration
+
+Config location:
+- Windows: `%APPDATA%\pakt`
+- Linux/macOS: `~/.config/pakt`
+
+## Trakt Account Limits
+
+Free Trakt accounts have a 100-item limit on collections and watchlists. Pakt will warn you if you hit these limits. Upgrade to [Trakt VIP](https://trakt.tv/vip) for unlimited.
+
+## License
+
+MIT

pakt-0.1.0/pyproject.toml

@@ -0,0 +1,69 @@
+[project]
+name = "pakt"
+version = "0.1.0"
+description = "Fast, efficient Plex-Trakt sync using batch API operations"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [
+    {name = "MikeSiLVO"}
+]
+keywords = ["plex", "trakt", "sync", "media", "scrobble"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+]
+dependencies = [
+    "httpx>=0.27.0",
+    "plexapi>=4.15.0",
+    "click>=8.1.0",
+    "rich>=13.0.0",
+    "pydantic>=2.0.0",
+    "pydantic-settings>=2.0.0",
+    "aiosqlite>=0.19.0",
+    "fastapi>=0.110.0",
+    "uvicorn>=0.27.0",
+    "jinja2>=3.1.0",
+    "apscheduler>=3.10.0",
+]
+
+[project.optional-dependencies]
+tray = [
+    "pystray>=0.19.0",
+    "Pillow>=10.0.0",
+]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "ruff>=0.3.0",
+]
+
+[project.scripts]
+pakt = "pakt.cli:main"
+
+[project.urls]
+Repository = "https://github.com/MikeSiLVO/pakt"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pakt"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

pakt-0.1.0/src/pakt/__init__.py

@@ -0,0 +1,3 @@
+"""Pakt - Fast, efficient Plex-Trakt sync."""
+
+__version__ = "0.1.0"

pakt-0.1.0/src/pakt/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m pakt."""
+
+from pakt.cli import main
+
+if __name__ == "__main__":
+    main()

pakt-0.1.0/src/pakt/assets/icon.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1"/>
+      <stop offset="100%" style="stop-color:#8b5cf6"/>
+    </linearGradient>
+  </defs>
+  <circle cx="128" cy="128" r="120" fill="url(#bg)"/>
+  <text x="128" y="165" font-family="Inter, -apple-system, sans-serif" font-size="140" font-weight="600" fill="white" text-anchor="middle">P</text>
+</svg>