misato 0.9.5

MissAV video downloader

misato

MissAV video downloader with multi-threading, resume support, and Cloudflare bypass.

Installation

pip install misato

Prerequisites

1. Chrome — set the MISATO_CHROME_EXE environment variable (defaults to C:\Program Files\Google\Chrome\Application\chrome.exe):

set MISATO_CHROME_EXE="C:\Program Files\Google\Chrome\Application\chrome.exe"

2. Chrome Profile (optional) — misato uses a dedicated Chrome profile at C:\workspace\chrome_auto_userdata by default. You can customize it via MISATO_CHROME_USER_DATA_DIR:

   Important: Do NOT point this at your everyday Chrome profile (%LOCALAPPDATA%\Google\Chrome\User Data). Chrome locks the profile directory while running, so misato cannot launch a second instance with the same profile. Always use a separate, dedicated directory.

   set MISATO_CHROME_USER_DATA_DIR="D:\misato_profile"
   

3. FFmpeg (optional, recommended) — for merging video segments and embedding cover thumbnails. https://ffmpeg.org/

Usage

# Download a single video
misato -auto "https://missav.ai/dm87/pppd-695" -ffcover -title

# Search and download
misato -search PPPD-695 -ffcover -title

# Batch download a playlist
misato -auto "https://missav.ai/dm132/actresses/JULIA" -limit 20 -ffmpeg

# Download from a URL list file
misato -file urls.txt -title

# Use a proxy
misato -auto "..." -proxy localhost:7890

Options

Option	Description
-auto URL [URL ...]	Video or playlist URLs (can be mixed)
-search CODE	Search by video code (e.g. PPPD-695)
-file PATH	Read URLs from a text file (one per line)
-limit N	Maximum number of videos to download
-proxy host:port	HTTP/HTTPS proxy
-ffmpeg	Merge segments with FFmpeg
-cover	Download cover image
-ffcover	Cover + FFmpeg merge + embed as video thumbnail
-title	Use full video title as filename
-quality 720	Preferred resolution (defaults to highest)
-noban	Suppress the ASCII art banner
-retry N	Retries per segment (default: 5)
-delay N	Delay between retries in seconds (default: 2)
-timeout N	Timeout per segment in seconds (default: 10)
-threads N	Number of download threads (default: CPU core count)

Supported playlist URLs

-auto accepts the following URL types:

• Search filters: "https://missav.ai/search/JULIA?filters=uncensored-leak&sort=saved"
• Actress pages: "https://missav.ai/dm132/actresses/JULIA"
• Label pages: "https://missav.ai/dm21/en/makers/Takara%20Visual"
• Genre/tag pages: "https://missav.ai/dm1/en/genres/4K"
• Public playlists: "https://missav.ai/playlists/ewzoukev"

Wrap URLs containing spaces or special characters in double quotes.

Features

• Multi-threaded — concurrent segment downloads (uses all CPU cores by default)
• Resume — interrupted downloads pick up where they left off
• Auto-retry — failed segments are retried with doubled persistence
• Connection pooling — TLS fingerprint impersonation to bypass Cloudflare
• Live progress — progress bar with download speed and ETA

Disclaimer

This project is provided for educational and communication purposes only. It is intended to facilitate learning and technical exchange. Users are solely responsible for ensuring that their use of this software complies with all applicable laws and regulations in their jurisdiction.

• Do not use this software to download or distribute copyrighted material without proper authorization from the rights holders.
• Do not use this software to engage in any activity that violates local, national, or international laws.
• The developers assume no liability for any misuse of this software or any consequences arising from its use.

By using this software, you acknowledge that you have read and understood this disclaimer and agree to use it in a lawful and responsible manner.

See LICENSE for details.