pyflix

The torrent streaming library that powers torrent-dl.

Features

• Sequential download for video streaming
• MOOV atom detection for optimal playback
• Configurable download strategies
• Daemon mode support

Installation

pip install -r requirements.txt

Development Setup

# Set up development environment
./scripts/setup-dev.sh

# Activate virtual environment
source venv/bin/activate

# Run validation checks
./scripts/validate.sh

Project Structure

pyflix/
├── torrent/              # Core torrent handling
│   ├── moov.py           # Video MOOV atom detection
│   └── strategy.py       # Download strategy engine
├── utils/                # Utility modules
├── docs/                 # Documentation (see below)
├── scripts/              # Automation scripts
└── tests/                # Test suite

Documentation

This repository follows a documentation-first approach:

Directory	Purpose
docs/specs/	Technical specifications
docs/adrs/	Architecture Decision Records
docs/architecture/	System diagrams
docs/agent-instructions/	AI agent protocols

For AI Agents

Before making changes, read:

1. Agent Instructions
2. Architecture Decisions
3. Technical Specs

Contributing

1. Write/update specification in docs/specs/
2. Write tests alongside implementation
3. Run ./scripts/validate.sh
4. Update documentation

License

See LICENSE for details.