Python library and CLI for extracting downloadable content from file hosting platforms. Supports 11 platforms through a plugin architecture with automatic URL detection.

Megaloader is available as two independent packages:

pip install megaloader          # core library
pip install megaloader-cli      # terminal CLI

Install one or both depending on whether you need API integration, command-line tools, or both.

Library usage:

from megaloader import extract

for item in extract("https://pixeldrain.com/l/abc123"):
    print(f"{item.filename} - {item.download_url}")

CLI usage:

megaloader download https://pixeldrain.com/l/abc123

More detailed information is available in the package-specific documentation:

• Core library: packages/core/readme.md
• CLI: packages/cli/readme.md

The library supports four core platforms with active maintenance and seven extended platforms on best-effort basis. Core platforms receive priority for bug fixes and feature development. Extended platforms work as of November 2025 but may break without immediate fixes.

Additional notes on authentication and platform-specific features are documented in the core library's readme.

This monorepo uses a uv workspace. The core library is in packages/core/ and the CLI tool is in packages/cli/. Each one is published to PyPI as a separate package.

The repository is organized like this:

megaloader/
├── apps/
│   ├── api/        # FastAPI server (deployed to Vercel)
│   └── docs/       # VitePress site (deployed to GitHub Pages)
├── packages/
│   ├── core/       # megaloader, the core library
│   └── cli/        # megaloader-cli, the command-line interface
├── scripts/        # Development utilities
└── assets/         # Static files

To set up a development environment, clone the repository and install all workspace dependencies:

git clone https://github.com/totallynotdavid/megaloader
cd megaloader
uv sync

If you prefer to manage tools with mise, run:

mise install
mise run sync

This installs the toolchain versions defined in mise.toml.

Before submitting changes, run the formatters, linters, and tests:

uv run ruff format .        # mise run format
uv run ruff check --fix .   # mise run format
uv run mypy packages/core   # mise run mypy
uv run pytest               # mise run test, mise run test-unit

These commands format the code, fix lint issues, check types, and run the test suite.

See .github/CONTRIBUTING.md for plugin development guidelines.

Originally created by @Ximaz before 2023. The repository was later deleted or made private. Current maintainer @totallynotdavid rebuilt the codebase from scratch to fix platform changes and modernize the architecture.

Feature discussions and issue reports take place on GitHub Discussions.