vget

module
v0.13.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 14, 2026 License: Apache-2.0

README

vget

Versatile downloader for audio, video, podcasts, PDFs and more. Available as CLI and Docker

简体中文 | 日本語 | 한국어 | Español | Français | Deutsch

Installation

macOS
curl -fsSL https://github.com/guiyumin/vget/releases/latest/download/vget-darwin-arm64.zip -o vget.zip
unzip vget.zip
sudo mv vget /usr/local/bin/
rm vget.zip
Linux / WSL
curl -fsSL https://github.com/guiyumin/vget/releases/latest/download/vget-linux-amd64.zip -o vget.zip
unzip vget.zip
sudo mv vget /usr/local/bin/
rm vget.zip
Windows

Download vget-windows-amd64.zip from Releases, extract it, and add to your PATH.

Screenshots

Download Progress

Download Progress

Docker Server UI

Docker

docker run -d -p 8080:8080 -v ~/downloads:/home/vget/downloads ghcr.io/guiyumin/vget:latest

Supported Sources

See sites.md for the full list of supported sites.

Commands

Command Description
vget [url] Download media (-o, -q, --info)
vget ls <remote>:<path> List remote directory (--json)
vget init Interactive config wizard
vget update Self-update (use sudo on Mac/Linux)
vget search --podcast <query> Search podcasts
vget completion [shell] Generate shell completion script
vget config show Show config
vget config set <key> <value> Set config value (non-interactive)
vget config get <key> Get config value
vget config path Show config file path
vget config webdav list List configured WebDAV servers
vget config webdav add <name> Add a WebDAV server
vget config webdav show <name> Show server details
vget config webdav delete <name> Delete a server
vget telegram login --import-desktop Import Telegram session from desktop app
Examples
vget https://twitter.com/user/status/123456789
vget https://www.xiaoyuzhoufm.com/episode/abc123
vget https://www.xiaohongshu.com/explore/abc123  # XHS video/image
vget https://example.com/video -o my_video.mp4
vget --info https://example.com/video
vget search --podcast "tech news"
vget pikpak:/path/to/file.mp4              # WebDAV download
vget ls pikpak:/Movies                     # List remote directory

Configuration

Config file location:

OS Path
macOS/Linux ~/.config/vget/config.yml
Windows %APPDATA%\vget\config.yml

Run vget init to create the config file interactively, or create it manually:

language: en # en, zh, jp, kr, es, fr, de

Note: Config is read fresh on every command. No restart required after changes (useful for Docker).

Updating

To update vget to the latest version:

macOS / Linux:

sudo vget update

Windows (run PowerShell as Administrator):

vget update

Languages

vget supports multiple languages:

  • English (en)
  • 中文 (zh)
  • 日本語 (jp)
  • 한국어 (kr)
  • Español (es)
  • Français (fr)
  • Deutsch (de)

License

Apache License 2.0

Directories

Path Synopsis
cmd
vget command
vget-server command
internal
cli
core/extractor/telegram
Package telegram provides Telegram media extraction and download functionality.
Package telegram provides Telegram media extraction and download functionality.
torrent
Package torrent provides integration with various torrent clients for remote download management.
Package torrent provides integration with various torrent clients for remote download management.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL