deefuse 0.1.7

Deemix library upgrader, automatically matching local files

DeeFuse

DeeFuse is a desktop application for upgrading your existing music library using tracks downloaded from Deezer. It scans your existing files, finds matches via the Deezer API and downloads the highest quality versions using the deemix command line interface. This aims to improve bitrate, metadata and organization.

Features

• Automatic scanning of a directory for .flac, .mp3 and .m4a files
• Strict matching of artist, title and duration for unattended downloads
• Manual search and relaxed matching when no automatic match is found
• Progress dialog with the ability to cancel a scan
• CSV logs for skipped and matched tracks

Requirements

• Python 3.9 or newer
• The deemix CLI available on your PATH

The application installs its Python dependencies automatically when you install the package.

Installation

Install the package from source:

pip install .

This will install a deefuse entry point.

Building a standalone executable

Use PyInstaller's module mode to bundle the application:

pyinstaller --noconsole --onefile \
  --icon assets/deefuse_desktop.ico \
  --add-data "assets/deefuse_desktop.ico;assets" \
  -n DeeFuse -m deefuse

Running in module mode ensures the package context is correctly set when the executable starts.

Usage

Run the program either with the installed command or via the module:

deefuse
# or
python -m deefuse

Select your music directory and click Scan & Download. Matches will be downloaded automatically. Unmatched tracks will appear in the Skipped Tracks table where you can perform manual searches and downloads.

Matched and skipped tracks are recorded in matched_tracks.csv and skipped_tracks.csv respectively.

License

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