Qt-Music-Player/README.md

How to Use Music Player

Starting the Program & First Screen

When a user first starts the program they'll see a blank screen with nothing in it like the following:

This is because the user has no uploaded music inside of the player.

Adding Music to the Player

Create a Directory that Contains Music

In order to add music to the player the user must first create a folder that will act as an album/playlist with a specific naming convention. This is done to correctly categorize/sort playlists by artist and to keep audio files isolated to their correct place.

[ARTIST_NAME]/[ALBUM_NAME]/

Tip

For example, if you wanted to upload "Dark Side of the Moon" by "Pink Floyd" you would create a folder called /Pink Floyd and inside it create another folder called Dark Side of the Moon. It will be inside /Pink Floyd/Dark Side of the Moon that all of the audio and image (for album cover) files will reside for the album.

Setting Up the Album Folder

For each album folder their two specific file types it needs:

The first is Artwork.jpg (.jpeg & .png also work), which is an image file that the player will set to be the albums cover. If this file is missing no cover artwork will be set.

The second type it needs and you may add as many as needed are .mp3 and .flac, which are both audio file types. These files represent the songs in the playlist and should be named with the following convention to ensure the correct ordering:

01. [SONG_NAME] --> 02. [NEXT_SONG] --> ...

Note

The player will automatically remove the numbering from the front of the audio files using regex.

Tip

For example, Dark Side of the Moon has the following song list:

Adding the Album to the Music Player