AUDX - Audio Exchange

Digital audio utilities.

Cassette Rip Utilities
Audio File Utilities
FLAC File Utilities
M4A File Utilities
Music Collection Utilities
Running The Project's Tests
License & Usage

Cassette Rip Utilities

Record, split, and re-encode analog audio from cassette or vinyl.

rip-c - Rip audio cassettes or vinyl.

rip-c.sh - Rip audio cassettes or vinyl.
Usage: rip-c.sh [flags]
Option flags:
  --base-name       - Output file base name. Default: '/tmp/audx-rip'.
  --start-duration  - Silence start duration. Default: '0.2'.
  --start-threshold - Silence start threshold. Default: '0.6%'.
  --end-duration    - Silence end duration. Default: '0.2'.
  --end-threshold   - Silence end threshold. Default: '0.6%'.
  -f --force        - Force overwrite if output file exists. Default: ''.
  -h --help         - Show this help and exit.
  -v --verbose      - Verbose execution. Default: '1'.
  -g --debug        - Extra verbose execution. Default: ''.
Info:
  AUDX rip-c.sh
  Project Home: https://github.com/glevand/audx

rip-c-to-flac - Encode SOX files as FLAC.

rip-c-to-flac.sh - Encode SOX files as FLAC.
Usage: rip-c-to-flac.sh [flags] top-dir
Option flags:
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
Info:
  AUDX rip-c-to-flac.sh
  Project Home: https://github.com/glevand/audx

rip-c-flac-tags - Add FLAC metadata tags to rip-c FLAC files.

rip-c-flac-tags.sh - Add FLAC metadata tags to rip-c FLAC files.
Usage: rip-c-flac-tags.sh [flags] top-dir
Option flags:
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
Info:
  AUDX rip-c-flac-tags.sh
  Project Home: https://github.com/glevand/audx

rip-c Equipment

Audio File Utilities

Utilities for working with encoded audio files.

audx-play - Play FLAC and AAC encoded M4A files.

audx-play.sh - Play FLAC and AAC encoded M4A files.
Usage: audx-play.sh [flags] <top-dir | M3U playlist | M4A file | FLAC file>
Option flags:
  -s --state-file  - State file. Default: '/tmp/audx-state/state'.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution. Default: ''.
  -g --debug       - Extra verbose execution. Default: ''.
Input:
Info:
  AUDX audx-play.sh
  Project Home: https://github.com/glevand/audx

Typical audx-play info header:

Playing: China Crisis, Working with Fire and Steel - 1983 (40:23)
-----------------------------------------------------------------
1/10: Working with Fire and Steel (3:41)
2/10: When the Piper Calls (4:04)
3/10: Hanna Hanna (3:29)
4/10: Animals in Jungles (3:40)
5/10: Here Comes a Raincloud (4:16)
6/10: Wishful Thinking (4:42)
7/10: Tragedy and Mystery (4:03)
8/10: Papua (3:36)
9/10: The Gates of Door to Door (4:16)
10/10: The Soul Awakening (4:36)
-----------------------------------------------------------------

audx-print-tags - Recursively print metadata tags.

audx-print-tags.sh - Recursively print metadata tags.
Usage: audx-print-tags.sh [flags] <top-dir|file>
Option flags:
  -a --all-tags - Print all tags (VORBIS_COMMENT block, etc).
  -h --help     - Show this help and exit.
  -v --verbose  - Verbose execution.
  -g --debug    - Extra verbose execution.
Info:
  AUDX audx-print-tags.sh
  Project Home: https://github.com/glevand/audx

FLAC File Utilities

Utilities for working with FLAC encoded audio files.

flac-print-tags - Recursively print FLAC metadata tags.

flac-print-tags.sh - Recursively print FLAC metadata tags.
Usage: flac-print-tags.sh [flags] <top-dir|file>
Option flags:
  -a --all     - Print the VORBIS_COMMENT block.
  -h --help    - Show this help and exit.
  -v --verbose - Verbose execution.
  -g --debug   - Extra verbose execution.
Info:
  AUDX flac-print-tags.sh
  Project Home: https://github.com/glevand/audx

flac-write-tag - Write new FLAC metadata tags.

flac-write-tag.sh - Write new FLAC metadata tags using --tag, or --tag-name and --tag-value.
Usage: flac-write-tag.sh [flags] <top-dir|file>
Option flags:
  -t --tag         - Full tag 'NAME=VALUE'. An empty VALUE will delete tag.  Default=''.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
  -d --dry-run     - Dry run, don't modify files.
Common tags:
  ARTIST
  ALBUM
  TITLE
  GENRE
  DATE
  TRACKNUMBER
  TRACKTOTAL
