Home

Awesome

AtomicParsley

GitHub Workflow Status

AtomicParsley is a lightweight command line program for reading, parsing and setting metadata into MPEG-4 files, in particular, iTunes-style metadata.

Installation

macOS

AtomicParsley is also available for brew users and can be installed by executing this command in a terminal:

$ brew install atomicparsley

Note that the version available in brew may lag behind the latest version of the code in this repo.

Windows

Linux (x86-64)

Alpine Linux (x86-64 musl libc)

Building from Source

If you are building from source you will need cmake and make. On Windows systems you'll need Visual Studio or MingW.

cmake .
cmake --build . --config Release

will generate an AtomicParsley executable.

Dependencies:

zlib - used to compress ID3 frames & expand already compressed frames available from http://www.zlib.net

A note on maintenance!

I made some fixes to the original project on sourceforge back in 2009 and became the de-facto fork of AtomicParsley as a result. However, I haven't used this tool myself in many years and have acted in a very loose guiding role since then.

In 2020 Bitbucket decided to cease hosting Mercurial based repositories which meant that I had to move it in order to keep it alive, so you'll see a flurry of recent activity.

I'll consider merging pull requests if they are easy to review, but because I don't use this tool myself I have no way to verify complex changes. If you'd like to make such a change, please consider contributing some kind of basic automated test with a corresponding small test file.

This repo has GitHub Actions enabled for the three major platforms so bootstrapping some test coverage is feasible.

You are welcome to report issues using the issue tracker, but I (@wez) am unlikely to act upon them.