lunatv 0.1.2.dev0

A collection of tools for downloading M3U8 video streams.

LunaTV Tools

A collection of Python scripts for downloading M3U8 video streams.

Features

• Fast Downloads: The main script, luna_downloader.py, uses multi-threading to download video segments concurrently.
• Automatic Merging: Automatically merges the downloaded .ts segments into a single .mp4 file using ffmpeg.
• URL Utilities: Includes other scripts for checking and handling stream URLs.

Requirements

• Python 3.8+
• ffmpeg: Must be installed and available in your system's PATH.

Setup & Installation

This project is packaged as a library and can be installed using uv.

1. Create & Activate Virtual Environment:

   # Create the virtual environment
   uv venv
   
   # Activate it (on macOS/Linux)
   source .venv/bin/activate
   

2. Install the lunatv package: Installing the package in editable mode (-e) is recommended for development. This will also automatically install all dependencies from pyproject.toml and make the command-line tool available.

   uv pip install -e .
   

Usage

After installation, a command-line tool luna-downloader will be available in your environment.

luna-downloader

The tool will then prompt you to enter the M3U8 URL and the desired output filename.