libmp3splt 0.9.2
Lossless library for splitting audio formats like mp3, ogg vorbis and FLAC.
Loading...
Searching...
No Matches

Topics

 Input filename and paths

Macros

#define SPLT_DEFAULT_PARAM_THRESHOLD   -48.0
#define SPLT_DEFAULT_PARAM_OFFSET   0.8
#define SPLT_DEFAULT_PARAM_MINIMUM_LENGTH   0.0
#define SPLT_DEFAULT_PARAM_MINIMUM_TRACK_LENGTH   0.0
#define SPLT_DEFAULT_PARAM_MIN_TRACK_JOIN   0.0
#define SPLT_DEFAULT_PARAM_GAP   30
#define SPLT_DEFAULT_PARAM_TRACKS   0
#define SPLT_DEFAULT_PARAM_SHOTS   25
#define SPLT_DEFAULT_KEEP_SILENCE_LEFT   0
#define SPLT_DEFAULT_KEEP_SILENCE_RIGHT   0
#define SPLT_DEFAULT_OUTPUT   "@f_@mm_@ss_@h0h__@Mm_@Ss_@H0h"
#define SPLT_DEFAULT_CDDB_CUE_OUTPUT   "@A - @n - @t"
#define SPLT_DEFAULT_SYNCERROR_OUTPUT   "@f_error_@n"
#define SPLT_DEFAULT_SILENCE_OUTPUT   "@f_silence_@n"
#define SPLT_DEFAULT_TRIM_SILENCE_OUTPUT   "@f_trimmed"

Enumerations

enum  splt_options {
  SPLT_OPT_PRETEND_TO_SPLIT = 1 , SPLT_OPT_QUIET_MODE , SPLT_OPT_DEBUG_MODE , SPLT_OPT_SPLIT_MODE ,
  SPLT_OPT_TAGS , SPLT_OPT_XING , SPLT_OPT_CREATE_DIRS_FROM_FILENAMES , SPLT_OPT_OUTPUT_FILENAMES ,
  SPLT_OPT_FRAME_MODE , SPLT_OPT_AUTO_ADJUST , SPLT_OPT_INPUT_NOT_SEEKABLE , SPLT_OPT_PARAM_NUMBER_TRACKS ,
  SPLT_OPT_PARAM_SHOTS , SPLT_OPT_PARAM_REMOVE_SILENCE , SPLT_OPT_PARAM_GAP , SPLT_OPT_ENABLE_SILENCE_LOG ,
  SPLT_OPT_FORCE_TAGS_VERSION , SPLT_OPT_LENGTH_SPLIT_FILE_NUMBER , SPLT_OPT_REPLACE_TAGS_IN_TAGS , SPLT_OPT_OVERLAP_TIME ,
  SPLT_OPT_SPLIT_TIME , SPLT_OPT_PARAM_THRESHOLD , SPLT_OPT_PARAM_OFFSET , SPLT_OPT_PARAM_MIN_LENGTH ,
  SPLT_OPT_PARAM_MIN_TRACK_LENGTH , SPLT_OPT_PARAM_MIN_TRACK_JOIN , SPLT_OPT_ARTIST_TAG_FORMAT , SPLT_OPT_ALBUM_TAG_FORMAT ,
  SPLT_OPT_TITLE_TAG_FORMAT , SPLT_OPT_COMMENT_TAG_FORMAT , SPLT_OPT_REPLACE_UNDERSCORES_TAG_FORMAT , SPLT_OPT_SET_FILE_FROM_CUE_IF_FILE_TAG_FOUND ,
  SPLT_OPT_KEEP_SILENCE_LEFT , SPLT_OPT_KEEP_SILENCE_RIGHT , SPLT_OPT_CUE_SET_SPLITPOINT_NAMES_FROM_REM_NAME , SPLT_OPT_CUE_DISABLE_CUE_FILE_CREATED_MESSAGE ,
  SPLT_OPT_CUE_CDDB_ADD_TAGS_WITH_KEEP_ORIGINAL_TAGS , SPLT_OPT_ID3V2_ENCODING , SPLT_OPT_INPUT_TAGS_ENCODING , SPLT_OPT_TIME_MINIMUM_THEORETICAL_LENGTH ,
  SPLT_OPT_WARN_IF_NO_AUTO_ADJUST_FOUND , SPLT_OPT_STOP_IF_NO_AUTO_ADJUST_FOUND , SPLT_OPT_DECODE_AND_WRITE_FLAC_MD5SUM_FOR_CREATED_FILES , SPLT_OPT_HANDLE_BIT_RESERVOIR
}
enum  splt_split_mode_options {
  SPLT_OPTION_NORMAL_MODE , SPLT_OPTION_WRAP_MODE , SPLT_OPTION_SILENCE_MODE , SPLT_OPTION_TRIM_SILENCE_MODE ,
  SPLT_OPTION_ERROR_MODE , SPLT_OPTION_TIME_MODE , SPLT_OPTION_LENGTH_MODE
}
enum  splt_id3v2_encoding { SPLT_ID3V2_LATIN1 , SPLT_ID3V2_UTF8 , SPLT_ID3V2_UTF16 }
enum  splt_output_filenames_options { SPLT_OUTPUT_FORMAT , SPLT_OUTPUT_DEFAULT , SPLT_OUTPUT_CUSTOM }
enum  splt_tags_options { SPLT_TAGS_ORIGINAL_FILE , SPLT_CURRENT_TAGS , SPLT_NO_TAGS , SPLT_TAGS_FROM_FILENAME_REGEX }
enum  splt_str_format {
  SPLT_NO_CONVERSION , SPLT_TO_LOWERCASE , SPLT_TO_UPPERCASE , SPLT_TO_FIRST_UPPERCASE ,
  SPLT_TO_WORD_FIRST_UPPERCASE
}

