YT-TUI

A terminal-based YouTube video browser and player written in Go. Search for videos directly from your terminal and play them using mpv.

Features

• 🔍 Fast YouTube search with real-time results
• 📺 Video playback using mpv
• 👀 View video details (duration, views, upload date)
• 🖼️ ASCII art thumbnails in terminal
• ⌨️ Vim-style keyboard navigation

Prerequisites

• Go 1.19 or higher
• mpv media player
• YouTube Data API key

Installation

1. Clone the repository:

git clone https://git.k4li.de/pika/ytgo.git
cd ytgo

2. Install dependencies:

go mod tidy

3. Get a YouTube Data API key:

   • Go to Google Cloud Console
   • Create a new project
   • Enable the YouTube Data API v3
   • Create credentials (API key)
   • Replace YOUR_API_KEY in scraper/scraper.go with your API key

4. Build and install:

go build

5. Run the application:

./ytgo

6. Enjoy!

Keyboard Controls

• / - Activate search bar
• Enter - Submit search or play selected video
• ↑/↓ - Navigate through results
• Esc - Exit search mode
• q - Quit application

Dependencies

• Bubble Tea - Terminal UI framework
• YouTube Data API v3 - YouTube API
• mpv - Video player

License

MIT License

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.