AutoPahe

A powerful, cross-platform anime downloader for AnimePahe with advanced features

Automatic anime search, download, and management with support for parallel downloads, desktop notifications, smart caching, filtering, and comprehensive record tracking. Fully cross-platform (Windows, macOS, Linux).

✨ Key Features

🔍 Smart Search with year and status filters
📦 Batch/Season Downloads - Download entire seasons with one command
🚀 Parallel Downloads - Speed up with multi-threaded downloads
🔔 Desktop Notifications - Get notified when downloads complete (Windows/macOS/Linux)
💾 Smart Caching - Faster repeat searches with automatic API caching
📊 Progress Tracking - Visual progress bars for multi-episode downloads
🗂️ Record Management - Track watching progress, ratings, and status
⚙️ Configuration System - Save your preferences in a config file
🎯 Auto-Sorting - Automatically organize downloaded files
🌐 Cross-Platform - Works on Windows, macOS, and Linux
📝 Detailed Logging - Verbose and quiet modes available
🍪 Session Persistence - Reduced DDoS-Guard friction with cookie caching

📋 Requirements

System Requirements

Python 3.8+
Web Browser: Firefox or Chrome/Chromium
WebDriver: geckodriver (Firefox) or chromedriver (Chrome)

Python Dependencies

pip install selenium beautifulsoup4 requests tqdm lxml

WebDriver Installation

Linux (Ubuntu/Debian):

# Firefox (geckodriver)
sudo apt install firefox-geckodriver

# Chrome (chromedriver)
sudo apt install chromium-chromedriver

macOS (Homebrew):

# Firefox
brew install geckodriver

# Chrome
brew install chromedriver

Windows:

Download geckodriver or chromedriver
Add to PATH or place in project directory

🚀 Quick Start

Installation

Clone the repository:

git clone https://github.com/haxsysgit/autopahe.git
cd autopahe

Install dependencies:

pip install -r requirements.txt

Install WebDriver (see requirements above)
Run the script:

python3 auto_pahe.py --help

First Use Example

# Search for an anime
python3 auto_pahe.py -s "Naruto"

# Select and download episode 1
python3 auto_pahe.py -s "Naruto" -i 0 -d 1

# Download multiple episodes
python3 auto_pahe.py -s "Naruto" -i 0 -md "1-5"

📖 Usage

Basic Commands

# Search for anime
python3 auto_pahe.py -s "Anime Name"

# Search with filters
python3 auto_pahe.py -s "Naruto" --year 2007 --status "Finished"

# Select anime from results (index 0 = first result)
python3 auto_pahe.py -s "Naruto" -i 0

# Download single episode
python3 auto_pahe.py -s "Naruto" -i 0 -d 1

# Download multiple episodes
python3 auto_pahe.py -s "Naruto" -i 0 -md "1-5"
python3 auto_pahe.py -s "Naruto" -i 0 -md "1,3,5-8,10"

# Download entire season (12-13 episodes)
python3 auto_pahe.py -s "Naruto" -i 0 --season 1

# Parallel downloads (use with caution)
python3 auto_pahe.py -s "Naruto" -i 0 -md "1-10" -w 2

# With desktop notifications
python3 auto_pahe.py -s "Naruto" -i 0 -md "1-5" --notify

Advanced Features

📊 Records Management

# View all records
python3 auto_pahe.py -R view

# Search records
python3 auto_pahe.py -R search "naruto"

# Update progress
python3 auto_pahe.py -R progress "Naruto" 27

# Rate anime
python3 auto_pahe.py -R rate "Naruto" 9.5

# Export records
python3 auto_pahe.py -R export backup.json json
python3 auto_pahe.py -R export records.csv csv

# Import records
python3 auto_pahe.py -R import backup.json

# Delete record
python3 auto_pahe.py -R delete "Naruto"

# List by status
python3 auto_pahe.py -R list-status completed

🗂️ File Sorting

# Sort downloaded files
python3 auto_pahe.py --sort all --sort-path ~/Downloads

# Dry run (preview changes)
python3 auto_pahe.py --sort all --sort-dry-run

# Rename only
python3 auto_pahe.py --sort rename

# Organize into folders
python3 auto_pahe.py --sort organize

💾 Cache Management

# View cache statistics
python3 auto_pahe.py --cache stats

# Clear cache and cookies
python3 auto_pahe.py --cache clear

📈 Execution Statistics

# Today's stats
python3 auto_pahe.py -dt "today"

# This week
python3 auto_pahe.py --summary "this week"

# All time
python3 auto_pahe.py --summary "all"

# Date range
python3 auto_pahe.py --summary "from 2025-11-01 to 2025-11-30"

💡 Example Workflows

Basic Workflow

