Initialize standalone ani-cli-web

2026-05-11 11:53:51 +02:00
commit ec6efac9e1
6 changed files with 1416 additions and 0 deletions
@@ -0,0 +1,49 @@
+# ani-cli web
+
+A small local web UI for a system-wide `ani-cli` install.
+
+Current version: `0.1.0`
+
+## Project Layout
+
+```text
+ani-cli-web/
+  app.py          Web server, queue, search, and post-download library naming.
+  ani-cli-web     Launcher script.
+  VERSION         Project version.
+  CHANGELOG.md    Change history.
+  README.md       Project documentation.
+```
+
+## Run
+
+```sh
+./ani-cli-web
+```
+
+Then open:
+
+```text
+http://127.0.0.1:8421/
+```
+
+The app searches anime, queues downloads, supports original or dubbed mode, quality, episode ranges, editable library names, season numbers, and a default download folder.
+
+Downloads are staged in the web app state directory first. After `ani-cli` finishes, the wrapper moves them into a Plex/Jellyfin-friendly layout:
+
+```text
+ANI_CLI_DOWNLOAD_DIR/anime_name/anime_name - S01E01.mp4
+```
+
+## Configuration
+
+- `ANI_CLI_BIN`: path or command name for `ani-cli`; defaults to `ani-cli` from `PATH`.
+- `ANI_CLI_DOWNLOAD_DIR`: initial default download folder.
+- `ANI_CLI_MODE`: initial mode, `sub` or `dub`.
+- `ANI_CLI_QUALITY`: initial quality, for example `best`, `1080`, or `720`.
+- `ANI_CLI_WEB_HOST`: server host, default `127.0.0.1`.
+- `ANI_CLI_WEB_PORT`: server port, default `8421`.
+
+Settings and the queue are stored under XDG config/state directories when writable, with a local `.ani-cli-web/` fallback inside this project.
+
+Runtime folders such as `.ani-cli-web/`, `downloads/`, and Python bytecode caches are ignored by git.