Steven Lei & Peter Zhao Systems Period 5
SPetify is a terminal based MP3 music player. It contains song and playlist organization features as well as basic music playback such as skip, pause, and resume. Proposal
Our program is designed to be directly tested on a linux machine. Based on our testing, SSH'ing into a linux machine will not grant audio permissions. Please makes sure the following libraries are installed on linux before compiling. Use sudo apt-get install libsdl2-dev and sudo apt-get install libsdl2-mixer-dev.
PLEASE DO NOT EXIT THE PROGRAM WITH CTRL-C OR CTRL-D. If you do so, please end the background process main.out using System Monitor. Please use exit to escape the program.
You will need a directory containing MP3 files. Please make sure they do not contain the | character in their name.
Compile the program using make and run it using make run. When you first run the program, you will be prompted to provide a PATH to the directory containing the MP3 files (in this case a sample music directory has been provided). Please provide a valid PATH.
Once provided the proper PATH, the program will prompt you to the main interface, where you can edit song information, create or remove playlists, and edit the queue. For a full list of commands and their functionalities, please type help. Note that a command and its arguments are separated by the | character. To terminate the program use exit.
After song(s) have been added to the queue, use qplay to play the songs. This will send you to the music player interface, where you can use basic playback controls like skip, pause, and resume. Please note that after a song is done playing, you will need to feed the terminal an input to move onto the next song (pressing enter will work). For a full list of commands use pbhelp. To return to the main interface and stop playing the queue, use exit.
Welcome to SPetify! Enter folder to open ('.' for current directory):
music...
sinfo|All Along The WatchtowerInfo for All Along The Watchtower:
File name: All Along The Watchtower.mp3
Artist: Unknown
Genre: Unknown
File size: 3860396
sartist|All Along The Watchtower|Jimi Hendrix
sgenre|All Along The Watchtower|Rock n' Roll
spub|All Along The Watchtower|1968
q|Thunderstruck
q|All Along The Watchtower
qplay...
Now playing...
Playing Thunderstruck by Unknown. Genre: Unknown. Published year: 0.
Please press enter when the current song is finished to advance to next song.
skipSKIPPED
Playing All Along The Watchtower by Jimi Hendrix. Genre: Rock n' Roll. Published year: 1968.
Please press enter when the current song is finished to advance to next song.
setv|0.25Setting volume to 0.250000
pausePAUSED
exit...
exit