# Quick Start Guide

## First Time Setup

1. **Configure your environment:**
   ```bash
   cp config.example.txt .env
   # Edit .env with your actual credentials and paths
   ```

2. **Enter development environment (Nix users):**
   ```bash
   nix develop
   ```

   **Or install dependencies (pip users):**
   ```bash
   pip install -r requirements.txt
   ```

## Quick Commands

### Movies
```bash
# Compare movie libraries
python compare_movies.py

# Analyze what's missing
python analyze_movies.py
```

### TV Series
```bash
# Compare series libraries
python compare_series.py

# Analyze what's missing
python analyze_series.py
```

## With Nix Flakes
```bash
nix run .#compare-movies
nix run .#analyze-movies
nix run .#compare-series
nix run .#analyze-series
```

## Output Files

- `movies_comparison_report.json` - Detailed movie data
- `series_comparison_report.json` - Detailed series data

## First Steps After Running

1. Check for `.plexignore` files (the scripts will warn you)
2. Review the analysis output for patterns
3. Force a Plex library scan if needed
4. Check Plex logs for scanner errors

## Common Fixes

- **Movies in `.plexignore`** → Remove entries, rescan Plex
- **Empty series directories** → Plex correctly ignores these
- **Old codecs (mpeg4, mpeg2)** → Re-encode or replace files
- **Low resolution** → Replace with HD versions
- **Title mismatches** → These are actually in Plex, just different names