Module audioio.audioconverter
Command line script for converting, downsampling, renaming and merging audio files.
audioconverter -o test.wav test.mp3
converts 'test.mp3' to 'test.wav'.
The script reads all input files with load_audio(),
combines the audio and marker data and writes them along with the
metadata to an output file using write_audio().
Thus, all formats supported by these functions and the installed python audio modules are available. This implies that MP3 files can be read via the audioread module, and they can be written via pydub. Many other input and output file formats are supported by the sndfile library, provided the SoundFile or wavefile python packages are installed.
Metadata and markers are preserved if possible.
Run
audioconverter -l
for a list of supported output file formats and
audioconverter -f wav -l
for a list of supported encodings for a given output format (-foption).
Running
audioconverter --help
prints
usage: audioconverter [-h] [--version] [-v] [-l] [-f FORMAT] [-e ENCODING] [-s SCALE] [-u [THRESH]] [-U [THRESH]]
[-d FAC] [-c CHANNELS] [-a KEY=VALUE] [-r KEY] [-n NUM] [-o OUTPATH]
[file ...]
Convert audio file formats.
positional arguments:
file one or more input files to be combined into a single output file
options:
-h, --help show this help message and exit
--version show program's version number and exit
-v print debug output
-l list supported file formats and encodings
-f FORMAT audio format of output file
-e ENCODING audio encoding of output file
-s SCALE scale the data by factor SCALE
-u [THRESH] unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and divide by
two
-U [THRESH] unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and clip
-d FAC downsample by integer factor
-c CHANNELS comma and dash separated list of channels to be saved (first channel is 0)
-a KEY=VALUE add key-value pairs to metadata. Keys can have section names separated by "."
-r KEY remove keys from metadata. Keys can have section names separated by "."
-n NUM merge NUM input files into one output file
-o OUTPATH path or filename of output file. Metadata keys enclosed in curly braces will be replaced by their
values from the input file
version 2.0.0 by Benda-Lab (2020-2024)
Expand source code
"""Command line script for converting, downsampling, renaming and merging audio files.
```sh
audioconverter -o test.wav test.mp3
```
converts 'test.mp3' to 'test.wav'.
The script reads all input files with `audioio.audioloader.load_audio()`,
combines the audio and marker data and writes them along with the
metadata to an output file using `audioio.audiowriter.write_audio()`.
Thus, all formats supported by these functions and the installed
python audio modules are available. This implies that MP3 files can be
read via the [audioread](https://github.com/beetbox/audioread) module,
and they can be written via [pydub](https://github.com/jiaaro/pydub).
Many other input and output file formats are supported by the [sndfile
library](http://www.mega-nerd.com/libsndfile/), provided the
[SoundFile](http://pysoundfile.readthedocs.org) or
[wavefile](https://github.com/vokimon/python-wavefile) python packages
are [installed](https://bendalab.github.io/audioio/installation).
Metadata and markers are preserved if possible.
Run
```sh
audioconverter -l
```
for a list of supported output file formats and
```sh
audioconverter -f wav -l
```
for a list of supported encodings for a given output format (`-f`option).
Running
```sh
audioconverter --help
```
prints
```text
usage: audioconverter [-h] [--version] [-v] [-l] [-f FORMAT] [-e ENCODING] [-s SCALE] [-u [THRESH]] [-U [THRESH]]
[-d FAC] [-c CHANNELS] [-a KEY=VALUE] [-r KEY] [-n NUM] [-o OUTPATH]
[file ...]
Convert audio file formats.
positional arguments:
file one or more input files to be combined into a single output file
options:
-h, --help show this help message and exit
--version show program's version number and exit
-v print debug output
-l list supported file formats and encodings
-f FORMAT audio format of output file
-e ENCODING audio encoding of output file
-s SCALE scale the data by factor SCALE
-u [THRESH] unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and divide by
two
-U [THRESH] unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and clip
-d FAC downsample by integer factor
-c CHANNELS comma and dash separated list of channels to be saved (first channel is 0)
-a KEY=VALUE add key-value pairs to metadata. Keys can have section names separated by "."
-r KEY remove keys from metadata. Keys can have section names separated by "."
-n NUM merge NUM input files into one output file
-o OUTPATH path or filename of output file. Metadata keys enclosed in curly braces will be replaced by their
values from the input file
version 2.0.0 by Benda-Lab (2020-2024)
```
"""
import os
import sys
import argparse
import numpy as np
from scipy.signal import decimate
from .version import __version__, __year__
from .audioloader import load_audio, markers, AudioLoader
from .audiometadata import flatten_metadata, unflatten_metadata
from .audiometadata import add_metadata, remove_metadata, cleanup_metadata
from .audiometadata import bext_history_str, add_history
from .audiometadata import update_gain, add_unwrap
from .audiotools import unwrap
from .audiowriter import available_formats, available_encodings
from .audiowriter import format_from_extension, write_audio
def add_arguments(parser):
""" Add command line arguments to parser.
Parameters
----------
parser: argparse.ArgumentParser
The parser.
"""
parser.add_argument('--version', action='version', version=__version__)
parser.add_argument('-v', action='count', dest='verbose', default=0,
help='print debug output')
parser.add_argument('-l', dest='list_formats', action='store_true',
help='list supported file formats and encodings')
parser.add_argument('-f', dest='data_format', default=None, type=str,
metavar='FORMAT', help='audio format of output file')
parser.add_argument('-e', dest='encoding', default=None, type=str,
help='audio encoding of output file')
parser.add_argument('-s', dest='scale', default=1, type=float,
help='scale the data by factor SCALE')
parser.add_argument('-u', dest='unwrap', default=0, type=float,
metavar='THRESH', const=1.5, nargs='?',
help='unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and divide by two')
parser.add_argument('-U', dest='unwrap_clip', default=0, type=float,
metavar='THRESH', const=1.5, nargs='?',
help='unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and clip')
parser.add_argument('-d', dest='decimate', default=1, type=int,
metavar='FAC',
help='downsample by integer factor')
parser.add_argument('-c', dest='channels', default='', type=str,
help='comma and dash separated list of channels to be saved (first channel is 0)')
parser.add_argument('-a', dest='md_list', action='append', default=[],
type=str, metavar='KEY=VALUE',
help='add key-value pairs to metadata. Keys can have section names separated by "."')
parser.add_argument('-r', dest='remove_keys', action='append', default=[],
type=str, metavar='KEY',
help='remove keys from metadata. Keys can have section names separated by "."')
parser.add_argument('-n', dest='nmerge', default=0, type=int, metavar='NUM',
help='merge NUM input files into one output file')
parser.add_argument('-o', dest='outpath', default=None, type=str,
help='path or filename of output file. Metadata keys enclosed in curly braces will be replaced by their values from the input file')
parser.add_argument('file', nargs='*', type=str,
help='one or more input files to be combined into a single output file')
def parse_channels(cstr):
""" Parse channel selection string.
Parameters
----------
cstr: str
String with comma separated channels and dash separated channel ranges.
Returns
-------
channels: list of int
List of selected channels.
"""
cs = [s.strip() for s in cstr.split(',')]
channels = []
for c in cs:
if len(c) == 0:
continue
css = [s.strip() for s in c.split('-')]
if len(css) == 2:
channels.extend(list(range(int(css[0]), int(css[1])+1)))
else:
channels.append(int(c))
return channels
def check_format(format):
"""
Check whether requested audio format is valid and supported.
If the format is not available print an error message on console.
Parameters
----------
format: string
Audio format to be checked.
Returns
-------
valid: bool
True if the requested audio format is valid.
"""
if not format or format.upper() not in available_formats():
print(f'! invalid audio file format "{format}"!')
print('run')
print(f'> {__file__} -l')
print('for a list of available formats')
return False
else:
return True
def list_formats_encodings(data_format):
""" List available formats or encodings.
Parameters
----------
data_format: None or str
If provided, list encodings for this data format.
Otherwise, list available audio file formats.
"""
if not data_format:
print('available file formats:')
for f in available_formats():
print(f' {f}')
else:
if not check_format(data_format):
sys.exit(-1)
print(f'available encodings for {data_format} file format:')
for e in available_encodings(data_format):
print(f' {e}')
def make_outfile(outpath, infile, data_format, blocks, format_from_ext):
""" Make name for output file.
Parameters
----------
outpath: None or str
Requested output path.
infile: str
Name of the input file.
data_format: None or str
Requested output file format.
blocks: bool
If True, produce outputfile for group of input files.
format_from_ext: function
Function that inspects a filename for its extension and
deduces a file format from it.
Returns
-------
outfile: str
Name of output file.
data_format: str
Format of output file.
"""
if blocks and outpath and \
format_from_ext(outpath) is None and \
not os.path.exists(outpath):
os.mkdir(outpath)
if not outpath or os.path.isdir(outpath):
outfile = infile
if outpath:
outfile = os.path.join(outpath, outfile)
if not data_format:
print('! need to specify an audio format via -f or a file extension !')
sys.exit(-1)
outfile = os.path.splitext(outfile)[0] + os.extsep + data_format.lower()
else:
outfile = outpath
if data_format:
outfile = os.path.splitext(outfile)[0] + os.extsep + data_format.lower()
else:
data_format = format_from_ext(outfile)
return outfile, data_format
def modify_data(data, samplingrate, metadata, channels, scale,
unwrap_clip, unwrap_thresh, ampl_max, unit, decimate_fac):
""" Modify audio data and add modifications to metadata.
Parameters
----------
data: 2-D array of float
The data to be written into the output file.
samplingrate: float
Sampling rate of the data in Hertz.
metadata: nested dict
Metadata.
channels: list of int
List of channels to be selected from the data.
scale: float
Scaling factor to be applied to the data.
unwrap_clip: float
If larger than zero, unwrap the data using this as a threshold
relative to `ampl_max`, and clip the data at +-`ampl_max`.
unwrap_thresh: float
If larger than zero, unwrap the data using this as a threshold
relative to `ampl_max`, and downscale the data by a factor of two.
Also update the gain in the metadata.
ampl_max: float
Maximum amplitude of the input range.
unit: str
Unit of the input range.
decimate_fac: int
Downsample the data by this factor.
Returns
-------
"""
# select channels:
if len(channels) > 0:
data = data[:,channels]
# scale data:
if scale != 1:
data *= scale
update_gain(metadata, 1/scale)
# fix data:
if unwrap_clip > 1e-3:
unwrap(data, unwrap_clip, ampl_max)
data[data > +ampl_max] = +ampl_max
data[data < -ampl_max] = -ampl_max
add_unwrap(metadata, unwrap_clip*ampl_max, ampl_max, unit)
elif unwrap_thresh > 1e-3:
unwrap(data, unwrap_thresh, ampl_max)
data *= 0.5
update_gain(metadata, 0.5)
add_unwrap(metadata, unwrap_thresh*ampl_max, 0.0, unit)
# decimate:
if decimate_fac > 1:
data = decimate(data, decimate_fac, axis=0)
samplingrate /= decimate_fac
return data, samplingrate
def format_outfile(outfile, metadata):
""" Put metadata values into name of output file.
Parameters
----------
outfile: str
Name of output file. May contain metadata keys enclosed in curly braces.
metadata: nested dict
Metadata.
Returns
-------
outfile: str
Name of output file.
"""
if len(metadata) > 0 and '{' in outfile and '}' in outfile:
fmd = flatten_metadata(metadata)
fmd = {k:(fmd[k] if isinstance(fmd[k], (int, float)) else fmd[k].replace(' ', '_')) for k in fmd}
outfile = outfile.format(**fmd)
return outfile
def main(*cargs):
"""
Command line script for converting, downsampling, renaming and merging audio files.
Parameters
----------
cargs: list of strings
Command line arguments as returned by sys.argv[1:].
"""
# command line arguments:
parser = argparse.ArgumentParser(add_help=True,
description='Convert audio file formats.',
epilog=f'version {__version__} by Benda-Lab (2020-{__year__})')
add_arguments(parser)
if len(cargs) == 0:
cargs = None
args = parser.parse_args(cargs)
channels = parse_channels(args.channels)
if args.list_formats:
if args.data_format is None and len(args.file) > 0:
args.data_format = args.file[0]
list_formats_encodings(args.data_format)
return
if len(args.file) == 0 or len(args.file[0]) == 0:
print('! need to specify at least one input file !')
sys.exit(-1)
nmerge = args.nmerge
if nmerge == 0:
nmerge = len(args.file)
for i0 in range(0, len(args.file), nmerge):
infile = args.file[i0]
outfile, data_format = make_outfile(args.outpath, infile,
args.data_format,
nmerge < len(args.file),
format_from_extension)
if not check_format(data_format):
sys.exit(-1)
if os.path.realpath(infile) == os.path.realpath(outfile):
print(f'! cannot convert "{infile}" to itself !')
sys.exit(-1)
# read in audio:
pre_history = None
try:
with AudioLoader(infile) as sf:
data = sf[:,:]
samplingrate = sf.samplerate
md = sf.metadata()
locs, labels = sf.markers()
pre_history = bext_history_str(sf.encoding,
sf.samplerate,
sf.channels,
sf.filepath)
if sf.encoding is not None and args.encoding is None:
args.encoding = sf.encoding
except FileNotFoundError:
print(f'file "{infile}" not found!')
sys.exit(-1)
if args.verbose > 1:
print(f'loaded audio file "{infile}"')
for infile in args.file[i0+1:i0+nmerge]:
try:
xdata, xrate = load_audio(infile)
except FileNotFoundError:
print(f'file "{infile}" not found!')
sys.exit(-1)
if abs(samplingrate - xrate) > 1:
print('! cannot merge files with different sampling rates !')
print(f' file "{args.file[i0]}" has {samplingrate:.0f}Hz')
print(f' file "{infile}" has {xrate:.0f}Hz')
sys.exit(-1)
if xdata.shape[1] != data.shape[1]:
print('! cannot merge files with different numbers of channels !')
print(f' file "{args.file[i0]}" has {data.shape[1]} channels')
print(f' file "{infile}" has {xdata.shape[1]} channels')
sys.exit(-1)
data = np.vstack((data, xdata))
xlocs, xlabels = markers(infile)
locs = np.vstack((locs, xlocs))
labels = np.vstack((labels, xlabels))
if args.verbose > 1:
print(f'loaded audio file "{infile}"')
data, samplingrate = modify_data(data, samplingrate, md,
channels, args.scale,
args.unwrap_clip,
args.unwrap, 1.0, '',
args.decimate)
add_metadata(md, args.md_list, '.')
if len(args.remove_keys) > 0:
remove_metadata(md, args.remove_keys, '.')
cleanup_metadata(md)
outfile = format_outfile(outfile, md)
# history:
hkey = 'CodingHistory'
if 'BEXT' in md:
hkey = 'BEXT.' + hkey
history = bext_history_str(args.encoding, samplingrate,
data.shape[1], outfile)
add_history(md, history, hkey, pre_history)
# write out audio:
try:
write_audio(outfile, data, samplingrate,
md, locs, labels,
format=data_format, encoding=args.encoding)
except PermissionError:
print(f'failed to write "{outfile}": permission denied!')
sys.exit(-1)
# message:
if args.verbose > 1:
print(f'wrote "{outfile}"')
elif args.verbose:
print(f'converted audio file "{infile}" to "{outfile}"')
if __name__ == '__main__':
main(*sys.argv[1:])Functions
def add_arguments(parser)-
Add command line arguments to parser.
Parameters
parser:argparse.ArgumentParser- The parser.
Expand source code
def add_arguments(parser): """ Add command line arguments to parser. Parameters ---------- parser: argparse.ArgumentParser The parser. """ parser.add_argument('--version', action='version', version=__version__) parser.add_argument('-v', action='count', dest='verbose', default=0, help='print debug output') parser.add_argument('-l', dest='list_formats', action='store_true', help='list supported file formats and encodings') parser.add_argument('-f', dest='data_format', default=None, type=str, metavar='FORMAT', help='audio format of output file') parser.add_argument('-e', dest='encoding', default=None, type=str, help='audio encoding of output file') parser.add_argument('-s', dest='scale', default=1, type=float, help='scale the data by factor SCALE') parser.add_argument('-u', dest='unwrap', default=0, type=float, metavar='THRESH', const=1.5, nargs='?', help='unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and divide by two') parser.add_argument('-U', dest='unwrap_clip', default=0, type=float, metavar='THRESH', const=1.5, nargs='?', help='unwrap clipped data with threshold relative to maximum of input range (default is 0.5) and clip') parser.add_argument('-d', dest='decimate', default=1, type=int, metavar='FAC', help='downsample by integer factor') parser.add_argument('-c', dest='channels', default='', type=str, help='comma and dash separated list of channels to be saved (first channel is 0)') parser.add_argument('-a', dest='md_list', action='append', default=[], type=str, metavar='KEY=VALUE', help='add key-value pairs to metadata. Keys can have section names separated by "."') parser.add_argument('-r', dest='remove_keys', action='append', default=[], type=str, metavar='KEY', help='remove keys from metadata. Keys can have section names separated by "."') parser.add_argument('-n', dest='nmerge', default=0, type=int, metavar='NUM', help='merge NUM input files into one output file') parser.add_argument('-o', dest='outpath', default=None, type=str, help='path or filename of output file. Metadata keys enclosed in curly braces will be replaced by their values from the input file') parser.add_argument('file', nargs='*', type=str, help='one or more input files to be combined into a single output file') def parse_channels(cstr)-
Parse channel selection string.
Parameters
cstr:str- String with comma separated channels and dash separated channel ranges.
Returns
channels:listofint- List of selected channels.
Expand source code
def parse_channels(cstr): """ Parse channel selection string. Parameters ---------- cstr: str String with comma separated channels and dash separated channel ranges. Returns ------- channels: list of int List of selected channels. """ cs = [s.strip() for s in cstr.split(',')] channels = [] for c in cs: if len(c) == 0: continue css = [s.strip() for s in c.split('-')] if len(css) == 2: channels.extend(list(range(int(css[0]), int(css[1])+1))) else: channels.append(int(c)) return channels def check_format(format)-
Check whether requested audio format is valid and supported.
If the format is not available print an error message on console.
Parameters
format:string- Audio format to be checked.
Returns
valid:bool- True if the requested audio format is valid.
Expand source code
def check_format(format): """ Check whether requested audio format is valid and supported. If the format is not available print an error message on console. Parameters ---------- format: string Audio format to be checked. Returns ------- valid: bool True if the requested audio format is valid. """ if not format or format.upper() not in available_formats(): print(f'! invalid audio file format "{format}"!') print('run') print(f'> {__file__} -l') print('for a list of available formats') return False else: return True def list_formats_encodings(data_format)-
List available formats or encodings.
Parameters
data_format:Noneorstr- If provided, list encodings for this data format. Otherwise, list available audio file formats.
Expand source code
def list_formats_encodings(data_format): """ List available formats or encodings. Parameters ---------- data_format: None or str If provided, list encodings for this data format. Otherwise, list available audio file formats. """ if not data_format: print('available file formats:') for f in available_formats(): print(f' {f}') else: if not check_format(data_format): sys.exit(-1) print(f'available encodings for {data_format} file format:') for e in available_encodings(data_format): print(f' {e}') def make_outfile(outpath, infile, data_format, blocks, format_from_ext)-
Make name for output file.
Parameters
outpath:Noneorstr- Requested output path.
infile:str- Name of the input file.
data_format:Noneorstr- Requested output file format.
blocks:bool- If True, produce outputfile for group of input files.
format_from_ext:function- Function that inspects a filename for its extension and deduces a file format from it.
Returns
outfile:str- Name of output file.
data_format:str- Format of output file.
Expand source code
def make_outfile(outpath, infile, data_format, blocks, format_from_ext): """ Make name for output file. Parameters ---------- outpath: None or str Requested output path. infile: str Name of the input file. data_format: None or str Requested output file format. blocks: bool If True, produce outputfile for group of input files. format_from_ext: function Function that inspects a filename for its extension and deduces a file format from it. Returns ------- outfile: str Name of output file. data_format: str Format of output file. """ if blocks and outpath and \ format_from_ext(outpath) is None and \ not os.path.exists(outpath): os.mkdir(outpath) if not outpath or os.path.isdir(outpath): outfile = infile if outpath: outfile = os.path.join(outpath, outfile) if not data_format: print('! need to specify an audio format via -f or a file extension !') sys.exit(-1) outfile = os.path.splitext(outfile)[0] + os.extsep + data_format.lower() else: outfile = outpath if data_format: outfile = os.path.splitext(outfile)[0] + os.extsep + data_format.lower() else: data_format = format_from_ext(outfile) return outfile, data_format def modify_data(data, samplingrate, metadata, channels, scale, unwrap_clip, unwrap_thresh, ampl_max, unit, decimate_fac)-
Modify audio data and add modifications to metadata.
Parameters
data:2-D arrayoffloat- The data to be written into the output file.
samplingrate:float- Sampling rate of the data in Hertz.
metadata:nested dict- Metadata.
channels:listofint- List of channels to be selected from the data.
scale:float- Scaling factor to be applied to the data.
unwrap_clip:float- If larger than zero, unwrap the data using this as a threshold
relative to
ampl_max, and clip the data at +-ampl_max. unwrap_thresh:float- If larger than zero, unwrap the data using this as a threshold
relative to
ampl_max, and downscale the data by a factor of two. Also update the gain in the metadata. ampl_max:float- Maximum amplitude of the input range.
unit:str- Unit of the input range.
decimate_fac:int- Downsample the data by this factor.
Returns
Expand source code
def modify_data(data, samplingrate, metadata, channels, scale, unwrap_clip, unwrap_thresh, ampl_max, unit, decimate_fac): """ Modify audio data and add modifications to metadata. Parameters ---------- data: 2-D array of float The data to be written into the output file. samplingrate: float Sampling rate of the data in Hertz. metadata: nested dict Metadata. channels: list of int List of channels to be selected from the data. scale: float Scaling factor to be applied to the data. unwrap_clip: float If larger than zero, unwrap the data using this as a threshold relative to `ampl_max`, and clip the data at +-`ampl_max`. unwrap_thresh: float If larger than zero, unwrap the data using this as a threshold relative to `ampl_max`, and downscale the data by a factor of two. Also update the gain in the metadata. ampl_max: float Maximum amplitude of the input range. unit: str Unit of the input range. decimate_fac: int Downsample the data by this factor. Returns ------- """ # select channels: if len(channels) > 0: data = data[:,channels] # scale data: if scale != 1: data *= scale update_gain(metadata, 1/scale) # fix data: if unwrap_clip > 1e-3: unwrap(data, unwrap_clip, ampl_max) data[data > +ampl_max] = +ampl_max data[data < -ampl_max] = -ampl_max add_unwrap(metadata, unwrap_clip*ampl_max, ampl_max, unit) elif unwrap_thresh > 1e-3: unwrap(data, unwrap_thresh, ampl_max) data *= 0.5 update_gain(metadata, 0.5) add_unwrap(metadata, unwrap_thresh*ampl_max, 0.0, unit) # decimate: if decimate_fac > 1: data = decimate(data, decimate_fac, axis=0) samplingrate /= decimate_fac return data, samplingrate def format_outfile(outfile, metadata)-
Put metadata values into name of output file.
Parameters
outfile:str- Name of output file. May contain metadata keys enclosed in curly braces.
metadata:nested dict- Metadata.
Returns
outfile:str- Name of output file.
Expand source code
def format_outfile(outfile, metadata): """ Put metadata values into name of output file. Parameters ---------- outfile: str Name of output file. May contain metadata keys enclosed in curly braces. metadata: nested dict Metadata. Returns ------- outfile: str Name of output file. """ if len(metadata) > 0 and '{' in outfile and '}' in outfile: fmd = flatten_metadata(metadata) fmd = {k:(fmd[k] if isinstance(fmd[k], (int, float)) else fmd[k].replace(' ', '_')) for k in fmd} outfile = outfile.format(**fmd) return outfile def main(*cargs)-
Command line script for converting, downsampling, renaming and merging audio files.
Parameters
cargs:listofstrings- Command line arguments as returned by sys.argv[1:].
Expand source code
def main(*cargs): """ Command line script for converting, downsampling, renaming and merging audio files. Parameters ---------- cargs: list of strings Command line arguments as returned by sys.argv[1:]. """ # command line arguments: parser = argparse.ArgumentParser(add_help=True, description='Convert audio file formats.', epilog=f'version {__version__} by Benda-Lab (2020-{__year__})') add_arguments(parser) if len(cargs) == 0: cargs = None args = parser.parse_args(cargs) channels = parse_channels(args.channels) if args.list_formats: if args.data_format is None and len(args.file) > 0: args.data_format = args.file[0] list_formats_encodings(args.data_format) return if len(args.file) == 0 or len(args.file[0]) == 0: print('! need to specify at least one input file !') sys.exit(-1) nmerge = args.nmerge if nmerge == 0: nmerge = len(args.file) for i0 in range(0, len(args.file), nmerge): infile = args.file[i0] outfile, data_format = make_outfile(args.outpath, infile, args.data_format, nmerge < len(args.file), format_from_extension) if not check_format(data_format): sys.exit(-1) if os.path.realpath(infile) == os.path.realpath(outfile): print(f'! cannot convert "{infile}" to itself !') sys.exit(-1) # read in audio: pre_history = None try: with AudioLoader(infile) as sf: data = sf[:,:] samplingrate = sf.samplerate md = sf.metadata() locs, labels = sf.markers() pre_history = bext_history_str(sf.encoding, sf.samplerate, sf.channels, sf.filepath) if sf.encoding is not None and args.encoding is None: args.encoding = sf.encoding except FileNotFoundError: print(f'file "{infile}" not found!') sys.exit(-1) if args.verbose > 1: print(f'loaded audio file "{infile}"') for infile in args.file[i0+1:i0+nmerge]: try: xdata, xrate = load_audio(infile) except FileNotFoundError: print(f'file "{infile}" not found!') sys.exit(-1) if abs(samplingrate - xrate) > 1: print('! cannot merge files with different sampling rates !') print(f' file "{args.file[i0]}" has {samplingrate:.0f}Hz') print(f' file "{infile}" has {xrate:.0f}Hz') sys.exit(-1) if xdata.shape[1] != data.shape[1]: print('! cannot merge files with different numbers of channels !') print(f' file "{args.file[i0]}" has {data.shape[1]} channels') print(f' file "{infile}" has {xdata.shape[1]} channels') sys.exit(-1) data = np.vstack((data, xdata)) xlocs, xlabels = markers(infile) locs = np.vstack((locs, xlocs)) labels = np.vstack((labels, xlabels)) if args.verbose > 1: print(f'loaded audio file "{infile}"') data, samplingrate = modify_data(data, samplingrate, md, channels, args.scale, args.unwrap_clip, args.unwrap, 1.0, '', args.decimate) add_metadata(md, args.md_list, '.') if len(args.remove_keys) > 0: remove_metadata(md, args.remove_keys, '.') cleanup_metadata(md) outfile = format_outfile(outfile, md) # history: hkey = 'CodingHistory' if 'BEXT' in md: hkey = 'BEXT.' + hkey history = bext_history_str(args.encoding, samplingrate, data.shape[1], outfile) add_history(md, history, hkey, pre_history) # write out audio: try: write_audio(outfile, data, samplingrate, md, locs, labels, format=data_format, encoding=args.encoding) except PermissionError: print(f'failed to write "{outfile}": permission denied!') sys.exit(-1) # message: if args.verbose > 1: print(f'wrote "{outfile}"') elif args.verbose: print(f'converted audio file "{infile}" to "{outfile}"')