A fast, efficient video downloader for Linux systems built with PyQt6. VipeDown emphasizes functionality over aesthetics, providing a reliable way to download videos and audio from various platforms.
- Queue system for multiple downloads
- Progress tracking with real-time speed and ETA
- Format selection (video/audio)
- Quality options from 360p to 2160p
- Playlist handling with selective download options
- URL input with paste functionality
- Format and quality selection dropdowns
- Progress indicators showing:
- Download speed in MB/s or KB/s
- Estimated time remaining
- File size and completion percentage
- Current download phase
- Queue management panel
- System tray integration with notifications
VipeDown can be installed and used in two ways: as a system package or in development mode.
- Install system dependencies:
sudo pacman -S base-devel git python python-pip ffmpeg- Clone and build:
git clone https://github.com/Bjorn99/vipedown.git
cd vipedown
make clean
make package
sudo pacman -U vipedown-0.1.0-1-any.pkg.tar.zst- Run:
vipedown- Install Poetry:
curl -sSL https://install.python-poetry.org | python3 -
# Fish shell
set -U fish_user_paths $HOME/.local/bin $fish_user_paths
# Bash/Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # or ~/.zshrc
source ~/.bashrc # or ~/.zshrc- Clone and set up:
git clone https://github.com/Bjorn99/vipedown.git
cd vipedown
poetry install- Run in development mode:
poetry run vipedownUse Poetry when developing:
# Activate development environment
poetry shell
# Run application
poetry run vipedown
# Add dependencies
poetry add package-name
# Update dependencies
poetry updateUse system installation for regular use:
# Install system-wide
sudo pacman -U vipedown-*.pkg.tar.zst
# Run application
vipedown- Poetry creates isolated virtual environments for each project
- Environments are stored in
~/.cache/pypoetry/virtualenvs/ - Useful commands:
# List environments poetry env list # Remove environments poetry env remove --all # Create new environment poetry env use python3.13
When switching from development to system installation:
- Exit Poetry shell if active
- Remove Poetry environments:
poetry env remove --all rm -rf $HOME/.cache/pypoetry/virtualenvs/vipedown-*
- Rebuild and install system package
- Launch VipeDown
- Paste video URL
- Select format (video/audio)
- Choose quality
- Click "Add to Queue"
- Start the queue
- Enter playlist URL
- Enable "Download as Playlist"
- Choose range (start/end) or specific videos
- Select format and quality
- Add to queue
- Add multiple items to queue
- Remove items (right-click)
- Cancel ongoing downloads
- Monitor progress in real-time
-
Poetry environment conflicts:
poetry env remove --all rm -rf $HOME/.cache/pypoetry/virtualenvs/vipedown-*
-
Package conflicts:
make clean make package
-
Check dependencies:
python --version # Should be 3.10 or higher ffmpeg -version -
Verify installation:
which vipedown
- Fork repository
- Create feature branch
- Set up development environment:
poetry install poetry shell
- Make changes and test
- Submit pull request
VipeDown is built upon the work of several amazing open-source projects and tools:
- yt-dlp - The core downloading functionality
- PyQt6 - The GUI framework that powers our interface
- FFmpeg - Essential media processing capabilities
- Poetry - Dependency management and packaging
- My Free Logo Maker - Tool used for creating our application logo
Special thanks to:
- The Python community for providing excellent libraries and tools
- The Arch Linux community for package management guidance
VipeDown is designed specifically for Linux systems, with special attention to Arch Linux and its derivatives.
MIT License