Skip to main content

mp3tools

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

  • mp3tools merge-mp3: merging script, works with foobar2000
  • mp3tools pack-subdirs: pack files into grouped subdirectories (good for large audiobooks)
  • mp3tools unpack-subdirs.py: unpack files from grouped subdirectories (undo mp3tools pack-subdirs)

Version

1.2.2 Fixed

1.2.0 Added PI/CI Support thanks to https://github.com/rochacbruno/python-project-template

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

Installation

pip install mp3tools

Usage

Command-line-use:

mp3tools -> start tools using standard wizard, just follow instructions.

mp3tools merge-mp3 [dir] [subdir-mode] [foobarpath] [autowaittime]
    [dir] determines the directory in which to perform. Use '.' to select the current directory
    [subdir-mode] 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.

mp3tools 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
    [file-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).

mp3tools unpack-subdirs [dir] [subdir-filter] [filter] [copy-mode] [remove-dir]")
    [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).
    [remove-dir] If 'True', the subdirectories are deleted. If 'False' they are left as they are.

Metadata

Release files for mp3tools 1.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mp3tools 1.2.4
File Size Uploaded
mp3tools-1.2.4.tar.gz 11.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mp3tools 1.2.4
File Interpreter ABI Platform
mp3tools-1.2.4-py3-none-any.whl Python 3 none any Details

Total release size: 21.6 kB

Release files / mp3tools-1.2.4.tar.gz

Download URL mp3tools-1.2.4.tar.gz
Size 11.0 kB
Tags Source
SHA-256 checksum
How to use checksums
290914bd4fc4eb682fdfcd141b1eb77d07c899c9185e6c015f6f6b17287e52fb
BLAKE2b-256 checksum
How to use checksums
78b93590c55a3dabe0c4c68e7f63d53d35ccab0330aef40212fdb700cd87bd95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / mp3tools-1.2.4-py3-none-any.whl

Download URL mp3tools-1.2.4-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9c3789ffb224d632aa77c696dfe7aa70438f5530fbfe0dfa79f59d4efa434740
BLAKE2b-256 checksum
How to use checksums
0973a0713fc8406f6875c6dba053d486307c892665b88d4f270e73e38230cac0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release history Release notifications | RSS feed

This release

1.2.4 This release

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page