# 1. Search
python3 auto_pahe.py -s "One Piece"

# 2. Select (index 0 = first result)
python3 auto_pahe.py -s "One Piece" -i 0

# 3. Download episode 1
python3 auto_pahe.py -s "One Piece" -i 0 -d 1

Advanced Workflow

# Search with filters
python3 auto_pahe.py -s "Naruto" --year 2007 --status "Finished Airing"

# Download season 1 with notifications and parallel downloads
python3 auto_pahe.py -s "Naruto" -i 0 --season 1 -w 2 --notify

# Auto-sort after download (if configured)
# Files automatically organized into folders

Record Management Workflow

# After downloading, update your records
python3 auto_pahe.py -R progress "Naruto" 12
python3 auto_pahe.py -R rate "Naruto" 9.0

# Check what you're watching
python3 auto_pahe.py -R list-status "watching"

# Export for backup
python3 auto_pahe.py -R export ~/anime_backup.json json

🎯 Complete Command Reference

Search & Download

Flag	Description
`-s, --search TEXT`	Search for anime by name
`-i, --index INT`	Select anime from search results
`-d, --single_download INT`	Download single episode
`-md, --multi_download TEXT`	Download multiple episodes (e.g., "1-5,7,10-12")
`-l, --link`	Display download link (no download)
`-ml, --multilinks`	Display multiple download links
`-a, --about`	Show anime overview

Options

Flag	Description
`-b, --browser TEXT`	Browser choice (firefox\|chrome)
`-p, --resolution TEXT`	Preferred resolution (480\|720\|1080)
`-w, --workers INT`	Parallel workers for downloads (default: 1)

🔍 Search Filters (NEW)

Flag	Description
`--year INT`	Filter search results by release year
`--status TEXT`	Filter search results by status

📦 Batch Downloads (NEW)

Flag	Description
`--season INT`	Download entire season (e.g., --season 1 = eps 1-12)

🔔 Notifications (NEW)

Flag	Description
`--notify`	Enable desktop notifications on completion

📊 Records Management

Flag	Description
`-r, --record TEXT`	Basic record access (view, index, keyword)
`-R, --records ...`	Advanced management (see subcommands below)

-R Subcommands:

view - List all records
search <query> - Search records
delete <id\|title> - Delete record
progress <id\|title> <episode> - Update progress
rate <id\|title> <0-10> - Set rating
rename <id\|title> <new_title> - Rename
set-keyword <id\|title> <keyword> - Update keyword
list-status <status> - Filter by status
export <path> [json\|csv] - Export records
import <path> - Import records

🗂️ File Sorting

Flag	Description
`--sort {all\|rename\|organize}`	Sort downloaded files
`--sort-path PATH`	Directory to sort (default: Downloads)
`--sort-dry-run`	Preview changes without applying

💾 Cache Management (NEW)

Flag	Description
`--cache {clear\|stats}`	Manage disk cache and cookies

📈 Statistics

Flag	Description
`-dt, --execution_data TEXT`	Execution stats for periods
`--summary TEXT`	Stats + records summary

📝 Logging (NEW)

Flag	Description
`--verbose`	Enable DEBUG logging (detailed)
`--quiet`	Enable WARNING logging (minimal)

⚙️ Configuration

Flag	Description
`--config PATH`	Load configuration from file
`--write-config [PATH]`	Generate sample config file

⚙️ Configuration

Create a config file to save your preferences:

# Generate sample config
python3 auto_pahe.py --write-config

# Edit ~/.config/autopahe/config.ini

Sample Configuration:

[defaults]
# Browser: firefox or chrome
browser = firefox

# Resolution: 480, 720, 1080
resolution = 1080

# Workers for parallel downloads (1 = sequential)
workers = 2

# Custom download directory (optional)
download_dir = /home/user/Videos/Anime

# Auto-sort after downloads
sort_on_complete = true
sort_mode = all

# Custom sort directory (optional)
sort_path =

Config is loaded automatically from:

~/.config/autopahe/config.ini
~/.autopahe.ini
./autopahe.ini

Or specify custom location: --config /path/to/config.ini

🚀 Performance Features

Smart Caching

API Response Caching: 6-hour cache for faster repeat searches
Cookie Persistence: 24-hour session cookies reduce DDoS-Guard challenges
Auto-cleanup: Old cache entries removed automatically

Parallel Downloads

Download multiple episodes simultaneously with -w/--workers
Safe staggering prevents port conflicts
Warning: May trigger DDoS-Guard protection. Use -w 1 for stability.

Progress Tracking

Visual progress bars for multi-episode downloads (requires tqdm)
Real-time completion status
Failed episode tracking

🔔 Desktop Notifications

Get notified when downloads complete or fail:

