This is a command-line interface (CLI) application written in Python that allows users to search for songs on YouTube Music, add them to a queue, and manage that queue. It simulates a music playback queue where you can see the total duration, add songs to the front or back, and advance to the next song.
This project utilizes the ytmusicapi library to interact with YouTube Music for searching songs.
- Search Songs: Find songs on YouTube Music using a search query.
- View Search Results: Displays the top 5 song results matching the query.
- Add to Queue:
- Add selected songs to the back of the queue (standard enqueue).
- Add selected songs to the front of the queue (priority enqueue).
- View Queue: Display the current list of songs in the queue, including the total number of songs and the total duration.
- See Current Song: Shows the song currently at the front of the queue (the "now playing" song).
- Next Song: Removes the current song from the front of the queue (simulates playing it and moving to the next).
- Clear Queue: Empties the entire music queue.
- User-Friendly Interface: Simple menu-driven interaction.
- Python 3.x
ytmusicapilibrary
-
Clone the repository or download the files: Make sure you have both
music_queue.pyandstructures.pyin the same directory. -
Install the required library: Open your terminal or command prompt and run:
pip install ytmusicapi # or pip3 install ytmusicapi
-
Navigate to the directory containing the files in your terminal.
-
Run the application:
python music_queue.py # or use python3 if needed # python3 music_queue.py
-
Follow the on-screen prompts:
- You will be presented with a main menu:
1. Add Song: Initiates the search process.- Enter your search query.
- Choose a song (1-5) from the results to add.
- Select whether to add it to the
Top(front) orEnd(back) of the queue. - Enter
0to search again, orqto go back to the main menu without adding.
2. Next Song: Removes the song at the front of the queue.3. Show Queue: Displays the current queue details.4. Clear Queue: Removes all songs from the queue.5. Quit: Exits the application.
- You will be presented with a main menu:
music_queue.py: Contains the main application logic, user interface interactions, and calls to the YouTube Music API.structures.py: Defines theSongclass (representing a single song) and theMusicQueueclass (the queue data structure itself), along with helper functions for time conversion.