VK Downloader

Download files from VK document pages. Modern GUI with multi-threaded downloads.

Version Francaise

---

Features

• Modern GUI built with CustomTkinter
• Multi-language support (English, French, Russian)
• Dark and light themes
• Up to 32 parallel downloads
• Automatic resume for interrupted downloads - Resume from where you left off
• Drag & drop support - Drop URLs or text files directly into the app
• Database to skip already downloaded files
• Real-time progress tracking
• Download history with export - Track all downloads and export to CSV/JSON
• File size tracking in history

Supported Formats

PDF, CBZ, CBR, JPG, PNG, GIF, MP3, MP4, MKV, FLAC, WAV, AVI, WEBM, DOC, DOCX, EPUB, ZIP, RAR

---

Requirements

• Python 3.8+

Installation

git clone https://github.com/L-at-nnes/Vk-dl-GUI.git
cd Vk-dl-GUI
pip install -r requirements.txt
python main.py

Quick Setup (Recommended)

For automatic installation including optional features:

python setup.py

Or use the install scripts:

# Windows
scripts\install.bat

# Linux / macOS
chmod +x scripts/install.sh && ./scripts/install.sh

---

Usage

GUI

python main.py

The app has four sections:

• Simple Download - Single URL with drag & drop support
• Bulk Download - Multiple URLs or drag & drop text files
• History - Past downloads with export to CSV/JSON
• Settings - Theme, language, defaults

Key Features

Automatic Resume

If a download is interrupted, the app will automatically resume from where it stopped. Partial files are saved with a .part extension and will be completed on the next attempt.

Drag & Drop

• Simple Download: Drag a URL or a text file containing URLs directly onto the URL field
• Bulk Download: Drag multiple text files or URLs onto the text area
• Works with Windows native drag & drop (no additional setup required)

Download History

• View all past downloads with timestamps, file sizes, and status
• Export history to CSV for spreadsheet analysis
• Export history to JSON for programmatic processing
• Filter by status (success, skipped, failed)

CLI

python vk_downloader.py <URL> [OPTIONS]

Options:
  --output_dir    Output directory (default: ./dl)
  --file_type     File extension (default: pdf)
  --threads       Parallel downloads (default: 1)

Example:

python vk_downloader.py https://vk.com/topic-xxx_xxx --file_type mp3 --threads 8

---

Build

Create standalone executables:

# Windows
scripts\build.bat

# Linux / macOS
chmod +x scripts/build.sh && ./scripts/build.sh

---

Project Structure

vk-downloader/
├── main.py              # GUI application
├── vk_downloader.py     # CLI application
├── requirements.txt
├── src/
│   ├── translations.py  # Language strings
│   ├── database.py      # Download tracking
│   ├── downloader.py    # Core engine
│   └── settings.py      # Configuration
├── scripts/             # Build and install scripts
├── assets/              # Icons
└── data/                # User data (auto-generated)

---

Contributing

See CONTRIBUTING.md.

---

Credits

Based on VkDownloader by Zephyris-Pro.

---

License

MIT

---

For personal use only. Respect VK's terms of service.