mp3toolsce 1.0.8
Tools for merging mp3 files using foobar2000, e.g. audiobooks
Requires Python: >=3.6

# mp3-tools
Merge mp3 files and set correct audio length using foobar2000 with an automated python script. These scripts can merge all files in one directory or create one file for each subdirectory.


![merge mp3 files from subdirectories](https://github.com/carsten-engelke/mp3-tools/blob/master/mergemp3subdirs.jpg?raw=true)
 - merge-mp3: merging script, works with foobar2000
 - pack-subdirs: pack files into grouped subdirectories (good for large audiobooks)
 - unpack-subdirs: unpack files from grouped subdirectories (undo pack-subdirs.py)

## Version
1.0.7  adjusted standard variables -> file-filter is now .mp3, copy-mode is off, removesubdir-mode is on and subdir-filter is set to subdir- for safety purposes

1.0.4 corrected several stuff. added auto wait time function

1.0.0 release version. Ported to vscode.

0.2.0 bug corrected foobar needs to be called from working directory as the command line plugin cannot handle empty spaces in file names or paths given by command line

0.1.0 initial release. Port from windows script to python, introducing automation


## Requirements
- Python (script was created using python 3.7.0) (https://www.python.org/)
- foobar2000 (https://www.foobar2000.org/)

## Installation
- copy mergeMp3.py into the directory in which the files to merge are contained.
- run the script and follow the instructions, alternatively use the following command line

Command-line-use:
```
mp3toolsce merge-mp3 [dir] [subdir-mode] [foobarpath] [autowaittime]")
mp3toolsce pack-subdirs [group-size] [dir] [file-filter] [copy-mode]")
mp3toolsce unpack-subdirs [dir] [subdir-filter] [file-filter] [copy-mode] [removesubdir-dir]")
mp3toolsce wait=seconds")
    Note: This script depends on a foobar2000 installation! (Get it from: https://www.foobar2000.org/)")

mp3toolsce merge-mp3 [dir] [sub] [foobarpath] [autowaittime]
    [dir] determines the directory in which to perform. Use '.' to select the current directory
    [sub] determines wheter all mp3 files in subfolders should be merged into one file each. ('true' to do so)")
    [foobarpath] determines the path to your foobar2000 installation. Please provide in case it differs from 'C:/Program Files (x86)/foobar2000/foobar2000.exe'
    [autowaittime] determines whether to automatically close foobar2000 after some seconds. Use -1 to disable and any number to set the waiting time.

mp3toolsce pack-subdirs [group-size] [dir] [file-filter] [copy-mode]
    [group-size] determines the number of files to put into each directory
    [dir] determines the directory in which to perform the script. Use '.' to select the current directory
    [filter] Filter the file list according to this
    [copy-mode] If 'True', the files are copied into the created subfolders. If 'False' they are moved (Use with caution).

mp3toolsce unpack-subdirs [dir] [subdir-filter] [file-filter] [copy-mode] [removesubdir-mode]
    [dir] determines the directory in which to perform the script. Use '.' to select the current directory
    [subdir-filter] Filter the subdir list according to this. Use '*' to select any subdirectory
    [filter] Filter the file list according to this
    [copy-mode] If 'True', the files are copied into the parent folder. If 'False' they are moved (Use with caution).
    [removesubdir-mode] If 'True', the subdirectories are deleted. If 'False' they are left as they are.
```