boosty-milker 1.0.1__tar.gz

boosty_milker-1.0.1/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: boosty-milker
+Version: 1.0.1
+Summary: CLI tool to download photos from Boosty.to
+Author-email: F3T1W <f3t1w@icloud.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: tqdm>=4.65.0
+Requires-Dist: colorama>=0.4.6
+
+# Boosty Milker 🥛
+
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/F3T1W/BoostyMilker)](https://github.com/F3T1W/BoostyMilker/releases)
+[![PyPI version](https://img.shields.io/pypi/v/boosty-milker)](https://pypi.org/project/boosty-milker/)
+[![Chocolatey Version](https://img.shields.io/chocolatey/v/boosty-milker)](https://community.chocolatey.org/packages/boosty-milker)
+[![Homebrew](https://img.shields.io/badge/homebrew-tap-orange)](https://github.com/F3T1W/homebrew-tap)
+[![APT](https://img.shields.io/badge/debian-apt-red)](https://github.com/F3T1W/apt-repo)
+
+**Boosty Milker** is a powerful cross-platform CLI tool to bulk download photos from Boosty.to creators.
+
+🚀 **Features:**
+*   📥 Download all photos from all posts of a creator.
+*   🔓 Support for premium/subscriber-only content (via auth token).
+*   ⚡ Async downloads (fast and efficient).
+*   🖥️ Works on **Windows, macOS, and Linux**.
+*   💾 Smart download (skips already existing files).
+
+---
+
+## 📦 Installation
+
+### 🍎 macOS (Homebrew)
+The easiest way for Mac users:
+```bash
+brew tap F3T1W/tap
+brew install boosty-milker
+```
+
+### 🐧 Linux (Debian / Ubuntu / APT)
+Add the repository and install:
+```bash
+echo "deb [trusted=yes] https://F3T1W.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/f3t1w.list
+sudo apt-get update
+sudo apt-get install boosty-milker
+```
+*Alternatively, download the `.deb` file manually from [Releases](https://github.com/F3T1W/BoostyMilker/releases).*
+
+### 🪟 Windows (Chocolatey)
+Install via PowerShell:
+```powershell
+choco install boosty-milker
+```
+
+### 🐍 Python (PIP)
+Universal method for any OS (requires Python 3.10+):
+```bash
+pip install boosty-milker
+```
+
+### 📁 Manual Binaries
+If you don't want to install anything, just download the executable for your OS from **[Releases](https://github.com/F3T1W/BoostyMilker/releases)**, place it in a convenient folder, and run it via terminal.
+
+---
+
+## 🚀 Usage
+
+### 1. Download Free Posts
+```bash
+boosty-milker --username "artist_name" --directory "./downloads"
+```
+* `artist_name` — creator's username from the URL (e.g., for `boosty.to/cool_art` the username is `cool_art`).
+* `directory` — folder to save photos.
+
+### 2. Download Premium Content (Subscribers)
+If you are subscribed to a creator, you need to provide your auth token to download private posts.
+
+1.  Open [Boosty.to](https://boosty.to) in your browser.
+2.  Press `F12` -> Go to **Application** (or Storage) tab.
+3.  In the left menu, select **Cookies** -> `https://boosty.to`.
+4.  Find the cookie named `auth_token` or `accessToken` and copy its value.
+
+Run:
+```bash
+boosty-milker --username "artist_name" --directory "./downloads" --auth_token "YOUR_TOKEN"
+```
+
+### All Arguments
+```text
+options:
+  -h, --help            show this help message
+  --username USERNAME   Boosty creator username (from URL)
+  --directory DIRECTORY Directory to save photos
+  --auth_token TOKEN    Auth token (Bearer/accessToken) for private content
+  --max_concurrency N   Number of concurrent downloads (default: 10)
+```
+
+---
+
+## ⚠️ Disclaimer
+This tool is for personal use only. Please only download content you have legal access to. The author is not responsible for any misuse of this software or violations of Boosty.to terms of service.
+
+---
+
+Made with ❤️ by [F3T1W](https://github.com/F3T1W)

boosty_milker-1.0.1/README.md

@@ -0,0 +1,94 @@
+# Boosty Milker 🥛
+
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/F3T1W/BoostyMilker)](https://github.com/F3T1W/BoostyMilker/releases)
+[![PyPI version](https://img.shields.io/pypi/v/boosty-milker)](https://pypi.org/project/boosty-milker/)
+[![Chocolatey Version](https://img.shields.io/chocolatey/v/boosty-milker)](https://community.chocolatey.org/packages/boosty-milker)
+[![Homebrew](https://img.shields.io/badge/homebrew-tap-orange)](https://github.com/F3T1W/homebrew-tap)
+[![APT](https://img.shields.io/badge/debian-apt-red)](https://github.com/F3T1W/apt-repo)
+
+**Boosty Milker** is a powerful cross-platform CLI tool to bulk download photos from Boosty.to creators.
+
+🚀 **Features:**
+*   📥 Download all photos from all posts of a creator.
+*   🔓 Support for premium/subscriber-only content (via auth token).
+*   ⚡ Async downloads (fast and efficient).
+*   🖥️ Works on **Windows, macOS, and Linux**.
+*   💾 Smart download (skips already existing files).
+
+---
+
+## 📦 Installation
+
+### 🍎 macOS (Homebrew)
+The easiest way for Mac users:
+```bash
+brew tap F3T1W/tap
+brew install boosty-milker
+```
+
+### 🐧 Linux (Debian / Ubuntu / APT)
+Add the repository and install:
+```bash
+echo "deb [trusted=yes] https://F3T1W.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/f3t1w.list
+sudo apt-get update
+sudo apt-get install boosty-milker
+```
+*Alternatively, download the `.deb` file manually from [Releases](https://github.com/F3T1W/BoostyMilker/releases).*
+
+### 🪟 Windows (Chocolatey)
+Install via PowerShell:
+```powershell
+choco install boosty-milker
+```
+
+### 🐍 Python (PIP)
+Universal method for any OS (requires Python 3.10+):
+```bash
+pip install boosty-milker
+```
+
+### 📁 Manual Binaries
+If you don't want to install anything, just download the executable for your OS from **[Releases](https://github.com/F3T1W/BoostyMilker/releases)**, place it in a convenient folder, and run it via terminal.
+
+---
+
+## 🚀 Usage
+
+### 1. Download Free Posts
+```bash
+boosty-milker --username "artist_name" --directory "./downloads"
+```
+* `artist_name` — creator's username from the URL (e.g., for `boosty.to/cool_art` the username is `cool_art`).
+* `directory` — folder to save photos.
+
+### 2. Download Premium Content (Subscribers)
+If you are subscribed to a creator, you need to provide your auth token to download private posts.
+
+1.  Open [Boosty.to](https://boosty.to) in your browser.
+2.  Press `F12` -> Go to **Application** (or Storage) tab.
+3.  In the left menu, select **Cookies** -> `https://boosty.to`.
+4.  Find the cookie named `auth_token` or `accessToken` and copy its value.
+
+Run:
+```bash
+boosty-milker --username "artist_name" --directory "./downloads" --auth_token "YOUR_TOKEN"
+```
+
+### All Arguments
+```text
+options:
+  -h, --help            show this help message
+  --username USERNAME   Boosty creator username (from URL)
+  --directory DIRECTORY Directory to save photos
+  --auth_token TOKEN    Auth token (Bearer/accessToken) for private content
+  --max_concurrency N   Number of concurrent downloads (default: 10)
+```
+
+---
+
+## ⚠️ Disclaimer
+This tool is for personal use only. Please only download content you have legal access to. The author is not responsible for any misuse of this software or violations of Boosty.to terms of service.
+
+---
+
+Made with ❤️ by [F3T1W](https://github.com/F3T1W)

boosty_milker-1.0.1/boosty_milker/__init__.py

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

boosty_milker-1.0.1/boosty_milker/main.py

@@ -0,0 +1,225 @@
+import argparse
+import asyncio
+import os
+import sys
+import logging
+import json
+import re
+from pathlib import Path
+from typing import List, Optional, Dict, Any
+from datetime import datetime
+
+import aiohttp
+from tqdm.asyncio import tqdm
+from colorama import init, Fore, Style
+
+# Initialize colorama
+init(autoreset=True)
+
+# Logging setup
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s',
+    handlers=[logging.StreamHandler(sys.stdout)]
+)
+logger = logging.getLogger("boosty-milker")
+
+class BoostyClient:
+    API_URL = "https://api.boosty.to/v1/blog/{}/post/"
+    
+    def __init__(self, session: aiohttp.ClientSession, auth_token: Optional[str] = None):
+        self.session = session
+        self.auth_token = auth_token
+        self.headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
+            "Accept": "application/json, text/plain, */*",
+            "Origin": "https://boosty.to",
+            "Referer": "https://boosty.to/"
+        }
+        if self.auth_token:
+            self.headers["Authorization"] = f"Bearer {self.auth_token}"
+
+    async def get_posts(self, blog_name: str, limit: int = 100, offset: str = "") -> Dict[str, Any]:
+        url = self.API_URL.format(blog_name)
+        params = {
+            "limit": limit,
+            "comments_limit": 0,
+            "reply_limit": 0,
+        }
+        if offset:
+            params["offset"] = offset
+
+        async with self.session.get(url, params=params, headers=self.headers) as resp:
+            if resp.status == 401:
+                logger.error(f"{Fore.RED}Unauthorized. Please provide a valid auth token for private content.")
+                return {}
+            if resp.status == 403:
+                logger.error(f"{Fore.RED}Access denied. Check your token or subscription.")
+                return {}
+            if resp.status != 200:
+                logger.error(f"{Fore.RED}Error fetching posts: {resp.status}")
+                return {}
+            return await resp.json()
+
+class Downloader:
+    def __init__(self, download_dir: Path, max_concurrency: int = 5):
+        self.download_dir = download_dir
+        self.semaphore = asyncio.Semaphore(max_concurrency)
+        self.download_dir.mkdir(parents=True, exist_ok=True)
+
+    async def download_file(self, session: aiohttp.ClientSession, url: str, filename: str) -> bool:
+        filepath = self.download_dir / filename
+        
+        # Simple sanitization
+        filepath = Path(str(filepath).split("?")[0]) # Remove query params from filename if present
+        
+        if filepath.exists():
+            return True # Skip existing
+
+        async with self.semaphore:
+            try:
+                async with session.get(url) as resp:
+                    if resp.status == 200:
+                        content = await resp.read()
+                        with open(filepath, "wb") as f:
+                            f.write(content)
+                        return True
+                    else:
+                        logger.warning(f"Failed to download {url}: {resp.status}")
+                        return False
+            except Exception as e:
+                logger.error(f"Error downloading {url}: {e}")
+                return False
+
+async def process_post(post: Dict[str, Any], downloader: Downloader, session: aiohttp.ClientSession, tasks: List[Any]):
+    post_id = post.get("id")
+    title = post.get("title", "")
+    published = post.get("publishTime", 0)
+    date_str = datetime.fromtimestamp(published).strftime('%Y-%m-%d')
+    
+    # Process data blocks
+    data_blocks = post.get("data", [])
+    if not data_blocks:
+        return
+
+    img_count = 0
+    for block in data_blocks:
+        block_type = block.get("type")
+        url = None
+        
+        if block_type == "image":
+            url = block.get("url")
+            # Sometimes URL is inside 'content'
+            if not url and "content" in block:
+                # content might be a string (unlikely for image) or object
+                pass 
+            
+            # High quality URL is usually main URL
+        
+        # Handle teaser blocks for locked posts if visible
+        if block_type == "teaser_image":
+             pass # Usually blurred, skip
+
+        if url:
+            img_count += 1
+            filename = f"{date_str}_post{post_id}_{img_count}.jpg"
+            tasks.append(downloader.download_file(session, url, filename))
+
+    # Boosty structure varies; sometimes 'teaser' contains images if locked but we have access? 
+    # Usually 'data' contains the content we can see.
+
+async def main():
+    parser = argparse.ArgumentParser(description="Boosty Milker - Photo Downloader")
+    parser.add_argument("--username", required=True, help="Boosty creator username")
+    parser.add_argument("--directory", required=True, help="Directory to save photos")
+    parser.add_argument("--auth_token", help="Bearer token for private content", default=None)
+    parser.add_argument("--max_concurrency", type=int, default=10, help="Max concurrent downloads")
+    
+    args = parser.parse_args()
+    
+    auth_token = args.auth_token
+    if not auth_token:
+        # Check env var
+        auth_token = os.environ.get("BOOSTY_TOKEN")
+
+    async with aiohttp.ClientSession() as session:
+        client = BoostyClient(session, auth_token)
+        downloader = Downloader(Path(args.directory), args.max_concurrency)
+        
+        logger.info(f"{Fore.CYAN}Starting download for user: {args.username}")
+        if auth_token:
+            logger.info(f"{Fore.GREEN}Authenticated with token.")
+        
+        offset = ""
+        tasks = []
+        total_posts = 0
+        
+        pbar_posts = tqdm(desc="Fetching posts", unit="page")
+        
+        while True:
+            data = await client.get_posts(args.username, offset=offset)
+            if not data or "data" not in data:
+                break
+                
+            posts = data["data"]
+            if not posts:
+                break
+                
+            for post in posts:
+                process_post_sync(post, tasks, downloader, session)
+            
+            total_posts += len(posts)
+            pbar_posts.update(1)
+            
+            extra = data.get("extra", {})
+            offset = extra.get("offset")
+            if not offset:
+                break
+        
+        pbar_posts.close()
+        logger.info(f"Found {len(tasks)} images in {total_posts} posts.")
+        
+        if tasks:
+            results = await tqdm.gather(*tasks, desc="Downloading images", unit="img")
+            success_count = sum(results)
+            logger.info(f"{Fore.GREEN}Downloaded {success_count}/{len(tasks)} images.")
+        else:
+            logger.info("No images found.")
+
+def process_post_sync(post, tasks, downloader, session):
+    """Synchronous helper to extract URLs and add tasks"""
+    post_id = post.get("id")
+    published = post.get("publishTime", 0)
+    date_str = datetime.fromtimestamp(published).strftime('%Y-%m-%d')
+    
+    data_blocks = post.get("data", [])
+    if not data_blocks:
+        return
+
+    img_count = 0
+    for block in data_blocks:
+        if block.get("type") == "image":
+            url = block.get("url")
+            # Try to get max resolution
+            # The 'url' field is usually the full size or decent size. 
+            # Sometimes there are 'resolutions' or 'urls' map?
+            # Boosty API 'image' block usually has 'url' at top level.
+            
+            if url:
+                img_count += 1
+                # Clean URL
+                if "?" in url:
+                    clean_url = url # Keep params for download if signed, but filename needs clean ext
+                
+                # Deduce extension
+                ext = ".jpg"
+                if ".png" in url.lower(): ext = ".png"
+                elif ".webp" in url.lower(): ext = ".webp"
+                
+                filename = f"{date_str}_{post_id}_img{img_count}{ext}"
+                tasks.append(downloader.download_file(session, url, filename))
+
+if __name__ == "__main__":
+    if sys.platform == 'win32':
+        asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+    asyncio.run(main())

boosty_milker-1.0.1/boosty_milker.egg-info/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: boosty-milker
+Version: 1.0.1
+Summary: CLI tool to download photos from Boosty.to
+Author-email: F3T1W <f3t1w@icloud.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: tqdm>=4.65.0
+Requires-Dist: colorama>=0.4.6
+
+# Boosty Milker 🥛
+
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/F3T1W/BoostyMilker)](https://github.com/F3T1W/BoostyMilker/releases)
+[![PyPI version](https://img.shields.io/pypi/v/boosty-milker)](https://pypi.org/project/boosty-milker/)
+[![Chocolatey Version](https://img.shields.io/chocolatey/v/boosty-milker)](https://community.chocolatey.org/packages/boosty-milker)
+[![Homebrew](https://img.shields.io/badge/homebrew-tap-orange)](https://github.com/F3T1W/homebrew-tap)
+[![APT](https://img.shields.io/badge/debian-apt-red)](https://github.com/F3T1W/apt-repo)
+
+**Boosty Milker** is a powerful cross-platform CLI tool to bulk download photos from Boosty.to creators.
+
+🚀 **Features:**
+*   📥 Download all photos from all posts of a creator.
+*   🔓 Support for premium/subscriber-only content (via auth token).
+*   ⚡ Async downloads (fast and efficient).
+*   🖥️ Works on **Windows, macOS, and Linux**.
+*   💾 Smart download (skips already existing files).
+
+---
+
+## 📦 Installation
+
+### 🍎 macOS (Homebrew)
+The easiest way for Mac users:
+```bash
+brew tap F3T1W/tap
+brew install boosty-milker
+```
+
+### 🐧 Linux (Debian / Ubuntu / APT)
+Add the repository and install:
+```bash
+echo "deb [trusted=yes] https://F3T1W.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/f3t1w.list
+sudo apt-get update
+sudo apt-get install boosty-milker
+```
+*Alternatively, download the `.deb` file manually from [Releases](https://github.com/F3T1W/BoostyMilker/releases).*
+
+### 🪟 Windows (Chocolatey)
+Install via PowerShell:
+```powershell
+choco install boosty-milker
+```
+
+### 🐍 Python (PIP)
+Universal method for any OS (requires Python 3.10+):
+```bash
+pip install boosty-milker
+```
+
+### 📁 Manual Binaries
+If you don't want to install anything, just download the executable for your OS from **[Releases](https://github.com/F3T1W/BoostyMilker/releases)**, place it in a convenient folder, and run it via terminal.
+
+---
+
+## 🚀 Usage
+
+### 1. Download Free Posts
+```bash
+boosty-milker --username "artist_name" --directory "./downloads"
+```
+* `artist_name` — creator's username from the URL (e.g., for `boosty.to/cool_art` the username is `cool_art`).
+* `directory` — folder to save photos.
+
+### 2. Download Premium Content (Subscribers)
+If you are subscribed to a creator, you need to provide your auth token to download private posts.
+
+1.  Open [Boosty.to](https://boosty.to) in your browser.
+2.  Press `F12` -> Go to **Application** (or Storage) tab.
+3.  In the left menu, select **Cookies** -> `https://boosty.to`.
+4.  Find the cookie named `auth_token` or `accessToken` and copy its value.
+
+Run:
+```bash
+boosty-milker --username "artist_name" --directory "./downloads" --auth_token "YOUR_TOKEN"
+```
+
+### All Arguments
+```text
+options:
+  -h, --help            show this help message
+  --username USERNAME   Boosty creator username (from URL)
+  --directory DIRECTORY Directory to save photos
+  --auth_token TOKEN    Auth token (Bearer/accessToken) for private content
+  --max_concurrency N   Number of concurrent downloads (default: 10)
+```
+
+---
+
+## ⚠️ Disclaimer
+This tool is for personal use only. Please only download content you have legal access to. The author is not responsible for any misuse of this software or violations of Boosty.to terms of service.
+
+---
+
+Made with ❤️ by [F3T1W](https://github.com/F3T1W)

boosty_milker-1.0.1/boosty_milker.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+boosty_milker/__init__.py
+boosty_milker/main.py
+boosty_milker.egg-info/PKG-INFO
+boosty_milker.egg-info/SOURCES.txt
+boosty_milker.egg-info/dependency_links.txt
+boosty_milker.egg-info/entry_points.txt
+boosty_milker.egg-info/requires.txt
+boosty_milker.egg-info/top_level.txt

boosty_milker-1.0.1/boosty_milker.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

boosty_milker-1.0.1/boosty_milker.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+boosty-milker = boosty_milker.main:main

boosty_milker-1.0.1/boosty_milker.egg-info/requires.txt

@@ -0,0 +1,3 @@
+aiohttp>=3.8.0
+tqdm>=4.65.0
+colorama>=0.4.6

boosty_milker-1.0.1/boosty_milker.egg-info/top_level.txt

@@ -0,0 +1 @@
+boosty_milker

boosty_milker-1.0.1/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "boosty-milker"
+version = "1.0.1"
+description = "CLI tool to download photos from Boosty.to"
+authors = [{ name = "F3T1W", email = "f3t1w@icloud.com" }]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "aiohttp>=3.8.0",
+    "tqdm>=4.65.0",
+    "colorama>=0.4.6"
+]
+
+[project.scripts]
+boosty-milker = "boosty_milker.main:main"
+
+[tool.setuptools]
+packages = ["boosty_milker"]

boosty_milker-1.0.1/setup.cfg

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