Skip to content

Latest commit

 

History

History
317 lines (257 loc) · 10.9 KB

README.md

File metadata and controls

317 lines (257 loc) · 10.9 KB

🌸 Chou Megumi Download 🌸

Python Version License Platform

🚀 Supercharge Your Anime Downloads!

It's a cross-platform version of a program previously written in C# called Megumi_Download for Windows, which, in a nutshell, allowed downloading anime episodes from a seedbox, moving them to the appropriate folders, renaming the file (to a system recognized by Kodi's TVDB standard) and automatically replacing various things in the subtitles (order of names, honorifics, etc.). Admittedly, it could be run through Wine on macOS and Linux without any problems, but it had other issues. The most important change is that it has now been rewritten to Python and supports not only parallel downloading of multiple episodes, but also downloading using chunks. Both things speed up the whole process a lot. Everything is configurable. Also, because it is written in Python, it starts natively on any system with a Python interpreter installed.

🌟 Features That'll Make Your Heart Go "DokiDoki!"

  • 🎞️ Subtitle Sorcery: Extracts, tweaks, and remuxes subtitles like magic! You can replace anything!
  • 🚄 Shinkansen-Fast Downloads: Parallel and chunked downloading for speed that'll make your head spin!
  • 🗂️ Kodi-Friendly Organization: Sorts episodes using the TVDB standard, perfect for Kodi and Plex!
  • 🔐 SFTP Superpowers: Connects to your seedbox faster than you can say "Nani?!"
  • ⚙️ Lab Memeber 001-Level Customization: Configure every nook and cranny to your liking!
  • 🖥️ Runs Everywhere: Windows, macOS, Linux – if it can run Python, it can run Chou Megumi Download!

📦 Installation: Easier Than Making Instant Ramen!

🖥️ For Python Version:

  1. Clone the Repo

    git clone https://github.com/HououinKyouma01/ChouMegumiDownload.git
cd ChouMegumiDownload

  2. Install Dependencies

    pip install asyncssh aiohttp rich paramiko psutil ass

    For macOS users experiencing issues:

    python3 -m pip install asyncssh aiohttp rich paramiko psutil ass

  3. Install Required Tools

    • MKVToolNix:
    • FFmpeg (optional but recommended for timing fixes):
      • Windows: Download from FFmpeg's site
      • macOS: brew install ffmpeg
      • Linux: sudo apt install ffmpeg

    💡 Pro Tip: You can place mkvmerge.exe, mkvextract.exe, and ffmpeg.exe in the script folder to use them without adding to PATH!

📦 For Compiled Version (Recommended):

  1. Download the latest release from the Releases page

  2. Place these files in the same folder:

    • chou-megumi-download.exe
    • config.megumi
    • groups.megumi
    • serieslist.megumi

  3. Download required tools:

    • MKVToolNix - place mkvmerge.exe and mkvextract.exe in the same folder
    • FFmpeg - place ffmpeg.exe in the same folder (optional but recommended for timing fixes)

    🚀 That's it! Just run chou-megumi-download.exe and enjoy!

⚙️ Configuration: Tailor It to Your Tastes!

1. config.megumi: The Heart of the Operation

Create this file in the script's directory. Here's a sample to get you started:

HOST=anime.seedbox.com
USER=otaku_master
PASSWORD=super_secret_password
REMOTEPATCH=/home/user/anime/completed/
LOCALPATCH=/Users/YourName/Movies/Anime/
LOCALTEMP=/Users/YourName/Downloads/AnimeTemp/
MOVELOCAL=OFF
RENAME=ON
SAVEINFO=ON
CHUNKS=4
USE_CHUNKS=ON

2. groups.megumi: Your Anime Squad

List your favorite release groups:

Doki
SNSbu
Nyanpasu
Chihiro
Nii-sama
MTBB
Zafkiel
SubsPlease

3. serieslist.megumi: Your Anime Catalog

Format: title_in_file_name|series_folder_name|season_number|replace_url