Functions

splt_code mp3splt_set_int_option (splt_state *state, splt_options option, int value)
splt_code mp3splt_set_long_option (splt_state *state, splt_options option, long value)
splt_code mp3splt_set_float_option (splt_state *state, splt_options option, float value)
int mp3splt_get_int_option (splt_state *state, splt_options option, splt_code *error)
long mp3splt_get_long_option (splt_state *state, splt_options option, splt_code *error)
float mp3splt_get_float_option (splt_state *state, splt_options option, splt_code *error)
splt_code mp3splt_set_oformat (splt_state *state, const char *format)

Detailed Description

Macro Definition Documentation

◆ SPLT_DEFAULT_PARAM_THRESHOLD

#define SPLT_DEFAULT_PARAM_THRESHOLD   -48.0

Default value for the SPLT_OPT_PARAM_THRESHOLD option.

Definition at line 804 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_OFFSET

#define SPLT_DEFAULT_PARAM_OFFSET   0.8

Default value for the SPLT_OPT_PARAM_OFFSET option.

Definition at line 808 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_MINIMUM_LENGTH

#define SPLT_DEFAULT_PARAM_MINIMUM_LENGTH   0.0

Default value for the SPLT_OPT_PARAM_MIN_LENGTH option.

Definition at line 812 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_MINIMUM_TRACK_LENGTH

#define SPLT_DEFAULT_PARAM_MINIMUM_TRACK_LENGTH   0.0

Default value for the SPLT_OPT_PARAM_MIN_TRACK_LENGTH option.

Definition at line 816 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_MIN_TRACK_JOIN

#define SPLT_DEFAULT_PARAM_MIN_TRACK_JOIN   0.0

Default value for the SPLT_OPT_PARAM_MIN_TRACK_JOIN option.

Definition at line 820 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_GAP

#define SPLT_DEFAULT_PARAM_GAP   30

Default value for the SPLT_OPT_PARAM_GAP option.

Definition at line 824 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_TRACKS

#define SPLT_DEFAULT_PARAM_TRACKS   0

Default value for the SPLT_OPT_PARAM_NUMBER_TRACKS option.

Definition at line 828 of file mp3splt.h.

◆ SPLT_DEFAULT_PARAM_SHOTS

#define SPLT_DEFAULT_PARAM_SHOTS   25

Default value for the SPLT_OPT_PARAM_SHOTS option.

Definition at line 832 of file mp3splt.h.

◆ SPLT_DEFAULT_KEEP_SILENCE_LEFT

#define SPLT_DEFAULT_KEEP_SILENCE_LEFT   0

Default value for the SPLT_OPT_KEEP_SILENCE_LEFT option.

Definition at line 836 of file mp3splt.h.

◆ SPLT_DEFAULT_KEEP_SILENCE_RIGHT

#define SPLT_DEFAULT_KEEP_SILENCE_RIGHT   0

Default value for the SPLT_OPT_KEEP_SILENCE_RIGHT option.

Definition at line 840 of file mp3splt.h.

◆ SPLT_DEFAULT_OUTPUT

#define SPLT_DEFAULT_OUTPUT   "@f_@mm_@ss_@h0h__@Mm_@Ss_@H0h"

Default output for SPLT_OPTION_NORMAL_MODE when using SPLT_OUTPUT_DEFAULT.

See also
mp3splt_set_oformat

Definition at line 868 of file mp3splt.h.

◆ SPLT_DEFAULT_CDDB_CUE_OUTPUT

#define SPLT_DEFAULT_CDDB_CUE_OUTPUT   "@A - @n - @t"

