ani-auto 1.3.0 → 1.3.2

package/README.md

@@ -10,7 +10,7 @@
 
 # ani-auto
 
-automatically downloads new anime episodes based on your anilist watching list.
+automatically downloads new anime episodes. works with your AniList watching list or a manual list — no account required.
 
 ---
 
@@ -26,28 +26,42 @@ npm install -g ani-auto
 
 ```bash
 ani-auto setup
-ani-auto check
+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.
+stays in sync with your watching list — only downloads episodes you haven't seen yet. supports multiple statuses (watching, paused, planning, repeating).
 
-**2. quality control**
-choose your preferred quality on each run or set a default.
+**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. background daemon**
-set it and forget it — checks for new episodes automatically on a schedule.
+**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. pause & resume**
-disable any anime at any time without losing your download history.
+**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.
 
-**5. telegram notifications**
+**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
@@ -55,24 +69,25 @@ get notified on your phone when episodes download, fail, or the daemon starts. m
 ```
 Usage: ani-auto [options] [command]
 
-Automatic anime episode downloader — AniList-aware
-
 Options:
   -V, --version          output the version number
   -h, --help             display help for command
 
 Commands:
   setup                  Interactive first-time configuration wizard
-  check [options]        Run one download cycle immediately
+  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 download list
-  remove [title]         Remove an anime from the manual list (interactive if no title given)
+  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)
-  status [options]       Show recent run log
+  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 [options]       Start the background daemon
+  daemon [action]        Manage the background daemon (install, start, stop, restart, status, logs)
   help [command]         display help for command
 ```
 
@@ -84,7 +99,8 @@ Commands:
 ani-auto config --set-quality 1080p
 ani-auto config --set-concurrency 3
 ani-auto config --set-output ~/videos/anime
-ani-auto config --set-interval 60
+ani-auto config --set-interval 120
+ani-auto config --set-airing-buffer 5
 ani-auto config --open
 ```
 
@@ -92,42 +108,18 @@ ani-auto config --open
 
 ## background service (linux)
 
-run this once to install and start the daemon as a systemd service:
+install and start the daemon as a systemd service with one command:
 
 ```bash
-mkdir -p ~/.config/systemd/user && \
-NODE_BIN=$(which node) && \
-DAEMON_PATH=$(npm root -g)/ani-auto/src/daemon.js && \
-cat > ~/.config/systemd/user/ani-auto.service << SERVICE
-[Unit]
-Description=ani-auto daemon
-After=network-online.target
-
-[Service]
-ExecStart=$NODE_BIN $DAEMON_PATH
-Restart=on-failure
-RestartSec=10
-
-[Install]
-WantedBy=default.target
-SERVICE
-systemctl --user daemon-reload && \
-systemctl --user enable --now ani-auto && \
-echo "ani-auto daemon installed and started"
+ani-auto daemon install
 ```
 
-**useful commands:**
+**other daemon commands:**
 
 ```bash
-# check status
-systemctl --user status ani-auto
-
-# view live logs
-journalctl --user -u ani-auto -f
-
-# restart
-systemctl --user restart ani-auto
-
-# stop
-systemctl --user stop ani-auto
+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
 ```

package/package.json

@@ -1,20 +1,19 @@
 {
   "name": "ani-auto",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Automatic anime episode downloader",
   "bin": {
     "ani-auto": "./src/cli.js"
   },
   "scripts": {
     "start": "node src/daemon.js",
-    "check": "node src/cli.js check",
+    "download": "node src/cli.js download",
     "setup": "node src/cli.js setup"
   },
   "dependencies": {
     "chalk": "^4.1.2",
     "cli-progress": "^3.12.0",
     "commander": "^12.0.0",
-    "cron": "^3.1.6",
     "inquirer": "^8.2.6",
     "node-fetch": "^2.7.0",
     "ora": "^5.4.1",