One Room, Hiatari Futsuu, Tenshi-tsuki|One Room, Hiatari Futsuu, Tenshi-tsuki|1
Shuumatsu Train Doko e Iku|Shuumatsu Train Doko e Iku|1
Kami wa Game ni Ueteiru|Kami wa Game ni Ueteiru|1
Spice and Wolf (2024)|Ookami to Koushinryou (2024)|1
Dainanaoji|Tensei shitara Dainana Ouji Datta node, Kimama ni Majutsu wo Kiwamemasu|1
The Dangers in My Heart S2|Boku no Kokoro no Yabai Yatsu|2
Yuru Camp S3|Yuru Camp|3
Hananoi-kun to Koi no Yamai|Hananoi-kun to Koi no Yamai|1
Jellyfish Can't Swim in the Night|Yoru no Kurage wa Oyogenai|1
Hibike! Euphonium S3|Hibike! Euphonium|3|https://example.com/hibike_euphonium_replace.txt
Jiisan Baasan Wakagaeru|Jiisan Baasan Wakagaeru|1
Mushoku Tensei S2|Mushoku Tensei|2

Note: The replace_url is optional. If provided, the script will automatically download the replace.txt file from the specified URL.

🎬 Usage: Action!

Fire it up with:

python chou_megumi_download.py

Alternatively, you can download the compiled executable in the "releases" tab

Sit back and watch as Chou Megumi Download:

  1. 🔗 Connects to your SFTP server
  2. 📥 Downloads fresh episodes
  3. 📁 Organizes them into your specified directories
  4. 🗣️ Processes subtitles (if replace.txt is present)

🛠️ Tweak your subtitles

🎬 Advanced Features

Subtitle Replacement Magic

Create a replace.txt in your series folder (for example C:\Anime\Hibike! Euphonium\Season 3\replace.txt) and fill it with everthing you want to replace using:

Old String|New String

Like in the provided example from Hibike! Euphonium below:

Kato|Katou
Yoshi|Yoshii
Yoko|Youko
Yuko|Yuuko
Otaki|Ootaki
Kyoko|Kyouko
Lala|Rara
Shuichi|Shuuichi
Hazuki Katou|Katou Hazuki
Sapphire Kawashima|Kawashima Sapphire
Reina Kousaka|Kousaka Reina
Mayu Kuroe|Kuroe Mayu
Kumiko Oumae|Oumae Kumiko
Kaho Hariya|Hariya Kaho
Kanade Hisaishi|Hisaishi Kanade
Suzume Kamaya|Kamaya Suzume
Tsubame Kamaya|Kamaya Tsubame
Yayoi Kamiishi|Kamiishi Yayoi
Ririka Kenzaki|Kenzaki Ririka
Mirei Suzuki|Suzuki Mirei
Satsuki Suzuki|Suzuki Satsuki
Noboru Taki|Taki Noboru
Shuuichi Tsukamoto|Tsukamoto Shuuichi
Motomu Tsukinaga|Tsukinaga Motomu
Sari Yoshii|Yoshii Sari
Chieri Takahisa|Takahisa Chieri
Hiyoko Ueda|Ueda Hiyoko
Hisae Takano|Takano Hisae
Youko Matsuzaki|Matsuzaki Youko
Aota Maeda|Maeda Aota
Sousuke Maeda|Maeda Sousuke
Michiko Machida|Machida Michiko
Une Kitada|Kitada Une
Motoko Higashiura|Higashiura Motoko
Rairi Hayashi|Hayashi Rairi
Masako Sakai|Sakai Masako
Tairu Kitayama|Kitayama Tairu
Maya Hashida|Hashida Maya
Taku Imura|Imura Taku
Ayako Sakasaki|Sakasaki Ayako
Michiru Hakase|Hakase Michiru
Tomomi Hotei|Hotei Tomomi
Sayaka Takino|Takino Sayaka
Tamari Asakura|Asakura Tamari
Maiya Kikkawa|Kikkawa Maiya
Tsubomi Nakano|Nakano Tsubomi
Sari Takahashi|Takahashi Sari
Meiko Oda|Oda Meiko
Maki Akamatsu|Akamatsu Maki
Sayaka Fukui|Fukui Sayaka
Akiko Yoshizawa|Yoshizawa Akiko
Sumiko Fukamachi|Fukamachi Sumiko
Suguru Takami|Takami Suguru
Kanade Hisaishi|Hisaishi Kanade
Nanami Ootaki|Ootaki Nanami
Kyouko Ayukawa|Ayukawa Kyouko
Babe Uchida|Uchida Babe
Chieri Takahisa|Takahisa Chieri
Hisae Takano|Takano Hisae
Hiyoko Ueda|Ueda Hiyoko
Youko Matsuzaki|Matsuzaki Youko
Miki Katou|Katou Miki
Kiri Matsumoto|Matsumoto Kiri
Machiko Nara|Nara Machiko
Nakaba Hattori|Hattori Nakaba
Narumi Hiraishi|Hiraishi Narumi
Seikoi Ashida|Ashida Seikoi
Kana Etou|Etou Kana
Michiyo Morimoto|Morimoto Michiyo
Junna Inoue|Inoue Junna
Yume Kohinata|Kohinata Yume
Yuuko Yoshikawa|Yoshikawa Yuuko
Natsuki Nakagawa|Nakagawa Natsuki
Nozomi Kasaki|Kasaki Nozomi
Haruna Hosono|Hosono Haruna
Suruga Koteyama|Koteyama Suruga
Aine Kohara|Kohara Aine
Tsumiki Yamane|Yamane Tsumiki
Shiori Hiranuma|Hiranuma Shiori
Eru Kabutodani|Kabutodani Eru
Hibiki Tsuchiya|Tsuchiya Hibiki
Sanae Yashiki|Yashiki Sanae
Rara Hitomi|Hitomi Rara
Chikao Takigawa|Takigawa Chikao
Seiya Suzuki|Suzuki Seiya
Chikai Maki|Maki Chikai
Michie Matsumoto|Matsumoto Michie
Chieri Takashita|Takashita Chieri
Asuka Tanaka|Tanaka Asuka

