📻 Qt Music Player

🕹️ Controls

💿 Start an Album - Just click a cover and a player should open to track 1
⏯️ Play/Pause - To play or pause the music just click on the record in the Now Playing window
🔊 Volume - To raise or lower the volume just drag the slider under the song duration -- Left is lower, right is higher
🎚️ Switch Songs - To jump/ahead or go back to another track use the song list in the Now Playing screen

⚙️ Startup & Adding Music

🚀 1. 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.

📦 2. Setting Up a Music Directory

Warning

In order for your music to correctly show in the player the naming scheme must be followed exactly. Deviating from the naming format given below will lead to errors in how the music data presents itself. Deviating from the directory scheme will lead to information in the wrong places and possibly total failure for the media to show

🗃️ 2a. Create a Directory to Hold Album Files

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]/

Note

Any time brackets are used in the instructions they are to be disregarded. They are just used to denote a parameter

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.

💿 2b. 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_1_NAME] --> 02. [SONG_2_NAME] --> ... --> 99. [SONG_99_NAME]

Warning

The numbering is needed for sorting purposes. Failure to add numbering will lead to tracks being out of order

Here's an example of naming scheme in action in Finder using Dark Side of the Moon

🔈 3. Adding the Artist/Album to the Music Player

Once the album folder has been finished it's ready to be moved into the music player. Inside of the project directory you should see a folder /music. Simply move the artist folder into the /music folder and rebuild the project. The album art should show right up in the startup window.

Tip

Using Dark Side of the Moon as an example again, simply grab the Pink Floyd folder (since it contains the directory Dark Side of the Moon... and possibly any additional Pink Floyd albums if a folder is mader for them) and move it into /music inside the music player directory

Here is how an upload of the /Pink Floyd (contains 1 folder - Dark Side of the Moon) folder will look:

If that works just repeat the process with any other artist (remember that artist folders can contain multiple folders, each representing an album), rebuild the project, and enjoy the music 🎶