🎬 Doode: DoodStream CLI, API Client, Url link Generator

A feature-rich, user-friendly command-line interface and Python API client for DoodStream — with real-time progress bars, clipboard integration, IDM support (Windows), and comprehensive error handling.

✨ Features

• ✅ Full DoodStream API coverage: account, files, folders, remote upload, DMCA, reports
• 📊 Real-time monitoring of remote uploads with live progress bar (% complete, ETA)
• 🔗 Generate direct download links from DoodStream shareable URLs
• 💾 Local file upload with progress tracking
• 🖥️ IDM integration (Windows only) for one-click downloads
• 📋 Auto-copy to clipboard for generated download links
• 🎨 Beautiful terminal UI powered by Rich
• 🛡️ Robust error handling with clear, actionable messages
• 🧪 Dual usage: as a CLI tool or as a Python library
• 📚 Comprehensive documentation with examples for every method

📦 Installation

Prerequisites

• Python 3.7 or higher
• A DoodStream API key (free account required)

Install via pip

pip install doode

Note: If installing from source, clone this repo and run:

pip install -r requirements.txt

Optional Dependencies

• Windows users: Install IDM for direct download integration.
• Debug mode: Install pydebugger if you plan to use debug features.

🔑 Authentication

You must provide your DoodStream API key in one of two ways:

1. Environment Variable (Recommended)

export DOOD_API_KEY="your_api_key_here"

2. Command-Line Flag

dood --api-key "your_api_key_here" account info

💡 The environment variable method is preferred for security and convenience.

🚀 Quick Start

Generate a Download Link

dood generate "https://dood.li/abc123xyz" -v -c

• -v: Verbose output (shows download URL in a styled panel)
• -c: Copy URL to clipboard automatically

Upload a Video Remotely

dood remote upload "https://example.com/video.mp4" --new-title "My Movie"

This starts the upload and monitors it in real-time with a live progress bar!

Upload from Local Disk

dood upload local ./my_video.mp4

View Account Info

dood account info

🧰 Full Command Reference

Account Management

Remote Upload

🔍 Real-time monitoring shows:

• Current download percentage
• Estimated time remaining
• Automatic success/failure detection

File Management

Folder Management

DMCA & Uploads

📊 Real-Time Upload Monitoring

When you run a remote upload, you’ll see a live progress bar like this:

⠴ Uploading... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  42% 0:02:15

• Automatically detects completion or failure
• Updates every 3 seconds
• Supports keyboard interrupt (Ctrl+C to stop monitoring)
• Times out after 1 hour (configurable)

🛠️ Requirements

• requests
• beautifulsoup4
• lxml
• rich
• rich-argparse
• configset
• pyperclip (for clipboard)
• licface (custom help formatter)
• requests-toolbelt (for local upload progress)

All dependencies are installed automatically via pip.

🐞 Error Handling & Debugging

Common Errors

Debug Mode

Set environment variable to enable debug output:

export DEBUG=1
dood generate "https://dood.li/abc123"

Requires pydebugger to be installed.

📜 License

see the LICENSE file for details.

🙌 Acknowledgements

• DoodStream for their API
• Rich for beautiful terminal rendering
• requests & BeautifulSoup for HTTP and parsing

Note: This tool is unofficial and not affiliated with DoodStream. Use responsibly and in compliance with their Terms of Service.

author

Hadi Cahyadi

Support me on Patreon