Melody-CLI 0.0.2

A command-line music player that downloads and plays music from YouTube.

Melody.CLI - A next-generation music streaming experience in your terminal (Upcoming Project)

Project Overview

Welcome to Melody CLI, a versatile command-line music player that brings the power of YouTube to your terminal. Whether you're a developer looking to integrate music playback into your own applications or a music enthusiast who enjoys the simplicity of command-line tools, Melody CLI has you covered.

With Melody CLI, you can easily search for songs on YouTube Music, download the audio, and play it directly from your terminal. The tool leverages the robust capabilities of yt-dlp for downloading and converting YouTube videos, ytmusicapi for interfacing with YouTube Music, and pygame for seamless audio playback.

Our straightforward command-line interface ensures that navigating through the CLI is a breeze, making it accessible even to those who are new to command-line tools. Whether you're pausing, resuming, or stopping playback, Melody CLI provides intuitive controls to manage your listening experience.

Join us in exploring the world of music through the command line. Melody CLI is open-source and welcomes contributions from the community, so feel free to get involved and help us improve this tool.

Why Melody.CLI ?

In a world dominated by graphical user interfaces, Melody.CLI offers a refreshing alternative. Designed for music enthusiasts who appreciate the elegance and efficiency of the command line, Melody.CLI provides a distraction-free, immersive music experience. Whether you're a developer seeking seamless music playback while coding, or a terminal aficionado, Melody.CLI is crafted to meet your needs.

Exciting Features to Look Forward To

• Search Songs: Find songs by title or artist using the YouTube Music API.
• Download Audio: Download audio from YouTube videos and convert them to MP3.
• Play Music: Play downloaded songs directly from the command line.
• Playback Controls: Pause, resume, and stop playback using intuitive commands.

Installation

You can install Melody.CLI from PyPI:

pip install melody_cli

Run Locally

Clone the project

  git clone https://github.com/pythonicforge/melody.CLI

Go to the project directory

  cd melody.CLI

Create a virtual environment

  pip install virtualenv

  virtualenv env

Install dependencies

  pip -r "requirements.txt"

Usage/Examples

from Melody_CLI import Player

if __name__ == '__main__':
    player = Player()
    searchQuery = input("Search for a song: ")
    youtubeSearchResults, videoIDS = player.searchSong(searchQuery)
    desiredVideo = int(input("Enter desired video number: "))
    audioFile = player.downloadSong(videoIDS[desiredVideo])
    player.playSong(audioFile)

Technical Highlights

• YTMusicAPI: Fetch songs and get search recommendations
• Yt_DLP: Download YT songs and store them locally.
• Pygame: Playback and control the downloaded audio files.

Contributing

Contributions are always welcome! Please adhere to this project's code of conduct.

Stay tuned for Melody.CLI, an upcoming project that will redefine music streaming for the terminal generation. Melody.CLI is a testament to my skills in Python development, user-centric design, and my passion for creating innovative, real-world applications. Join me on this journey to bring a unique music streaming experience to life.