MatchX

A web-based music recognition app that listens through your microphone and identifies the song playing using the Shazam API. Built with Python and PHP.

How it works

1. User clicks the match button on the web interface
2. The browser records 7 seconds of audio via the microphone
3. The audio is sent to the PHP backend
4. PHP passes the file to a Python script that queries the Shazam API
5. The result (title, artist, lyrics, cover art) is returned and displayed

Tech Stack

• Frontend — HTML, Bootstrap 5, jQuery, Web Audio API
• Backend — PHP (file handling, Python bridge)
• Recognition — Python 3, ShazamIO

Requirements

• Python 3.8+
• PHP 7.4+
• pip

Installation

git clone https://github.com/iammcoding/MatchX.git
cd MatchX
pip3 install -r requirements.txt

Usage

Deploy the folder on a PHP-enabled server (Apache, Nginx, or local with php -S):

php -S localhost:8000

Then open http://localhost:8000/app.php in your browser, click the button and let it listen.

Project Structure

MatchX/
├── app.php          # Frontend UI
├── match.php        # PHP backend, handles file upload and calls Python
├── app.py           # Python script, sends audio to Shazam API
└── requirements.txt

License

MIT