A beautiful TUI app for searching and downloading YouTube videos, built with Go and Bubble Tea.

• Interactive Search - Search YouTube videos directly from your terminal
• Channel Browsing - View all videos from a specific channel with /channel @username
• Playlist Support - Browse and download videos from playlists with /playlist <id>
• Format Selection - Choose from available video/audio formats with quality indicators
• Download Management - Real-time progress tracking with speed and ETA
• Resume Downloads - Resume unfinished downloads with /resume
• Search History - Persistent search history for quick access
• Keyboard Navigation - Vim-style keybindings and intuitive shortcuts
• Cross-Platform - Works on Linux, macOS, and Windows

Requirements:

• Installation: https://github.com/yt-dlp/yt-dlp#installation
• ffmpeg - Required for full features
  • Installation: https://ffmpeg.org/download.html

curl -fsSL https://raw.githubusercontent.com/xdagiz/xytz/main/install.sh | bash

If you have Go installed, you can install directly:

go install github.com/xdagiz/xytz@latest

If you're using an Arch-based distribution, you can install xytz from the AUR:

yay -S xytz-bin

Requirements:

• Go 1.25+ - For building from source

# Clone the repository
git clone https://github.com/xdagiz/xytz.git
cd xytz

# Build
go build -o xytz .

# Move to your PATH (optional)
sudo mv xytz /usr/local/bin/

Launch xytz by running:

xytz

1. Search - Type your query and press Enter to search
2. Select - Use ↑/↓ or j/k to navigate results, Enter to select
3. Choose Format - Select your preferred video/audio format
4. Download - The download starts automatically

The config file location varies by operating system:

On first run, xytz will create the config file with default values if it doesn't exist.

xytz supports command-line arguments for quick access to search, channels, and playlists.

Note: Default values for these flags are grabbed from the configuration file.

# Direct video search
xytz -q "golang tutorial"

# Browse a specific channel
xytz -c @username

# Browse a playlist
xytz -p PLplaylistId

# Custom search results and sorting
xytz -n 50 -s date

# Combined: Search with custom options
xytz -q "rust programming" -n 10 -s views

xytz uses a YAML configuration file located at ~/.config/xytz/config.yaml.

search_limit: 25 # Number of search results
default_download_path: ~/Videos # Download destination
default_quality: best # Default format selection (480p, 720p, 1080p, 4k...)
sort_by_default: relevance # Default sort: relevance, date, views, rating
video_format: mp4 # The format which videos are downloaded
audio_format: mp3 # The format which audio files are downloaded
embed_subtitles: false # Embed subtitles in downloads
embed_metadata: true # Embed metadata in downloads
embed_chapters: true # Embed chapters in downloads
ffmpeg_path: "" # Custom ffmpeg path (optional)
yt_dlp_path: "" # Custom yt-dlp path (optional)
cookies_browser: "" # Browser for cookies: chrome, firefox, etc (optional)
cookies_file: "" # Path to cookies.txt file for authentication (optional)

The configuration file is created automatically on first run with sensible defaults.

Contributions are welcome. Please ensure your fork is synced with the upstream repository before submitting pull requests.

Follow Conventional Commits for commit messages:

<type>(<scope>): <description>

[optional body]
[optional footer]

Types:

• feat - New feature
• fix - Bug fix
• docs - Documentation
• refactor - Code refactoring
• chore - Maintenance tasks

• Keep changes focused and minimal
• Ensure all tests pass before submitting
• Update documentation if needed
• Follow the existing code style

Ensure yt-dlp is installed and available in your PATH:

yt-dlp --version

If installed in a non-standard location, set yt_dlp_path in your config.

ffmpeg is required for most of features to work. Install it and ensure it's in your PATH, or set ffmpeg_path in your config.

• Check your internet connection
• Verify the video is available in your region
• Ensure you have sufficient disk space
• Check the download path is writable
• Make sure you have yt-dlp and ffmpeg installed

• Bubble Tea - TUI framework
• yt-dlp - YouTube download engine
• Lipgloss - Styling library
• Bubbles - TUI components

By xdagiz