Linux: Uses notify-send (libnotify)

sudo apt install libnotify-bin  # Ubuntu/Debian

macOS: Uses AppleScript (built-in)

Windows: Uses PowerShell toast notifications (built-in)

Enable with --notify flag.

🗂️ File Organization

Automatic Sorting

Integrates pahesort functionality:

Rename: Clean up AnimePahe filenames
Organize: Group episodes into anime folders
Auto-sort: Enable in config for automatic organization

Manual Sorting

# Preview changes
python3 auto_pahe.py --sort all --sort-dry-run

# Apply sorting
python3 auto_pahe.py --sort all --sort-path ~/Downloads

📝 Logging

Control output verbosity:

# Normal logging (INFO)
python3 auto_pahe.py -s "Naruto" -i 0 -d 1

# Verbose logging (DEBUG) - shows cache hits, API calls, etc.
python3 auto_pahe.py -s "Naruto" -i 0 -d 1 --verbose

# Quiet logging (WARNING) - errors only
python3 auto_pahe.py -s "Naruto" -i 0 -d 1 --quiet

Logs saved to autopahe.log in current directory.

🌐 Cross-Platform Support

Windows

✅ Full support with Firefox or Chrome
✅ Desktop notifications via PowerShell
✅ Automatic driver detection
📝 Install drivers to PATH or project directory

macOS

✅ Full support with Firefox or Chrome
✅ Desktop notifications via AppleScript
✅ Homebrew driver installation
📝 Use brew install geckodriver or chromedriver

Linux

✅ Full support on all distros
✅ Desktop notifications via notify-send
✅ Package manager driver installation
📝 Tested on Ubuntu, Debian, Fedora, Arch

📚 Documentation

Detailed documentation in the repository:

ALL_PHASES_DOCUMENTATION.txt - Complete feature guide
CONFIG_DOCUMENTATION.txt - Configuration system details
TESTING_GUIDE.txt - Comprehensive testing procedures
PHASE2_CHANGES_SUMMARY.txt - Implementation changelog

⚠️ Important Notes

DDoS-Guard Protection

AnimePahe uses DDoS-Guard protection
Script includes bypass mechanism (refresh + implicit wait)
Parallel downloads may trigger protection - use cautiously
Persistent cookies help reduce challenges
If blocked, wait a few minutes and try again

Download Quality

Default: 720p (configurable)
Available: 480p, 720p, 1080p
Script selects best available quality if preferred not available

Resume Support

Partial downloads automatically resumed
Uses HTTP Range headers
Safe to interrupt and restart

🤝 Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

⚖️ License

See license.md for details.

🙏 Credits

Created by haxsys

Built with:

AnimePahe - Anime source
Selenium - Browser automation
BeautifulSoup - HTML parsing
Requests - HTTP library

📞 Support

Issues: GitHub Issues
Questions: Open a discussion or issue
Updates: Watch the repository for new releases

Enjoy AutoPahe! 🎬

Name		Name	Last commit message	Last commit date
Latest commit History 46 Commits
__pycache__		__pycache__
ap_core		ap_core
features		features
imgs		imgs
.gitignore		.gitignore
.python-version		.python-version
COMMIT_MESSAGE.txt		COMMIT_MESSAGE.txt
README.md		README.md
auto_pahe.py		auto_pahe.py
kwikdown.py		kwikdown.py
license.md		license.md
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
uv.lock		uv.lock

License

haxsysgit/autopahe

Folders and files

Latest commit

History

Repository files navigation

AutoPahe

✨ Key Features

📋 Requirements

System Requirements

Python Dependencies

WebDriver Installation

🚀 Quick Start

Installation

First Use Example

📖 Usage

Basic Commands

Advanced Features

📊 Records Management

🗂️ File Sorting

💾 Cache Management

📈 Execution Statistics

💡 Example Workflows

Basic Workflow

Advanced Workflow

Record Management Workflow

🎯 Complete Command Reference

Search & Download

Options

🔍 Search Filters (NEW)

📦 Batch Downloads (NEW)

🔔 Notifications (NEW)

📊 Records Management

🗂️ File Sorting

💾 Cache Management (NEW)

📈 Statistics

📝 Logging (NEW)

⚙️ Configuration

⚙️ Configuration

🚀 Performance Features

Smart Caching

Parallel Downloads

Progress Tracking

🔔 Desktop Notifications

🗂️ File Organization

Automatic Sorting

Manual Sorting

📝 Logging

🌐 Cross-Platform Support

Windows

macOS

Linux

📚 Documentation

⚠️ Important Notes

DDoS-Guard Protection

Download Quality

Resume Support

🤝 Contributing

⚖️ License

🙏 Credits

📞 Support

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Packages