primary goal

disCoverJ is a free, open-source, Java-based graphical tool developed by RouHim on GitHub that automatically finds and embeds missing cover art into your audio files. Because it is powered by Java and deployed using jDeploy, it runs smoothly on both standard desktop Linux distributions and ARM-based systems like the Raspberry Pi.

To run disCoverJ on Linux or Raspberry Pi, your system requires a Java Runtime Environment (JRE) and a desktop environment, as it uses a graphical user interface (GUI). 📦 Prerequisites

Before installing disCoverJ, you must update your system packages and install a compatible Java version (Java 11 or higher is recommended). Open your terminal. Update your package manager list: sudo apt update && sudo apt upgrade -y Use code with caution. Install the Default Java Runtime Environment (OpenJDK): sudo apt install default-jre -y Use code with caution. Verify the installation by checking the Java version: java -version Use code with caution.

📥 Method 1: Download the Extracted tar.gz Package (Recommended)

The easiest cross-platform method is to fetch the binary built for your specific processor architecture from the jDeploy disCoverJ Portal. Step 1: Download the Package For Standard Linux (x86_64 PCs): wget https://jdeploy.com -O discoverj.tar.gz Use code with caution.

For Raspberry Pi (ARM64 / AArch64):Make sure you are running a 64-bit version of Raspberry Pi OS. wget https://jdeploy.com -O discoverj.tar.gz Use code with caution. Step 2: Extract and Execute Extract the compressed folder: tar -xvf discoverj.tar.gz Use code with caution. Navigate into the extracted directory: cd disCoverJ Use code with caution. Give execution permissions to the main launcher script: chmod +x disCoverJ Use code with caution. Run the application from your desktop terminal: ./disCoverJ Use code with caution. 🌐 Method 2: Running via NPM / jDeploy CLI

If you regularly use Node.js on your Linux desktop or Raspberry Pi, you can instantly run disCoverJ without manually managing files by leveraging the jDeploy npm tool. Install Node.js and NPM if you haven’t already: sudo apt install nodejs npm -y Use code with caution. Launch disCoverJ instantly using npx: npx discoverj Use code with caution.

(This commands downloads the runtime assets into a temporary cache and launches the interface immediately). ⚙️ Setting Up and Using disCoverJ

Once the graphical window opens on your Linux or Raspberry Pi desktop, configuring it to match your music files takes only a few simple steps:

Import Music: Drag and drop your target audio folders or specific files directly into the central list panel of the application.

Configure Search APIs: Navigate to the settings to select which databases disCoverJ will ping. It aggregates data from multiple platforms, including Spotify, iTunes, Amazon, Deezer, and Discogs.

Run Batch Search: Click the Search button located at the bottom-right corner. The app will fast-scan metadata, query the APIs, and show you visual cover alternatives.

Embed Art: Confirm the matching album covers to write the high-quality metadata directly inside your MP3, FLAC, or M4A audio containers. 🔍 Troubleshooting Common Issues