A TUI wrapper for yt-dlp written in Rust. Download videos and audio from YouTube and 1000+ other sites with style.

• Cool TUI - Clean, modern interface with ASCII art branding
• Smart Format Selection - Interactive format picker with audio-only toggle
• Queue Management - Add multiple downloads and track their progress
• Playlist Support - Preview and confirm playlists before downloading
• Real-time Progress - Live download stats with speed, ETA, and progress bars
• Lightning Fast - Event-driven rendering, smart caching, and parallel processing
• Cross-Platform - Works on Linux, macOS, and Windows
• 1000+ Sites - Powered by yt-dlp, supports YouTube, Vimeo, Twitter, and more

• yt-dlp installed and in your PATH
• Rust toolchain (for building from source)

# Install yt-dlp (if not already installed)
# Linux: sudo apt install yt-dlp  # or your package manager
# macOS: brew install yt-dlp

# Clone and install
git clone https://github.com/2Yuri-afk/gorlock.git
cd gorlock
cargo install --path .

# Run
gorlock

# Install yt-dlp (if not already installed)
pip install yt-dlp
# OR download from: https://github.com/yt-dlp/yt-dlp/releases

# Clone and install
git clone https://github.com/2Yuri-afk/gorlock.git
cd gorlock
cargo install --path .

# Run
gorlock

Note for Windows users: Make sure yt-dlp is in your PATH. You can verify with:

yt-dlp --version

1. Launch with gl
2. Press i to enter input mode
3. Paste URL and press Enter
4. Press f to see formats
5. Select format and press Enter

1. Add URL as above
2. Press f for formats
3. Press t to filter audio-only
4. Select format and download

• When you paste a playlist URL, Gorlock shows a preview
• Navigate through videos with ↑/↓
• Press Enter to add all to queue
• Press Esc to cancel

# Development build
cargo build

# Release build (optimized)
cargo build --release

# Run development version
cargo run

# Install globally
cargo install --path .

src/
├── main.rs              # Application entry & event loop
├── app_state/           # State management
│   ├── mod.rs          # Core state structures
│   └── events.rs       # Event definitions
├── ui/                  # User interface
│   ├── app.rs          # Main UI rendering
│   ├── events.rs       # Input handling
│   └── components.rs   # Reusable UI parts
└── commands/            # External commands
    ├── mod.rs          # Command orchestration
    └── yt_dlp.rs       # yt-dlp integration

Contributions are welcome! Feel free to:

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Configuration file support
• Custom output directory per download
• Download history/log
• Concurrent downloads
• Resume interrupted downloads
• Subtitle download options
• Authentication support
• Bandwidth limiting
• Post-download actions

MIT License - see LICENSE file for details

• Built with Ratatui - Amazing TUI framework
• Powered by yt-dlp - The downloading engine
• Inspired by the need for a better downloading experience