MP3 ID3 Tag Reader

This project is a COBOL-based MP3 ID3 tag reader that parses and displays metadata from MP3 files. It uses GnuCOBOL for compilation and execution.

Software Requirements

GnuCOBOL: Version 3.2.0 or later
- Ensure GnuCOBOL is installed and accessible via the cobc command.
Operating System: Linux (tested on May 5, 2025)
Make: Version 4.3 or later (for building the project)
Git: Version 2.30.0 or later (for version control)

Project Structure

id3cobol.cbl: Main COBOL program for reading and parsing MP3 ID3 tags.
zero-ord.cbl: COBOL module for zero-based ordinal conversion.
Makefile: Build automation file for compiling and cleaning the project.
.gitignore: Specifies files and directories to be ignored by Git.

Build Instructions

Compile the zero-ord module:
```
make zero-ord
```
Compile the id3cobol program:
```
make id3cobol
```
Clean up build artifacts:
```
make clean
```
Perform a deep clean (removes all artifacts):
```
make distclean
```

Usage

Run the compiled id3cobol program to parse the audio.mp3 file:

./id3cobol

Note

: Ensure you have an audio.mp3 file in the same directory as the program. This file is required for the program to function.

Debugging

To enable debugging, ensure the WS-DEBUG-MODE variable in id3cobol.cbl is set to 1. This will display additional debug information during execution.

License

This project is licensed under the MIT License. See the LICENSE file for details.

1.7 KiB Raw Blame History