# 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**:
    ```sh
    # 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.
    ```sh
    uv pip install -e .
    ```

## Usage

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

```sh
luna-downloader
```

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