Engine Sync - v1.1.0

🇺🇸 Engine Sync — Changelog
v1.1.0

Much Faster Synchronization
Synchronization speed has been drastically improved. Users with large libraries reported waits of 15 to 30 minutes — this has been fixed. Library reading is now much more efficient, reducing the total time to seconds or a few minutes depending on the size of the collection.
Additional performance improvements for older computers with low RAM, such as previous generation MacBooks.

Automatic Update Fix
Fixed an issue that could prevent the app from correctly checking for new versions on some Macs.

New Report Window
At the end of each synchronization, a new report window is displayed with a detailed summary of what was done: how many songs were added to the database and which playlists received updates — so you know exactly what changed in your collection.

New Feature — Debug Mode
Added a "Debug Mode" option in the app's footer, disabled by default. When activated, it generates a detailed log file at the end of the synchronization, automatically saved in the same folder as the application. This file can be sent to support to help identify problems more quickly.

🇧🇷 Engine Sync — Changelog
v1.1.0

Sincronização muito mais rápida
A velocidade de sincronização foi drasticamente melhorada. Usuários com bibliotecas grandes relatavam esperas de 15 a 30 minutos — isso foi corrigido. A leitura da biblioteca agora é feita de forma muito mais eficiente, reduzindo o tempo total para segundos ou poucos minutos dependendo do tamanho da coleção.
Melhorias adicionais de performance para computadores mais antigos e com pouca memória RAM, como MacBooks de gerações anteriores.

Correção de atualização automática
Corrigido um problema que podia impedir o app de verificar novas versões corretamente em alguns Macs.

Nova janela de relatório
Ao final de cada sincronização, uma nova janela de relatório é exibida com um resumo detalhado do que foi feito: quantas músicas foram adicionadas ao banco de dados e quais playlists receberam atualizações — para você saber exatamente o que mudou na sua coleção.

Novo recurso — Modo Debug
Adicionada uma opção de "Modo Debug" no rodapé do app, desativada por padrão. Quando ativada, ela gera um arquivo de log detalhado ao final da sincronização, salvo automaticamente na mesma pasta do aplicativo. Esse arquivo pode ser enviado ao suporte para ajudar a identificar problemas com mais rapidez.

🇺🇸 Engine Sync - The Ultimate Library Solution

Created by a DJ with 3 decades of dancefloor experience (with a little help from AI for the coding), this free, open-source app solves one of the biggest bottlenecks in Engine DJ: automatic folder synchronization.

If you meticulously organize your tracks in folders on your Windows or Mac and hate having to manually recreate everything inside Engine DJ (or get frustrated when you have to manually update folders with newly downloaded tracks in Engine), this tool is for you.

Key Features:

• Perfect Mirroring (1-Click Sync): Reads your computer's root music folder and automatically mirrors the exact same folder tree structure inside a - MY COLLECTION playlist in Engine.
• Smart Updating: Downloaded new tracks? Just run the app and it will only inject the new files into their respective playlists, without messing up what's already there.
• 100% Safe: Zero track duplication. It respects Engine's native folder aggregation, preserves your manual gig playlists, and keeps your Hot Cues, Beatgrids, and BPM analysis intact.
• Cross-Platform & Multi-language: Available for Windows (.exe) and macOS (.app), featuring a smart UI that auto-detects your system language (English, Spanish, or Portuguese).

How to use:

• Close Engine DJ Desktop.

• Open Engine DJ Mirror Sync.

• Select your computer's music folder and your Engine m.db file.

• Hit "Start Synchronization" and let the magic happen!

• [Tip] After syncing, launch Engine DJ, go to the main Collection in Engine DJ, choose to show songs by date added, so the new songs added during syncing will appear there. Select all of them and right-click on the menu and choose Re-import track information so that the album art and other information are loaded! 😍

⚠️ Transparency and Security Notice: Antivirus Alerts (False Positives) When downloading the executable file (Engine-Sync.exe), some antivirus engines (as seen in VirusTotal) or Windows SmartScreen may issue a security alert. We would like to clarify that this is a common and harmless "false positive".

