seedr-py 0.1.0__tar.gz

seedr_py-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Developer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

seedr_py-0.1.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: seedr-py
+Version: 0.1.0
+Summary: Modern Python client and API wrapper for Seedr.cc with zero-CAPTCHA authentication, folder ZIP streaming, and HLS playback.
+Author-email: Nishant <nishantprime@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/nishantprime/seedr-py
+Project-URL: Bug Tracker, https://github.com/nishantprime/seedr-py/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# seedr-py ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/seedr-py.svg)](https://pypi.org/project/seedr-py/)
+[![Python versions](https://img.shields.io/pypi/pyversions/seedr-py.svg)](https://pypi.org/project/seedr-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A modern, high-speed Python client and API wrapper for **[Seedr.cc](https://www.seedr.cc)**.
+
+Designed to overcome the limitations of legacy wrappers: provides **zero-CAPTCHA email/password authentication**, **one-click full folder ZIP downloads without mCaptcha**, **browser-compatible HLS video streaming**, and clean dataclass models.
+
+---
+
+## ✨ Features
+
+- 🚀 **Zero-CAPTCHA Login:** Authenticates programmatically via Seedr's internal identity handshake (`seedr_sbvt`). No browser automation or CAPTCHA solving required.
+- 📦 **One-Click Folder ZIP Downloads:** Download entire subfolder structures as a single ZIP archive directly from Seedr CDN with zero mCaptcha prompts.
+- 🎬 **HLS Video Streaming:** Access both raw 1080p/4K bitrate files and browser-compatible HLS (`.m3u8`) streams with auto-converted AAC stereo audio (fixing silent Dolby EAC3 audio in Chrome/Firefox).
+- 🧲 **Magnets & `.torrent` Files:** Supports magnet links, direct torrent URLs, and local `.torrent` file uploads.
+- 📂 **Full Cloud File Management:** List directories, inspect quotas, retrieve direct CDN download links, cancel downloading tasks, and batch delete.
+- 🛡️ **Fully Typed Dataclasses:** Every response returns rich, typed models (`FolderContents`, `SeedrFile`, `Quota`, `AccountSettings`, `VideoStream`).
+
+---
+
+## 📦 Installation
+
+```bash
+pip install seedr-py
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Authenticate
+
+```python
+from seedr_py import SeedrClient
+
+# Login with email and password (Zero CAPTCHA)
+client = SeedrClient.from_password("your_email@example.com", "your_password")
+
+# Or authenticate using cookies
+client = SeedrClient.from_cookies({
+    "seedr_ptok": "your_token",
+    "RSESS_remember": "your_session"
+})
+```
+
+### 2. Check Quota & Account
+
+```python
+quota = client.get_quota()
+print(f"Storage: {quota.space_used_formatted} / {quota.space_max_formatted} ({quota.space_pct}%)")
+
+account = client.get_account_settings()
+print(f"Logged in as: {account.email} (User ID: {account.user_id})")
+```
+
+### 3. Browse Files & Folders
+
+```python
+# folder_id=0 represents the root directory
+root = client.get_folder(0)
+
+# List subfolders
+for folder in root.folders:
+    print(f"📁 {folder.name} (ID: {folder.id}, Size: {folder.size_formatted})")
+
+# List files
+for file in root.files:
+    print(f"📄 {file.name} (ID: {file.id}, Size: {file.size_formatted})")
+
+# List active torrent transfers
+for task in root.tasks:
+    print(f"⚡ {task.name}: {task.progress}% @ {task.download_rate / 1024:.1f} KB/s")
+```
+
+### 4. Download Entire Folder as a ZIP (No CAPTCHA)
+
+```python
+# 1. Get the direct signed ZIP URL from Seedr CDN
+archive = client.get_folder_zip_url(folder_id=1438069680)
+print("Signed ZIP Download Link:", archive.url)
+
+# 2. Or stream it directly to disk
+client.download_folder_zip(folder_id=1438069680, save_path="MyFolder.zip")
+```
+
+### 5. Add Torrents & Magnet Links
+
+```python
+# Add a magnet link
+task = client.add_magnet("magnet:?xt=urn:btih:08ada5a7a6183aae1e0908bc1376f4c61b03387c...")
+print(f"Transfer queued! Torrent ID: {task.get('user_torrent_id')}")
+
+# Or upload a local .torrent file
+client.add_torrent_file("ubuntu-24.04.torrent")
+```
+
+### 6. Stream Videos with Browser-Compatible Audio
+
+```python
+stream = client.get_video_stream(file_id=6018680430)
+
+# Universal HLS stream with converted AAC audio
+print("HLS Stream URL:", stream.hls_url)
+
+# Raw untouched 1080p/4K bitrate stream (for VLC / external players)
+print("Raw Stream URL:", stream.raw_url)
+
+# Multi-language subtitle tracks (.vtt)
+print("Subtitles:", stream.subtitles)
+```
+
+### 7. Delete Files, Folders, or Tasks
+
+```python
+# Cancel an active downloading torrent
+client.cancel_task(task_id=200392405)
+
+# Delete a folder
+client.delete_folder(folder_id=1438069680)
+
+# Delete a file
+client.delete_file(file_id=6018680430)
+```
+
+---
+
+## 📜 License
+
+MIT License. See [LICENSE](LICENSE) for details.

seedr_py-0.1.0/README.md

@@ -0,0 +1,132 @@
+# seedr-py ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/seedr-py.svg)](https://pypi.org/project/seedr-py/)
+[![Python versions](https://img.shields.io/pypi/pyversions/seedr-py.svg)](https://pypi.org/project/seedr-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A modern, high-speed Python client and API wrapper for **[Seedr.cc](https://www.seedr.cc)**.
+
+Designed to overcome the limitations of legacy wrappers: provides **zero-CAPTCHA email/password authentication**, **one-click full folder ZIP downloads without mCaptcha**, **browser-compatible HLS video streaming**, and clean dataclass models.
+
+---
+
+## ✨ Features
+
+- 🚀 **Zero-CAPTCHA Login:** Authenticates programmatically via Seedr's internal identity handshake (`seedr_sbvt`). No browser automation or CAPTCHA solving required.
+- 📦 **One-Click Folder ZIP Downloads:** Download entire subfolder structures as a single ZIP archive directly from Seedr CDN with zero mCaptcha prompts.
+- 🎬 **HLS Video Streaming:** Access both raw 1080p/4K bitrate files and browser-compatible HLS (`.m3u8`) streams with auto-converted AAC stereo audio (fixing silent Dolby EAC3 audio in Chrome/Firefox).
+- 🧲 **Magnets & `.torrent` Files:** Supports magnet links, direct torrent URLs, and local `.torrent` file uploads.
+- 📂 **Full Cloud File Management:** List directories, inspect quotas, retrieve direct CDN download links, cancel downloading tasks, and batch delete.
+- 🛡️ **Fully Typed Dataclasses:** Every response returns rich, typed models (`FolderContents`, `SeedrFile`, `Quota`, `AccountSettings`, `VideoStream`).
+
+---
+
+## 📦 Installation
+
+```bash
+pip install seedr-py
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Authenticate
+
+```python
+from seedr_py import SeedrClient
+
+# Login with email and password (Zero CAPTCHA)
+client = SeedrClient.from_password("your_email@example.com", "your_password")
+
+# Or authenticate using cookies
+client = SeedrClient.from_cookies({
+    "seedr_ptok": "your_token",
+    "RSESS_remember": "your_session"
+})
+```
+
+### 2. Check Quota & Account
+
+```python
+quota = client.get_quota()
+print(f"Storage: {quota.space_used_formatted} / {quota.space_max_formatted} ({quota.space_pct}%)")
+
+account = client.get_account_settings()
+print(f"Logged in as: {account.email} (User ID: {account.user_id})")
+```
+
+### 3. Browse Files & Folders
+
+```python
+# folder_id=0 represents the root directory
+root = client.get_folder(0)
+
+# List subfolders
+for folder in root.folders:
+    print(f"📁 {folder.name} (ID: {folder.id}, Size: {folder.size_formatted})")
+
+# List files
+for file in root.files:
+    print(f"📄 {file.name} (ID: {file.id}, Size: {file.size_formatted})")
+
+# List active torrent transfers
+for task in root.tasks:
+    print(f"⚡ {task.name}: {task.progress}% @ {task.download_rate / 1024:.1f} KB/s")
+```
+
+### 4. Download Entire Folder as a ZIP (No CAPTCHA)
+
+```python
+# 1. Get the direct signed ZIP URL from Seedr CDN
+archive = client.get_folder_zip_url(folder_id=1438069680)
+print("Signed ZIP Download Link:", archive.url)
+
+# 2. Or stream it directly to disk
+client.download_folder_zip(folder_id=1438069680, save_path="MyFolder.zip")
+```
+
+### 5. Add Torrents & Magnet Links
+
+```python
+# Add a magnet link
+task = client.add_magnet("magnet:?xt=urn:btih:08ada5a7a6183aae1e0908bc1376f4c61b03387c...")
+print(f"Transfer queued! Torrent ID: {task.get('user_torrent_id')}")
+
+# Or upload a local .torrent file
+client.add_torrent_file("ubuntu-24.04.torrent")
+```
+
+### 6. Stream Videos with Browser-Compatible Audio
+
+```python
+stream = client.get_video_stream(file_id=6018680430)
+
+# Universal HLS stream with converted AAC audio
+print("HLS Stream URL:", stream.hls_url)
+
+# Raw untouched 1080p/4K bitrate stream (for VLC / external players)
+print("Raw Stream URL:", stream.raw_url)
+
+# Multi-language subtitle tracks (.vtt)
+print("Subtitles:", stream.subtitles)
+```
+
+### 7. Delete Files, Folders, or Tasks
+
+```python
+# Cancel an active downloading torrent
+client.cancel_task(task_id=200392405)
+
+# Delete a folder
+client.delete_folder(folder_id=1438069680)
+
+# Delete a file
+client.delete_file(file_id=6018680430)
+```
+
+---
+
+## 📜 License
+
+MIT License. See [LICENSE](LICENSE) for details.

seedr_py-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "seedr-py"
+version = "0.1.0"
+authors = [
+  { name = "Nishant", email = "nishantprime@gmail.com" },
+]
+description = "Modern Python client and API wrapper for Seedr.cc with zero-CAPTCHA authentication, folder ZIP streaming, and HLS playback."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/nishantprime/seedr-py"
+"Bug Tracker" = "https://github.com/nishantprime/seedr-py/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

seedr_py-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

seedr_py-0.1.0/src/seedr_py/__init__.py

@@ -0,0 +1,45 @@
+"""
+seedr-py: A modern, reverse-engineered Python wrapper for Seedr.cc
+"""
+
+from seedr_py.client import SeedrClient
+from seedr_py.models import (
+    AccountSettings,
+    Quota,
+    SeedrFile,
+    SubFolder,
+    Task,
+    FolderContents,
+    DownloadLink,
+    FolderArchive,
+    VideoStream
+)
+from seedr_py.exceptions import (
+    SeedrError,
+    AuthenticationError,
+    APIError,
+    TorrentError,
+    NotFoundError
+)
+from seedr_py.utils import format_bytes, torrent_to_magnet
+
+__version__ = "0.1.0"
+__all__ = [
+    "SeedrClient",
+    "AccountSettings",
+    "Quota",
+    "SeedrFile",
+    "SubFolder",
+    "Task",
+    "FolderContents",
+    "DownloadLink",
+    "FolderArchive",
+    "VideoStream",
+    "SeedrError",
+    "AuthenticationError",
+    "APIError",
+    "TorrentError",
+    "NotFoundError",
+    "format_bytes",
+    "torrent_to_magnet",
+]

seedr_py-0.1.0/src/seedr_py/client.py

@@ -0,0 +1,352 @@
+"""
+Core Seedr Client implementation.
+"""
+
+import os
+import json
+import time
+import requests
+from typing import Dict, Any, List, Optional, Union
+
+from seedr_py.models import (
+    AccountSettings,
+    Quota,
+    SeedrFile,
+    SubFolder,
+    Task,
+    FolderContents,
+    DownloadLink,
+    FolderArchive,
+    VideoStream
+)
+from seedr_py.exceptions import (
+    AuthenticationError,
+    APIError,
+    TorrentError,
+    NotFoundError
+)
+from seedr_py.utils import torrent_to_magnet
+
+class SeedrClient:
+    """
+    Python client for Seedr.cc supporting:
+    - Zero-CAPTCHA email/password authentication
+    - Zero-CAPTCHA full folder ZIP archive generation
+    - Browser-compatible HLS video streaming
+    - Direct CDN signed file download links
+    - Magnet links and .torrent file uploads
+    """
+    BASE_URL = "https://www.seedr.cc/api/v0.1"
+
+    def __init__(self, session: Optional[requests.Session] = None, cookies: Optional[Dict[str, str]] = None):
+        self.session = session or requests.Session()
+        self.session.headers.update({
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+            "Accept": "application/json, text/plain, */*",
+            "Referer": "https://www.seedr.cc/files",
+        })
+        self._csrf_token: Optional[str] = None
+
+        if cookies:
+            for name, value in cookies.items():
+                self.session.cookies.set(name, value, domain=".seedr.cc")
+
+    def __enter__(self) -> "SeedrClient":
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb) -> None:
+        self.close()
+
+    def close(self) -> None:
+        """Close the underlying HTTP session."""
+        if self.session:
+            self.session.close()
+
+    @classmethod
+    def from_password(cls, email: str, password: str) -> "SeedrClient":
+        """
+        Authenticate directly using Email and Password via Seedr's internal
+        identity proof token (seedr_sbvt) handshake, completely bypassing
+        Cloudflare Turnstile and hCaptcha.
+        """
+        session = requests.Session()
+        session.headers.update({
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+            "Accept": "application/json, text/plain, */*",
+            "Referer": "https://www.seedr.cc/files",
+        })
+
+        # Step 1: Handshake for bind token (sbvt)
+        try:
+            ptok_resp = session.get(f"{cls.BASE_URL}/auth/ptok", timeout=12)
+            ptok_resp.raise_for_status()
+            sbvt = ptok_resp.json().get("sbvt")
+        except Exception as e:
+            raise AuthenticationError(f"Failed to obtain identity proof handshake: {e}") from e
+
+        # Step 2: Login request
+        login_payload = {
+            "username": email,
+            "password": password,
+            "rememberme": 1,
+            "seedr_sbvt": sbvt
+        }
+        try:
+            resp = session.post(f"{cls.BASE_URL}/auth/login", json=login_payload, timeout=15)
+            data = resp.json()
+        except Exception as e:
+            raise AuthenticationError(f"Login request failed: {e}") from e
+
+        if resp.status_code != 200 or not data.get("success"):
+            reason = data.get("reason_phrase") or data.get("error") or "Authentication failed"
+            raise AuthenticationError(f"Invalid credentials ({resp.status_code}): {reason}")
+
+        # Step 3: Populate any additional cookie strings from response payload
+        if "cookies" in data:
+            for c_str in data["cookies"]:
+                parts = c_str.split(";")[0].split("=", 1)
+                if len(parts) == 2:
+                    session.cookies.set(parts[0].strip(), parts[1].strip(), domain=".seedr.cc")
+
+        return cls(session=session)
+
+    @classmethod
+    def from_cookies(cls, cookies: Dict[str, str]) -> "SeedrClient":
+        """
+        Authenticate using pre-existing browser cookies (e.g. seedr_ptok or RSESS_remember).
+        """
+        return cls(cookies=cookies)
+
+    def _get_csrf_token(self, refresh: bool = False) -> str:
+        """Fetch and cache CSRF token required for mutating API actions."""
+        if not self._csrf_token or refresh:
+            url = f"{self.BASE_URL}/organization/csrf-token"
+            resp = self.session.get(url, timeout=12)
+            resp.raise_for_status()
+            self._csrf_token = resp.json().get("csrf_token")
+            self.session.headers["X-CSRF-Token"] = self._csrf_token
+        return self._csrf_token
+
+    def get_account_settings(self) -> AccountSettings:
+        """Fetch user profile details (email, user_id, storage quota, package type)."""
+        url = f"{self.BASE_URL}/account/settings"
+        resp = self.session.get(url, timeout=15)
+        if resp.status_code in (401, 403):
+            raise AuthenticationError("Session expired or unauthorized.")
+        resp.raise_for_status()
+        data = resp.json()
+        acc = data.get("account", {})
+        return AccountSettings(
+            user_id=acc.get("user_id", 0),
+            email=acc.get("email", ""),
+            username=acc.get("username", ""),
+            is_premium=acc.get("premium", False),
+            package_name=acc.get("package_name", "Free"),
+            space_used=acc.get("space_used", 0),
+            space_max=acc.get("space_max", 0),
+            country=data.get("country", "")
+        )
+
+    def get_quota(self) -> Quota:
+        """Fetch storage space and bandwidth quota information."""
+        url = f"{self.BASE_URL}/account/quota/used"
+        resp = self.session.get(url, timeout=12)
+        if resp.status_code in (401, 403):
+            raise AuthenticationError("Session expired or unauthorized.")
+        resp.raise_for_status()
+        data = resp.json()
+        return Quota(
+            space_used=data.get("space_used", 0),
+            space_max=data.get("space_max", 0),
+            bandwidth_used=data.get("bandwidth_used", 0),
+            is_premium=data.get("is_premium", False)
+        )
+
+    def get_folder(self, folder_id: int = 0) -> FolderContents:
+        """
+        Fetch subfolders, files, and active torrent tasks inside a directory.
+        folder_id = 0 represents the root directory.
+        """
+        url = f"{self.BASE_URL}/fs/folder/{folder_id}/items"
+        resp = self.session.get(url, timeout=15)
+        if resp.status_code in (401, 403):
+            raise AuthenticationError("Session expired or unauthorized.")
+        if resp.status_code == 404:
+            raise NotFoundError(f"Folder ID {folder_id} not found.")
+        resp.raise_for_status()
+        data = resp.json()
+
+        folders = [
+            SubFolder(
+                id=fo.get("id"),
+                name=fo.get("path"),
+                size=fo.get("size", 0),
+                last_update=fo.get("last_update", "")
+            )
+            for fo in data.get("folders", [])
+        ]
+
+        files = [
+            SeedrFile(
+                id=fi.get("id"),
+                name=fi.get("name"),
+                size=fi.get("size", 0),
+                hash=fi.get("hash", ""),
+                folder_id=fi.get("folder_id", folder_id),
+                is_video=fi.get("is_video", False),
+                is_audio=fi.get("is_audio", False),
+                thumb=fi.get("thumb", "")
+            )
+            for fi in data.get("files", [])
+        ]
+
+        tasks = [
+            Task(
+                id=t.get("id"),
+                name=t.get("name", ""),
+                size=t.get("size", 0),
+                progress=t.get("progress", 0.0),
+                download_rate=t.get("download_rate", 0),
+                seeders=t.get("seeders", 0),
+                leechers=t.get("leechers", 0)
+            )
+            for t in (data.get("torrents", []) or data.get("tasks", []))
+        ]
+
+        return FolderContents(
+            id=data.get("id", folder_id),
+            path=data.get("path", "Home"),
+            parent_id=data.get("parent", -1),
+            folders=folders,
+            files=files,
+            tasks=tasks
+        )
+
+    def get_file_url(self, file_id: int) -> DownloadLink:
+        """Generate a signed high-speed CDN direct download link for a file."""
+        url = f"{self.BASE_URL}/download/file/{file_id}/url"
+        resp = self.session.get(url, timeout=12)
+        if resp.status_code == 404:
+            raise NotFoundError(f"File ID {file_id} not found.")
+        resp.raise_for_status()
+        data = resp.json()
+        return DownloadLink(url=data.get("url"), name=data.get("name", ""))
+
+    def get_folder_zip_url(self, folder_id: int) -> FolderArchive:
+        """
+        Generate a signed direct ZIP archive URL for an entire folder without CAPTCHA.
+        Uses POST /api/v0.1/download/archive with X-CSRF-Token.
+        """
+        self._get_csrf_token()
+        url = f"{self.BASE_URL}/download/archive"
+        payload = {
+            "archive_arr": json.dumps([{"type": "folder", "id": folder_id}])
+        }
+        resp = self.session.post(url, data=payload, timeout=15)
+        resp.raise_for_status()
+        data = resp.json()
+        return FolderArchive(
+            archive_id=str(data.get("archive_id")),
+            url=data.get("url")
+        )
+
+    def download_folder_zip(self, folder_id: int, save_path: str, chunk_size: int = 128 * 1024) -> str:
+        """
+        Streams and saves an entire folder as a ZIP file directly to local disk.
+        """
+        archive = self.get_folder_zip_url(folder_id)
+        with requests.get(archive.url, stream=True, timeout=30) as r:
+            r.raise_for_status()
+            with open(save_path, "wb") as f:
+                for chunk in r.iter_content(chunk_size=chunk_size):
+                    if chunk:
+                        f.write(chunk)
+        return save_path
+
+    def get_video_stream(self, file_id: int) -> VideoStream:
+        """
+        Fetches streaming endpoints for a video file:
+        - raw_url: Direct untouched original bitrate file (1080p/4K)
+        - hls_url: Browser-compatible HLS stream with converted AAC audio
+        - subtitles: WebVTT multi-language subtitle tracks
+        """
+        dl = self.get_file_url(file_id)
+        hls_url = None
+        subtitles = {}
+
+        try:
+            resp = self.session.get(f"{self.BASE_URL}/media/hls/{file_id}", timeout=12)
+            if resp.status_code == 200:
+                h_data = resp.json()
+                hls_url = h_data.get("url")
+                subtitles = h_data.get("subtitles", {})
+        except Exception:
+            pass
+
+        return VideoStream(
+            file_id=file_id,
+            name=dl.name,
+            hls_url=hls_url,
+            raw_url=dl.url,
+            subtitles=subtitles
+        )
+
+    def add_magnet(self, magnet_link: str, folder_id: int = 0) -> Dict[str, Any]:
+        """Add a magnet link download to the account."""
+        self._get_csrf_token()
+        url = f"{self.BASE_URL}/task"
+        payload = {
+            "folder_id": folder_id,
+            "type": "torrent",
+            "torrent_magnet": magnet_link.strip()
+        }
+        resp = self.session.post(url, data=payload, timeout=15)
+        data = resp.json()
+        if not data.get("success"):
+            reason = data.get("reason_phrase") or "Failed to add magnet link."
+            raise TorrentError(reason)
+        return data
+
+    def add_torrent_file(self, torrent_input: Union[str, bytes], folder_id: int = 0) -> Dict[str, Any]:
+        """
+        Add a .torrent file to the account.
+        Accepts either a file path (str) or raw bytes.
+        """
+        if isinstance(torrent_input, str):
+            with open(torrent_input, "rb") as f:
+                torrent_bytes = f.read()
+        else:
+            torrent_bytes = torrent_input
+
+        magnet = torrent_to_magnet(torrent_bytes)
+        return self.add_magnet(magnet, folder_id=folder_id)
+
+    def cancel_task(self, task_id: int) -> bool:
+        """Cancel and delete an in-progress torrent task."""
+        self._get_csrf_token()
+        url = f"{self.BASE_URL}/tasks/{task_id}"
+        resp = self.session.delete(url, timeout=12)
+        resp.raise_for_status()
+        return resp.json().get("success", False)
+
+    def delete_folder(self, folder_id: int) -> bool:
+        """Delete a folder and its contents."""
+        return self.delete_batch([{"type": "folder", "id": folder_id}])
+
+    def delete_file(self, file_id: int) -> bool:
+        """Delete an individual file."""
+        return self.delete_batch([{"type": "file", "id": file_id}])
+
+    def delete_batch(self, items: List[Dict[str, Any]]) -> bool:
+        """
+        Batch delete folders and files.
+        items format: [{"type": "folder", "id": 123}, {"type": "file", "id": 456}]
+        """
+        self._get_csrf_token()
+        url = f"{self.BASE_URL}/fs/batch/delete"
+        payload = {
+            "delete_arr": json.dumps(items)
+        }
+        resp = self.session.post(url, data=payload, timeout=15)
+        resp.raise_for_status()
+        return resp.json().get("success", False)

seedr_py-0.1.0/src/seedr_py/exceptions.py

@@ -0,0 +1,26 @@
+"""
+Custom exceptions for seedr-py
+"""
+
+class SeedrError(Exception):
+    """Base exception for all Seedr errors."""
+    pass
+
+class AuthenticationError(SeedrError):
+    """Raised when authentication fails (invalid credentials or expired session)."""
+    pass
+
+class APIError(SeedrError):
+    """Raised when the Seedr API returns an error response."""
+    def __init__(self, message: str, status_code: int = None, response_data: dict = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.response_data = response_data
+
+class TorrentError(SeedrError):
+    """Raised when adding a magnet link or torrent fails."""
+    pass
+
+class NotFoundError(SeedrError):
+    """Raised when a requested file or folder is not found."""
+    pass

seedr_py-0.1.0/src/seedr_py/models.py

@@ -0,0 +1,116 @@
+"""
+Dataclass models representing Seedr resources.
+"""
+
+from dataclasses import dataclass, field
+from typing import List, Dict, Any, Optional
+from seedr_py.utils import format_bytes
+
+@dataclass
+class AccountSettings:
+    user_id: int
+    email: str
+    username: str
+    is_premium: bool
+    package_name: str
+    space_used: int
+    space_max: int
+    country: str = ""
+
+    @property
+    def space_used_formatted(self) -> str:
+        return format_bytes(self.space_used)
+
+    @property
+    def space_max_formatted(self) -> str:
+        return format_bytes(self.space_max)
+
+    @property
+    def space_pct(self) -> float:
+        return round((self.space_used / self.space_max) * 100, 1) if self.space_max > 0 else 0.0
+
+@dataclass
+class Quota:
+    space_used: int
+    space_max: int
+    bandwidth_used: int
+    is_premium: bool
+
+    @property
+    def space_used_formatted(self) -> str:
+        return format_bytes(self.space_used)
+
+    @property
+    def space_max_formatted(self) -> str:
+        return format_bytes(self.space_max)
+
+    @property
+    def space_pct(self) -> float:
+        return round((self.space_used / self.space_max) * 100, 1) if self.space_max > 0 else 0.0
+
+@dataclass
+class SeedrFile:
+    id: int
+    name: str
+    size: int
+    hash: str
+    folder_id: int
+    is_video: bool = False
+    is_audio: bool = False
+    thumb: str = ""
+
+    @property
+    def size_formatted(self) -> str:
+        return format_bytes(self.size)
+
+@dataclass
+class SubFolder:
+    id: int
+    name: str
+    size: int
+    last_update: str = ""
+
+    @property
+    def size_formatted(self) -> str:
+        return format_bytes(self.size)
+
+@dataclass
+class Task:
+    id: int
+    name: str
+    size: int
+    progress: float
+    download_rate: int
+    seeders: int = 0
+    leechers: int = 0
+
+    @property
+    def size_formatted(self) -> str:
+        return format_bytes(self.size)
+
+@dataclass
+class FolderContents:
+    id: int
+    path: str
+    parent_id: int
+    folders: List[SubFolder] = field(default_factory=list)
+    files: List[SeedrFile] = field(default_factory=list)
+    tasks: List[Task] = field(default_factory=list)
+
+@dataclass
+class DownloadLink:
+    url: str
+    name: str
+
+@dataclass
+class FolderArchive:
+    archive_id: str
+    url: str
+
+@dataclass
+class VideoStream:
+    file_id: int
+    name: str
+    hls_url: Optional[str]
+    raw_url: str
+    subtitles: Dict[str, str] = field(default_factory=dict)

seedr_py-0.1.0/src/seedr_py/utils.py

@@ -0,0 +1,92 @@
+"""
+Utility functions for torrent parsing and formatting.
+"""
+
+import hashlib
+from typing import Dict, Any, Tuple
+
+def format_bytes(num_bytes: int) -> str:
+    """Convert bytes count to human-readable string (e.g. 1.25 GB)."""
+    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
+        if num_bytes < 1024.0:
+            return f"{num_bytes:.2f} {unit}"
+        num_bytes /= 1024.0
+    return f"{num_bytes:.2f} PB"
+
+def bdecode(data: bytes) -> Any:
+    """Minimal, pure-Python bencode decoder for .torrent files."""
+    def decode_item(index: int) -> Tuple[Any, int]:
+        char = chr(data[index])
+        if char == 'i':
+            end = data.index(b'e', index)
+            return int(data[index + 1:end]), end + 1
+        elif char.isdigit():
+            colon = data.index(b':', index)
+            length = int(data[index:colon])
+            start = colon + 1
+            return data[start:start + length], start + length
+        elif char == 'l':
+            items = []
+            idx = index + 1
+            while chr(data[idx]) != 'e':
+                item, idx = decode_item(idx)
+                items.append(item)
+            return items, idx + 1
+        elif char == 'd':
+            items = {}
+            idx = index + 1
+            while chr(data[idx]) != 'e':
+                key, idx = decode_item(idx)
+                val, idx = decode_item(idx)
+                items[key.decode('utf-8', errors='ignore')] = val
+            return items, idx + 1
+        raise ValueError(f"Unknown bencode type at offset {index}: {char}")
+
+    return decode_item(0)[0]
+
+def torrent_to_magnet(torrent_bytes: bytes) -> str:
+    """
+    Extracts info-hash from raw .torrent file bytes and converts to magnet link.
+    """
+    info_start = torrent_bytes.find(b'4:info') + 6
+    if info_start < 6:
+        raise ValueError("Invalid .torrent file: 'info' dictionary not found.")
+
+    def find_end_dict(b: bytes, start: int) -> int:
+        depth = 0
+        i = start
+        while i < len(b):
+            c = chr(b[i])
+            if c in ('d', 'l'):
+                depth += 1
+                i += 1
+            elif c == 'i':
+                i = b.index(b'e', i) + 1
+            elif c.isdigit():
+                colon = b.index(b':', i)
+                length = int(b[i:colon])
+                i = colon + 1 + length
+            elif c == 'e':
+                depth -= 1
+                i += 1
+                if depth == 0:
+                    return i
+            else:
+                i += 1
+        return len(b)
+
+    info_end = find_end_dict(torrent_bytes, info_start)
+    raw_info = torrent_bytes[info_start:info_end]
+    sha1 = hashlib.sha1(raw_info).hexdigest()
+
+    name = "torrent"
+    try:
+        decoded = bdecode(torrent_bytes)
+        info_d = decoded.get('info', {})
+        if 'name' in info_d:
+            val = info_d['name']
+            name = val.decode('utf-8', errors='ignore') if isinstance(val, bytes) else str(val)
+    except Exception:
+        pass
+
+    return f"magnet:?xt=urn:btih:{sha1}&dn={name}"

seedr_py-0.1.0/src/seedr_py.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: seedr-py
+Version: 0.1.0
+Summary: Modern Python client and API wrapper for Seedr.cc with zero-CAPTCHA authentication, folder ZIP streaming, and HLS playback.
+Author-email: Nishant <nishantprime@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/nishantprime/seedr-py
+Project-URL: Bug Tracker, https://github.com/nishantprime/seedr-py/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# seedr-py ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/seedr-py.svg)](https://pypi.org/project/seedr-py/)
+[![Python versions](https://img.shields.io/pypi/pyversions/seedr-py.svg)](https://pypi.org/project/seedr-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A modern, high-speed Python client and API wrapper for **[Seedr.cc](https://www.seedr.cc)**.
+
+Designed to overcome the limitations of legacy wrappers: provides **zero-CAPTCHA email/password authentication**, **one-click full folder ZIP downloads without mCaptcha**, **browser-compatible HLS video streaming**, and clean dataclass models.
+
+---
+
+## ✨ Features
+
+- 🚀 **Zero-CAPTCHA Login:** Authenticates programmatically via Seedr's internal identity handshake (`seedr_sbvt`). No browser automation or CAPTCHA solving required.
+- 📦 **One-Click Folder ZIP Downloads:** Download entire subfolder structures as a single ZIP archive directly from Seedr CDN with zero mCaptcha prompts.
+- 🎬 **HLS Video Streaming:** Access both raw 1080p/4K bitrate files and browser-compatible HLS (`.m3u8`) streams with auto-converted AAC stereo audio (fixing silent Dolby EAC3 audio in Chrome/Firefox).
+- 🧲 **Magnets & `.torrent` Files:** Supports magnet links, direct torrent URLs, and local `.torrent` file uploads.
+- 📂 **Full Cloud File Management:** List directories, inspect quotas, retrieve direct CDN download links, cancel downloading tasks, and batch delete.
+- 🛡️ **Fully Typed Dataclasses:** Every response returns rich, typed models (`FolderContents`, `SeedrFile`, `Quota`, `AccountSettings`, `VideoStream`).
+
+---
+
+## 📦 Installation
+
+```bash
+pip install seedr-py
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Authenticate
+
+```python
+from seedr_py import SeedrClient
+
+# Login with email and password (Zero CAPTCHA)
+client = SeedrClient.from_password("your_email@example.com", "your_password")
+
+# Or authenticate using cookies
+client = SeedrClient.from_cookies({
+    "seedr_ptok": "your_token",
+    "RSESS_remember": "your_session"
+})
+```
+
+### 2. Check Quota & Account
+
+```python
+quota = client.get_quota()
+print(f"Storage: {quota.space_used_formatted} / {quota.space_max_formatted} ({quota.space_pct}%)")
+
+account = client.get_account_settings()
+print(f"Logged in as: {account.email} (User ID: {account.user_id})")
+```
+
+### 3. Browse Files & Folders
+
+```python
+# folder_id=0 represents the root directory
+root = client.get_folder(0)
+
+# List subfolders
+for folder in root.folders:
+    print(f"📁 {folder.name} (ID: {folder.id}, Size: {folder.size_formatted})")
+
+# List files
+for file in root.files:
+    print(f"📄 {file.name} (ID: {file.id}, Size: {file.size_formatted})")
+
+# List active torrent transfers
+for task in root.tasks:
+    print(f"⚡ {task.name}: {task.progress}% @ {task.download_rate / 1024:.1f} KB/s")
+```
+
+### 4. Download Entire Folder as a ZIP (No CAPTCHA)
+
+```python
+# 1. Get the direct signed ZIP URL from Seedr CDN
+archive = client.get_folder_zip_url(folder_id=1438069680)
+print("Signed ZIP Download Link:", archive.url)
+
+# 2. Or stream it directly to disk
+client.download_folder_zip(folder_id=1438069680, save_path="MyFolder.zip")
+```
+
+### 5. Add Torrents & Magnet Links
+
+```python
+# Add a magnet link
+task = client.add_magnet("magnet:?xt=urn:btih:08ada5a7a6183aae1e0908bc1376f4c61b03387c...")
+print(f"Transfer queued! Torrent ID: {task.get('user_torrent_id')}")
+
+# Or upload a local .torrent file
+client.add_torrent_file("ubuntu-24.04.torrent")
+```
+
+### 6. Stream Videos with Browser-Compatible Audio
+
+```python
+stream = client.get_video_stream(file_id=6018680430)
+
+# Universal HLS stream with converted AAC audio
+print("HLS Stream URL:", stream.hls_url)
+
+# Raw untouched 1080p/4K bitrate stream (for VLC / external players)
+print("Raw Stream URL:", stream.raw_url)
+
+# Multi-language subtitle tracks (.vtt)
+print("Subtitles:", stream.subtitles)
+```
+
+### 7. Delete Files, Folders, or Tasks
+
+```python
+# Cancel an active downloading torrent
+client.cancel_task(task_id=200392405)
+
+# Delete a folder
+client.delete_folder(folder_id=1438069680)
+
+# Delete a file
+client.delete_file(file_id=6018680430)
+```
+
+---
+
+## 📜 License
+
+MIT License. See [LICENSE](LICENSE) for details.

seedr_py-0.1.0/src/seedr_py.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/seedr_py/__init__.py
+src/seedr_py/client.py
+src/seedr_py/exceptions.py
+src/seedr_py/models.py
+src/seedr_py/utils.py
+src/seedr_py.egg-info/PKG-INFO
+src/seedr_py.egg-info/SOURCES.txt
+src/seedr_py.egg-info/dependency_links.txt
+src/seedr_py.egg-info/requires.txt
+src/seedr_py.egg-info/top_level.txt
+tests/test_client.py

seedr_py-0.1.0/src/seedr_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

seedr_py-0.1.0/src/seedr_py.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

seedr_py-0.1.0/src/seedr_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+seedr_py

seedr_py-0.1.0/tests/test_client.py

@@ -0,0 +1,12 @@
+import pytest
+from seedr_py import SeedrClient, format_bytes, torrent_to_magnet
+from seedr_py.exceptions import AuthenticationError
+
+def test_format_bytes():
+    assert format_bytes(500) == "500.00 B"
+    assert format_bytes(1024 * 1024) == "1.00 MB"
+    assert format_bytes(1024 * 1024 * 1024 * 2) == "2.00 GB"
+
+def test_invalid_login():
+    with pytest.raises(AuthenticationError):
+        SeedrClient.from_password("invalid@example.com", "wrongpass123")