When using a URL for automatic list download, ensure it points to a plain text file with the correct formatting. The script will validate the content before using it for subtitle processing. If you use pastebin, make sure you're using "raw" link (pastebin.com/raw/file) that will provide plain text.

🕒 Timing Fix Magic - Fixing Subtitle timing problems

Hidive/Sentai subtitles are notorious for terrible timing - subtitles appearing too early/late or not matching scene changes. This feature fixes almost all timing issues by:

  1. Re-encoding the video (using fast preset) to create proper keyframes at scene changes
  2. Adjusting subtitles to:
    • Start/end exactly when scenes change
    • Be adjacent to each other (no gaps between lines)
    • Not overlap or blink

To use:

  1. Add FixTiming after the season number in serieslist.megumi: 
    Hibike! Euphonium S3|Hibike! Euphonium|3|FixTiming
  2. The program will automatically:
    • Re-encode the video (fast preset, 720p, original audio)
    • Extract and adjust subtitles to match new keyframes
    • Remux everything back together to original file and delete temp files

💡 Requires FFmpeg! Place ffmpeg.exe in the program folder or having it in system PATH.

💡 Using this option, the app run will be slower due to necessary re-encoding.

Example fixes:

  • Subtitles appearing before scene changes → Fixed!
  • Subtitles lingering after scene changes → Fixed!
  • Gaps between subtitle lines → Fixed!
  • Overlapping subtitles → Fixed!

⚡ Turbocharge Your Downloads

Adjust these in config.megumi:

  • CHUNKS: Number of parallel downloads (3-5 recommended)
  • USE_CHUNKS: Set to ON for faster downloads
  • MOVELOCAL: Set to ON if files are already on your local machine

🆘 Troubleshooting: When Things Go Yabai

Common Issues:

  • SFTP Connection Problems:

    • Double-check HOST, USER, and PASSWORD in config.megumi
    • Ensure your seedbox allows SFTP connections

  • Subtitle Timing Fix Errors:

    • Make sure ffmpeg.exe is in the program folder
    • Check errorlog.txt for details

  • MKVToolNix Issues:

    • Place mkvmerge.exe and mkvextract.exe in the program folder
    • Ensure you're using the latest version

  • Compiled Version Not Working:

    • Make sure all required .exe files are in the same folder
    • Run as Administrator if you get permission errors

  • 🔒 SFTP Woes: Double-check your HOST, USER, and PASSWORD

  • 🐌 Snail-Paced Downloads: Try bumping up CHUNKS or BUFFER_SIZE

  • 🗂️ Folder Chaos: Ensure serieslist.megumi is formatted correctly

  • 🍎 macOS Hiccups: Use python3 instead of python for commands

Now go forth and download anime and never be like those filthy tourists! 🎌✨