nobi-dl 2026.1.24

A scraping-based movie downloader. No own database; sources are scraped from the web.

nobi-dl

A lightweight command-line tool for searching and downloading movies from publicly available sources.

Disclaimer / Legal Notice

This tool is provided for educational purposes only. nobi-dl scrapes publicly accessible websites to locate and download media content. It does not host, store, or maintain any media files or databases.

Users are solely responsible for ensuring their use of this tool complies with applicable laws and regulations, including copyright laws in their jurisdiction. The developers of nobi-dl do not endorse or encourage copyright infringement or any illegal activity.

By using this software, you acknowledge that you are responsible for your actions and any consequences that may arise from using this tool.

Features

• Search for movies across multiple public sources
• Download movies in various formats and qualities
• Resume interrupted downloads
• List available video and audio formats
• Extract metadata in JSON format
• Verbose and quiet output modes
• Network debugging capabilities
• Browser impersonation for enhanced compatibility
• Modular extractor architecture

Installation

Install nobi-dl from PyPI using pip:

pip install nobi-dl

Verify the installation:

nobi-dl --version

Development Installation

Clone the repository:

git clone https://github.com/yourusername/nobi-dl.git
cd nobi-dl

Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install in editable mode:

pip install -e .

Install with optional development dependencies:

pip install -e ".[dev]"

Usage

Basic usage:

nobi-dl [OPTIONS] QUERY

Search for movies without downloading:

nobi-dl --search "movie title"

Examples

Search for a movie:

nobi-dl --search "Inception"

Download a movie:

nobi-dl "Inception 2010"

List available formats before downloading:

nobi-dl -F "The Matrix"

Resume an interrupted download:

nobi-dl -c "Interstellar"

Dump metadata to JSON:

nobi-dl -j "The Godfather" > movie.json

Command-line Options

Option	Description
--search	Search for movies without downloading
-F, --list-formats	List all available formats for a movie
-c, --continue	Resume an interrupted download
-j, --dump-json	Output metadata in JSON format
-v, --verbose	Enable verbose output for debugging
-q, --quiet	Suppress all output except errors
--parse-network	Parse and display network requests
--print-traffic	Print all network traffic for debugging
--impersonate	Impersonate a specific browser
--list-impersonate-targets	List available browser impersonation targets
--list-extractors	Display all available extractors
--extractor	Use a specific extractor

Supported Platforms

• Linux
• Windows
• macOS

Project Structure

nobi-dl/
├── nobi_dl/
│   ├── __init__.py
│   ├── cli.py
│   ├── downloader.py
│   ├── extractors/
│   └── utils.py
├── tests/
├── setup.py
├── README.md
└── LICENSE

Contributing

Contributions are welcome. Please follow these guidelines:

Issues: Report bugs or request features by opening an issue on the project repository. Provide detailed information about the problem or suggestion.

Pull Requests: Fork the repository, create a feature branch, and submit a pull request with a clear description of your changes. Ensure all tests pass before submitting.

License

This project is licensed under the MIT License. See the LICENSE file for details.