# AutoEQ for AIMP - Readme
**Version 1.1.0 (Stable)** | Developed by S. Jaime (troyanoj)

### A Journey of Passion
AutoEQ didn't start as a product, but as a dream. It was a personal project created for one simple reason: I wanted to enjoy my music like never before. I wanted a player that "understood" the soul of every song. 

After months of intense work and sacrifice to perfect this tool, the results were so extraordinary that I felt I couldn't keep it only for myself. This plugin is my gift to the music community—a way to make your player come alive. Thousands of lines of code and months of dedication have gone into this, and I hope it brings as much joy to your ears as it has to mine.

If you appreciate the time and effort invested in this personal journey, your support and donations are the best way to say thank you and help me keep improving this experience for everyone.

---

AutoEQ is an intelligent plugin that automatically adjusts the AIMP equalizer bands based on the currently playing track's genre or artist.

## Key Features
*   **Smart EQ:** Automatically enables the AIMP Equalizer when a profile is matched.
*   **Global Genre Support:** Over 20+ built-in profiles including Rock, Pop, Metal, Jazz, Blues, Classical, Ska, Reggae, and more.
*   **Hybrid Detection:** Uses local metadata first, with a smart Last.fm fallback for unknown tracks.
*   **Spanish/Latin Specialist:** Built-in recognition for Spanish Pop, Rock en Español, and Regional Mexican music.


## How to Install
1. Close AIMP.
2. Create a folder named `AutoEQ` inside your AIMP Plugins directory (usually `C:\Program Files (x86)\AIMP\Plugins\`).
3. Copy `AutoEQ.dll` and `AutoEQ.ini` into that folder.
4. Restart AIMP.
5. Go to `Preferences (Ctrl+P) > Plugins` and make sure "AutoEQ" is enabled.

## Tips for Best Performance (Important!)
To ensure the plugin works quickly and accurately, follow these tips:

*   **Clean Metadata:** The plugin identifies songs by their Artist and Genre tags. If your music collection has accurate metadata, the plugin will apply the correct EQ profile instantly.
*   **Manual Genre Tagging:** If you find a song that isn't being recognized or you want to use a specific profile, simply open the AIMP Tag Editor (F4) and set the Genre manually. AutoEQ will detect the change immediately and apply the corresponding profile.
*   **Avoid Internet Scans:** By having updated metadata in your files, you help the plugin work locally, making it much faster and avoiding unnecessary scans to the Last.fm database.
*   **Customization:** You can edit the `AutoEQ.ini` file to add your own mappings or adjust the gains for existing profiles.

## Requirements
*   AIMP v5.40 or higher.
*   Windows (64-bit version recommended).

## Support the Developer
If you enjoy this plugin and would like to support its continued development, you can make a voluntary donation here:
*   **Ko-fi:** [ko-fi.com/jaimefsa](https://ko-fi.com/jaimefsa)
*   **PayPal:** [paypal.me/JaimeFSA](https://paypal.me/JaimeFSA)

---
Developed by S. Jaime (troyanoj) for the AIMP community. Enjoy your music!