Output filename format for CDDB and CUE when using SPLT_OUTPUT_DEFAULT.

See also
mp3splt_set_oformat, SPLT_OPT_OUTPUT_FILENAMES

Definition at line 874 of file mp3splt.h.

◆ SPLT_DEFAULT_SYNCERROR_OUTPUT

#define SPLT_DEFAULT_SYNCERROR_OUTPUT   "@f_error_@n"

Output filename format for SPLT_OPTION_ERROR_MODE when using SPLT_OUTPUT_DEFAULT.

See also
mp3splt_set_oformat, SPLT_OPT_OUTPUT_FILENAMES

Definition at line 879 of file mp3splt.h.

◆ SPLT_DEFAULT_SILENCE_OUTPUT

#define SPLT_DEFAULT_SILENCE_OUTPUT   "@f_silence_@n"

Output filename format for SPLT_OPTION_SILENCE_MODE when using SPLT_OUTPUT_DEFAULT.

See also
mp3splt_set_oformat, SPLT_OPT_OUTPUT_FILENAMES

Definition at line 884 of file mp3splt.h.

◆ SPLT_DEFAULT_TRIM_SILENCE_OUTPUT

#define SPLT_DEFAULT_TRIM_SILENCE_OUTPUT   "@f_trimmed"

Default output for the trim silence split.

See also
mp3splt_set_oformat, SPLT_OPT_OUTPUT_FILENAMES

Definition at line 889 of file mp3splt.h.

Enumeration Type Documentation

◆ splt_options

Split options.

Use mp3splt_set_int_option, mp3splt_set_long_option and mp3splt_set_float_option to set those options.

Use mp3splt_get_int_option, mp3splt_get_long_option and mp3splt_get_float_option to get those options.

Enumerator
SPLT_OPT_PRETEND_TO_SPLIT 

Pretend to split the file, without actually creating output files.

This option works in all modes except error mode and dewrap split.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_QUIET_MODE 

If quiet return less messages and don't do mp3 CRC check.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_DEBUG_MODE 

If we return debug messages or not.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_SPLIT_MODE 

The type of the split.

Int option that can take the values from splt_split_mode_options.

Default is SPLT_OPTION_NORMAL_MODE

SPLT_OPT_TAGS 

What tags to put in the output split files.

Int option that can take the values from splt_tags_options.

Default is SPLT_CURRENT_TAGS

SPLT_OPT_XING 

For mp3 files, if we write the Xing header.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_TRUE

SPLT_OPT_CREATE_DIRS_FROM_FILENAMES 

If this option is SPLT_TRUE, we create directories from the output filenames without parsing for illegal characters the output filenames.

Otherwise, we parse for illegal characters the filenames and replace them with '_'.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_OUTPUT_FILENAMES 

Defines how the output filenames are created.

Int option that can take values from splt_output_filenames_options.

Default is SPLT_OUTPUT_DEFAULT

SPLT_OPT_FRAME_MODE 

For mp3 files, force to use the frame mode or not.

The frame mode processes the file frame by frame and it is useful when splitting VBR (Variable Bit Rate) files. Frame mode provides higher precision but is slower.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_AUTO_ADJUST 

If we use silence detection to auto-adjust splitpoints.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_INPUT_NOT_SEEKABLE 

If the input is not seekable.

This allows splitting mp3 streams which can be read only one time and can't be seeked.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_PARAM_NUMBER_TRACKS 

The desired number of tracks when having a SPLT_OPTION_SILENCE_MODE split.

Int option that can take positive integer values. 0 means that we split as many files we find.

Default is SPLT_DEFAULT_PARAM_TRACKS

SPLT_OPT_PARAM_SHOTS 

The desired number of shots when having a SPLT_OPTION_SILENCE_MODE or SPLT_OPTION_TRIM_SILENCE_MODE split or using the SPLT_OPT_AUTO_ADJUST option.

Int option that can take positive integer values. It defines the number of shots to be found after the silence. Decrease this value if you need to split files having closer silence points.

Default is SPLT_DEFAULT_PARAM_SHOTS

SPLT_OPT_PARAM_REMOVE_SILENCE 

Used to remove silence between the split tracks when having a SPLT_OPTION_SILENCE_MODE split.

Int option that can take the values SPLT_TRUE or SPLT_FALSE.

Default is SPLT_FALSE

SPLT_OPT_PARAM_GAP 

The time to auto-adjust before and after splitpoint when having the SPLT_OPT_AUTO_ADJUST option.

Int option that can take positive integer values.

Default is SPLT_DEFAULT_PARAM_GAP

SPLT_OPT_ENABLE_SILENCE_LOG