Skip to content

batasoy2/openpod_tagger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

openPod Tagger

openPod Tagger Logo

Automatically tag MP3 and FLAC files using acoustic fingerprinting

Note: Though this is an Electron app, I've not tested it in Windows, and due to metaflac CLI tool I used, it would not run on Windows. Mac OS? Don't know. Never tried, never will.

FeaturesInstallationUsageBuildingLicense

Features

  • 🎵 Acoustic Fingerprinting - Identifies songs by their actual audio content using AcoustID (not filename!)
  • 📝 Automatic Tagging - Writes metadata (title, artist, album, year, track number) to your files
  • 🖼️ Cover Art - Fetches and embeds album artwork from Last.fm and MusicBrainz
  • 📃 Lyrics - Downloads and saves lyrics from LRCLIB, ChartLyrics, and Genius
  • 🌍 Multi-language - Supports English, Türkçe, Deutsch, Español, Français
  • 🐧 Linux Native - Available as DEB package and AppImage
  • Fast & Lightweight - Built with Electron for a responsive desktop experience

Installation

For .deb package: npx electron-builder --linux appimage -c.electronVersion=27.0.0 AppImage: npx electron-builder --linux deb -c.electronVersion=27.0.0

Install from source:

Clone the repository

git clone https://github.com/batasoy2/openpod_tagger.git cd openpod_tagger

Install dependencies

npm install

Run the app

npm start

API Keys (Free)

The following API keys are optional but recommended for full functionality:

AcoustID Song identification (required)

Last.fm Cover art

Genius Lyrics

Quick Start

Launch openPod Tagger

Go to File → Settings and add your API keys

Select a folder containing MP3/FLAC files

Click "Identify" on any untagged file

Choose the correct match from the list

The file is automatically tagged!

Features in Detail 🔍 Acoustic Identification

Uses fpcalc to generate audio fingerprints

Queries AcoustID database for matches

Shows confidence scores for each match

Works even with filenames like track01.mp3

🖼️ Cover Art

Automatically fetches from Last.fm (high quality)

Falls back to MusicBrainz Cover Art Archive

Apply cover to single file or entire folder

📃 Lyrics

Fetches from LRCLIB (free, no API key)

Falls back to ChartLyrics and Genius

Saves lyrics directly to file tags

Ubuntu / Debian (DEB Package)

# Download the .deb file from releases
sudo dpkg -i openpod-tagger_1.0.0_amd64.deb
sudo apt-get install -f  # Fix dependencies
**

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors