█████╗ ███╗   ██╗██╗      █████╗ ██╗   ██╗████████╗ ██████╗ 
     ██╔══██╗████╗  ██║██║     ██╔══██╗██║   ██║╚══██╔══╝██╔═══██╗
     ███████║██╔██╗ ██║██║     ███████║██║   ██║   ██║   ██║   ██║
     ██╔══██║██║╚██╗██║██║     ██╔══██║██║   ██║   ██║   ██║   ██║
     ██║  ██║██║ ╚████║██║     ██║  ██║╚██████╔╝   ██║   ╚██████╔╝
     ╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝     ╚═╝  ╚═╝ ╚═════╝    ╚═╝    ╚═════╝ 
            A N I M E   A U T O   D O W N L O A D E R

ani-auto

automatically downloads new anime episodes. works with your AniList watching list or a manual list — no account required.

installation

npm install -g ani-auto

quick start

ani-auto setup
ani-auto download

Tip: connecting your AniList account lets the daemon know exactly when episodes air and download them automatically. without AniList, you can still add anime manually and the daemon will check every 2 hours.

features

1. anilist sync stays in sync with your watching list — only downloads episodes you haven't seen yet. supports multiple statuses (watching, paused, planning, repeating).

2. manual list no AniList account? add any anime manually with ani-auto add "title" and it will be tracked and downloaded just like AniList entries.

3. quality control choose your preferred quality on each run or set a default. set a different quality per anime with ani-auto quality.

4. smart daemon connects to your AniList to know exactly when each episode airs and downloads at the right time. falls back to checking every 2 hours for manual list entries or when AniList is not connected.

5. offline recovery if your device loses internet, the daemon detects it instantly and resumes the moment connection is restored.

6. episode range download a specific range of episodes in one run — useful for catching up on a series.

7. telegram notifications get notified on your phone when episodes download, fail, or the daemon starts. message @userinfobot on telegram to get your chat id, then run ani-auto setup.

8. pause & resume disable any anime at any time without losing your download history.

9. retry failed episodes re-attempt all failed downloads in one command with ani-auto retry.

commands

Usage: ani-auto [options] [command]

Options:
  -V, --version          output the version number
  -h, --help             display help for command

Commands:
  setup                  Interactive first-time configuration wizard
  download               Run one download cycle immediately
  list                   Show all tracked anime and their episode download status
  add [options] <title>  Search AniList and add an anime to the manual list
  remove [title]         Remove an anime from the manual list
  enable                 Re-enable downloads for an anime
  disable                Pause downloads for an anime (keeps history)
  quality [title]        Set per-anime quality override
  retry                  Re-attempt all failed episode downloads
  status [options]       Show recent run log or per-anime episode breakdown
  notify [action]        Enable or disable Telegram notifications (on, off)
  config [options]       View, update, or open config file
  update                 Check for updates and install the latest version
  daemon [action]        Manage the background daemon (install, start, stop, restart, status, logs)
  help [command]         display help for command

configuration

ani-auto config --set-quality 1080p
ani-auto config --set-concurrency 3
ani-auto config --set-output ~/videos/anime
ani-auto config --set-interval 120
ani-auto config --set-airing-buffer 5
ani-auto config --open

background service (linux)

install and start the daemon as a systemd service with one command:

ani-auto daemon install

other daemon commands:

ani-auto daemon enable   # enable daemon service
ani-auto daemon disable  # disable daemon service
ani-auto daemon start    # start the service
ani-auto daemon stop     # stop the service
ani-auto daemon restart  # restart the service
ani-auto daemon status   # check if running
ani-auto daemon logs     # stream live logs