Tune Snap 🎵

Tune Snap is a music recognition platform inspired by Shazam’s algorithm. In addition to identifying songs, it integrates Spotify and YouTube APIs to store songs in the library.

Demo

🚀 Quick Start

Ensure you have either Docker or the following installed and configured:

• Go
• Node.js
• ffmpeg

Clone the project

git clone https://github.com/danilovict2/tune-snap.git
cd tune-snap

Set environment variables

cp .env.example .env

Spotify API

1. Go to the Spotify Developer Dashboard and create a new application.
2. Copy the generated Client ID and Client Secret.
3. Open your .env file and paste these values into the appropriate fields.

Run with Docker

docker compose up --build

Run locally

1. Set up a MongoDB instance (locally or using a cloud provider like MongoDB Atlas).
2. Copy the connection string and paste it into the MONGODB_URI field in your .env file.
3. Install frontend dependencies

npm install

4. Build frontend assets

npm run build

5. Run the Application

go build -o bin/app
./bin/app

Access the Platform

Open your web browser and go to http://localhost:8000.

Note: For the best experience, use localhost instead of 127.0.0.1. This ensures embedded YouTube videos work correctly within the platform.

✨ Features

• 🎶 Accurate music recognition powered by advanced audio fingerprinting.
• 🔗 Seamless integration with Spotify and YouTube APIs for song discovery and library management.
• ⚙️ Effortless setup using Docker or manual local installation.

🤝 Contributing

Build the project

npx webpack
go build -o bin/app

Run the project

./bin/app

If you'd like to contribute, please fork the repository and open a pull request to the main branch.