miyuki

Revived tool for downloading videos from MissAV website, with Cloudflare support.

0.8.1

PyPI

Maintainers: 1

⭐️ Miyuki-Reborn

This is a fork/revived version of the original Miyuki tool by MiyukiQAQ due to the original page being deleted.

A tool for downloading videos from the "MissAV" website. This is provided under the MIT license.

✅ Changes

Cloudflare Bypass: Replaced the original HTTP client with cloudscraper to handle JavaScript challenges and access missav.ai.
Updated Video Metadata Extraction:
- Modified MATCH_UUID_PATTERN to locate video info in obfuscated JavaScript (eval block).
- Updated parsing logic (_fetch_metadata) to extract components and reconstruct the new hyphenated UUID format.
Improved Page Type Detection: Ensured _is_movie_url uses the updated pattern and re.DOTALL to correctly identify video pages post-Cloudflare.
Code Refactoring & Dependency Update: Integrated cloudscraper throughout (VideoDownloader, UrlSource subclasses), removed http_client.py, and added cloudscraper to requirements.txt.
Bug Fixes: Corrected various import and logic errors encountered during the update process.

⚙️ Installation

Clone the repository:

git clone https://github.com/notmiyukisasaki/Miyuki-Reborn.git

Navigate into the project directory:

cd Miyuki-Reborn

Install required dependencies:

pip install -r requirements.txt

(Optional but Recommended) Ensure FFmpeg is installed and accessible in your system's PATH if you plan to use the -ffmpeg or -ffcover options.

📖 Instructions

[root@miyuki ~]# miyuki -h
usage: main.py [-h] [-auto  [...]] [-auth  [...]] [-limit] [-search] [-file] [-proxy] [-ffmpeg] [-cover] [-ffcover] [-noban] [-title] [-quality] [-retry] [-delay] [-timeout]

A tool for downloading videos from the "MissAV" website.

Main Options:
Use the -auto   option to specify the video or playlist URLs to download. can be mixed.
Use the -auth   option to specify the username and password to download the videos collected by the account.
Use the -search option to search for movie by serial number and download it.
Use the -file   option to download video or playlist URLs in the file. ( Each line is a URL )

Additional Options:
Use the -limit   option to limit the number of downloads. 
Use the -proxy   option to configure http proxy server ip and port.
Use the -ffmpeg  option to get the best video quality. ( Recommend! )
Use the -cover   option to save the cover when downloading the video
Use the -ffcover option to set the cover as the video preview (ffmpeg required)
Use the -noban   option to turn off the miyuki banner when downloading the video
Use the -title   option to use the full title as the movie file name
Use the -quality option to specify the movie resolution (360, 480, 720, 1080...)
Use the -retry   option to specify the number of retries for downloading segments
Use the -delay   option to specify the delay before retry ( seconds )
Use the -timeout option to specify the timeout for segment download ( seconds )

options:
  -h, --help     show this help message and exit
  -auto  [ ...]  Multiple movie and playlist URLs can be mixed. separate with spaces
  -auth  [ ...]  Username and password, separate with space
  -limit         Limit the number of downloads
  -search        Movie serial number
  -file          File path
  -proxy         HTTP(S) proxy
  -ffmpeg        Enable ffmpeg processing
  -cover         Download video cover
  -ffcover       Set cover as preview (ffmpeg required)
  -noban         Do not display the banner
  -title         Full title as file name
  -quality       Specify the movie resolution
  -retry         Number of retries for downloading segments
  -delay         Delay in seconds before retry
  -timeout       Timeout in seconds for segment download

Examples:
  miyuki -auto "https://missav.ai/sw-950" "https://missav.ai/dm132/actresses/JULIA"
  miyuki -auto "https://missav.ai/dm132/actresses/JULIA" -limit 20 -ffcover
  miyuki -auto "https://missav.ai/sw-950" "https://missav.ai/dandy-917"
  miyuki -auto "https://missav.ai/sw-950" -proxy localhost:7890
  miyuki -auth miyuki@gmail.com miyukiQAQ -ffmpeg -noban -limit 20
  miyuki -file /home/miyuki/url.txt -ffmpeg -title -limit 20
  miyuki -search sw-950 -ffcover -quality 720

💬 The `-auto` option

Use the -auto option to download movies from a playlist.
This playlist can be a public playlist created by your own account, or any playlist displayed based on search results or tag filters.
You should wrap the playlist URL with " " when you use the -auto option.

Command Examples:

miyuki -auto "https://missav.ai/search/JULIA?filters=uncensored-leak&sort=saved" -limit 50 -ffmpeg
miyuki -auto "https://missav.ai/search/JULIA?filters=individual&sort=views" -limit 20 -ffmpeg
miyuki -auto "https://missav.ai/dm132/actresses/JULIA" -limit 20 -ffmpeg
miyuki -auto "https://missav.ai/playlists/ewzoukev" -limit 20 -ffmpeg
miyuki -auto "https://missav.ai/dm444/en/labels/WANZ" -limit 20 -ffmpeg
miyuki -auto "https://missav.ai/dm21/en/makers/Takara%20Visual" -limit 20 -ffmpeg
miyuki -auto "https://missav.ai/dm1/en/genres/4K" -limit 20 -ffmpeg

💡 Precautions

If you are from an ancient oriental country, you will most likely need a proxy.
Use ffmpeg to synthesize videos for the best experience.

👀 About FFmpeg

If you want miyuki to use ffmpeg to process the video, use the -ffmpeg option.
Please check whether the ffmpeg command is valid before using the -ffmpeg option. (e.g. ffmpeg -version)
To install FFmpeg, please refer to https://ffmpeg.org/

📄 Disclaimer

This project is licensed under the MIT License. The following additional disclaimers and notices apply:

1. Legal Compliance

This software is provided solely for communication, research, learning, and personal use.
Users are responsible for ensuring that their use of this software complies with all applicable laws and regulations in their jurisdiction.
The software must not be used for any unlawful, unethical, or unauthorized purposes, including but not limited to violating third-party rights or legal restrictions.

2. No Warranty

As stated in the MIT License:

"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."

3. Limitation of Liability

The author(s) shall not be held liable for any claims, damages, or other liabilities arising from or in connection with the use or performance of this software.
Users bear all risks and responsibilities for the use of this software, including but not limited to data loss, system damage, or legal consequences.

4. Third-Party Dependencies

This project may include or depend on third-party libraries or tools. Users are responsible for reviewing and complying with the licenses and terms of these dependencies.

5. Security and Privacy

This software may interact with user systems, networks, or data. Users should implement appropriate security measures to protect sensitive information and infrastructure.
The authors are not responsible for any security vulnerabilities or data breaches resulting from the use of this software.