Skip to content

kamalkoranga/daamusic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 daamusic — Music Streaming CLI

A terminal-based YouTube music streamer built in Python.
Simple. Offline-ready. MPV-powered.

PyPI version License Python 3.10+


📦 What is daamusic?

daamusic is a Python command-line tool that streams audio from YouTube directly in your terminal using mpv. It handles everything — from installing mpv to keeping the terminal clean.

🧪 Built as a DAA (Design & Analysis of Algorithms) PBL project in 4th Semester.


🚀 Features

  • 🔊 Stream music from YouTube
  • 💻 Clean terminal interface
  • ⚙️ Automatically downloads mpv on Windows/MacOs/Linux
  • 🎯 Caches mpv to avoid repeat downloads
  • 📡 Plays URL or lets you interactively search
  • 🧠 Written with simplicity and DAA concepts in mind

🧩 Installation

From PyPI

pip install daa_music

Then run:

daamusic

From GitHub (Latest Dev Version)

pip install git+https://github.com/kamalkoranga/daamusic.git

🎮 Usage

Interactive Search Mode

daamusic

🎛️ Interactive Controls

While the song is playing, use:

  • / : Skip backward/forward 5 seconds
  • / : Skip backward/forward 1 minute
  • Space : Pause / Play
  • m : Mute
  • q : Quit / Close the player

🛠️ Contributing

Pull requests are welcome!

  1. Fork the repository
  2. Create a new feature branch
  3. Make your changes
  4. Open a PR

📜 License

This project is licensed under the MIT License.
See LICENSE for more information.


🔗 Links

About

A lightweight Python CLI to stream YouTube music using `mpv`, built as a PBL (Project-Based Learning) project for the DAA (Design and Analysis of Algorithms) course.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages