Download Latest Version media-processing-1.0.tar.gz (8.3 kB)
Email in envelope

Get an email when there's a new version of mediaProcessing

Home
Name Modified Size InfoDownloads / Week
README.md 2026-06-10 2.8 kB
0
media-processing-1.0.checksums 2026-06-10 226 Bytes
0
media-processing-1.0.tar.gz 2026-06-10 8.3 kB
0
ChangeLog.txt 2026-06-10 44 Bytes
0
LICENSE 2026-06-10 1.5 kB
0
Totals: 5 Items   12.9 kB 0

Audio Utilities

A collection of small command-line tools for audio conversion, metadata handling and content identification.

Included Tools

Tool Description
makeId3Index Recursively generate and update deterministic index.json metadata trees
md5neutral Compute metadata-independent MD5 checksums for MP3 files
tomp3 Convert audio or video files to MP3

makeId3Index

Recursively builds or updates a deterministic metadata index over a media repository.

Each directory contains an index.json file describing:

  • local MP3 files (via gettag)
  • nested directory indexes
  • deterministic signature for change detection

Features

  • Recursive indexing of media trees
  • Incremental rebuild based on signature comparison
  • Leaf and node aggregation model
  • Automatic cleanup of empty leaf nodes
  • Deterministic JSON output via jq

Usage

makeId3Index [DIRECTORY]

If no directory is provided, . is used as the default root.

Example

makeId3Index /mnt/multimedia/audio

md5neutral

Compute MD5 checksums that ignore ID3 metadata.

The tool creates a temporary copy of each MP3 file, removes all ID3 tags, and computes the checksum of the resulting file. Files that differ only in metadata therefore produce identical checksums.

Features

  • Metadata-independent checksums
  • Compatible output format to md5sum
  • Verification mode (--check)
  • Useful for duplicate detection

Examples

Generate checksums:

md5neutral *.mp3

Verify checksums:

md5neutral --check checksums.txt

See:

md5neutral --help

for full documentation.

tomp3

Convert audio or video files into MP3 format (MPEG Layer III).

Features

  • Supports any format readable by ffmpeg
  • Constant bitrate (CBR) and variable bitrate (VBR)
  • Partial extraction using start offset and duration
  • Batch processing of multiple files

Example

tomp3 movie.mp4

See:

tomp3 --help

for full documentation.

Requirements

makeId3Index

  • bash
  • find
  • jq
  • sha256sum
  • gettag
  • md5neutral (required by gettag)
  • ffprobe/avprobe (required by gettag)

md5neutral

  • bash
  • mid3v2
  • md5sum

tomp3

  • bash
  • ffmpeg

Notes

All tools are desinged for deterministic processing of large media repositories.

  • File ordering is lexicographically stable
  • Metadate normalization is performed via helper tools
  • Index structures are desinged for incremental updates

Copyright

(c) 2011–2026 Hans-Hermann Froehlich

All rights reserved.

Source: README.md, updated 2026-06-10