sni-cli 1.2.2__tar.gz → 1.2.4__tar.gz

{sni_cli-1.2.2 → sni_cli-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sni-cli
-Version: 1.2.2
+Version: 1.2.4
 Summary: Stream Ninja Interface — terminal-based anime streaming CLI + TUI
 Project-URL: Homepage, https://github.com/sundeepyt2/SNI
 Project-URL: Source, https://github.com/sundeepyt2/SNI
@@ -380,26 +380,30 @@ echo 'cf_clearance=...;' > ~/.config/sni/allanime_cookies.txt
 sni play "one piece" --cookie 'cf_clearance=...;'
 ```
 
-### Option 2 — Cloudflare Worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
+### Option 2 — Self-hosted proxy worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
 
-This is the most powerful bypass — it proxies AllAnime API requests through Cloudflare's own IPs, which AllAnime rarely challenges. Only set this up if Option 1 fails AND SNI's built-in proxy fallback doesn't work for you.
+SNI ships with ready-to-deploy proxy worker code in the [`worker/`](worker/) directory. The worker proxies AllAnime API requests through a clean IP (the platform's IP), which AllAnime's edge doesn't flag. **Three deployment platforms are supported — all have free tiers, none require a credit card:**
 
-**Deploy via Cloudflare** (free, requires a Cloudflare account):
+| Platform | Difficulty | Setup time | Why pick this |
+|---|---|---|---|
+| **Deno Deploy** | Easiest | ~2 min | Most reliable as of 2026; playground = no GitHub repo needed |
+| **Vercel Edge Functions** | Easy | ~3 min | Good if you already use Vercel |
+| **Cloudflare Workers** | Hard right now | ~5 min | Known dashboard deploy bugs; use only if others fail |
 
-1. Go to https://dash.cloudflare.com → Workers & Pages → Create
-2. Paste the contents of [`cf-worker/worker.js`](https://github.com/smithmx20/XAN/blob/main/cf-worker/worker.js) from the XAN repo
-3. Deploy, copy the worker URL (e.g. `https://xan-proxy.you.workers.dev`)
-4. Save it to SNI:
+**Full step-by-step instructions for all three platforms are in [`worker/README.md`](worker/README.md).**
+
+Quick Deno Deploy setup (recommended):
+
+1. Go to https://dash.deno.com → sign in with GitHub → "New Project" → "Playground"
+2. Paste the contents of [`worker/proxy.deno.js`](worker/proxy.deno.js) → click "Save & Deploy"
+3. Copy the URL (e.g. `https://your-project.deno.dev`)
+4. Save to SNI:
 
    ```bash
-   sni config --update allanime_cf_worker_url='https://xan-proxy.you.workers.dev'
+   sni config --update allanime_cf_worker_url='https://your-project.deno.dev'
    ```
 
-**Can't create a Cloudflare account?** Deploy the same `worker.js` code to any of these alternative platforms (all have free tiers, none require a credit card):
-
-- **Deno Deploy** (https://dash.deno.com) — free, no card required, fastest setup. Wrap the worker's `fetch` handler in a `Deno.serve()` call.
-- **Vercel Edge Functions** (https://vercel.com) — free tier. Adapt the handler to Vercel's `export default function handler(req: Request)` signature.
-- **Netlify Functions** (https://netlify.com) — free tier. Convert to Netlify's `exports.handler` format.
+5. Try: `sni play "one piece"`
 
 The worker code is platform-agnostic — it's just a `fetch` handler that proxies a request. The only thing that changes between platforms is the entry-point wrapper.
 

{sni_cli-1.2.2 → sni_cli-1.2.4}/README.md

@@ -327,26 +327,30 @@ echo 'cf_clearance=...;' > ~/.config/sni/allanime_cookies.txt
 sni play "one piece" --cookie 'cf_clearance=...;'
 ```
 
-### Option 2 — Cloudflare Worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
+### Option 2 — Self-hosted proxy worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
 
-This is the most powerful bypass — it proxies AllAnime API requests through Cloudflare's own IPs, which AllAnime rarely challenges. Only set this up if Option 1 fails AND SNI's built-in proxy fallback doesn't work for you.
+SNI ships with ready-to-deploy proxy worker code in the [`worker/`](worker/) directory. The worker proxies AllAnime API requests through a clean IP (the platform's IP), which AllAnime's edge doesn't flag. **Three deployment platforms are supported — all have free tiers, none require a credit card:**
 
-**Deploy via Cloudflare** (free, requires a Cloudflare account):
+| Platform | Difficulty | Setup time | Why pick this |
+|---|---|---|---|
+| **Deno Deploy** | Easiest | ~2 min | Most reliable as of 2026; playground = no GitHub repo needed |
+| **Vercel Edge Functions** | Easy | ~3 min | Good if you already use Vercel |
+| **Cloudflare Workers** | Hard right now | ~5 min | Known dashboard deploy bugs; use only if others fail |
 
-1. Go to https://dash.cloudflare.com → Workers & Pages → Create
-2. Paste the contents of [`cf-worker/worker.js`](https://github.com/smithmx20/XAN/blob/main/cf-worker/worker.js) from the XAN repo
-3. Deploy, copy the worker URL (e.g. `https://xan-proxy.you.workers.dev`)
-4. Save it to SNI:
+**Full step-by-step instructions for all three platforms are in [`worker/README.md`](worker/README.md).**
+
+Quick Deno Deploy setup (recommended):
+
+1. Go to https://dash.deno.com → sign in with GitHub → "New Project" → "Playground"
+2. Paste the contents of [`worker/proxy.deno.js`](worker/proxy.deno.js) → click "Save & Deploy"
+3. Copy the URL (e.g. `https://your-project.deno.dev`)
+4. Save to SNI:
 
    ```bash
-   sni config --update allanime_cf_worker_url='https://xan-proxy.you.workers.dev'
+   sni config --update allanime_cf_worker_url='https://your-project.deno.dev'
    ```
 
-**Can't create a Cloudflare account?** Deploy the same `worker.js` code to any of these alternative platforms (all have free tiers, none require a credit card):
-
-- **Deno Deploy** (https://dash.deno.com) — free, no card required, fastest setup. Wrap the worker's `fetch` handler in a `Deno.serve()` call.
-- **Vercel Edge Functions** (https://vercel.com) — free tier. Adapt the handler to Vercel's `export default function handler(req: Request)` signature.
-- **Netlify Functions** (https://netlify.com) — free tier. Convert to Netlify's `exports.handler` format.
+5. Try: `sni play "one piece"`
 
 The worker code is platform-agnostic — it's just a `fetch` handler that proxies a request. The only thing that changes between platforms is the entry-point wrapper.
 

{sni_cli-1.2.2 → sni_cli-1.2.4}/pyproject.toml

@@ -9,7 +9,7 @@ build-backend = "hatchling.build"
 # just `sni` (defined below in [project.scripts]), so users run `sni play`,
 # `sni tui`, etc. — only `pip install sni-cli` differs from the bare name.
 name = "sni-cli"
-version = "1.2.2"
+version = "1.2.4"
 description = "Stream Ninja Interface — terminal-based anime streaming CLI + TUI"
 readme = "README.md"
 requires-python = ">=3.10"

sni_cli-1.2.4/sni/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.2.4"

{sni_cli-1.2.2 → sni_cli-1.2.4}/sni/cli.py

@@ -529,17 +529,16 @@ def config(
             "    sni config --update allanime_cookies='cf_clearance=...;'\n"
             "  Or write to file (easier to refresh):\n"
             f"    echo 'cf_clearance=...;' > {DEFAULT_COOKIES_PATH}\n\n"
-            "[bold yellow]Option 2 - Cloudflare Worker[/bold yellow]\n"
+            "[bold yellow]Option 2 - Self-hosted proxy worker[/bold yellow]\n"
             "[bold yellow](last resort for VPN/shared IPs):[/bold yellow]\n"
-            "  Deploy the XAN CF Worker (free, requires Cloudflare account):\n"
-            "    1. https://dash.cloudflare.com -> Workers & Pages -> Create\n"
-            "    2. Paste XAN/cf-worker/worker.js from the XAN repo\n"
-            "    3. Deploy, copy the worker URL\n"
-            "    4. sni config --update allanime_cf_worker_url='https://your-worker.workers.dev'\n"
-            "  Can't create a Cloudflare account? Deploy the same worker.js to:\n"
-            "    - Deno Deploy (https://dash.deno.com) - free, no card required\n"
-            "    - Vercel Edge Functions (https://vercel.com) - free tier\n"
-            "    - Netlify Functions (https://netlify.com) - free tier\n",
+            "  SNI ships worker code in the worker/ directory. Deploy to ANY of:\n"
+            "    - Deno Deploy (recommended): https://dash.deno.com -> Playground\n"
+            "      Paste worker/proxy.deno.js -> Save & Deploy. ~2 min, no card.\n"
+            "    - Vercel Edge Functions: https://vercel.com (3 min)\n"
+            "    - Cloudflare Workers: https://dash.cloudflare.com (5 min, flaky)\n"
+            "  See worker/README.md in the repo for full step-by-step.\n"
+            "  Then save the URL:\n"
+            "    sni config --update allanime_cf_worker_url='https://your-deployment'\n",
             title="AllAnime captcha bypass",
             border_style="cyan",
         ))

{sni_cli-1.2.2 → sni_cli-1.2.4}/sni/providers/allanime.py

@@ -242,8 +242,8 @@ class AllAnimeProvider(Provider):
         Fallback order:
           1. Direct request to api.allanime.day (fastest when not captcha-walled)
           2. Each public CORS proxy in PUBLIC_PROXIES (no user config needed)
-          3. CF Worker (only if user configured allanime_cf_worker_url — but
-             CF Workers are GET-only, so this raises a clear error instead)
+          3. CF Worker (if user configured allanime_cf_worker_url — the v3
+             worker in worker/proxy.js supports POST)
 
         CaptchaRequiredError is raised only when ALL fallbacks fail.
         """
@@ -255,6 +255,12 @@ class AllAnimeProvider(Provider):
         fallbacks: List[tuple] = [("direct", self.GRAPHQL_URL)]
         for i in range(len(self.PUBLIC_PROXIES)):
             fallbacks.append(("proxy", self._proxy_url(i, self.GRAPHQL_URL)))
+        if self.cf_worker_url:
+            # CF Worker v3 supports POST — body is forwarded as-is
+            fallbacks.append(("worker", _build_cf_worker_url(
+                self.cf_worker_url, self.GRAPHQL_URL,
+                extra_headers={"Referer": self.REFERER, "Origin": self.ORIGIN},
+            )))
 
         # If a proxy previously worked, try it first (skip the dead direct)
         if self._working_proxy_idx is not None:

sni_cli-1.2.4/worker/README.md

@@ -0,0 +1,133 @@
+# SNI Stream Proxy — Self-Hostable Captcha Bypass
+
+This directory contains the proxy worker code that SNI uses as a fallback when your IP is captcha-walled on `api.allanime.day`. The worker is a simple JavaScript `fetch` handler that proxies requests through a clean IP (the platform's IP, not yours), which AllAnime's Cloudflare edge doesn't flag.
+
+## When you need this
+
+You need this **only** if ALL of these are true:
+
+1. `sni play "one piece"` fails with `NEED_CAPTCHA` or `ConnectTimeout`
+2. `curl -I https://api.allanime.day` times out or returns 403 from your machine
+3. `curl -I https://proxy.cors.sh` also times out (SNI's built-in public proxy fallback doesn't work for you)
+
+If any of those work, you don't need this — SNI's built-in fallbacks already cover you.
+
+## Three deployment options (all free, no credit card required)
+
+Pick **one**. All three run the same JavaScript code (slightly different entry-point wrappers).
+
+| Platform | Free tier | Signup difficulty | Setup time |
+|---|---|---|---|
+| **Deno Deploy** | 1M req/month | Easy (GitHub login) | ~2 min |
+| **Vercel Edge Functions** | 1M req/month | Easy (GitHub login) | ~3 min |
+| **Cloudflare Workers** | 100K req/day | Hard right now (deploy bugs) | ~5 min |
+
+**If you can't create a Cloudflare Worker (the Hello World project won't deploy), use Deno Deploy instead — it's the most reliable as of 2026.**
+
+---
+
+## Option 1: Deno Deploy (recommended — most reliable)
+
+1. Go to https://dash.deno.com → Sign in with GitHub
+2. Click **"New Project"**
+3. Click **"Playground"** (top-right, lets you paste code directly — no GitHub repo needed)
+4. Delete the default code, paste the entire contents of [`proxy.deno.js`](./proxy.deno.js) from this directory
+5. Click **"Save & Deploy"**
+6. You'll get a URL like `https://your-project.deno.dev` — copy it
+7. Test it in your browser: visit `https://your-project.deno.dev/` — you should see `{"ok":true,"service":"sni-stream-proxy",...}`
+8. Save it to SNI:
+
+   ```bash
+   sni config --update allanime_cf_worker_url='https://your-project.deno.dev'
+   ```
+
+9. Try SNI: `sni play "one piece"`
+
+---
+
+## Option 2: Vercel Edge Functions
+
+1. Go to https://vercel.com → Sign in with GitHub
+2. Click **"Add New"** → **"Project"**
+3. Click **"Create New Project"** → under "No Framework", click **"Browse all templates"** → pick **"Blank"**
+4. Name your project, click **"Deploy"** (this creates an empty project)
+5. Once deployed, click **"Continue to Dashboard"** → **"Code"** tab → **"Files"** tab
+6. Create a new folder called `api` and a file inside it called `proxy.js`
+7. Paste the entire contents of [`api/proxy.js`](./api/proxy.js) into that file
+8. Click **"Commit"** → **"Commit & Deploy"**
+9. Once redeployed, your URL will be `https://your-project.vercel.app/api/proxy` — copy it
+10. Test it in your browser: visit `https://your-project.vercel.app/api/proxy` — you should see `{"ok":true,...}`
+11. Save it to SNI:
+
+    ```bash
+    sni config --update allanime_cf_worker_url='https://your-project.vercel.app/api/proxy'
+    ```
+
+12. Try SNI: `sni play "one piece"`
+
+---
+
+## Option 3: Cloudflare Workers
+
+Use this only if Deno Deploy and Vercel both fail for you.
+
+1. Go to https://dash.cloudflare.com → sign up / sign in
+2. Left sidebar → **"Workers & Pages"** → **"Create"** → **"Create Worker"**
+3. Give it a name (e.g. `sni-proxy`) → click **"Deploy"**
+4. Click **"Edit code"** (top-right)
+5. Delete the default code, paste the entire contents of [`proxy.js`](./proxy.js) from this directory
+6. Click **"Deploy"** (top-right)
+7. Your URL will be `https://sni-proxy.<your-subdomain>.workers.dev` — copy it
+8. Test it in your browser: visit the URL — you should see `{"ok":true,...}`
+9. Save it to SNI:
+
+   ```bash
+   sni config --update allanime_cf_worker_url='https://sni-proxy.your-subdomain.workers.dev'
+   ```
+
+10. Try SNI: `sni play "one piece"`
+
+**If the "Hello World" project won't deploy:** This is a known Cloudflare dashboard bug. Try:
+- Use a different browser (Chrome instead of Firefox, or vice versa)
+- Disable ad-blockers / privacy extensions
+- Try incognito mode
+- Wait 30 minutes and retry (sometimes it's a transient outage)
+- **Or just use Deno Deploy instead** (Option 1) — it's more reliable right now
+
+---
+
+## How it works
+
+SNI's `AllAnimeProvider` tries these in order when fetching anime data:
+
+1. **Direct request** to `api.allanime.day` — fastest, works for most users
+2. **proxy.cors.sh** (built-in public proxy) — automatic fallback, no setup needed
+3. **Your self-hosted worker** (this directory) — last resort, only used if you configured `allanime_cf_worker_url`
+4. **CF Worker** (Cloudflare's own IPs) — same as #3, just deployed on Cloudflare specifically
+
+The worker:
+- Accepts GET and POST requests
+- Proxies them to the target URL with proper headers (Referer, Origin, User-Agent)
+- Only allows requests to a hardcoded list of AllAnime-related hosts (security: prevents abuse)
+- Streams the response body back (supports large video files)
+
+## Security
+
+The worker has a hardcoded allowlist of hosts it will proxy (`ALLOWED_HOSTS` in the code). It will refuse to proxy requests to any other host. This prevents someone from using your worker as an open proxy for arbitrary traffic.
+
+## Verification
+
+After configuring your worker URL, verify SNI can use it:
+
+```bash
+# Should print the version
+sni --version
+
+# Should search successfully (using your worker if direct fails)
+sni search "one piece"
+
+# Should play successfully
+sni play "one piece"
+```
+
+If you still get `NEED_CAPTCHA` or `ConnectTimeout`, run `sni config --cookie-info` for more options or open an issue at https://github.com/sundeepyt2/SNI/issues

sni_cli-1.2.2/sni/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.2.2"