bentu-downloader 0.1.0

A small, importable Python video downloader toolkit with a yt-dlp-like CLI.

Bentu Downloader

Bentu is a small, importable Python downloader toolkit with a yt-dlp-style command line interface.

It is designed for videos and media that you own, created yourself, have permission to download, or are otherwise legally allowed to save. It does not bypass DRM, paywalls, logins, captchas, private APIs, or other access controls.

What works in this first version

• Importable Python API: from bentu import download
• CLI command: bentu URL -o "%(title)s.%(ext)s"
• Direct media URLs such as .mp4, .webm, .m4a, .mp3, .mov
• Simple unencrypted HLS playlists (.m3u8)
• Generic HTML pages that expose media via <video>, <source>, og:video, or JSON-LD contentUrl
• PyPI update check on CLI startup
• Retries, progress output, custom headers, output templates
• Provider architecture for adding more sites

Install locally

python -m pip install -e .

Build for PyPI

python -m pip install build
python -m build

The build output will be in dist/.

Upload to PyPI

Install Twine once:

python -m pip install twine

Upload:

python -m twine upload dist/*

CLI examples

bentu "https://example.com/video.mp4"
bentu "https://example.com/video.mp4" -o "downloads/%(title)s.%(ext)s"
bentu "https://example.com/page-with-video" --print-info
bentu "https://example.com/stream.m3u8" --no-update-check
bentu "https://example.com/video.mp4" --add-header "Referer:https://example.com/"

Useful options:

bentu --help

Python examples

from bentu import download

result = download("https://example.com/video.mp4", output="videos/%(title)s.%(ext)s")
print(result.path)

Or use the downloader object:

from bentu import Downloader, DownloadOptions

downloader = Downloader()
info = downloader.extract_info("https://example.com/page-with-video")
print(info.title, info.formats)

result = downloader.download(
    "https://example.com/page-with-video",
    DownloadOptions(output="%(title)s.%(ext)s"),
)

yt-dlp-style migration helper

from bentu import BentuDL

options = {
    "outtmpl": "downloads/%(title)s.%(ext)s",
    "format": "best",
    "quiet": False,
}

with BentuDL(options) as bdl:
    info = bdl.extract_info("https://example.com/video.mp4", download=True)
    print(info["filepath"])

Adding a provider

Create a provider by subclassing Provider and returning a MediaInfo object:

from bentu.models import MediaFormat, MediaInfo
from bentu.providers import Provider


class MyProvider(Provider):
    name = "my-site"

    def supports(self, url: str) -> bool:
        return "example.com" in url

    def extract(self, url: str, context):
        return MediaInfo(
            webpage_url=url,
            title="Example Video",
            formats=[MediaFormat(format_id="best", url="https://example.com/video.mp4", ext="mp4")],
        )

Then pass it to Downloader(providers=[MyProvider()]).

Note about big platforms

Platforms such as YouTube, TikTok, streaming hosts, and movie sites change frequently and often use signatures, throttling, login flows, region checks, or DRM. Bentu's core intentionally does not implement bypasses for those systems. If a page exposes a normal public media URL, Bentu can download it through the generic providers.

Publishing checklist

Before uploading, change the package metadata in pyproject.toml:

• name, if you want a different PyPI project name
• authors
• Homepage, Repository, and Issues
• version, every time you publish a new release