https://github.com/harmonicode/tunespy

TuneSpy is a Python application that allows users to load audio files, generate spectrograms, extract MFCC features, and compare the loaded audio with a preprocessed database of songs to find the most similar match.
https://github.com/harmonicode/tunespy

audio-feature-extraction audio-mixing fingerprint music-identification python qt5

Last synced: 3 months ago
JSON representation

TuneSpy is a Python application that allows users to load audio files, generate spectrograms, extract MFCC features, and compare the loaded audio with a preprocessed database of songs to find the most similar match.

• Host: GitHub
• URL: https://github.com/harmonicode/tunespy
• Owner: HarmoniCode
• License: mit
• Created: 2024-12-27T08:20:13.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-01-26T02:16:28.000Z (3 months ago)
• Last Synced: 2025-01-26T03:21:57.815Z (3 months ago)
• Topics: audio-feature-extraction, audio-mixing, fingerprint, music-identification, python, qt5
• Language: Python
• Homepage:
• Size: 43.3 MB
• Stars: 1
• Watchers: 0
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# TuneSpy

![Python](https://img.shields.io/badge/python-3.x-blue.svg)

![License](https://img.shields.io/badge/license-MIT-green.svg)

![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)

![alt text](./Styles/image.png)

TuneSpy shares similarities with the popular **Shazam** app, as both are designed to identify and match audio clips with songs from a database. While Shazam primarily focuses on real-time audio recognition using advanced fingerprinting algorithms optimized for mobile environments, TuneSpy is a desktop application aimed at exploring the core concepts of audio processing and music matching.

TuneSpy is a Python application that allows users to load audio files, generate spectrograms, extract MFCC features, and compare the loaded audio with a preprocessed database of songs to find the most similar match.

## Features

- Load audio files in various formats (MP3, WAV, FLAC)

- Generate spectrograms and save them as PNG images

- Extract MFCC features and save them as JSON files

- Hash spectrogram images using perceptual hashing

- Compare loaded audio with a preprocessed database of songs

- Display the most similar songs with similarity percentages

- Mix two audio files with adjustable weights

- Play and stop audio playback

## Requirements

- Python 3.x

- Required Python packages (install using `pip`):

  - `librosa`

  - `numpy`

  - `matplotlib`

  - `imagehash`

  - `Pillow`

  - `PyQt5`

  - `soundfile`

  - `sounddevice`

  - `scipy`

  - `mutagen`

## Installation

1. Clone the repository:

   ```sh

   git clone https://github.com/HarmoniCode/TuneSpy.git

   cd TuneSpy

   ```

2. Install the required Python packages:

   ```sh

   pip install -r requirements.txt

   ```

## Running the Application

```sh

python main.py

```

## License

This project is licensed under the MIT License. See the LICENSE file for details.