ohm_streaming/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Ohm Stream Downloader is a FastAPI-based web application for downloading media files from various file hosting services (1fichier, Doodstream, Rapidfile, etc.). It features a web interface, parallel downloads, pause/resume support, and direct file serving.

Development Commands

# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run development server (auto-reload)
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# Access web interface
# Open http://localhost:8000/web in browser

Architecture

Directory Structure:

Ohm_streaming/
├── main.py                      # FastAPI application & API endpoints
├── app/
│   ├── models/                  # Pydantic models (DownloadTask, DownloadStatus, etc.)
│   ├── downloaders/             # Host-specific downloaders
│   │   ├── base.py              # BaseDownloader abstract class
│   │   ├── unfichier.py         # 1fichier.com handler
│   │   ├── doodstream.py        # Doodstream handler
│   │   └── rapidfile.py         # Rapidfile handler
│   └── download_manager.py      # Manages download queue, progress, parallel downloads
├── downloads/                   # Downloaded files storage
├── templates/
│   └── index.html               # Web interface (single-page app)
└── static/                      # Static assets (CSS, JS, images)

Core Components:

1. DownloadManager (app/download_manager.py)

   • Manages all download tasks with parallel download limit (default: 3 concurrent)
   • Handles pause/resume/cancel operations
   • Tracks progress, speed, and file chunks for resume support
   • Uses semaphore to limit concurrent downloads

2. Downloaders (app/downloaders/)

   • Each host has its own downloader class inheriting from BaseDownloader
   • can_handle(url) - Checks if downloader supports the URL
   • get_download_link(url) - Extracts direct download link and filename from host page
   • Uses httpx for async HTTP requests and BeautifulSoup for HTML parsing

3. Download Task Flow:

   • Client sends URL via POST /api/download
   • DownloadManager creates task with unique ID
   • Appropriate downloader extracts direct link
   • File downloaded in chunks (1MB) to downloads/ directory
   • Progress tracked in real-time (bytes, speed, percentage)
   • Resume uses HTTP Range headers to continue from last byte

API Endpoints:

• POST /api/download - Create new download task (starts automatically)
• GET /api/downloads - List all download tasks with status
• GET /api/download/{task_id} - Get specific task details
• POST /api/download/{task_id}/pause - Pause active download
• POST /api/download/{task_id}/resume - Resume paused download
• DELETE /api/download/{task_id} - Cancel/delete download
• GET /api/download/{task_id}/file - Download completed file
• GET /web - Web interface

Web Interface:

• Single-page app at /web (templates/index.html)
• Auto-refreshes every second to show progress
• Shows progress bar, speed, file size
• Controls: Pause, Resume, Cancel, Download completed file

Adding New Host Support

To add support for a new file hosting service:

1. Create new file in app/downloaders/ (e.g., myhost.py)
2. Inherit from BaseDownloader
3. Implement can_handle(url) to detect your host URLs
4. Implement get_download_link(url) to extract direct download link
5. Import and add to downloaders list in app/downloaders/__init__.py

Example:

from .base import BaseDownloader

class MyHostDownloader(BaseDownloader):
    def can_handle(self, url: str) -> bool:
        return "myhost.com" in url.lower()

    async def get_download_link(self, url: str) -> tuple[str, str]:
        # Fetch page, parse HTML, extract download URL
        soup = BeautifulSoup(await self._fetch_page(url), 'lxml')
        # ... extraction logic ...
        return download_url, filename

Configuration

Edit main.py to configure:

• max_parallel - Maximum concurrent downloads (default: 3)
• download_dir - Storage location (default: "downloads")