Skip to content

chinmayrozekar/mpv-stream-console

Repository files navigation

Author

Chinmay Rozekar

mpv Stream Console

A lightweight terminal-based media launcher built around mpv and yt-dlp. Perfect for long Terminal/ coding sessions.

This tool allows you to quickly stream online audio or video sources directly from the terminal, including YouTube live streams, YouTube search results, and SoundCloud links. It is designed to be simple, fast, and scriptable.


Features

  • 18+ Predefined Channels: Including LoFi, Chillhop, Jazz, Synthwave, Indian Classical, Metal, Binaural Beats, and more.
  • High-Quality Audio: Optimized for bestaudio using yt-dlp.
  • Minimalist UI: Simple interactive terminal menu.
  • Stealth Mode: Suppresses mpv verbose logging for a cleaner terminal experience.
  • Smart Routing: Handles YouTube search queries and direct SoundCloud URLs.
  • Browser Cookie Support: Uses Chrome cookies for better compatibility with YouTube.

Requirements

Make sure the following tools are installed:

  • mpv
  • yt-dlp
  • zsh (The script is optimized for Zsh)
  • Google Chrome (Used for YouTube cookie authentication)

Install on macOS (Homebrew)

brew install mpv yt-dlp

Usage

Run the script directly:

./focusradio.sh

You can also pass a channel number or 's' for shuffle as an argument:

./focusradio.sh 1  # Plays LoFi Girl
./focusradio.sh s  # Plays a random channel

Platform Support

This project is developed and tested on macOS using Homebrew.

It can also run on:

  • Linux (install mpv, yt-dlp, and zsh via your distribution’s package manager)
  • Windows using WSL (Windows Subsystem for Linux)

Note: The script uses Zsh-specific features for better array handling and emulation.

About

No description, website, or topics provided.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages