mp3tools 1.2.4__tar.gz → 1.2.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. {mp3tools-1.2.4 → mp3tools-1.2.6}/PKG-INFO +32 -21
  2. mp3tools-1.2.6/README.md +62 -0
  3. mp3tools-1.2.6/mp3tools/VERSION +1 -0
  4. mp3tools-1.2.6/mp3tools/cli.py +588 -0
  5. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools.egg-info/PKG-INFO +32 -21
  6. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools.egg-info/SOURCES.txt +2 -1
  7. mp3tools-1.2.6/tests/test_cli.py +158 -0
  8. mp3tools-1.2.4/README.md +0 -51
  9. mp3tools-1.2.4/mp3tools/VERSION +0 -1
  10. mp3tools-1.2.4/mp3tools/cli.py +0 -392
  11. {mp3tools-1.2.4 → mp3tools-1.2.6}/Containerfile +0 -0
  12. {mp3tools-1.2.4 → mp3tools-1.2.6}/HISTORY.md +0 -0
  13. {mp3tools-1.2.4 → mp3tools-1.2.6}/LICENSE +0 -0
  14. {mp3tools-1.2.4 → mp3tools-1.2.6}/MANIFEST.in +0 -0
  15. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools/__init__.py +0 -0
  16. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools/__main__.py +0 -0
  17. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools/base.py +0 -0
  18. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools/mp3tool.py +0 -0
  19. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools.egg-info/dependency_links.txt +0 -0
  20. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools.egg-info/entry_points.txt +0 -0
  21. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools.egg-info/requires.txt +0 -0
  22. {mp3tools-1.2.4 → mp3tools-1.2.6}/mp3tools.egg-info/top_level.txt +0 -0
  23. {mp3tools-1.2.4 → mp3tools-1.2.6}/setup.cfg +0 -0
  24. {mp3tools-1.2.4 → mp3tools-1.2.6}/setup.py +0 -0
  25. {mp3tools-1.2.4 → mp3tools-1.2.6}/tests/__init__.py +0 -0
  26. {mp3tools-1.2.4 → mp3tools-1.2.6}/tests/conftest.py +0 -0
  27. {mp3tools-1.2.4 → mp3tools-1.2.6}/tests/test_base.py +0 -0
{mp3tools-1.2.4 → mp3tools-1.2.6}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mp3tools
3
- Version: 1.2.4
3
+ Version: 1.2.6
4
4
  Summary: Awesome mp3tools created by carsten-engelke
5
5
  Home-page: https://github.com/carsten-engelke/mp3tools/
6
6
  Author: carsten-engelke
@@ -59,24 +59,35 @@ pip install mp3tools
59
59
  ## Usage
60
60
  Command-line-use:
61
61
  ```
62
- mp3tools -> start tools using standard wizard, just follow instructions.
63
-
64
- mp3tools merge-mp3 [dir] [subdir-mode] [foobarpath] [autowaittime]
65
- [dir] determines the directory in which to perform. Use '.' to select the current directory
66
- [subdir-mode] determines wheter all mp3 files in subfolders should be merged into one file each. ('True' to do so)")
67
- [foobarpath] determines the path to your foobar2000 installation. Please provide in case it differs from 'C:/Program Files (x86)/foobar2000/foobar2000.exe'
68
- [autowaittime] determines whether to automatically close foobar2000 after some seconds. Use -1 to disable and any number to set the waiting time.
69
-
70
- mp3tools pack-subdirs [group-size] [dir] [file-filter] [copy-mode]
71
- [group-size] determines the number of files to put into each directory
72
- [dir] determines the directory in which to perform the script. Use '.' to select the current directory
73
- [file-filter] Filter the file list according to this
74
- [copy-mode] If 'True', the files are copied into the created subfolders. If 'False' they are moved (Use with caution).
75
-
76
- mp3tools unpack-subdirs [dir] [subdir-filter] [filter] [copy-mode] [remove-dir]")
77
- [dir] determines the directory in which to perform the script. Use '.' to select the current directory
78
- [subdir-filter] Filter the subdir list according to this. Use '*' to select any subdirectory
79
- [filter] Filter the file list according to this
80
- [copy-mode] If 'True', the files are copied into the parent folder. If 'False' they are moved (Use with caution).
81
- [remove-dir] If 'True', the subdirectories are deleted. If 'False' they are left as they are.
62
+ mp3tools -> start tools using the interactive wizard.
63
+ mp3tools --help -> show available commands and options.
64
+ mp3tools merge-mp3 --help -> show command-specific help.
65
+
66
+ mp3tools merge-mp3 [DIR] [SUBDIR-MODE] [FOOBAR-PATH] [SECONDS]
67
+ DIR: folder containing MP3 files (default: current directory)
68
+ SUBDIR-MODE: merge each subfolder separately; if omitted, choose interactively
69
+ FOOBAR-PATH: legacy positional executable path; prefer --foobar-path
70
+ SECONDS: auto-close delay (default: 5; use -1 to disable)
71
+
72
+ mp3tools pack-subdirs [GROUP-SIZE] [DIR] [FILE-FILTER] [COPY-MODE]
73
+ GROUP-SIZE: maximum files per subdirectory (default: 15; must be positive)
74
+ DIR: folder containing files (default: current directory)
75
+ FILE-FILTER: case-sensitive substring selecting files (default: '.mp3')
76
+ COPY-MODE: copy rather than move (default: false)
77
+
78
+ mp3tools unpack-subdirs [DIR] [SUBDIR-FILTER] [FILE-FILTER] [COPY-MODE] [REMOVE-SUBDIRS]
79
+ DIR: folder containing subdirectories (default: current directory)
80
+ SUBDIR-FILTER: case-sensitive substring; '*' selects all (default: 'subdir-')
81
+ FILE-FILTER: case-sensitive substring selecting files (default: '.mp3')
82
+ COPY-MODE: copy rather than move (default: false)
83
+ REMOVE-SUBDIRS: remove emptied subdirectories (default: true)
84
+
85
+ mp3tools wait [SECONDS]
86
+ set the foobar2000 auto-close delay before opening the interactive wizard
87
+
88
+ Boolean arguments accept true/false, yes/no, y/n, ja/nein, 1/0, and on/off.
89
+ For COPY-MODE, 'move' is also accepted as false. Use --foobar-path PATH and
90
+ --mp3tag-path PATH to set executable locations; both default to their configured
91
+ paths and may be placed before or after a subcommand. The legacy `wait=SECONDS`
92
+ form remains supported.
82
93
  ```
