🇺🇸 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 COLLECTIONplaylist 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.dbfile. -
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! 😍
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.
🇺🇸
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 resolve um dos maiores gargalos do Engine DJ: a sincronização automática de pastas do seu computador.
Se você organiza suas músicas meticulosamente em pastas no Windows ou Mac e odeia ter que recriar tudo manualmente dentro do Engine (ou se frustra quando tem que atualizar as pastas com novas músicas baixadas no Engine manualmente), este app foi feito para você.
Principais Funcionalidades:
- Espelhamento Perfeito (1-Click Sync): Lê a pasta de músicas do seu computador e espelha a mesma estrutura de subpastas exata dentro de uma playlist raiz chamada
- MY COLLECTIONno Engine. - Atualização Inteligente: Baixou músicas novas? Basta rodar o app e ele injeta apenas as novidades nas playlists corretas, sem bagunçar o que já está lá.
- 100% Seguro: Não duplica músicas, respeita a agregação nativa de pastas do Engine OS, não apaga suas playlists manuais (seus sets continuam intactos) e mantém seus Hot Cues, Grids e BPMs já analisados.
- Multiplataforma & Multilíngue: Disponível para Windows (.exe) e macOS (.app), com interface gráfica que detecta o idioma do seu sistema automaticamente (Português, Inglês ou Espanhol).
Como usar:
-
Feche o Engine DJ Desktop.
-
Abra o Engine DJ Mirror Sync.
-
Selecione a sua pasta de músicas raiz e o seu arquivo
m.dbdo Engine. -
Clique em "Iniciar Sincronização" e deixe a mágica acontecer!
-
[Dica] Após o sincronizmo, inicie o Engine DJ, vá até a Coleção principal do Engine DJ, escolha mostrar as musicas por data de adição, assim as novas musicas adicionadas no sincronismo aparecerão ali. Selecione todas e com o botao direito do mouse no menu escolha Re-import track information para que a capa de album e o restante das informações sejam carregadas! 😍
🇧🇷
Ao fazer o download do arquivo executável (Engine-Sync.exe), é possível que alguns motores de antivírus (como vistos no VirusTotal) ou o Windows SmartScreen emitam um alerta de segurança. Gostaríamos de esclarecer que este é um "falso positivo" comum e inofensivo.
Por que isso acontece?
O Engine Sync é escrito em Python e convertido para um arquivo .exe utilizando o pacote PyInstaller. Motores de antivírus baseados em heurística costumam sinalizar executáveis criados dessa forma por dois motivos:
O aplicativo não possui uma Assinatura Digital Corporativa (um certificado pago que custa centenas de dólares anuais, inviável para um projeto independente).
O comportamento natural do aplicativo — que varre diretórios locais em alta velocidade e edita o banco de dados SQLite (m.db) do Engine DJ — é interpretado por sistemas genéricos de segurança como uma atividade suspeita.
O Engine Sync é um projeto 100% de código aberto (Open Source). Não há nenhum tipo de telemetria, rastreamento ou código malicioso oculto.
🚨 Atenção: Baixe apenas de fontes oficiais!
O Engine Sync é um software 100% de código aberto. Essa transparência é ótima, mas significa que qualquer desenvolvedor pode pegar este código, alterar e compilar o próprio executável.
Não confie em arquivos executáveis recebidos por grupos de WhatsApp, fóruns de DJs ou sites de terceiros. Apenas os arquivos disponibilizados aqui, no repositório oficial do GitHub, são originais e seguros.
Nota: Por se tratar de um software independente e sem assinatura digital comercial, é comum que seu antivírus gere um "falso positivo" no momento da instalação. Fique tranquilo, desde que o download tenha sido feito diretamente daqui!
🛠️ Alternativas para Execução (Faça você mesmo)
Para total tranquilidade, se você não se sentir confortável em baixar e rodar o arquivo .exe pré-compilado, você pode auditar o código com seus próprios olhos e executá-lo ou compilá-lo diretamente na sua máquina. Siga os passos abaixo:
Opção 1: Executar o Script em Python Diretamente
Em vez de baixar o .exe, você pode rodar o código-fonte original (.py).
Baixe e instale a versão mais recente do Python em seu computador. (Certifique-se de marcar a opção "Add Python to PATH" durante a instalação).
Faça o download do arquivo fonte deste repositório.
Abra o Terminal (Prompt de Comando ou PowerShell) e instale as bibliotecas necessárias digitando:
pip install customtkinter tinytag pillow
Após a instalação, navegue até a pasta onde salvou o script e execute-o com o comando:
python engine_sync_v1.0.0.py
O Engine Sync é um projeto de código aberto totalmente independente e não possui nenhum tipo de vínculo, afiliação, patrocínio ou endosso oficial por parte da Engine DJ, Engine OS ou do grupo InMusic Brands. O uso de nomes, logotipos e ícones dentro do aplicativo possui caráter meramente ilustrativo e referencial, pertencendo os direitos de propriedade intelectual exclusivamente aos seus respectivos donos.
Em termos técnicos, este aplicativo não altera, burla ou modifica qualquer código-fonte proprietário dos softwares originais. Seu funcionamento restringe-se única e exclusivamente à leitura e escrita padronizada de informações em um banco de dados SQL local (m.db), operando de maneira 100% externa aos sistemas oficiais da marca.
O objetivo deste projeto não é gerar lucro sobre a propriedade de terceiros, mas sim fornecer uma ferramenta desenvolvida de DJ para DJ, ajudando a nossa comunidade a contornar uma limitação diária na gestão de bibliotecas. Fica aqui o desejo de que esta iniciativa possa, inclusive, servir como validação e inspiração para que funcionalidades semelhantes sejam implementadas de forma nativa em futuras atualizações oficiais do ecossistema Engine DJ.
💡 Apoie o Desenvolvimento
Este é um projeto 100% gratuito voltado para a comunidade. Se ele salvou horas da sua semana na organização das tracks, considere me pagar um cafezinho através do link de doação no próprio app! Todo o suporte ajuda a cobrir os custos das horas de programação e me incentiva a continuar mantendo o software atualizado para todos.
