ytgram

Features

• Classic OS/2 Warp 3.0 UI: Authentic gray color scheme with 3D beveled borders
• Download Queue: Add multiple URLs and download them sequentially
• Audio Formats: MP3, AAC, OGG with embedded metadata and artwork
• Video Quality: 360p, HD (1080p), 4K (2160p) with automatic fallback to best available
• Clipboard Monitoring: Automatically detect video URLs copied to clipboard
• yt-dlp Management: Install and update yt-dlp via pipx directly from the app
• Settings Persistence: Saves download directory and preferences

Requirements

• Java 11 or higher
• Maven (for building)
• Linux with Debian/Ubuntu (for pipx installation feature)

Building

bash
mvn clean package

This will create target/ytgram.jar

Running

Using the run script:

bash
./run.sh

Or directly with Java:

bash
java -jar target/ytgram.jar

Installing yt-dlp

ytgram can install yt-dlp for you:
• Click the "Install/Update yt-dlp" button
• A terminal window will open
• Enter your sudo password when prompted
• Wait for installation to complete
Or install manually:

bash
sudo apt install pipx
pipx install yt-dlp

Usage

• Add URLs: Paste a video URL and click "Add to Queue"
• Enable Clipboard Monitor: Check "Auto-grab from clipboard" to automatically detect URLs
• Select Format: Choose audio format (MP3/AAC/OGG) or video quality (360p/HD/4K)
• Choose Download Location: Browse to select where files will be saved
• Start Downloads: Click "Start Downloads" to begin processing the queue

Format Options

Audio Formats

• MP3: Extract audio as MP3 with metadata and artwork
• AAC: Extract audio as AAC with metadata and artwork
• OGG: Extract audio as OGG/Vorbis with metadata and artwork

Video Formats

• 360p: Download 360p video or best available if not available
• HD (1080p): Download 1080p video or best available if not available
• 4K (2160p): Download 4K video or best available if not available

Settings

Settings are automatically saved to ~/.ytgram.properties including:
• Download directory
• Clipboard monitoring preference
• Default format selection

Supported Sites

ytgram supports any site that yt-dlp supports, including:
• YouTube
• Vimeo
• Dailymotion
• Twitter/X
• Twitch
• TikTok
• Instagram
• Reddit
• SoundCloud
• And many more...

License

Open source - feel free to modify and distribute.

Credits

• Uses yt-dlp for downloading
• Inspired by OS/2 Warp 3.0 interface design