mp3tools-1.2.6/README.md ADDED
@@ -0,0 +1,62 @@
1
+ # mp3tools
2
+ 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.
3
+
4
+
5
+ ![merge mp3 files from subdirectories](https://github.com/carsten-engelke/mp3tools/blob/main/mergemp3subdirs.jpg)
6
+ - mp3tools merge-mp3: merging script, works with foobar2000
7
+ - mp3tools pack-subdirs: pack files into grouped subdirectories (good for large audiobooks)
8
+ - mp3tools unpack-subdirs.py: unpack files from grouped subdirectories (undo mp3tools pack-subdirs)
9
+
10
+ ## Version
11
+ 1.2.2 Fixed
12
+
13
+ 1.2.0 Added PI/CI Support thanks to https://github.com/rochacbruno/python-project-template
14
+
15
+ 1.0.0 release version. Ported to vscode.
16
+
17
+ 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
18
+
19
+ 0.1.0 initial release. Port from windows script to python, introducing automation
20
+
21
+ ## Requirements
22
+ - Python (script was created using python 3.7.0) (https://www.python.org/)
23
+ - foobar2000 (https://www.foobar2000.org/)
24
+
25
+ ## Installation
26
+ pip install mp3tools
27
+
28
+ ## Usage
29
+ Command-line-use:
30
+ ```
31
+ mp3tools -> start tools using the interactive wizard.
32
+ mp3tools --help -> show available commands and options.
33
+ mp3tools merge-mp3 --help -> show command-specific help.
34
+
35
+ mp3tools merge-mp3 [DIR] [SUBDIR-MODE] [FOOBAR-PATH] [SECONDS]
36
+ DIR: folder containing MP3 files (default: current directory)
37
+ SUBDIR-MODE: merge each subfolder separately; if omitted, choose interactively
38
+ FOOBAR-PATH: legacy positional executable path; prefer --foobar-path
39
+ SECONDS: auto-close delay (default: 5; use -1 to disable)
40
+
41
+ mp3tools pack-subdirs [GROUP-SIZE] [DIR] [FILE-FILTER] [COPY-MODE]
42
+ GROUP-SIZE: maximum files per subdirectory (default: 15; must be positive)
43
+ DIR: folder containing files (default: current directory)
44
+ FILE-FILTER: case-sensitive substring selecting files (default: '.mp3')
45
+ COPY-MODE: copy rather than move (default: false)
46
+
47
+ mp3tools unpack-subdirs [DIR] [SUBDIR-FILTER] [FILE-FILTER] [COPY-MODE] [REMOVE-SUBDIRS]
48
+ DIR: folder containing subdirectories (default: current directory)
49
+ SUBDIR-FILTER: case-sensitive substring; '*' selects all (default: 'subdir-')
50
+ FILE-FILTER: case-sensitive substring selecting files (default: '.mp3')
51
+ COPY-MODE: copy rather than move (default: false)
52
+ REMOVE-SUBDIRS: remove emptied subdirectories (default: true)
53
+
54
+ mp3tools wait [SECONDS]
55
+ set the foobar2000 auto-close delay before opening the interactive wizard
56
+
57
+ Boolean arguments accept true/false, yes/no, y/n, ja/nein, 1/0, and on/off.
58
+ For COPY-MODE, 'move' is also accepted as false. Use --foobar-path PATH and
59
+ --mp3tag-path PATH to set executable locations; both default to their configured
60
+ paths and may be placed before or after a subcommand. The legacy `wait=SECONDS`
61
+ form remains supported.
62
+ ```
mp3tools-1.2.6/mp3tools/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.2.6