Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Celty : Miyuki x aria2c

Celty mixes the power of aria2c and the simplicity of Miyuki to bring you the ultimate automatic anime downloader.

What does it do?

In short, it uses an ad-hoc modified Miyuki configuration file to locate where it downloaded your animu torrents, starts an aria2 instance and loads all the torrents, saving them in your favourite folders. More notes on the needed modifications can be found at docs/

What do I have to do?

  1. Modify your Miyuki configuration to include at least this, in the global section
  - downloadDir: /my/download/dir
  - seedTime: 10 #optional, default is 0 (zero)
  1. run celty start path/to/miyuki.conf
  2. wait a bit
  3. enjoy your animu

Please note that Celty does not start Miyuki: you have to launch it manually.

Why did you start this project?

I experienced some problems while using baretorrent: torrent files were removed from watch directory. To make it worse, I lost several downloaded series in this "put/removed torrents" dance.

A patch for Yamazaki (the library Miyuki uses to query torrent sources and download torrent files) was proposed in order to fix an annoying behaviour of another famous torrent client: it renames torrent files (adding a suffix), so Miyuki does not find them and re-downloads 'em again. You can patch for one client, but you can't do that for every client out there.

As aria2c does not modify the downloaded torrents in Miyuki's watch directory, I thought it was the perfect candidate for a joint operation with the best dubb- ehm, command line anime tracker out there.


  • Libraries
    • pyyaml (for Miyuki conf file parsing)
    • click (command line handling)
    • alfateam123/pyaria2 (use "-r requirements.txt" with pip!)

They will be installed automatically when installing Celty.

  • Third-party apps
    • aria2c
    • Miyuki

Be sure that aria2c is compiled with torrent and xml-rcp support. Ruby is needed for running Miyuki.


[soon] A glorified aria2 launcher and scriptable interface to aria2



No releases published


No packages published