Examples:
  flac-write-tag.sh  --tag='ALBUM=No Jacket Required' "${collection}/Phil Collins/No Jacket Required"
  flac-write-tag.sh  --tag='ARTIST=Ultravox' "${collection}/Ultravox"
  flac-write-tag.sh  --tag='COMMENT=' "${collection}/Bruce Cockburn/Stealing Fire"
Info:
  AUDX flac-write-tag.sh
  Project Home: https://github.com/glevand/audx

flac-add-tracktotal - Add FLAC tracktotal metadata tags.

flac-add-tracktotal.sh - Add FLAC tracktotal metadata tags.
Usage: flac-add-tracktotal.sh [flags] top-dir
Option flags:
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
  -d --dry-run     - Dry run, don't modify files.
Info:
  AUDX flac-add-tracktotal.sh
  Project Home: https://github.com/glevand/audx

flac-clean-tags - Clean FLAC metadata tags using standard rules.

flac-clean-tags.sh - Clean FLAC metadata tags using standard rules.
Usage: flac-clean-tags.sh [flags] top-dir
Option flags:
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
  -d --dry-run     - Dry run, don't modify files.
Info:
  AUDX flac-clean-tags.sh
  Project Home: https://github.com/glevand/audx

flac-meta-rename - Rename files based on FLAC metadata tags.

flac-meta-rename.sh - Rename files based on FLAC metadata tags.
Usage: flac-meta-rename.sh [flags] top-dir
Option flags:
  -a --various - Use 'Various Artists' logic.
  -h --help    - Show this help and exit.
  -v --verbose - Verbose execution.
  -g --debug   - Extra verbose execution.
  -d --dry-run - Dry run, don't rename files.
Info:
  AUDX flac-meta-rename.sh
  Project Home: https://github.com/glevand/audx

flac-tag-switcher - Swap FLAC title/artist tags.

flac-tag-switcher.sh - Swap FLAC title/artist tags.
Usage: flac-tag-switcher.sh [flags] <top-dir|file>
Option flags:
  -o --output-dir - Output directory. Default: '/tmp/audx-switcher'.
  -c --clobber    - Overwrite existing files. Default: ''.
  -r --rename     - Rename output files ${track}-${artist} - ${title}.
  -h --help       - Show this help and exit.
  -v --verbose    - Verbose execution.
  -g --debug      - Extra verbose execution.
Info:
  AUDX flac-tag-switcher.sh
  Project Home: https://github.com/glevand/audx

flac-fixup-cddb - Convert eight character DISCID tags to CDDB tags.

flac-fixup-cddb.sh - Convert eight character DISCID tags to CDDB tags.
Usage: flac-fixup-cddb.sh [flags] <top-dir>
Option flags:
  -k --keep_id - Keep DISCID tag. Default: ''.
  -h --help    - Show this help and exit.
  -v --verbose - Verbose execution.
  -g --debug   - Extra verbose execution.
  -d --dry-run - Dry run, don't modify files.
Info:
  AUDX flac-tag-switcher.sh
  Project Home: https://github.com/glevand/audx

M4A File Utilities

Utilities for working with AAC encoded MPEG-4 audio files.

m4a-print-tags - Recursively print M4A metadata tags.

m4a-print-tags.sh - Recursively print M4A metadata tags.
Usage: m4a-print-tags.sh [flags] <top-dir|file>
Option flags:
  -h --help    - Show this help and exit.
  -v --verbose - Verbose execution.
  -g --debug   - Extra verbose execution.
Info:
  AUDX m4a-print-tags.sh
  Project Home: https://github.com/glevand/audx

m4a-write-tag - Write M4A metadata tags.

m4a-write-tag.sh.in - Write M4A metadata tags.
Usage: m4a-write-tag.sh.in [flags] <top-dir|file>
Option flags:
  -t --tag         - Full tag 'NAME=VALUE'. An empty VALUE will delete tag.  Default='COMMENT=gftggv'.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
  -d --dry-run     - Dry run, don't modify files.
Common tags:
  ARTIST
  ALBUM
  TITLE
  GENRE
  DATE
  TRACKNUMBER x of y
Examples:
  m4a-write-tag.sh.in  --tag='ALBUM=Street Survivors' "${truck-music}/Lynyrd Skynyrd/Street Survivors"
  m4a-write-tag.sh.in  --tag='ARTIST=Al Jarreau' "${truck-music}/Al Jarreau"
  m4a-write-tag.sh.in  --tag='COMMENT="${truck-music}/Dixie Chicks/Landslide"
Info:
  AUDX m4a-write-tag.sh
  Project Home: https://github.com/glevand/audx

