MP3SPLT(1)MP3SPLT(1)NAME
mp3splt, oggsplt, flacsplt - utility for mp3, ogg vorbis and native
flac splitting without decoding
SYNOPSISmp3splt [OPTIONS] FILE_OR_DIR1 [FILE_OR_DIR2] ... [BEGIN_TIME] [TIME2]
... [END_TIME]
FILE_OR_DIR: mp3, ogg vorbis, native flac file to be split or a direc‐
tory. If you want to specify STDIN as input, you can use "m-" (or "-")
when input is mp3, and "o-" when ogg. Multiple files can be specified,
all files will be split with the same criterion. If a directory is
specified, a recursive scan is performed in that directory to find out
all the supported file formats.
TIME FORMAT:
minutes.seconds[.hundredths] or EOF-minutes.seconds[.hundredths]
Minutes (required): There is no limit to minutes. (You must use
this format also for minutes over 59)
Seconds (required): Must be between 0 and 59.
Hundredths (optional): Must be between 0 and 99. Use them for
higher precision.
Multiple split points can be specified. After the minimal 2, another
indefinite number of split points can be specified. Each split point
will be an end time for the previous, and a begin for the following.
If you want to reach the end of file, you can use "EOF" as last split‐
point. EOF-minutes.seconds[.hundredths] only works when input is seek‐
able.
DESCRIPTIONmp3splt is a free command-line utility that allows you to split mp3,
ogg vorbis and native flac files from several splitpoints, without need
of decoding and reencoding. It is useful to split large mp3, ogg vor‐
bis and native flac to make smaller files or to split entire albums to
obtain original tracks.
If you are splitting an album you can get splitpoints and filenames
automatically from servers on internet like freedb.org, tracktype.org
or from a local .XMCD (.CDDB) or .CUE file (see -c option), with the
possibility to adjust them automatically with silence detection (see -a
option).
You can also try to split files automatically with silence detection
(see -s option), trim files using silence detection (see -r option), or
by a fixed time length (see -t option)
Or if you have a file created either with Mp3Wrap or AlbumWrap, you can
easily split it just with one command (see -w option).
IMPORTANT NOTE for FLAC: FLAC support is still experimental. Please use
with caution. Missing FLAC features are stdin (input not seekable) and
stdout.
NOTE for MP3: usually mp3splt understands if mp3 is VBR by checking the
presence of a Xing or Info header and will consequently start in
framemode, but if this is not present, mp3splt will start in standard
mode. This means that splitting process will be quicker, but imprecise
due to variable bitrate, you can split those VBR files only with
framemode (see -f option).
NOTE for OGG: in some cases, mp3splt does not manage to split ogg vor‐
bis streams correctly. Splitting the input file from 0.0 to EOF might
fix the issues.
NOTES about TAGS: by default, mp3splt will put the original tags in the
split files with one exception: the track number starts at 1 and is
incremented along split files. When copying the original file tags,
only one artist, album, title are supported. Custom tags for the split
files can be set with the -g option. Setting exactly the same tags as
the original file is possible with -g %[@O] (mp3 only) or -g %[@o].
NOTE about MP3 TAGS: in order to extract the original tags from mp3
files, libmp3splt must be compiled with 'id3tag' support. By default,
the output files will have the same ID3 tag version as the input file;
this behaviour can be changed with the -T option. If the input file has
no tags and the -g option is used, then both ID3v1 and ID3v2 are writ‐
ten. Total tracknumber is not yet supported. Only writing ID3v2.4 is
supported for custom tags; note that some software only support ID3v2.3
and will not be able to read them. However, it is possible to write the
exact original tags using %[@O], keeping the same tags version as in
the original file.
NOTE about the OUTPUT DIRECTORY: by default, mp3splt will put the split
files in the directory of the input file. In order to change the output
directory, you can use one of the following options: -d or -o. Please
note that directories from the -o option will be created relative to
the input file directory.
OPTIONS-w Wrap Mode. Use to split file created with:
Mp3Wrap http://mp3wrap.sourceforge.net: This tool joins two
or more mp3 files in one large playable file that usually
contains the string MP3WRAP in filename and a special comment
in ID3v2. If the file you are splitting is a Mp3Wrap file the
splitting process will be very fast and you will obtain all
files just with one command. If your filename contains
MP3WRAP and you have errors or you don't want to use wrap
mode, just remove it from the file.
AlbumWrap: mp3splt is compatible also with albumwrap files,
which usually contain the string ALBW in filename and ID3v2
contains AlbumWrap. But, as AlbumWrap extractor, mp3splt
doesn't give any warranty.
-l List mode (Only for Wrap mode). Lists all tracks wrapped in
a Mp3Wrap or AlbumWrap archive without any extraction. Use
this to view the content of the file or to test if file is a
valid wrapped file.
-e Error mode (mp3 only). It is useful to split large file
derivated from a concatenation of smaller files. It detects
split points from the so called "sync errors" (data that
break stream, such as ID3 or junk data). Examples of appli‐
cable files are wrapped file (both AlbumWrap and Mp3Wrap) or
file created by appending many mp3 files together. So, when
you have a file to split, you should always try to use this
option.
-A AUDACITY_FILE
Audacity labels mode. Split with splitpoints from the audac‐
ity labels file. Example of audacity labels file (in sec‐
onds):
10.000000 67.000000 first_file
67.000000 127.000000 second_file
149.000000 206.000000 third_file
-t TIME[>MIN_TIME]
Time mode. This option will create an indefinite number of
smaller files with a fixed time length specified by TIME
(which has the same format described above). It is useful to
split long files into smaller (for example with the time
length of a CD). Adjust option (-a) can be used to adjust
splitpoints with silence detection. >MIN_TIME can be used to
specify the theoretical minimum track length of the last seg‐
ment; it allows avoiding to create very small files as the
last segment. Make sure to quote the argument when using
MIN_TIME - "TIME>MIN_TIME".
-S SPLIT_NUMBER
Equal time tracks mode. Split in SPLIT_NUMBER files.
-r Trim using silence detection, to trim using silence detec‐
tion. To trim using silence detection we need to decode
files, so this option can be really slow if used with big
files. It accepts some parameters with -p option (see below
for a detailed description): threshold level (th) which is
the sound level to be considered silence, min (min) which is
the minimum silence length to trigger a trimming; this amount
of silence will be kept in the split file at the beginning
and at the end.
-s Silence mode, to split with silence detection. When you use
-s option, mp3splt attempts to detect silence points in all
the file (or just in some parts, see -a and -c below for
this). To detect silence we need to decode files, so this
option can be really slow if used with big files. It accepts
some parameters with -p option (see below for a detailed
description): threshold level (th) which is the sound level
to be considered silence, number of tracks (nt) which is the
desired number of tracks, cutpoint offset (off) which is the
offset of cutpoint in silence, minimum_length (min) which is
the minimum silence length in seconds, remove silence (rm)
which allows you to remove the silence between split tracks.
If you don't specify any parameter, mp3splt will use the
default values. Of course if you specify the number of tracks
to split, you will help mp3splt to understand what are the
most probable split points, anyway once you scan a file with
-s option, mp3splt will write a file named "mp3splt.log" in
which it saves all silence points found. If this file exists
in the current working directory, mp3splt will read the
splitpoints from this file and will not recompute the silence
splitpoints. This allows you to run mp3splt with different
parameters (except th and min) without decoding the file
again. Finally, if the number of silence points is not cor‐
rect, you have many chances to achieve right result. For
example if a silence point was not detected because too
short, you can manually split the long track in the two
smaller ones. Or if file is an MP3 (not with ogg) and there
are too many silence points that can't be discarded reducing
track number (because are longer than right points) you can
safely concatenate them with 'cat' programs or similar ('copy
/b file1+file2' for dos) because split files are consecutive,
no data is lost. This option is intended to split
small/medium size (but even large if you can wait ;) mp3 and
ogg files where tracks are separated by a reasonable silence
time. To try to split mixed albums or files with consecutive
tracks (such as live performances) might be only a waste of
time.
Note about "mp3splt.log":
The first line contains the name of the split file
The second line contains the threshold and the minimum
silence length
The next lines contain each one three columns:
‐the first column is the start position of the found
silence (in seconds.fractions)
‐the second column is the end position of the found
silence (in seconds.fractions)
‐the third column is the order of magnitude of the
silence length; it is useful to find out most probable
silence points
-c SOURCE CDDB mode. To get splitpoints and filenames automatically
from SOURCE, that is the name of a ".CUE" file (note that it
must end with ".cue", otherwise it will be wrongly inter‐
preted as a cddb file) or a local .XMCD (.CDDB) file on your
hard disk.
Furthermore, if you want to split using internal sheets,
SOURCE must be internal_sheet. Currently two internal sheets
are supported: internal CUE sheet of native FLAC files and
ID3v2 chapters for MP3 files (note that there is a limitation
on ID3v2 chapters for overlapped chapters).
If you want to get informations from Internet, SOURCE must
have one of the following formats:
query
query{album}
query{album}(ALBUM_RESULT_NUMBER)
query[search=protocol://SITE:PORT, get=proto‐
col://SITE:PORT]
query[search...]{album}
query[search...]{album}(ALBUM_RESULT_NUMBER)
If a string is specified between '{' and '}', then the inter‐
net search is made on this string and the user will not be
requested to interactively input a search string. The number
between '(' and ')' is for auto-selecting the result number
ALBUM_RESULT_NUMBER; thus, the user will not be requested to
interactively input a result number.
The other parameters between '[' and ']' are used to specify
the protocols and the sites. If those parameters are not
specified, default values will be chosen, which are good
enough in most cases. Inside the square brackets, 'search'
defines the CDDB search protocol and site (for searching the
disc ID from the album and title); 'get' defines the CDDB
download protocol and site (for downloading the CDDB file
from the disc ID). Valid 'search' protocols are : 'cddb_cgi'
and 'cddb_protocol'. Valid 'get' protocols are: 'cddb_cgi'.
Examples:
query[search=cddb_cgi://track‐
type.org/~cddb/cddb.cgi:80,get=cddb_cgi://track‐
type.org/~cddb/cddb.cgi:80]
query[get=cddb_protocol://freedb.org:8880]
query[get=cddb_cgi://freedb.org/~cddb/cddb.cgi:80]
Mp3splt will connect to the server and start to find the
requested informations. If the right album is found, then
mp3splt will query the server to get the selected album and
(if no problem occurs) will write a file named "query.cddb"
from which will get splitpoints and filenames.
Proxy support: The first time that the user queries the
internet (and if the quiet mode is not enabled), mp3splt asks
for some information about proxy usage. Mp3splt has basic
authentification support using base64 for HTTP proxies. A
file named ´.mp3splt´ is created in the user home directory
containing the informations provided by the user. Deleting
this file will make mp3splt to query the user again. Please
note that the authentification storage is not secure. The
'username:password' is stored as base64 and can be easily
decoded.
IMPORTANT NOTE FOR CDDB: File split with this option can be
not very precise due to:
1) Who extracts CD tracks may use "Remove silence" option.
This means that the large file is shorter than CD Total time.
Never use this option.
2) Who burns CD may add extra pause seconds between tracks.
Never do it.
3) Encoders may add some padding frames so that file is
longer than CD.
4) There are several entries of the same cd on CDDB. In
mp3splt they appears with "\=>" symbol. Try some of them and
find the best for yours; usually you can find the correct
splitpoints, so good luck!
YOU CAN USE THE -a OPTION TO ADJUST SPLITPOINTS!
-a Auto-adjust mode. This option uses silence detection to
auto-adjust splitpoints. It can be used in standard mode, or
with -t and -c option (of course if there is silence in the
file ;). It accepts some parameters with -p option (see
below for a detailed description): threshold level (th) which
is the sound level to be considered silence, cutpoint offset
(off) which is the offset of cutpoint in silence, min (min)
which is the minimum silence length in seconds, gap (gap)
which is the gap value around splitpoint to search for
silence. If you don't specify any parameter, mp3splt will
use the default values. With -a option splitting process is
the same, but for each splitpoint mp3splt will decode some
time (gap) before and some after to find silence and adjust
splitpoints.
-p PARAMETERS
Parameters for -a, -s and -r option. When using -a, -s and -r
option some users parameters can be specified in the argument
and must be in the form:
<name1=value,name2=value,..>
You can specify an indefinite number of them, with no spaces
and separated by comma. Available parameters are:
For -s, -a and -r
th=FLOAT Threshold level (dB) to be considered silence. It is a float
number between -96 and 0. Default is -48 dB, which is a value
found by tests and should be good in most cases.
shots=INTEGER
Positive integer of the minimum number of shots to be found
as non silence after the silence. Default is 25. Decrease
this value if you need to split files having closer silence
points.
min=FLOAT Positive float of the minimum number of seconds to be consid‐
ered as valid silence. All silences shorter than min are dis‐
carded. Default is 0. For the trim silence split, it is the
minimum silence length to trigger a trimming; this amount of
silence will be kept in the split file at the beginning and
at the end.
Both -s and -a
off=FLOAT Float number between -2 and 2 and allows you to adjust the
offset of cutpoint in silence time. 0 is the begin of
silence, and 1 the end. Default is 0.8. In most cases, you
will only need to use a value between 0 and 1.
Offset visualization:
v off=0 v off=1
++++ ... ++++++++++++++++++++++----------++++++++++ ...
+++++
^off=-0.5 ^off=1.5
^off=-1 ^off=2
^off=-1.5
^off=-2
Legend: pluses are 'audio', minuses 'silence', 'v' down-
arrow, '^' up-arrow and '...' a segment of the audio file
(silence or audio)
Only -s
nt=INTEGER
Positive integer number of tracks to be split when using -s
option. By default all tracks are split.
rm[=FLOAT_FLOAT]
It is used to remove silence when using the -s option. Can
be used without additional numbers - by default it will cut
all the silence found. Users can keep some of the silence
found by passing the number of seconds to be kept at the
beginning of the output files and at the end of the output
files. For example, 'rm=2_6' will keep 2 seconds of silence
at the beginning of the split files and 6 seconds at the end.
If the silence length is less than the sum of the number of
seconds passed to the rm parameter, the split will convert
the values to a percentage of the silence length. Taking the
previous example, if the silence length is less than 8 sec‐
onds, the split will be done at 75% of the silence segment
starting from the beginning of the silence ( 75% = 6/(2+6) ).
trackmin=FLOAT
Positive float of the minimum number of seconds for a track
to be written out. Tracks shorter than trackmin will be
skipped during the output phase. The default value 0.0 means
to not skip any tracks.
trackjoin=FLOAT
Positive float of the minimum number of seconds for a track
to be written out. Tracks shorter than trackjoin will be
joined with others. The main difference between this parame‐
ter and trackmin is that using this one, no part of the orig‐
inal file will be lost. The default value of 0.0 means to
not join any tracks. If using both trackmin and trackjoin,
tracks shorter than trackmin will be discarded, but after the
join.
Only -a
gap=INTEGER
Positive integer for the time to decode before and after
splitpoint, increase if splitpoints are completely wrong, or
decrease if wrong for only few seconds. Of course the smaller
the gap, the faster the process. Default gap is 30 seconds
(so for each song, total decode time is one minute).
warn_if_no_aa
Print a warning for each splitpoint if it has not been auto-
adjusted.
error_if_no_aa
Stop the split process with error if one of the splitpoints
has not been auto-adjusted.
-f Frame mode (mp3 only). Process all frames, seeking split
positions by counting frames and not with bitrate guessing.
In this mode you have higher precision and you can split
variable bitrate (VBR) mp3. (You can also split costant
bitrate mp3, but it will take more time). Note also that
"high" precision means that time seeking is reliable, but may
not coincide for example with another player program that
uses time seeking with bitrate guessing, so make your choice.
Frame mode will print extra info on split process, such as
sync errors. If you obtain some sync errors, try also to
split with -e option.
-b [Experimental] Bit reservoir handling for gapless playback
(mp3 only). Handles bit reservoir issues when splitting mp3
files. This option also allows playback at the exact sample
specified by the input time, instead of the music data bound‐
aries. Warning: split files will play gapless only on players
supporting mp3 gapless playback using the LAME tag delay and
padding values (example of gapless mp3 players: cmus, mpg123,
foobar2000). The feature is heavily inspired by pcutmp3
developed by Sebastian Gesemann. Use with caution because it
is still an experimental feature.
-k Input not seekable. Consider input not seekable (default when
using STDIN as input). This allows you to split mp3 streams
which can be read only one time and can't be seeked. Both
framemode and standard mode are available, but framemode can
be really slow if used with big files, because to seek split‐
points we need to process all bytes and all frames. -k option
(so STDIN as input too) can't be used together with -s -a -w
-e, because input must be seekable for those options. Copying
original tags is not yet supported for the non seekable
option.
-M Write MD5 sum (FLAC only). Using this option, the frames are
decoded just before being written in the output files and MD5
sum of the unencoded data is computed in order to complete
the STREAMINFO metadata block of the created files. This
option is disabled by default because the decoding process
makes the split to be much slower (it can be twice slower).
However, even when using this option, the process remains
faster compared to splitting by decoding and then re-encod‐
ing.
-O TIME Overlap split files. TIME will be added to each end split‐
point. Current implementation of this option makes the split
slower.
-o FORMAT Output format. FORMAT is a string that will be used as output
directory and/or filename. If FORMAT contains the DIRCHAR
character ('\' on windows and '/' on other systems), directo‐
ries will be created for each DIRCHAR if they don't exist and
the output files will be created in the corresponding direc‐
tory. If the -d option is not specified, the output directory
is the concatenation of the input file directory and the
extracted path from FORMAT. If the -d option is also speci‐
fied, the output directory will be the concatenation between
the -d option value and the extracted path from the -o FORMAT
(characters up to the last DIRCHAR). Invalid filename charac‐
ters from the tags are transformed to '_'.
It can contain name variables, that must begin with @ char
and that can be:
@A: performer if found, otherwise artist
@a: artist name
@p: performer of each song (only with .cue)
@b: album title
@g: genre
@t: song title*
@n: track number identifier* (not the real ID3 track num‐
ber)**
@N: track tag number**
@l: track number identifier as lowercase letter* (not the
real ID3 track number)**
@L: track tag number as lowercase letter**
@u: track number identifier as uppercase letter* (not the
real ID3 track number)**
@U: track tag number as uppercase letter**
@f: input filename (without extension)
@d: last directory of the input filename or the filename
itself if no directory
@m, @s or @h: the number of minutes, seconds or hundreths of
seconds of the start splitpoint**
@M, @S or @H: the number of minutes, seconds or hundreths of
seconds of the end splitpoint**
(**) One digit may follow defining the number of digits to
output.
If the digit is 0, then a special rule is applied when the
pattern value is equal to 0:
- the pattern is discarded
- all characters like : _ . and -. preceding it are discarded
- all characters following it are discarded up to the next @
or a separator like : _ . and -
This rule is useful for discarding the last part of the time
when equal to 0. For example @m_@s_@h0hundreths__@M_@S will
only output @m_@s__@M_@S if the hundreths of seconds are 0.
When split files are more than one, at least one of @t, @n,
@N, @l, @L, @u or @U (*) must be present to avoid ambiguous
names. You can put any prefix, separator, suffix in the
string, for more elegance. To make easy the use spaces in
output filename without interfering with line parameters, you
can use the char '+' that will be automatically replaced with
a space. Valid examples are:
@n_@a_@b_@t
@a+-+@n+-+@t (default if using -c and -o is not specified)
@a/@b/@t_@n (will create the directories '<artist>' and
'<artist>/<album>')
@f_@n+@m:@s+@M:@S
-d NAME Output directory. To put all output files in the directory
named NAME. If directory does not exists, it will be created.
The -o option can also be used to output files into a direc‐
tory.
-n No tags. Does not write ID3 or Vorbis comment in output
files. Use if you need clean files. See also the -x option.
-x No Xing header. Does not write the Xing header in output
files. Use this option with -n if you wish to concatenate the
split files and obtain a similar file as the input file.
-T TAGS_VERSION
Force output tags version. For mp3 files, force output ID3
tags as version ID3v1, ID3v2 or ID3v1 and ID3v2. TAGS_VERSION
can be 1, 2 or 12. Default is to set the output tags version
as the tags version of the input file.
-C ID3V2_TEXT_ENCODING
Set encoding of the ID3V2 tags. For mp3 files, set the encod‐
ing of ID3V2 tags. ID3V2_TEXT_ENCODING can be 1 for latin1
(iso-8859-1), 8 for UTF-8 or 16 for UTF-16. Default is
UTF-16.
-I INPUT_TAGS_ENCODING_FOR_ID3V2
Set encoding of the input tags for mp3 files.
INPUT_TAGS_ENCODING_FOR_ID3V2 can be 1 for latin1
(iso-8859-1), 8 for UTF-8 or 16 for UTF-16. Default is
UTF-8.
-N No silence log file. Don't create the 'mp3splt.log' log file
when using silence detection. This option cannot be used
without the '-s' option.
-K Keep original tags for CDDB or CUE. When importing a CDDB or
CUE file, set the original input file tags and then replace
them with those read from the imported file.
-g TAGS Custom tags. Set custom tags to the split files. If you want
to set spaces in tags, you might need to double quote the
whole TAGS. TAGS should contain a list of square brackets
pairs []. The tags defined in the first pair of square brack‐
ets will be set on the first split file, those defined in the
second pair of square brackets will be set on the second
split file, ... Inside a pair of square brackets, each tag is
defined as @variable=value and tags are separated by comma.
If a percent sign % is found before the open square bracket
character, then the pair of square brackets following the %
character will define the default tags in the following
files. Multiple '%' can be defined. An optional 'r' character
can be placed at the start, to replace tags in tags. The
'replace tags in tags' option is not recursive. The variables
can be:
@a: artist name
@b: album title
@t: audio title
@y: year
@c: comment
@g: genre
@n: track number (set to -2 for none)
@o: set original tags
@O: set exactly the same original tag bytes and discard other
variables (mp3 only)
@N: auto increment track number: this variable has to be
placed inside the %[] field in order to have the track number
auto incremented for all the split files following it
@m, @s or @h: the number of minutes, seconds or hundreths of
seconds of the start splitpoint
@M, @S or @H: the number of minutes, seconds or hundreths of
seconds of the end splitpoint
Using the 'replace tags in tags' option, you can also use the
following variables, which are replaced by the data from the
original tags: #a, #b, #t, #y, #c, #g. Note that this will
only work if @o has been found before.
Example of tags format: %[@o,@N=1,@b=spe‐
cial_album][@a=foo,@b=bar][@t=footitle]. In this example, the
first split file will have the original tags with album tag
replaced by 'special album'; the second split file will have
the tags of the first split, with the artist tag replaced by
'foo' and the album tag replaced by 'bar'; the third split
file will have the tags of the first split, with the title
tag replaced by 'footitle'. The track number will start at 1
for the first split file and auto increment to the other
files.
Example of replacing tags in tags:
r%[@o,@N=1,@b=album,@a=artist_@b_@N]. Having the 'r' option,
the replace tags in tags mode is activated; thus, output
artists are 'artist_album_1','artist_album_2', ... Without
the 'r' option, output artists are 'artist_@b_@N'.
Replacement is not recursive:
r%[@o,@N=1,@b=album_@N,@a=artist_@b] will output albums as
'album_1', 'album_2', ... but artists as 'artist_album_@N'.
Example of replacing tags in tags with # variables:
r%[@o,@N=1,@t=@N_#t]This will prepend the auto incremented
track number to the original input file title; supposing that
the input file title is 'one_title', this will set the titles
as follows: '1_one_title', '2_one_title', ...
-G regex=REGEX
Tags from filename regex. Set tags from input filename regu‐
lar expression. REGEX can contain those variables:
(?<artist>), (?<album>), (?<title>), (?<tracknum>),
(?<year>), (?<comment>), (?<genre>)
Example: if the input filename is
artist1__album2__title3__comment4__2__2004__Samba.ogg,
the following regular expression
(?<artist>.*?)__(?<album>.*?)__(?<title>.*?)__(?<com‐
ment>.*?)__(?<tracknum>.*?)__(?<year>.*?)__(?<genre>.*)
extracts the tags:
(?<artist>): artist1
(?<album>): album2
(?<title>): title3
(?<genre>): Samba
(?<comment>): comment4
(?<tracknum>): 2
(?<year>): 2004
-m M3U Create .m3u file. Creates a .m3u file containing the split
files. The generated .m3u file only contains the split file‐
names without the path. If an output directory is specified
with -d or -o, the file is created in this directory. The
path of M3U is ignored. This option cannot be used with STD‐
OUT output.
-E CUE_FILE
Export to .cue file. Creates a .cue file containing the
splitpoints. Use -P to export the splitpoints without actu‐
ally splitting. The cue file contains the tags of the split‐
points as comments (for example REM ALBUM, REM GENRE, REM
DATE). There is however one limitation: REM TRACK is not
written if the track was auto incremented without user
defined tags.
-F FULL_SILENCE_LOG_FILE
Export the full log of silence detection. The full log file‐
name is useful to draw the amplitude wave of the input file
(in dB) in order to choose a threshold.
Note about the file structure:
‐the first column is a dummy column which is always
zero, for plotting on zero axis purposes
‐the second column is the time in seconds as double
‐the third column is the dB level
‐the fourth column is the silences shots counter
‐the five column is the number of splitpoints found
‐the sixth column is the start time of the silence spot
found
‐the seventh column is the end time of the silence spot
found
Example of plotting the full log file with gnuplot:
gnuplot -e "file='silence_logs.txt'; set decimalsign locale;
set xlabel 'Time in seconds'; plot file using 2:3 title
'Threshold', file using 2:4 title 'Silence shots' with lines‐
points, file using 2:5 title 'Number of silence points found'
with fsteps, file using 6:1 title 'Begin of silence', file
using 7:1 title 'End of silence' with points; pause -1"
-P Pretend to split. Simulation of the process without creating
any files or directories.
-q Quiet mode. Stays quiet :) i.e. do not prompt the user for
anything and print less messages. When you use quiet option,
mp3splt will try to end program without asking anything to
the user (useful for scripts). In Wrap mode it will also
skip CRC check, use if you are in such a hurry.
-Q Very quiet mode. Enables the -q option and does not print
anything to STDOUT. This option cannot be used with STDOUT
output.
-D Debug mode. Experimental debug support. Print extra informa‐
tions about what is being done. Current print doesn't have a
nice format.
-v Print version. Print the version of mp3splt and libmp3splt
and exit.
-h Print help. Print a short usage of mp3splt and exit.
EXAMPLESmp3splt album.mp3 54.32.19 67.32 -o out
mp3splt album.ogg 54.32.19 67.32 -o out
This is the standard use of mp3splt for constant bitrate mp3 or for any
ogg. You specify a begin time (which in this case uses hundredths,
54.32.19), an end time and an output file.
mp3splt-f -d newdir album.mp3 album2.mp3 145.59 234.2
This is frame mode for variable bitrate mp3 and multiple files. You
can see that time format uses min.sec even if minutes are over 60.
Output files in this case will be: album_145m_59s_0h__234m_2s_0h.mp3
and album2_145m_59s_0h__234m_2s_0h.mp3 because user didn't specify it
and they will be in the directory named newdir.
mp3splt-nf album.mp3 0.12 21.34.7 25.3 30.40 38.58
This is the use of -n option and multiple splitpoints. Four files will
be created and will not contain ID3 informations.
mp3splt-w album_MP3WRAP.mp3
This is Wrap mode. You can use this when mp3 is a file wrapped with
Mp3Wrap or AlbumWrap. You can specify an output directory with the -d
option.
mp3splt-lq album.mp3
This is List mode. You can use this when you want to list all tracks of
a wrapped file without extracting them. With quiet option (-q), pro‐
gram will not calculate CRC!
mp3splt-s f.mp3 or mp3splt-s -p th=-50,nt=10 f.mp3
This is silence option. Mp3splt will try to automatically detect split‐
points with silence detection and in the first case will split all
tracks found with default parameters, while in the second 10 tracks (or
less if too much) with the most probable silence points at a threshold
of -50 dB.
mp3splt-c file.cddb album.mp3
This is CDDB mode with a local file. Filenames and splitpoints will be
taken from file.cddb.
mp3splt-c query album.mp3
This is CDDB mode with internet query. Will ask you the keyword to
search and you will select the wanted cd.
mp3splt-a -c file.cddb album.mp3
This is CDDB mode with auto-adjust option (default parameters). Split‐
points will be adjusted with silence detection in a range of 30 seconds
before and after cddb splitpoints.
mp3splt-a -p gap=15,th=-23,rm -c file.cddb album.mp3
This is CDDB mode with auto-adjust option. Splitpoints will be adjusted
with silence detection in a range of 15 seconds before and after cddb
splitpoints, with a threshold of -23 dB, and silence will be removed.
mp3splt-c query album.mp3 -n -o @n_@t
This is CDDB mode with internet query with Frame mode, NoID3 and Output
format. Output filenames will be named like: 01_Title.mp3
mp3splt-t 10.00 album.mp3
This is -t option. It will split album.mp3 in many files of 10 minutes
each.
BUGS
Report any bugs you find to authors (see below). Advices, support
requests and contributions are welcome.
SEE ALSOmp3wrap(1)AUTHORS
Matteo Trotta <mtrotta@users.sourceforge.net>
Alexandru Ionut Munteanu <m@ioalex.net>
DISTRIBUTION
Visit http://mp3splt.sourceforge.net for latest release.
mp3splt-project is
(C) 2002-2005 by Matteo Trotta
(C) 2005-2014 by Alexandru Ionut Munteanu
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License. This can be found
as COPYING in mp3splt packages.
MP3SPLT(1)
