dloor

Educational purpose only.

dloor is intended for learning, personal tooling experiments, and lawful personal archiving. Use it only with content you own, content in the public domain, or content you have explicit permission to download. You are responsible for complying with copyright law, platform terms of service, and any other rules that apply in your jurisdiction. This project does not encourage or support infringement, redistribution of copyrighted material, bypassing access controls, or downloading private content without authorization.

dloor is a Rust TUI multimedia downloader powered by yt-dlp and ffmpeg. It detects supported social/video URLs automatically and lets you download media as video or audio from a terminal UI.

Supported URL families:

• YouTube
• YouTube Shorts
• Instagram
• Instagram Reels
• TikTok
• Facebook
• X / Twitter

Status

dloor is early-stage OSS software. The local download flow is the primary supported path today. Cloud upload support is designed around rclone, but should be treated as experimental while the project matures.

Quick Start

Install system prerequisites:

# macOS
brew install rust yt-dlp ffmpeg

# optional, only needed for cloud upload experiments
brew install rclone

Clone and run:

git clone https://github.com/hamst-p/dloor.git
cd dloor
cargo run -p dloor-tui

Install the dloor command locally:

cargo install --path dloor-tui --force
dloor

Installation Options

Install From GitHub

If Rust is already installed, you can install directly from the repository:

cargo install --git https://github.com/hamst-p/dloor.git --package dloor-tui --bin dloor
dloor

The executable is usually installed at ~/.cargo/bin/dloor. If your shell cannot find dloor, make sure ~/.cargo/bin is included in your PATH.

Build From Source

git clone https://github.com/hamst-p/dloor.git
cd dloor
cargo build --release
./target/release/dloor

For day-to-day development:

cargo run -p dloor-tui

Requirements

Rust

Install Rust with rustup if you do not already have it:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your shell or source Cargo's environment file:

source "$HOME/.cargo/env"

External Tools

dloor shells out to existing media tools instead of bundling them.

Required:

• yt-dlp
• ffmpeg

Optional:

• rclone, only needed for cloud upload experiments

macOS:

brew install yt-dlp ffmpeg rclone

Debian / Ubuntu:

sudo apt update
sudo apt install ffmpeg rclone
python3 -m pip install -U yt-dlp

Arch Linux:

sudo pacman -S ffmpeg rclone yt-dlp

Verify your tools:

yt-dlp --version
ffmpeg -version
rclone version

rclone can be missing if you only use local downloads.

First Run

Start the app:

dloor

On first launch, choose where downloads should be saved.

• Local: save files to a local directory
• Cloud: upload files through an rclone remote and remote path

If you choose cloud storage, configure rclone first:

rclone config

Then enter the remote name and remote path in dloor's setup screen.

Usage

1. Paste a supported URL into the main screen.
2. Press Enter.
3. Choose Video or Audio.
4. Choose Best or Compressed.
5. Wait for the progress bar to complete.
6. Copy the final path shown on the completion screen.

Key Commands

• URL input: paste a URL and press Enter
• /settings: open destination settings
• /howtouse: show the short usage guide
• /quit: quit
• q: quit from the URL input or completion screen
• Esc: go back, or quit from the URL input screen
• Arrow keys: move between choices
• Tab: move between setup fields
• Enter: confirm

Quality Presets

• Video / Best: downloads bestvideo*+bestaudio/best and merges to mp4
• Video / Compressed: downloads up to 1080p, then re-encodes with ffmpeg using libx264 -crf 28 -preset fast
• Audio / Best: extracts m4a at best available quality
• Audio / Compressed: extracts mp3 with --audio-quality 5

Configuration

Configuration is stored as config.toml in the operating system's standard config directory, resolved through the directories crate.

Typical locations:

• macOS: ~/Library/Application Support/com.dloor.dloor-tui/config.toml
• Linux: ~/.config/dloor-tui/config.toml or the path selected by your XDG environment

You can reopen the setup screen from inside the app with:

/settings

Troubleshooting

dloor: command not found

Make sure Cargo's binary directory is in your PATH:

export PATH="$HOME/.cargo/bin:$PATH"

Add that line to your shell profile, such as ~/.zshrc or ~/.bashrc, if needed.

Missing yt-dlp or ffmpeg

dloor checks for required tools on startup. Install the missing tool, then run dloor again.

Cloud Upload Is Unavailable

Cloud upload requires rclone. Install it and run:

rclone config

Then open /settings in dloor and enter your remote name.

Platform Download Fails

Some platforms change frequently, require login, or block automated downloads. Update yt-dlp first:

yt-dlp -U

If that does not work, verify that the URL is public and that you have permission to download it.

Development

Run checks before opening a pull request:

cargo fmt --all
cargo test
cargo clippy -- -D warnings

Project layout:

• dloor-core: UI-independent core library for platform detection, configuration, dependency checks, and download jobs
• dloor-tui: Ratatui / crossterm terminal frontend

The core download logic is intentionally separated from the TUI. Future chat integrations, such as Telegram or Slack agents, can reuse dloor-core by subscribing to the same DownloadEvent stream.

Contributing

Issues and pull requests are welcome. Please keep changes focused, run the checks above, and avoid adding code paths that bypass platform terms, access controls, or privacy boundaries.

License

Licensed under the MIT License. See LICENSE for details.