Henry's Music Player

A music player built on the LAMP stack which can play local MP3 files and stream music from Deezer.

Requirements

• PHP 8
• SQLite 3
• Apache

Other versions of PHP may work, but is not guaranteed.

Installation

1. Clone the repo:

git clone https://github.com/henryli17/musicPlayer.git

2. Install dependencies using Composer:

cd musicPlayer && composer install

3. Run sqlite3 db.sqlite3 < database.sql

4. Setup environment variables.

• Make a copy of .env.example and rename it to .env.
• Populate the environment variables

Key	Value	Required
MUSIC_DIRECTORY	The full directory of where your local MP3 files are stored.	No
DEEZER_ARL	Your Deezer arl cookie obtained from logging into Deezer's web player.	No
LASTFM_API_KEY	Your Last.fm API key.	No
LASTFM_API_SECRET	Your Last.fm API secret.	No
LASTFM_SESSION_KEY	Your Last.fm session key.	No
LASTFM_USERNAME	Your Last.fm username.	No
GENIUS_TOKEN	Your Genius API token.	No

5. Setup an Apache VirtualHost for the repo. Example:

<VirtualHost *:8080>
	ServerName localhost
	DocumentRoot /mnt/c/Users/henry/Repos/Personal/musicPlayer

	<Directory /mnt/c/Users/henry/Repos/Personal/musicPlayer>
		Options Indexes FollowSymLinks
		AllowOverride All
		Require all granted
	</Directory>

	ErrorLog ${APACHE_LOG_DIR}/error.log
	CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

6. Call the update endpoint to populate the database with information about your local MP3 files. Example:

curl http://localhost:8080/api/update

You should receive a JSON response that looks like this:

{
  "success": true,
  "message": "",
  "data": []
}

7. You should now be able to access the music player by browsing to http://localhost:8080.

Hotkeys

Hotkey	Action
Esc	Home Page
Space	Play/Pause
↑/↓	Volume Up/Down
Meta + F	Search
Meta + D	Saved Songs
Meta + S	Shuffle All Songs

Where Meta is either Ctrl or Cmd (⌘).

Features

• Search and stream from Deezer by prefixing your search query with e: , for example e: 24K Magic.
• Save songs from Deezer by pressing the heart icon on the track.
• Automatically scrobbles songs to Last.fm when a track finishes playing.

PWA Support

This can be installed as a Progressive Web App (PWA). For the best experience, enable the following flags in your Chromium based browser.

• #enable-desktop-pwas-remove-status-bar
• #enable-desktop-pwas-window-controls-overlay

Nativefier

This can also be installed as a standalone Electron app using Nativefier. For example:

nativefier 'http://localhost:8080'
	--title-bar-style 'hiddenInset'
	--icon '<PATH_TO_ICON>'

Troubleshooting

• In the case that images take a long time to load, try turning Apache's KeepAlive directive to Off.
• If you are receiving a playback error whilst streaming from Deezer ensure that OpenSSL's legacy provider has been enabled (see below).

Enabling OpenSSL's Legacy Provider

This may be needed in order to stream music as the BF-CBC cipher has been deprecated since OpenSSL 3.0 and needs to be manually enabled. In your openssl.cnf file:

• At the [default_sect] section change it to the following:

[default_sect]
activate = 1
[legacy_sect]
activate = 1

• Then find the [provider_sect] and change it to the following:

[provider_sect]
default = default_sect
legacy = legacy_sect

• Apache may need to be restarted after this change.

Disclaimer

This repository is for educational/research purposes only, the use of this code is your responsibility.

I take no responsibility and/or liability for how you choose to use any of the source code available here. By using any of the files available in this repository, you understand that you are agreeing to use at your own risk. Once again, all files available here are for education and/or research purposes only.