# puddletag
puddletag is an audio tag editor (primarily created) for GNU/Linux similar to the Windows program, Mp3tag. Unlike most taggers for GNU/Linux, it uses a spreadsheet-like layout so that all the tags you want to edit by hand are visible and easily editable.
The usual tag editor features are supported like extracting tag information from filenames, renaming files based on their tags by using patterns and basic tag editing.
Then there’re _Functions_, which can do things like replace text, trim it, do case conversions, etc. _Actions_ can automate repetitive tasks. Doing web lookups using Amazon (including cover art), Discogs (does cover art too!), FreeDB and MusicBrainz is also supported. There’s quite a bit more, but I’ve reached my comma quota.
Supported formats: ID3v1, ID3v2 (mp3), MP4 (mp4, m4a, etc.), VorbisComments (ogg, flac), Musepack (mpc), Monkey’s Audio (.ape) and WavPack (wv).
## Dependencies
puddletag uses several third-party modules to performs its tasks:
- [Python3](https://www.python.org/)
- [PyQt5](https://pypi.org/project/pyqt5/), for the GUI.
- [configobj](https://pypi.org/project/configobj/)
- [pyparsing](https://pypi.org/project/pyparsing/) , takes care of the parsing
- [Mutagen](https://pypi.org/project/mutagen/), used as the tagging lib
- [Chromaprint](http://acoustid.org/chromaprint) (recommended), for AcoustID support
- [unidecode](https://pypi.org/project/Unidecode/)
## How to install
### PyPI
Puddletag is available on [PyPI](https://pypi.org/project/puddletag/).
In addition to the full releases, every time we merge a PR or commit a change, we automatically release a new version on [TestPyPI](https://test.pypi.org/project/puddletag/), so if you want to try a brand new feature or a recent bugfix, you can give these pre-releases a try.
There are several tools to install puddletag via PyPI, for example [pip](https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-to-the-user-site), [pipx](https://pypa.github.io/pipx/installation/), [pipenv](https://pipenv.pypa.io/en/latest/), and several others. Choose the one that suits best your workflow, but we strongly recommend you create an isolated, local (f.e. by using `pip install --local`) environment when installing third-party software.
### Distributions package
Here below is a list of the distributions and platforms where puddletag is available, and how to install it:
<details>
<summary><b>Debian</b></summary>
`apt install puddletag`
Contact: @sandrotosi
</details>
<details>
<summary><b>Gentoo</b></summary>
1. overlay: https://github.com/istitov/stuff/
1. add overlay: `sudo layman -a stuff`
1. install: `sudo emerge -av puddletag`
Contact: @DolphinStKom
</details>
<details>
<summary><b>Arch Linux</b></summary>
puddletag is currently part of the [AUR](https://aur.archlinux.org/packages/puddletag/):
```
git clone https://aur.archlinux.org/puddletag.git
cd puddletag
makepkg -si
```
</details>
<details>
<summary><b>Fedora</b></summary>
Available since Fedora 32.
`dnf install puddletag`
</details>
<details>
<summary><b>Brew/MacOS</b></summary>
_support needed, open an issue if interested in working on it_
</details>
### Source Code
If you seek the bleeding edge of puddletag, or wanting to contribute (we welcome all contributions!) you can install and/or run via source code.
First, you need to install the dependencies; this step is different depending on the distribution; on Debian you can run:
```
apt install python3 python3-mutagen python3-configobj python3-pyparsing python3-pyqt5 python3-pyqt5.qtsvg python3-unidecode
```
Then, clone the repo and run puddletag:
```sh
git clone 'https://github.com/puddletag/puddletag'
cd 'puddletag'
./puddletag
```
Alternatively you can use a [virtual environment](https://docs.python.org/3/library/venv.html) to install the dependencies, which only requires python and pip to be installed:
```sh
git clone 'https://github.com/puddletag/puddletag.git'
cd 'puddletag'
python3 -m 'venv' '.'
bin/pip3 install -r 'requirements.txt'
bin/python3 'puddletag'
```
## License
`puddletag` is licensed under the GPLv3, which you can find in its entirety at [http://www.gnu.org/licenses/gpl-3.0.html](http://www.gnu.org/licenses/gpl-3.0.html)
Raw data
{
"_id": null,
"home_page": "https://docs.puddletag.net/",
"name": "puddletag",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "tagging ogg mp3 apev2 mp4 id3",
"author": "puddletag developers",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/0f/6e/ba6d3bd66e502fdb14175ca602ee471defd8446d14130c1a0178046ce847/puddletag-2.3.0.tar.gz",
"platform": null,
"description": "# puddletag\n\n\n\npuddletag is an audio tag editor (primarily created) for GNU/Linux similar to the Windows program, Mp3tag. Unlike most taggers for GNU/Linux, it uses a spreadsheet-like layout so that all the tags you want to edit by hand are visible and easily editable.\n\nThe usual tag editor features are supported like extracting tag information from filenames, renaming files based on their tags by using patterns and basic tag editing.\n\nThen there\u2019re _Functions_, which can do things like replace text, trim it, do case conversions, etc. _Actions_ can automate repetitive tasks. Doing web lookups using Amazon (including cover art), Discogs (does cover art too!), FreeDB and MusicBrainz is also supported. There\u2019s quite a bit more, but I\u2019ve reached my comma quota.\n\nSupported formats: ID3v1, ID3v2 (mp3), MP4 (mp4, m4a, etc.), VorbisComments (ogg, flac), Musepack (mpc), Monkey\u2019s Audio (.ape) and WavPack (wv).\n\n\n## Dependencies\n\npuddletag uses several third-party modules to performs its tasks:\n\n- [Python3](https://www.python.org/)\n- [PyQt5](https://pypi.org/project/pyqt5/), for the GUI.\n- [configobj](https://pypi.org/project/configobj/)\n- [pyparsing](https://pypi.org/project/pyparsing/) , takes care of the parsing\n- [Mutagen](https://pypi.org/project/mutagen/), used as the tagging lib\n- [Chromaprint](http://acoustid.org/chromaprint) (recommended), for AcoustID support\n- [unidecode](https://pypi.org/project/Unidecode/)\n\n\n## How to install\n\n### PyPI\n\nPuddletag is available on [PyPI](https://pypi.org/project/puddletag/).\n\nIn addition to the full releases, every time we merge a PR or commit a change, we automatically release a new version on [TestPyPI](https://test.pypi.org/project/puddletag/), so if you want to try a brand new feature or a recent bugfix, you can give these pre-releases a try.\n\nThere are several tools to install puddletag via PyPI, for example [pip](https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-to-the-user-site), [pipx](https://pypa.github.io/pipx/installation/), [pipenv](https://pipenv.pypa.io/en/latest/), and several others. Choose the one that suits best your workflow, but we strongly recommend you create an isolated, local (f.e. by using `pip install --local`) environment when installing third-party software.\n\n### Distributions package\n\nHere below is a list of the distributions and platforms where puddletag is available, and how to install it:\n\n<details>\n<summary><b>Debian</b></summary>\n\n`apt install puddletag`\n\nContact: @sandrotosi\n</details>\n\n<details>\n<summary><b>Gentoo</b></summary>\n\n1. overlay: https://github.com/istitov/stuff/\n1. add overlay: `sudo layman -a stuff`\n1. install: `sudo emerge -av puddletag`\n\nContact: @DolphinStKom\n</details>\n\n<details>\n<summary><b>Arch Linux</b></summary>\n\npuddletag is currently part of the [AUR](https://aur.archlinux.org/packages/puddletag/):\n\n```\ngit clone https://aur.archlinux.org/puddletag.git\ncd puddletag\nmakepkg -si\n```\n\n</details>\n\n<details>\n<summary><b>Fedora</b></summary>\n\nAvailable since Fedora 32.\n\n`dnf install puddletag`\n</details>\n\n<details>\n<summary><b>Brew/MacOS</b></summary>\n\n_support needed, open an issue if interested in working on it_\n</details>\n\n### Source Code\n\nIf you seek the bleeding edge of puddletag, or wanting to contribute (we welcome all contributions!) you can install and/or run via source code.\n\nFirst, you need to install the dependencies; this step is different depending on the distribution; on Debian you can run:\n\n```\napt install python3 python3-mutagen python3-configobj python3-pyparsing python3-pyqt5 python3-pyqt5.qtsvg python3-unidecode\n```\n\nThen, clone the repo and run puddletag:\n\n```sh\ngit clone 'https://github.com/puddletag/puddletag'\ncd 'puddletag'\n./puddletag\n```\n\nAlternatively you can use a [virtual environment](https://docs.python.org/3/library/venv.html) to install the dependencies, which only requires python and pip to be installed:\n```sh\ngit clone 'https://github.com/puddletag/puddletag.git'\ncd 'puddletag'\npython3 -m 'venv' '.'\nbin/pip3 install -r 'requirements.txt'\nbin/python3 'puddletag'\n```\n\n## License\n\n`puddletag` is licensed under the GPLv3, which you can find in its entirety at [http://www.gnu.org/licenses/gpl-3.0.html](http://www.gnu.org/licenses/gpl-3.0.html) \n",
"bugtrack_url": null,
"license": "GNU General Public License v3 or later (GPLv3+)",
"summary": "Powerful, simple, audio tag editor",
"version": "2.3.0",
"project_urls": {
"Download": "https://github.com/puddletag/puddletag",
"Homepage": "https://docs.puddletag.net/"
},
"split_keywords": [
"tagging",
"ogg",
"mp3",
"apev2",
"mp4",
"id3"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "12e1a7a67c3b38ededcb97c08f4c2d46eb35ab6cd8ac4144594199828b9841ca",
"md5": "20f405422345a2319095eca85d8f9efc",
"sha256": "36ac1e6f640298d76c2efe664b6116ce25de97ed489f2c14034b29470ebe5947"
},
"downloads": -1,
"filename": "puddletag-2.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "20f405422345a2319095eca85d8f9efc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 674649,
"upload_time": "2024-03-05T03:25:40",
"upload_time_iso_8601": "2024-03-05T03:25:40.719157Z",
"url": "https://files.pythonhosted.org/packages/12/e1/a7a67c3b38ededcb97c08f4c2d46eb35ab6cd8ac4144594199828b9841ca/puddletag-2.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0f6eba6d3bd66e502fdb14175ca602ee471defd8446d14130c1a0178046ce847",
"md5": "f25db77690f180b9b915a4110605aad5",
"sha256": "f61269898e50a0fd5e46fb0c13a6867cb4d07b74184ad8e126de0a078ad5107b"
},
"downloads": -1,
"filename": "puddletag-2.3.0.tar.gz",
"has_sig": false,
"md5_digest": "f25db77690f180b9b915a4110605aad5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 636213,
"upload_time": "2024-03-05T03:25:48",
"upload_time_iso_8601": "2024-03-05T03:25:48.746895Z",
"url": "https://files.pythonhosted.org/packages/0f/6e/ba6d3bd66e502fdb14175ca602ee471defd8446d14130c1a0178046ce847/puddletag-2.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-05 03:25:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "puddletag",
"github_project": "puddletag",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "puddletag"
}
JSON
