whatisgithub

What is anime-dl-nyaa-helper?

yskt/anime-dl-nyaa-helper — explained in plain English

Analysis updated 2026-05-18

184Audience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A Python CLI that finds anime magnet links from Nyaa and HorribleSubs and hands them off to a torrent client automatically.

Mindmap

mindmap
  root((repo))
    What it does
      Find anime magnets
      Filter by quality
      Send to torrent client
    Tech stack
      Python CLI
      Nyaa and HorribleSubs
      OpenAI Claude APIs
    Commands
      search
      fetch
      watch
    Platforms
      Linux macOS
      Windows WSL2
    Audience
      Anime fans
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search for an anime show and quality level and send the magnet link straight to a torrent client.

USE CASE 2

Watch a list of shows and get notified automatically when new episodes appear.

USE CASE 3

Fetch a specific season and episode range with fallback subtitle languages.

USE CASE 4

Let an AI module resolve ambiguous or mislabeled episode metadata.

What is it built with?

PythonqBittorrentaria2OpenAI APIClaude API

How does it compare?

yskt/anime-dl-nyaa-helper6hourt9/push-video-wallpaper-engineabhirammandula-boop/nooklink-pc-emulator-toolkit
Stars184184184
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencevibe codervibe codergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a separate torrent client (qBittorrent, Transmission, or aria2) already installed to actually download files.

MIT License: free to use, modify, and share, including commercially, as long as the copyright notice is kept.

So what is it?

AniLink Hub is a Python command line tool that pulls together anime magnet links and metadata from Nyaa and HorribleSubs so a user can search for a show and hand the result to a torrent client in one step. The README describes it as an orchestrator rather than a scraper: it resolves magnet links, filters by quality and episode, and passes the result to Transmission, qBittorrent, or aria2. Settings live in a config.yaml profile where a user picks the downloader backend, a Nyaa instance to query, whether to fall back to HorribleSubs, preferred and fallback subtitle languages, download folder layout, and a file naming template. The profile can also enable an idle mode that only downloads while the system is otherwise unused, and a limit on simultaneous downloads. Commands include a basic search with a quality and subtitle language filter, a more detailed fetch command that can target a specific season and episode range with multiple subtitle fallback languages, a watch mode that checks a list of shows on a set interval and notifies when new episodes appear, and an interactive wizard mode for new users. Two optional AI integrations are described. The OpenAI API is used for fuzzy matching show titles, detecting the language of a release name, and generating fallback search strings. The Claude API is used to resolve ambiguous episode metadata, such as telling apart two similarly named releases of the same episode, and the README claims this resolves most of these edge cases automatically. The tool is supported on Linux, macOS, and Windows through WSL2, with community testing on FreeBSD and an experimental build for Android through Termux. The README includes a disclaimer stating the project does not host or distribute copyrighted content itself, only an interface to public magnet links and metadata, and that users are responsible for following their own local copyright laws. It also encourages supporting official releases. The project is released under the MIT License.

Copy-paste prompts

Prompt 1
Help me write a config.yaml profile for AniLink Hub with qBittorrent as the backend and English subtitles preferred.
Prompt 2
Explain the difference between the search, fetch, and watch commands in this CLI.
Prompt 3
Walk me through setting up the watch mode to check for new episodes of a show every 12 hours.
Prompt 4
What does the --ai-assist flag do when metadata for an episode is ambiguous?
Prompt 5
Show me how to set up the naming template for organizing downloaded episodes by series.

Frequently asked questions

What is anime-dl-nyaa-helper?

A Python CLI that finds anime magnet links from Nyaa and HorribleSubs and hands them off to a torrent client automatically.

What license does anime-dl-nyaa-helper use?

MIT License: free to use, modify, and share, including commercially, as long as the copyright notice is kept.

How hard is anime-dl-nyaa-helper to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is anime-dl-nyaa-helper for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.