m4a-converter - Convert FLAC files to AAC encoded M4A files.

m4a-converter.sh - Convert FLAC files to AAC encoded M4A files suitable for download to Walkman type devices.
Usage: m4a-converter.sh [flags] <top-dir | M3U playlist | flac file>
Option flags:
  -b --bitrate     - Encoding bitrate. Default: '328k'.
  -o --output-dir  - Output directory. Default: '/tmp/audx-m4a'.
  -c --clobber     - Overwrite existing files. Default: ''.
  -k --keep-tmp    - Keep tmp directory. Default: ''.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution. Default: ''.
  -g --debug       - Extra verbose execution. Default: ''.
Common bitrates:
  Truck Music: 328 bps
  Phone Music: 192 bps
  Low-Fi Music: 96 bps
Input:
  top-dir          - '/home/music-collection'
Info:
  AUDX m4a-converter.sh
  Project Home: https://github.com/glevand/audx

Typical CPU usage when running the m4a-converter script.

Music Collection Utilities

Utilities for managing a collection of audio files.

check-vfat-names - Check vfat file names.

Recursively check for valid vfat file names by writing zero length files to a vfat device.

check-vfat-names.sh - Check vfat file names.
Usage: check-vfat-names.sh [flags] top-dir
Option flags:
  -d --vfat-dir    - vfat test directory. Default: ''.
  -c --clean-names - Clean file names using standard rules. Default: ''.
  -k --keep-going  - Do not exit on file error. Default: ''.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
Info:
  AUDX check-vfat-names.sh
  Project Home: https://github.com/glevand/audx

make-inventory - Make inventory lists of an album collection.

make-inventory.sh - Make inventory lists of an album collection.
Usage: make-inventory.sh [flags] src-directory [src-directory]...
Option flags:
  -o --output-dir - Output directory. Default: '/tmp/audx-inventory'.
  -a --age-sort   - Sort list by age. Default: ''.
  -t --tracks     - Output album tracks. Default: ''.
  -n --canonical  - Output full canonical paths to lists. Default: ''.
  -c --config     - Configuration file. Default: ''.
  -h --help       - Show this help and exit.
  -v --verbose    - Verbose execution.
  -g --debug      - Extra verbose execution.
Info:
  AUDX make-inventory.sh
  Project Home: https://github.com/glevand/audx

Typical make-inventory list:

# make-inventory.sh (AUDX)
# /music/collection/country: 1001 albums.

[1] 'Aaron Lewis/Frayed At Both Ends'
[2] 'Aaron Tippin/Greatest Hits - And Then Some'
[3] 'Aimee Mann/Mental Illness'
[4] 'Alabama/16 Biggest Hits'
[5] 'Alabama/Alabama and Friends At The Ryman - Disc1'
[6] 'Alabama/Alabama and Friends At The Ryman - Disc2'
[7] 'Alabama/Alabama and Friends'
[8] 'Alabama/Alabama Greatest Hits'
[9] 'Alabama/Angels Among Us - Hymns and Gospel Favorites'
[10] 'Alabama/Dancin on the Boulevard'

make-playlists - Recursively search for audio files and create M3U playlists.

make-playlists.sh - Recursively create M3U album playlists.
Usage: make-playlists.sh [flags] top-dir
Option flags:
  -n --canonical   - Output full canonical paths to playlist.
  -t --file-types  - File extension types {flac mp3 m4a sox wav}. Default: 'flac'.
  -c --clobber     - Overwrite existing files. Default: ''.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
Inputs:
  top-dir          - '/home/music-collection'
Info:
  AUDX make-playlists.sh
  Project Home: https://github.com/glevand/audx

Typical make-playlists M3U playlist:

#EXTM3U
#PLAYLIST: AUDX playlist
#EXTART: Boz Scaggs
#EXTALB: Hits
#EXTDATE: 1980
#EXTGENRE: ROCK
#CDDB: 710a150a

01-Lowdown.flac
02-You Make It So Hard.flac
03-Miss Sun.flac
04-Lido Shuffle.flac
05-Were All Alone.flac
06-Breakdown Dead Ahead.flac
07-Look What Youve Done To Me.flac
08-Jojo.flac
09-Dinah Flo.flac
10-You Can Have Me Anytime.flac

make-age-list - Make age lists of an album collection.

make-age-list.sh - Make age lists of an album collection.
Usage: make-age-list.sh [flags] src-directory [src-directory]...
Option flags:
  -o --output-dir - Output directory. Default: '/tmp/audx-age'.
  -t --tracks     - Output an album track list. Default: ''.
  -h --help       - Show this help and exit.
  -v --verbose    - Verbose execution.
  -g --debug      - Extra verbose execution.