Why does this happen?

Engine Sync is written in Python and converted to an .exe file using the PyInstaller package. Heuristic-based antivirus engines often flag executables created in this way for two reasons:

The application does not have a Corporate Digital Signature (a paid certificate that costs hundreds of dollars annually, impractical for an independent project).

The application's natural behavior—which scans local directories at high speed and edits the Engine DJ SQLite database (m.db)—is interpreted by generic security systems as suspicious activity.

Engine Sync is a 100% open-source project. There is no telemetry, tracking, or hidden malicious code.

🇺🇸 ⚠️ Transparency and Security Notice: Antivirus Alerts (False Positives)
When downloading the executable file (Engine-Sync.exe), some antivirus engines (as seen in VirusTotal) or Windows SmartScreen may issue a security alert. We would like to clarify that this is a common and harmless "false positive".

Why does this happen?

Engine Sync is written in Python and converted to an .exe file using the PyInstaller package. Heuristic-based antivirus engines often flag executables created in this way for two reasons:

The application does not have a Corporate Digital Signature (a paid certificate that costs hundreds of dollars annually, impractical for an independent project).

The application's natural behavior—which scans local directories at high speed and edits the Engine DJ SQLite database (m.db)—is interpreted by generic security systems as suspicious activity.

Engine Sync is a 100% open-source project. There is no telemetry, tracking, or hidden malicious code.

🚨 Warning: Download only from official sources!

Engine Sync is 100% open-source software. This transparency is great, but it means any developer can take this code, modify it, and compile their own executable.

Do not trust executable files received through WhatsApp groups, DJ forums, or third-party websites. Only the files available here, in the official GitHub repository, are original and safe.

Note: Because it is independent software without a commercial digital signature, it is common for your antivirus to generate a "false positive" during installation. Rest assured, as long as the download was done directly from here!

🛠️ Alternatives for Execution (Do It Yourself)
For complete peace of mind, if you don't feel comfortable downloading and running the pre-compiled .exe file, you can audit the code with your own eyes and run or compile it directly on your machine. Follow the steps below:

Option 1: Run the Python Script Directly
Instead of downloading the .exe, you can run the original source code (.py).

Download and install the latest version of Python on your computer. (Be sure to check the "Add Python to PATH" option during installation).

Download the source file from this repository.

Open the Terminal (Command Prompt or PowerShell) and install the necessary libraries by typing:
pip install customtkinter tinytag pillow

After installation, navigate to the folder where you saved the script and run it with the command:
python engine_sync_v1.0.0.py

⚠️ Legal Notice and Disclaimer

Engine Sync is a completely independent, open-source project and has no affiliation, sponsorship, or official endorsement from Engine DJ, Engine OS, or the InMusic Brands group. The use of names, logos, and icons within the application is strictly for illustrative and referential purposes, with all intellectual property rights belonging exclusively to their respective owners.

In technical terms, this application does not alter, bypass, or modify any proprietary source code of the original software. Its functionality is strictly limited to standard reading and writing of information in a local SQL database (m.db), operating 100% externally to the brand's official systems.

The goal of this project is not to profit from third-party property, but rather to provide a tool developed by a DJ for DJs, helping our community overcome a daily limitation in library management. It is my hope that this initiative might even serve as validation and inspiration for similar features to be natively implemented in future official updates of the Engine DJ ecosystem.

💡 Support the Development
This is a 100% free, community-driven project. If it saved you hours of track organization this week, consider buying me a coffee through the donation link in the app! All support helps cover the costs of programming hours and encourages me to keep the software updated for everyone.

---

🇧🇷 Engine Sync - A Solução Definitiva para sua Biblioteca

Criado por um DJ com 3 décadas de experiência de pista (com uma ajudinha da Inteligência Artificial na programação), este aplicativo gratuito e de código aberto r...