jut-su.py 0.1.5

Modern Python library for parsing anime data from jut.su website

Jut.su Scraper | jut-su.py

Modern Python library for parsing anime data from jut.su website.

[!IMPORTANT] Is currently under development, so some features may not work properly or may not work at all

If you enjoy this project, please consider supporting it by giving it a star ⭐

Support Discord:

jut-su.py Community

Installation

pip install jut-su.py

Quick Start

from jutsu_scraper import JutsuClient

client = JutsuClient()

anime = client.get_anime("mayoiga")

if anime:
    print(f"Title: {anime.title}")
    print(f"Year: {anime.year}")
    print(f"Genres: {', '.join(anime.genres)}")
    print(f"Episodes: {len(anime.episodes)}")

Custom Headers and Logging

import logging
from jutsu_scraper import JutsuClient, setup_logger

setup_logger(level=logging.INFO)

client = JutsuClient(
    timeout=30,
    headers={
        "Custom-Header": "value"
    },
    use_random_ua=True,
    log_level=logging.INFO
)

Authentication

from jutsu_scraper import JutsuClient

client = JutsuClient()

# login_url can be any page URL (e.g., episode page)
success = client.login(
    username="your_username",
    password="your_password",
    login_url="https://jut.su/watari-ga-houkai/episode-19.html"
)

if success:
    print(f"Login successful! Authenticated: {client.is_authenticated}")
else:
    print("Login failed")

Downloading Episodes

[!WARNING] To download the video, you need to have a jut-su plus subscription.

import logging
from jutsu_scraper import JutsuClient, setup_logger, VideoExtractionError, DownloadError, NetworkError

setup_logger(level=logging.INFO)

client = JutsuClient()

# Login first (required for accessing video URLs)
try:
    client.login("your_username", "your_password", "https://jut.su/anime/episode-1.html")
    
    episode_url = "https://jut.su/watari-ga-houkai/episode-19.html"
    video_urls = client.get_video_urls(episode_url)
    
    if video_urls:
        print(f"Available qualities: {', '.join(video_urls.keys())}p")
        
        output_path = client.download_episode(
            episode_url=episode_url,
            quality="720",  # Options: "1080", "720", "480", "360"
            output_path="episode_19.mp4",  # Optional: auto-generated if not provided
            show_progress=True
        )
        
        if output_path:
            print(f"Downloaded to: {output_path}")
            
except (VideoExtractionError, DownloadError, NetworkError) as e:
    print(f"Error: {e}")

Batch Downloading

Download multiple episodes at once:

from jutsu_scraper import JutsuClient

client = JutsuClient()
client.login("your_username", "your_password", "https://jut.su/anime/")

anime_url = "https://jut.su/watari-ga-houkai/"

# Download all episodes
downloaded = client.download_all_episodes(
    anime_url=anime_url,
    output_dir="episodes",
    quality="720"
)

# Download specific season
downloaded = client.download_season(
    anime_url=anime_url,
    season_number=1,
    output_dir="season_1",
    quality="720"
)

# Download specific arc
downloaded = client.download_arc(
    anime_url=anime_url,
    season_number=1,
    arc_name="Arc Name",
    output_dir="arc_name",
    quality="720"
)

# Download specific episodes by numbers
downloaded = client.download_episodes(
    anime_url=anime_url,
    episode_numbers=[1, 5, 10, 15],
    output_dir="selected_episodes",
    quality="720"
)

Examples

See the examples/ directory for more detailed examples:

• examples/basic_usage.py - Basic usage
• examples/authentication.py - User authentication
• examples/download_episode.py - Downloading single episode
• examples/batch_download.py - Batch downloading episodes
• examples/seasons_and_arcs.py - Working with seasons and arcs
• examples/json_export.py - Exporting to JSON

Roadmap

Planned features for future releases:

• 📖 Manga Support - Parse manga data from jut.su
• 📺 Large Series Support - Enhanced support for long-running series

Implemented Features

• ✅ Authentication - User authentication with username and password
• ✅ Video Downloading - Download anime episodes with quality selection
• ✅ Batch Downloading - Download multiple episodes, seasons, or arcs at once

Contact me

• Telegram | Telegram Channel
• Discord
• [e-mail]