@wjhm/music-meta
v0.2.7
Published
CLI tool to bulk-edit MP3/FLAC metadata tags
Maintainers
Readme
music-meta
A CLI tool for reading and writing metadata tags on MP3 and FLAC files.
Installation
Global Install (Recommended)
To use the tool from anywhere on your system, install it directly from npm:
npm install -g @wjhm/music-metaUsage
music-meta <command> [options]Commands
bulk <directory>
Interactively apply a set of tags to all MP3/FLAC files in a directory.
music-meta bulk "Music/Laid Out - EP"You will be prompted to enter the tag values you want to apply across all files in the directory.
Development
# Run a command directly with tsx (no build step)
npm run dev -- bulk "Music/Laid Out - EP"
# Or use the named scripts
npm run bulk "Music/Laid Out - EP"
# Build for production
npm run buildScripts
| Script | Description |
|--------|-------------|
| npm run dev | Run the CLI via tsx (no build needed) |
| npm run bulk | Shorthand for tsx src/index.ts bulk |
| npm run scan | Shorthand for tsx src/index.ts scan |
| npm run build | Bundle and minify to dist/index.cjs via esbuild |
| npm run typecheck | Type-check with tsc (no emit) |
Tech Stack
- Commander — CLI argument parsing
- Inquirer — interactive prompts
- music-metadata — reading audio metadata
- node-id3 — writing ID3 tags (MP3)
- node-taglib-sharp — tag read/write (FLAC and more)
- chalk — terminal colours
- ora — terminal spinners
- esbuild — bundler
- tsx — TypeScript execution for development
