# Puddletag

Puddletag is an audio tag editor for GNU/Linux, similar to the Windows program Mp3tag, that uses a spreadsheet-like layout to make every tag you want to edit by hand visible and easily editable. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/1974/puddletag

## Description

Puddletag is an audio tag editor for GNU/Linux, similar to the Windows program Mp3tag, that uses a spreadsheet-like layout to make every tag you want to edit by hand visible and easily editable. This version is provided as a lightweight Alpine Linux Docker container that exposes the full graphical interface through any modern web browser—requiring no installation or configuration on the client side—or via any VNC (Virtual Network Computing) client, with added audio playback, clipboard sharing, and an integrated file manager and terminal. It suits homelab users who maintain a music library and want a self-hosted, resource-efficient tagging tool.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

59/100 (Fair), based on 3 of 4 factors.
- Maintained: 97 (last commit 60 days ago)
- Popular: 16 (5 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/puddletag-1ct6emu03d8che?q=puddletag
- Docker Hub: https://hub.docker.com/r/jlesage/puddletag
- GitHub: https://github.com/jlesage/docker-puddletag
- Official website: https://docs.puddletag.net/index.html

## Common questions

### Which port should I publish for the puddletag Docker container in the quick start setup?

The quick start command publishes container port 5800 to host port 5800.

### What volume should I mount to keep puddletag configuration outside the container?

Mount a read/write volume to /config, such as /docker/appdata/puddletag:/config:rw.

### How do I reach the puddletag container GUI without installing anything on the client?

Open the full graphical interface in any modern web browser, or connect with any VNC client.

### Which audio file formats does puddletag support for tagging?

It supports ID3v1, ID3v2 for MP3, MP4 including m4a, VorbisComments for OGG and FLAC, Musepack, Monkey's Audio, and WavPack.

### How can I be notified about new puddletag releases?

Releases are very infrequent, and you can subscribe to the RSS feed to be notified.

## Alternatives

- Kid3: If you want to easily tag multiple MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV and AIFF files (e.g.
- Mp3tag: Edit and organize audio metadata easily with comprehensive support for batch editing and various audio formats.
- MusicBrainz Picard: MusicBrainz Picard is the official cross-platform music tagger, automatically organizing and tagging audio files using the MusicBrainz data…
- Tag&amp;Rename: Tag&amp;Rename is a music files tag editor that easily handles all popular digital audio formats.

---
Source: Our Local Host (https://ourlocalhost.com/app/1974/puddletag), the self-hosted and open-source app directory.
