glassdrop/README.md

glassdrop

glassdrop is a simple music player, originally created with the singular goal of being a free music player with an acceptable shuffling algorithm.

Now, its primary goal is to provide a unique user interface that draws your music across the top of your screen while it is playing, without interfering with your mouse events.

It is currently Windows-only.

Screenshots

Features

• Displays album art on the left of the screen
• Displays ID3 info in odd intervals on the right of the screen
• Simple graphical UI that can play or pause, be hidden, or exit the program

Usage

As it currently stands, glassdrop must be used from the command line, and also happens to not echo any helpful information to stdout because it is compiled with /SUBSYSTEM:WINDOWS.

In order to use glassdrop from the command line, you must extract the files from the .zip into a standalone folder, and add that folder to your PATH.

Then, to open a particular playlist: glassdrop playlist-name.

The playlist format is plain-text and pretty straightforward. The preferable extension is .list, at least for the time being. A basic playlist looks like this:

Song1.mp3
Song2.mp3

This playlist will play Song1.mp3 and Song2.mp3 in order, and then loop.

In order to shuffle a playlist, it can be modified as such:

+shuffle
Song1.mp3
Song2.mp3

+shuffle tells glassdrop to shuffle the playlist. In the future, it is planned to support rather esoteric playlist structures, making glassdrop potentially useful to those users with strange listening habits.

Dependencies

glassdrop currently depends on SDL2, SDL2_mixer, stb_image.h, and id3v2lib.