sudacode

Repositories

28

Projects Packages Public Activity Starred Repositories

1

jimaku-dl (0.1.3)

Published 2025-03-07 05:28:00 -08:00 by sudacode in sudacode/jimaku-dl

Installation

To install the package using pip, run the following command:

pip install --index-url  jimaku-dl

For more information on the PyPI registry, see the documentation.

About this package

Download japanese anime subtitles from Jimaku

Jimaku Downloader

A Python package to download japanese subtitles for anime from Jimaku.cc

Features

• Search for subtitles using AniList IDs
• Supports both individual files and directories
• Interactive subtitle selection using fzf
• Auto-detects anime from filenames with season and episode numbers
• Recursively checks parent directories for anime titles
• Optional MPV playback with downloaded subtitles
• Caches AniList IDs to reduce API calls

Installation

# From PyPI
pip install jimaku-dl

# From source
git clone https://github.com/InsaneDesperado/jimaku-dl.git
cd jimaku-dl
pip install -e .

Usage

Command Line

# Download subtitles for a video file
jimaku-dl /path/to/your/anime.S01E02.mkv

# Download subtitles for an entire series (directory mode)
jimaku-dl /path/to/your/anime/directory/

# Specify a different destination directory
jimaku-dl /path/to/your/anime.mkv --dest /path/to/subtitles/

# Play the video with MPV after downloading subtitles
jimaku-dl /path/to/your/anime.mkv --play

# Set API token via command line
jimaku-dl /path/to/your/anime.mkv --api-token YOUR_TOKEN

Environment Variables

You can set your Jimaku API token using the JIMAKU_API_TOKEN environment variable:

export JIMAKU_API_TOKEN=your_api_token

Python API

from jimaku_downloader import JimakuDownloader

# Create a downloader instance
downloader = JimakuDownloader(api_token="your_api_token", log_level="INFO")

# Download subtitles
downloaded_files = downloader.download_subtitles(
    media_path="/path/to/your/anime.mkv",
    dest_dir="/path/to/save/subtitles/",  # Optional
    play=True  # Optional: play with MPV after downloading
)

print(f"Downloaded {len/downloaded_files)} subtitle files")

Requirements

• Python 3.8 or higher
• fzf command-line utility for interactive selection
• mpv (optional, for playback functionality)
• A valid Jimaku.cc API token

License

GPL v3

Requirements

Requires Python: >=3.8

Details

PyPI

sudacode/jimaku-dl

2025-03-07 05:28:00 -08:00

1

InsaneDesperado

Project Site

45 KiB

Assets (2)

jimaku_dl-0.1.3-py3-none-any.whl 22 KiB

jimaku_dl-0.1.3.tar.gz 23 KiB

Versions (2) View all

0.1.3 2025-03-07

0.1.0 2025-03-07

Issues