SYV — Save Your Video

A clean, interactive CLI for downloading videos — one command, no fuss

---

What is this?

SYV is a terminal app that wraps yt-dlp with a clean, interactive interface.

Paste a URL, pick your quality, get a file.

No browser extensions. No GUIs to install. Just a shell script with arrow-key navigation powered by gum.

---

Supported platforms

Platform	Support
YouTube	✅ Default, 1080p, MP3
Twitter / X	✅
Instagram	✅
TikTok	✅

Windows — not yet supported. Coming soon.

---

Requirements

• macOS or Linux
• Homebrew (macOS) or your distro's package manager (Linux)
• yt-dlp and gum — installed automatically on first run (macOS)

Linux users — install deps manually before running:

# Debian / Ubuntu
sudo apt install yt-dlp
brew install gum   # or: go install github.com/charmbracelet/gum@latest

# Arch
sudo pacman -S yt-dlp
brew install gum

# Fedora
sudo dnf install yt-dlp
brew install gum

---

Install

One-liner:

curl -fsSL https://raw.githubusercontent.com/Saimonsanbr/syv/refs/heads/main/install.sh | bash

Or clone the repo:

git clone https://github.com/Saimosanbr/syv.git
cd syv
chmod +x install.sh
./install.sh

Then reload your shell:

source ~/.zshrc   # or ~/.bashrc

---

Usage

yt

1. Enter a destination folder — or press Enter to use the current directory
2. Choose a platform
3. Choose quality (YouTube only: Default / 1080p / MP3)
4. Paste the video URL and hit Enter
5. Done ✅

After each download, you can:

• Download another — keeps the same platform and quality, just paste a new URL
• Change platform / quality — goes back to the beginning
• Exit

---

Uninstall

rm -rf ~/.syv

Then remove these lines from your ~/.zshrc (or ~/.bashrc):

# SYV — Save Your Video
export PATH="$HOME/.syv:$PATH"
alias yt="$HOME/.syv/syv"

---

Project structure

syv/
├── syv.sh        # Main script
├── install.sh    # Installer
└── README.md

---

Powered by

• yt-dlp — the actual downloader
• gum — interactive terminal UI

---

License

MIT