Metadata-Version: 2.4
Name: autopahe
Version: 3.4.2
Summary: Cross-platform anime downloader for AnimePahe with advanced features: smart caching, cross-platform streaming, notifications, filters, batch downloads, and record management
Home-page: https://github.com/haxsysgit/autopahe
Author: haxsys
Author-email: haxsys <haxsysgit@users.noreply.github.com>
License: MIT License
        
        Copyright (c) [2023] [Arinze]
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/haxsysgit/autopahe
Project-URL: Repository, https://github.com/haxsysgit/autopahe
Project-URL: Issues, https://github.com/haxsysgit/autopahe/issues
Keywords: anime,downloader,animepahe,automation,cli
Classifier: Development Status :: 4 - Beta
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
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Requires-Dist: playwright>=1.45.0
Requires-Dist: tqdm>=4.66.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: rich>=13.0.0
Requires-Dist: beautifulsoup4>=4.12.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Provides-Extra: publish
Requires-Dist: build>=1.2.0; extra == "publish"
Requires-Dist: twine>=4.0.2; extra == "publish"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python


<!-- Badges -->
[![PyPI version](https://badge.fury.io/py/autopahe.svg)](https://pypi.org/project/autopahe/)
[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/haxsysgit/autopahe/)
[![License](https://img.shields.io/github/license/haxsysgit/autopahe?color=brightgreen)](https://github.com/haxsysgit/autopahe/blob/main/license.md)
[![OpenIssues](https://img.shields.io/github/issues/haxsysgit/autopahe?color=important)](https://github.com/haxsysgit/autopahe/issues)
<!--LineBreak-->
[![Windows](https://img.shields.io/badge/Windows-white?style=flat-square&logo=windows&logoColor=blue)](https://github.com/haxsysgit/autopahe/)
[![macOS](https://img.shields.io/badge/macOS-white?style=flat-square&logo=apple&logoColor=black)](https://github.com/haxsysgit/autopahe/)
[![Linux](https://img.shields.io/badge/Linux-white?style=flat-square&logo=linux&logoColor=black)](https://github.com/haxsysgit/autopahe/)
<!-- Badges -->

# AutoPahe

> **Download and stream anime episodes easily from AnimePahe**

A simple yet powerful tool to search, download, and stream your favorite anime episodes. Works on Windows, Mac, and Linux with a beautiful, colorful interface.

## ✨ New in v3.4

## 🧩 Configuration fixes (v3.4.1)

- **Config resolution/quality is now robust**
  - Accepts `480`, `720`, `1080` (also `360`, `best`, `worst`)
  - Accepts values like `1080p`
  - Inline comments like `resolution = 1080  # comment` are supported
  - Invalid values no longer break config loading (falls back to `720` with a warning)

- **New command: `autopahe config edit`**
  - Open your config in `$EDITOR` (creates a sample config if missing)
  - Print config: `autopahe config show`
  - Validate config: `autopahe config validate`

### 📚 **New Modular Collection System**
- **Complete collection package** - New `collection/` module with full metadata support
- **Enhanced AnimeEntry model** - Now includes type, year, genres, synopsis, and ratings
- **Rich collection commands** - stats, view, show, episodes, search, organize, duplicates, export, import
- **Watch status tracking** - Track anime as unwatched, watching, completed, on hold, dropped, or plan to watch
- **Powerful search and filtering** - Find anime by title, type, status, genres, and more

### 🚀 **Interactive First-Time Setup**
- **Automatic browser installation** - Prompts to install Playwright browsers on first run
- **Smart fallback system** - Tries Chrome first, then Chromium if needed
- **Seamless onboarding** - No more manual setup requirements for new users
- **Environment control** - Skip auto-install with `AUTOPAHE_SKIP_AUTO_INSTALL` environment variable

### 🛠️ **Technical Improvements**
- **Modular architecture** - Replaced old collection_manager.py with new collection/ package
- **Enhanced data models** - Better type safety and data validation
- **Improved import/export** - Backup and restore your collection data
- **Better error handling** - More robust collection management

## 🎯 What It Does

- **Search Anime** - Find any anime by name with smart suggestions
- **Download Episodes** - Get single episodes or entire seasons
- **Fast Downloads** - Download multiple episodes at once
- **Resume Downloads** - Pick up where you left off if interrupted
- **Organize Collection** - Keep your downloaded anime neatly organized
- **Desktop Notifications** - Get alerts when downloads finish

## 🚀 Quick Start

### Installation

#### 🚀 **Easiest Setup (Recommended)**
```bash
# Clone and run our automated installer
git clone https://github.com/haxsysgit/autopahe.git
cd autopahe
python install.py
```

#### 📦 **Alternative Methods**

**Using UV (fastest):**
```bash
git clone https://github.com/haxsysgit/autopahe.git
cd autopahe
uv sync
uv run playwright install
```

**Using pip:**
```bash
git clone https://github.com/haxsysgit/autopahe.git
cd autopahe
pip install -r requirements.txt
playwright install
```

**From PyPI:**
```bash
pip install autopahe
autopahe --setup  # Required first-time setup
```

### 🔧 First-Time Setup (Required)

After installation, run the setup command once to install browser engines:

```bash
autopahe --setup
```

This installs Playwright browsers (~500MB) needed for bypassing DDoS protection. You only need to do this once.

### Basic Usage
```bash
# Search for anime
autopahe -s "your anime name"

# Download a single episode
autopahe -s "anime name" -i 0 -d 1

# Download entire season
autopahe -s "anime name" -i 0 -md 1-12
```
## 📖 More Examples

### Download Different Quality
```bash
# Download in 1080p (best quality)
autopahe -s "anime name" -i 0 -d 1 -p 1080

# Download in 360p (smaller file size)
autopahe -s "anime name" -i 0 -d 1 -p 360
```

### Download Multiple Episodes
```bash
# Download episodes 1, 3, and 5
autopahe -s "anime name" -i 0 -md "1,3,5"

# Download episodes 1 through 12
autopahe -s "anime name" -i 0 -md "1-12"

# Download with faster parallel downloads
autopahe -s "anime name" -i 0 -md "1-12" --workers 3

# Download English dubbed versions (if available)
autopahe -s "anime name" -i 0 -md "1-12" --dub
```

### 🎬 Stream Anime Episodes
```bash
# Stream episode 1 directly (auto-detects player)
autopahe -s "anime name" -i 0 -st 1

# Stream with specific player
autopahe -s "anime name" -i 0 -st 1 --player vlc
autopahe -s "anime name" -i 0 -st 1 --player mpv

# Stream multiple episodes
autopahe -s "anime name" -i 0 -st "1-3"

# Stream in different quality
autopahe -s "anime name" -i 0 -st 1 -p 1080

# Stream English dubbed versions (if available)
autopahe -s "anime name" -i 0 -st 1 --dub
```

**Supported Players:**
- **Windows**: VLC, MPV, Windows Media Player, MPC-HC, MPC-BE
- **macOS**: VLC, MPV, Iina
- **Linux**: VLC, MPV, MPlayer, SMPlayer, Celluloid

**If no player is found, AutoPahe will:**
- Show installation instructions for your OS
- Suggest available players
- Guide you through setup

### Get Download Links Only
```bash
# Get the download link without downloading
autopahe -s "anime name" -i 0 -l 1
```

## 💡 Tips

- Use quotes around anime names with spaces: `"Attack on Titan"`
- The first time you run it, it may take a moment to set up
- Downloads go to your `Downloads/Anime` folder by default
- Use `--verbose` to see detailed information while downloading
- Use `--quiet` to see minimal output

## 🛠️ What You Need

- Python 3.8 or higher
- Internet connection
- About 500MB of free space for setup

**That's it!** The tool handles everything else automatically.

## 🎨 Beautiful Interface

AutoPahe features a colorful, organized interface that looks like a webpage:
- Clean section headers with progress indicators
- Colored text for easy reading
- Organized layout with proper spacing
- No technical clutter - just what you need

## 📱 Works Everywhere

- **Windows** - Full support with desktop notifications
- **Mac** - Native integration and notifications  
- **Linux** - Complete functionality

## 🆘 Need Help?

If you run into any issues:
1. Make sure you have Python 3.8 or higher
2. Check your internet connection
3. Try using quotes around anime names with spaces

For more help, visit our GitHub page or report an issue.

---

## 📜 License

This project is licensed under the MIT License - see the [LICENSE](license.md) file for details.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 📞 Support

If you need help or have questions, visit our [GitHub Issues](https://github.com/haxsysgit/autopahe/issues) page.

## 🔧 Advanced Usage

For power users who want more control and features, see our [Advanced Usage Guide](ADVANCED.md) which covers:

- **Detailed command reference** with all available options
- **Configuration system** for customizing settings
- **Batch operations** and parallel downloads
- **Record management** for tracking your anime collection
- **File organization** and sorting options
- **Performance tuning** and troubleshooting

---

**Enjoy AutoPahe! 🎬**
