ReadMe for MP3epoc 1.3

Contents

About MP3epoc

MP3epoc (formerly named MP3Attr) is a command line tool to view or modify unused information, also referred to as attributes, in the frame headers of MP3 files, including the private, copyright and original home bits and the emphasis field.

While most players simply ignore this information (Winamp just displays copyright, original and emphasis attributes in the MP3 file info box), real MP3 maniacs do not! Actually, the reason why I wrote MP3epoc is I couldn't find any free software with its capabilities (still wondering why there are so many apps for tagging MP3's instead).

I changed the name to MP3epoc because I found out that there was already a tool called MP3Attr, though it doesn't seem to do the same things.

MP3epoc is available in English, German and Italian. As of version 1.3, all download packages include support for all of those langauges.

Requirements

MP3epoc comes in versions for Windows, OS X, and for the .NET Framework (multiplatform), each with different requirements. See the relevant subsections under Installation for details.

Download

Click on the links below for available downloads.

Installation

Windows

MP3epoc for Windows requires Windows XP or better.

Download the ZIP archive for Windows and extract the file MP3epoc.exe to a location on your path, for example to C:\Windows or C:\Windows\System32. You can then run MP3epoc from the command line.

OS X

MP3epoc for OS X is compatible with all 64 bit processors and operating systems

Download the ZIP archive for OS X to your Downloads folder. Then open Terminal and enter:


sudo unzip ~/Downloads/MP3epoc.zip -d /usr

If prompted, enter your password. This will extract the MP3epoc binary along with strings resource files and man page files to their proper locations. You can then run MP3epoc from the command line.

.NET Framework

MP3epoc 1.3 requires the .NET Framework 4.5 to run on Windows, or a compatible version of Mono on other systems.

Download the ZIP archive for .NET and extract the contents to a location on your path, for example to C:\Windows or C:\Windows\System32. You can then run MP3epoc from the command line.

Technical information

For usage reference, please type MP3epoc -? at the command line prompt.

MP3epoc supports reading or writing the status of the private, copyright and original home bits as well as the emphasis field in one or more MP3 files in a folder.

The wildcards * and ? can be used to perform an operation on more than one file in the same folder.

If an error is found in an MP3 file, a message is printed to the default output stream and the file is not processed. MP3epoc always tests a file for errors before performing any operation that may modify the contents of the file. Be aware that an MP3 file may contain errors even if it plays flawlessly. In most cases, MP3epoc behaves not so tolerantly as most players do, because trying to modify a damaged file may result in further damage.

While concerned with structural error detection, MP3epoc strives for reliable recognition of the most common tags, to prevent some kind of extra information being confused with corrupt frame data. Recognized tags include ID3v1, ID3v2, APEv2, "Brava Software Inc." and more; nevertheless, some encoders or audio tools may decorate their files with information in a proprietary format that is not recognized by MP3epoc. If you think you've got a well-formed file that MP3epoc doesn't work with, feel free to contact the author at ft1@ft1.org.

Version history

Version 1.3

Version 1.2

Version 1.1

Author, licensing

MP3epoc 1.3 was released on 4th January 2014 and is copyright © 2005-2014 Francesco Trotta.

MP3epoc is provided as it is with no warranty of any kind. You are welcome to redistribute this software.

You can contact the author by sending an e-mail to: ft1@ft1.