ani-auto 1.0.0

package/README.md

@@ -0,0 +1,159 @@
+# ani-auto
+
+Automatic anime episode downloader.  
+Watches your **AniList** list (or a manual list) and downloads new episodes the moment they appear on the site — with full quality/language control, a background daemon, cron scheduling etc.
+---
+
+## Requirements
+
+- Node.js 18+
+
+---
+
+## Installation
+
+```bash
+#    ani-auto/     ← this project
+
+cd ani-auto
+npm install
+
+# 2. Link the CLI globally (optional)
+npm link
+```
+
+---
+
+## Quick Start
+
+```bash
+# First-time setup wizard
+ani-auto setup
+
+# Manually trigger one download cycle
+ani-auto check
+
+# Start the background daemon
+ani-auto daemon
+# or: npm start
+```
+
+---
+
+## How It Works
+
+1. **AniList** — queries your list for the configured statuses (e.g. `CURRENT`).  
+   For each anime, it searches the download site, fetches the episode list, and downloads anything not already in the database.
+
+2. **Manual list** — entries added via `ani-auto add` are checked the same way.  
+   Manual entries support per-anime quality/language overrides.
+
+3. **State** — SQLite (`~/.config/ani-auto/state.db`) tracks every episode as `pending → downloading → done / failed`. Already-downloaded episodes are never re-fetched.
+
+4. **Scheduling** — the daemon runs on both:
+   - A **polling interval** (default: every 30 min)
+   - A **cron schedule** (default: `0 */2 * * *` — every 2 hours)
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `setup` | Interactive first-time wizard |
+| `check` | Run one download cycle now |
+| `list` | Show all tracked anime |
+| `add "<title>"` | Add to manual list |
+| `remove "<title>"` | Remove from tracking |
+| `enable "<title>"` | Re-enable downloads |
+| `disable "<title>"` | Pause without removing |
+| `status` | View recent run log |
+| `config` | View / update settings |
+| `daemon` | Start background daemon |
+
+---
+
+## Manual Add Options
+
+```bash
+# Default quality/language from global config
+ani-auto add "Frieren: Beyond Journey's End"
+
+# Per-anime overrides
+ani-auto add "One Piece" --quality 720p --language dub
+```
+
+---
+
+## Config Options
+
+```bash
+ani-auto config --set-quality 1080p
+ani-auto config --set-language sub
+ani-auto config --set-concurrency 3
+ani-auto config --set-output ~/Videos/Anime
+ani-auto config --set-interval 60        # daemon: poll every 60 min
+ani-auto config --set-cron "0 6 * * *"  # also trigger at 6 AM daily
+```
+
+Full config lives at `~/.config/ani-auto/config.json`.
+
+---
+
+## AniList Statuses
+
+Configured during `setup` or by editing `config.json`:
+
+| Status | Meaning |
+|---|---|
+| `CURRENT` | Currently watching (recommended) |
+| `PLANNING` | Plan to watch |
+| `PAUSED` | Paused |
+| `REPEATING` | Re-watching |
+
+---
+
+
+
+---
+
+## File Structure
+
+```
+ani-auto/
+├── src/
+│   ├── cli.js        ← entry point for all commands
+│   ├── daemon.js     ← background daemon
+│   ├── engine.js     ← core run cycle logic
+│   ├── scraper.js    ← adapter over k-anime utils
+│   ├── anilist.js    ← AniList GraphQL client
+│   ├── db.js         ← SQLite state layer
+│   └── config.js     ← JSON config manager
+├── package.json
+├── utils.js
+└── README.md
+```
+
+---
+
+## Systemd Service (Linux/Arch)
+
+```ini
+# ~/.config/systemd/user/ani-auto.service
+[Unit]
+Description=K-Anime Auto Downloader
+
+[Service]
+ExecStart=/usr/bin/node /path/to/ani-auto/src/daemon.js
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+```
+
+```bash
+systemctl --user enable --now ani-auto
+systemctl --user status ani-auto
+journalctl --user -u ani-auto -f
+```

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "ani-auto",
+  "version": "1.0.0",
+  "description": "Automatic anime episode downloader",
+  "bin": {
+    "ani-auto": "./src/cli.js"
+  },
+  "scripts": {
+    "start": "node src/daemon.js",
+    "check": "node src/cli.js check",
+    "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",
+    "sql.js": "^1.12.0"
+  }
+}