Info:
  AUDX make-age-list.sh
  Project Home: https://github.com/glevand/audx

make-shufflelist.sh - Create an M3U playlist of random albums.

make-shufflelist.sh - Create an M3U playlist of random albums.
Usage: make-shufflelist.sh [flags] top-dir
Option flags:
  -c --count       - Number of albums in playlist. Default: '6'.
  -o --output-file - Playlist output file. Default: '/tmp/audx-shufflelist.m3u'.
  -s --start-date  - Starting date. Default: ''.
  -e --end-date    - Ending date. Default: ''.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
Inputs:
  top-dir          - '/home/music-collection'
Date Specifiers:
  '2 days ago'
  '3 months ago'
  'last week'
  'last Thursday'
Info:
  AUDX make-shufflelist.sh
  Project Home: https://github.com/glevand/audx

shuffle-playlist.sh - Randomly shuffle an M3U playlist.

shuffle-playlist.sh - Randomly shuffle an M3U playlist.
Usage: shuffle-playlist.sh [flags] <M3U playlist>
Option flags:
  -o --output-file - Shuffle list output file. Default: '/tmp/audx-shufflelist.m3u'.
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution. Default: ''.
  -g --debug       - Extra verbose execution. Default: ''.
Input:
  ''
Info:
  AUDX shuffle-playlist.sh
  Project Home: https://github.com/glevand/audx

batch-shufflelist.sh - Runs make-shufflelist.sh as batch.

batch-shufflelist.sh - Batch create M3U shuffle lists.
Usage: batch-shufflelist.sh [flags] top-dir
Option flags:
  -h --help        - Show this help and exit.
  -v --verbose     - Verbose execution.
  -g --debug       - Extra verbose execution.
Inputs:
  top-dir          - ''
Info:
  AUDX batch-shufflelist.sh
  Project Home: https://github.com/glevand/audx

genre-sort.sh - Sort FLAC files base on GENRE metadata tag.

genre-sort.sh - Sort FLAC files base on GENRE metadata tag.
Usage: genre-sort.sh [flags] <top-dir>
Option flags:
  -o --output-dir - Output directory. Default: '/tmp/audx-sort'.
  -c --copy-cmd   - Copy command. Default='cp -avi --link'.
  -h --help       - Show this help and exit.
  -v --verbose    - Verbose execution.
  -g --debug      - Extra verbose execution.
Info:
  AUDX genre-sort.sh
  Project Home: https://github.com/glevand/audx

create-compare-tests - Create encoding comparison files.

create-compare-tests.sh - Create encoding comparison files.
Usage: create-compare-tests.sh [flags]
Option flags:
  -i --input-file - flac input file. Default: '/tmp/compare.flac'.
  -o --output-dir - Output directory. Default: '/tmp/audx-compare'.
  -h --help       - Show this help and exit.
  -v --verbose    - Verbose execution. Default: ''.
  -g --debug      - Extra verbose execution. Default: ''.
Info:
  AUDX create-compare-tests.sh
  Project Home: https://github.com/glevand/audx

Typical compare-test files:

total 86M
  36M '04-Werewolves of London.wav'
  20M '04-Werewolves of London.flac'
 8.2M '04-Werewolves of London - 328k.m4a'
 8.0M '04-Werewolves of London - 328k.mp3'
 4.9M '04-Werewolves of London - 192k.m4a'
 4.8M '04-Werewolves of London - 192k.mp3'
 2.5M '04-Werewolves of London - 96k.m4a'
 2.4M '04-Werewolves of London - 96k.mp3'

Running The Project's Tests

audx_root=???
rsync -a --delete ${audx_root}/audx/ /tmp/audx-tester/
git -C /tmp/audx-tester reset --hard HEAD
/tmp/audx-tester/tests/build-test.sh /tmp/audx-tester
/tmp/audx-tester/tests/lib-test.sh /tmp/audx-tester
/tmp/audx-tester/tests/help-test.sh /tmp/audx-tester
/tmp/audx-tester/tests/rip-test.sh /tmp/audx-tester

Licence & Usage

All files in the audx project, unless otherwise noted, are covered by an MIT Plus License. The text of the license describes what usage is allowed.

Name		Name	Last commit message	Last commit date
Latest commit History 224 Commits
.github/workflows		.github/workflows
images		images
scripts		scripts
tests		tests
COPYING		COPYING
Makefile.am		Makefile.am
README.md		README.md
bootstrap		bootstrap
configure.ac		configure.ac
mit-plus-license.txt		mit-plus-license.txt
version.sh		version.sh

License

glevand/audx

Folders and files

Latest commit

History

Repository files navigation