package/src/anilist.js

@@ -0,0 +1,132 @@
+'use strict';
+
+const fetch = require('node-fetch');
+
+const ANILIST_GQL = 'https://graphql.anilist.co';
+
+// ── Queries ────────────────────────────────────────────────────────────────
+
+const MEDIA_LIST_QUERY = `
+query ($userName: String, $status: MediaListStatus) {
+    MediaListCollection(userName: $userName, type: ANIME, status: $status) {
+        lists {
+            entries {
+                mediaId
+                status
+                progress
+                media {
+                    id
+                    title { romaji english native }
+                    episodes
+                    status
+                    nextAiringEpisode { episode airingAt }
+                }
+            }
+        }
+    }
+}`;
+
+const VIEWER_QUERY = `
+query {
+    Viewer { id name }
+}`;
+
+const SEARCH_QUERY = `
+query ($search: String) {
+    Page(page: 1, perPage: 8) {
+        media(search: $search, type: ANIME) {
+            id
+            title { romaji english native }
+            episodes
+            status
+            seasonYear
+            format
+        }
+    }
+}`;
+
+// ── Helpers ────────────────────────────────────────────────────────────────
+
+async function gqlRequest(query, variables = {}, token = null) {
+    const headers = { 'Content-Type': 'application/json', 'Accept': 'application/json' };
+    if (token) headers['Authorization'] = `Bearer ${token}`;
+
+    const res = await fetch(ANILIST_GQL, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ query, variables }),
+    });
+
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`AniList API error ${res.status}: ${text}`);
+    }
+
+    const json = await res.json();
+    if (json.errors) throw new Error(`AniList GQL error: ${json.errors[0].message}`);
+    return json.data;
+}
+
+// ── Public API ─────────────────────────────────────────────────────────────
+
+async function getViewer(token) {
+    const data = await gqlRequest(VIEWER_QUERY, {}, token);
+    return data.Viewer;
+}
+
+async function getUserList(userName, statuses, token = null) {
+    const results = [];
+    for (const status of statuses) {
+        const data = await gqlRequest(MEDIA_LIST_QUERY, { userName, status }, token);
+        const lists = data?.MediaListCollection?.lists || [];
+        for (const list of lists) {
+            for (const entry of list.entries) {
+                results.push({
+                    anilistId:     entry.mediaId,
+                    status:        entry.status,
+                    progress:      entry.progress,
+                    totalEpisodes: entry.media.episodes,
+                    animeStatus:   entry.media.status,
+                    titles: {
+                        romaji:  entry.media.title.romaji,
+                        english: entry.media.title.english,
+                        native:  entry.media.title.native,
+                    },
+                    nextAiring: entry.media.nextAiringEpisode || null,
+                });
+            }
+        }
+    }
+    return results;
+}
+
+/**
+ * Search AniList for anime by title.
+ * Returns up to 8 results with id, titles, episodes, status, year.
+ */
+async function searchAnime(query, token = null) {
+    const data = await gqlRequest(SEARCH_QUERY, { search: query }, token);
+    return (data?.Page?.media || []).map(m => ({
+        anilistId: m.id,
+        titles: {
+            romaji:  m.title.romaji,
+            english: m.title.english,
+            native:  m.title.native,
+        },
+        episodes:  m.episodes,
+        status:    m.status,
+        year:      m.seasonYear,
+        format:    m.format,
+    }));
+}
+
+function pickTitle(titles) {
+    return titles.english || titles.romaji || titles.native;
+}
+
+module.exports = {
+    getViewer,
+    getUserList,
+    searchAnime,
+    pickTitle,
+};