music-disc-maker 1.0.0__tar.gz

music_disc_maker-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DJ Woodward-Magar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

music_disc_maker-1.0.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: music-disc-maker
+Version: 1.0.0
+Summary: Build scripted Minecraft Bedrock custom music disc add-ons.
+License-File: LICENSE
+Author: DJ Stomp
+Author-email: 85457381+DJStompZone@users.noreply.github.com
+Requires-Python: >=3.12,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: dev
+Requires-Dist: pillow (>=12.2.0,<13.0.0)
+Requires-Dist: pytest (>=8.0.0) ; extra == "dev"
+Requires-Dist: tqdm (>=4.66.0,<5.0.0)
+Description-Content-Type: text/markdown
+
+# music-disc-maker
+
+Build scripted Minecraft Bedrock custom music disc add-ons without globally replacing vanilla sound effects.
+
+## Single-disc mode
+
+```bash
+music-disc-maker song.mp3 --id whiplash --title "Whiplash!"
+```
+
+The CLI also works as a module:
+
+```bash
+python -m music_disc_maker song.mp3 --id whiplash --title "Whiplash!"
+```
+
+## Config mode
+
+`music_disc_maker.toml`:
+
+```toml
+pack_id = "custom_discs"
+pack_title = "Custom Music Discs"
+namespace = "custom"
+output_root = "dist"
+dummy_sound_event = "pre_ram.screamer"
+server_module_version = "2.8.0-beta"
+item_format_version = "1.21.70"
+sound_definitions_format_version = "1.20.20"
+min_engine_version = [1, 21, 70]
+default_comparator_signal = 13
+comparator_signal_min = 1
+comparator_signal_max = 13
+pack_icon_size = 256
+loot_enabled = true
+# Optional: point at a custom layer directory or zip matching the bundled layer names.
+# icon_layer_source = "disc_layers"
+
+[[discs]]
+input = "audio/whiplash.mp3"
+id = "whiplash"
+title = "Whiplash!"
+comparator_signal = 13
+
+[[discs]]
+input = "audio/doom_banjo.mp3"
+id = "doom_banjo"
+title = "Doom Banjo"
+sound_id = "record.doom_banjo"
+comparator_signal = 11
+```
+
+Run it:
+
+```bash
+music-disc-maker --config music_disc_maker.toml
+```
+
+If `--config` is omitted, the tool checks the current directory for common config names such as `music_disc_maker.toml`, `music-disc-maker.toml`, `.music-disc-maker.toml`, JSON equivalents, `discs.json`, and `[tool.music-disc-maker]` / `[tool.music_disc_maker]` in `pyproject.toml`.
+
+CLI arguments override config-file values where applicable. Config-file paths are resolved relative to the config file, not wherever your shell happens to be yelling from.
+
+
+## Procedural icons
+
+Generated item icons now use bundled layered 16x16 disc assets instead of the old one-color fallback puck. The generator derives a deterministic icon from the disc namespace, ID, and title, so rebuilding the same pack keeps the same icon.
+
+To use your own layer set, provide either a directory or zip containing files named like:
+
+```text
+layer1_outer.png
+layer2_surface.png
+layer2_surface_alt.png
+layer3_accent.png
+layer3_accent_alt.png
+layer4_edge.png
+layer4_edge_alt.png
+layer5_inner_a.png
+layer5_inner_a_alt.png
+layer6_inner_b.png
+layer6_inner_b_alt.png
+layer7_center.png
+```
+
+Then set it in config:
+
+```toml
+icon_layer_source = "assets/disc_layers.zip"
+```
+
+Or pass it on the CLI:
+
+```bash
+music-disc-maker --config music_disc_maker.toml --icon-layer-source assets/disc_layers.zip
+```
+
+## Loot tables
+
+By default, the behavior pack writes chest loot tables for:
+
+- `chests/simple_dungeon`
+- `chests/abandoned_mineshaft`
+- `chests/stronghold_corridor`
+- `chests/ancient_city`
+
+The generated tables preserve the bundled vanilla entries for those four targets and append a small extra custom-disc pool. Disable this with:
+
+```toml
+loot_enabled = false
+```
+
+Or from the CLI:
+
+```bash
+music-disc-maker --config music_disc_maker.toml --disable-loot
+```
+
+
+## Generate a config from audio files
+
+Scan the current directory and create `music_disc_maker.toml`:
+
+```bash
+music-disc-maker-config
+```
+
+The config generator uses `ffprobe` metadata when available. The generated disc `id` comes from the normalized song title, while the display `title` becomes `Artist - Title` when artist metadata is present. If metadata is missing, filenames like `01 - DJ Stomp - Whiplash! (Official Audio).mp3` are parsed as a fallback, because manually typing that crap is how souls leave bodies.
+
+The metadata scan shows a `tqdm` progress bar by default. Disable it with `--no-progress` when piping logs or being aggressively boring.
+
+Useful options:
+
+```bash
+music-disc-maker-config --recursive --overwrite --pack-title "DJ Stomp Discs" --namespace dj
+```
+
+Preview without writing:
+
+```bash
+music-disc-maker-config --stdout
+```
+
+If your files use `Title - Artist.ext` instead of `Artist - Title.ext`:
+
+```bash
+music-disc-maker-config --filename-order title-artist --overwrite
+```
+
+For a big messy library, use MusicBrainz Picard or beets to fix the tags first, then regenerate the TOML. This tool reads metadata; it does not rewrite your files.
+
+## Testing
+
+```bash
+python -m pytest
+```
+
+## License
+
+MIT License. See the [LICENSE](LICENSE) file for details.
+

music_disc_maker-1.0.0/README.md

@@ -0,0 +1,159 @@
+# music-disc-maker
+
+Build scripted Minecraft Bedrock custom music disc add-ons without globally replacing vanilla sound effects.
+
+## Single-disc mode
+
+```bash
+music-disc-maker song.mp3 --id whiplash --title "Whiplash!"
+```
+
+The CLI also works as a module:
+
+```bash
+python -m music_disc_maker song.mp3 --id whiplash --title "Whiplash!"
+```
+
+## Config mode
+
+`music_disc_maker.toml`:
+
+```toml
+pack_id = "custom_discs"
+pack_title = "Custom Music Discs"
+namespace = "custom"
+output_root = "dist"
+dummy_sound_event = "pre_ram.screamer"
+server_module_version = "2.8.0-beta"
+item_format_version = "1.21.70"
+sound_definitions_format_version = "1.20.20"
+min_engine_version = [1, 21, 70]
+default_comparator_signal = 13
+comparator_signal_min = 1
+comparator_signal_max = 13
+pack_icon_size = 256
+loot_enabled = true
+# Optional: point at a custom layer directory or zip matching the bundled layer names.
+# icon_layer_source = "disc_layers"
+
+[[discs]]
+input = "audio/whiplash.mp3"
+id = "whiplash"
+title = "Whiplash!"
+comparator_signal = 13
+
+[[discs]]
+input = "audio/doom_banjo.mp3"
+id = "doom_banjo"
+title = "Doom Banjo"
+sound_id = "record.doom_banjo"
+comparator_signal = 11
+```
+
+Run it:
+
+```bash
+music-disc-maker --config music_disc_maker.toml
+```
+
+If `--config` is omitted, the tool checks the current directory for common config names such as `music_disc_maker.toml`, `music-disc-maker.toml`, `.music-disc-maker.toml`, JSON equivalents, `discs.json`, and `[tool.music-disc-maker]` / `[tool.music_disc_maker]` in `pyproject.toml`.
+
+CLI arguments override config-file values where applicable. Config-file paths are resolved relative to the config file, not wherever your shell happens to be yelling from.
+
+
+## Procedural icons
+
+Generated item icons now use bundled layered 16x16 disc assets instead of the old one-color fallback puck. The generator derives a deterministic icon from the disc namespace, ID, and title, so rebuilding the same pack keeps the same icon.
+
+To use your own layer set, provide either a directory or zip containing files named like:
+
+```text
+layer1_outer.png
+layer2_surface.png
+layer2_surface_alt.png
+layer3_accent.png
+layer3_accent_alt.png
+layer4_edge.png
+layer4_edge_alt.png
+layer5_inner_a.png
+layer5_inner_a_alt.png
+layer6_inner_b.png
+layer6_inner_b_alt.png
+layer7_center.png
+```
+
+Then set it in config:
+
+```toml
+icon_layer_source = "assets/disc_layers.zip"
+```
+
+Or pass it on the CLI:
+
+```bash
+music-disc-maker --config music_disc_maker.toml --icon-layer-source assets/disc_layers.zip
+```
+
+## Loot tables
+
+By default, the behavior pack writes chest loot tables for:
+
+- `chests/simple_dungeon`
+- `chests/abandoned_mineshaft`
+- `chests/stronghold_corridor`
+- `chests/ancient_city`
+
+The generated tables preserve the bundled vanilla entries for those four targets and append a small extra custom-disc pool. Disable this with:
+
+```toml
+loot_enabled = false
+```
+
+Or from the CLI:
+
+```bash
+music-disc-maker --config music_disc_maker.toml --disable-loot
+```
+
+
+## Generate a config from audio files
+
+Scan the current directory and create `music_disc_maker.toml`:
+
+```bash
+music-disc-maker-config
+```
+
+The config generator uses `ffprobe` metadata when available. The generated disc `id` comes from the normalized song title, while the display `title` becomes `Artist - Title` when artist metadata is present. If metadata is missing, filenames like `01 - DJ Stomp - Whiplash! (Official Audio).mp3` are parsed as a fallback, because manually typing that crap is how souls leave bodies.
+
+The metadata scan shows a `tqdm` progress bar by default. Disable it with `--no-progress` when piping logs or being aggressively boring.
+
+Useful options:
+
+```bash
+music-disc-maker-config --recursive --overwrite --pack-title "DJ Stomp Discs" --namespace dj
+```
+
+Preview without writing:
+
+```bash
+music-disc-maker-config --stdout
+```
+
+If your files use `Title - Artist.ext` instead of `Artist - Title.ext`:
+
+```bash
+music-disc-maker-config --filename-order title-artist --overwrite
+```
+
+For a big messy library, use MusicBrainz Picard or beets to fix the tags first, then regenerate the TOML. This tool reads metadata; it does not rewrite your files.
+
+## Testing
+
+```bash
+python -m pytest
+```
+
+## License
+
+MIT License. See the [LICENSE](LICENSE) file for details.

music_disc_maker-1.0.0/music_disc_maker/__init__.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from music_disc_maker.models import BuildConfig, BuiltDisc, DiscInput, PackPaths
+from music_disc_maker.pack_builder import ScriptedDiscPackBuilder
+
+__all__ = [
+    "BuildConfig",
+    "BuiltDisc",
+    "DiscInput",
+    "PackPaths",
+    "ScriptedDiscPackBuilder",
+]

music_disc_maker-1.0.0/music_disc_maker/__main__.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from music_disc_maker.loader import load_build_config
+from music_disc_maker.pack_builder import ScriptedDiscPackBuilder
+from music_disc_maker.parser import parse_args
+
+
+def main() -> int:
+    """Run the pack generator."""
+    args = parse_args()
+    config = load_build_config(args)
+    builder = ScriptedDiscPackBuilder(config)
+    builder.build()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

music_disc_maker-1.0.0/music_disc_maker/audio.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from music_disc_maker.io_utils import run_command
+
+
+def convert_audio(input_file: Path, output_file: Path) -> float:
+    """Convert an input audio file to a mono streaming OGG and return duration in seconds."""
+    output_file.parent.mkdir(parents=True, exist_ok=True)
+
+    run_command([
+        "ffmpeg",
+        "-y",
+        "-i",
+        str(input_file),
+        "-vn",
+        "-ac",
+        "1",
+        "-ar",
+        "44100",
+        "-c:a",
+        "libvorbis",
+        "-q:a",
+        "4",
+        str(output_file),
+    ])
+
+    probe = run_command([
+        "ffprobe",
+        "-v",
+        "error",
+        "-show_entries",
+        "format=duration",
+        "-of",
+        "default=noprint_wrappers=1:nokey=1",
+        str(output_file),
+    ])
+
+    try:
+        return round(float(probe.stdout.strip()), 3)
+    except ValueError as exc:
+        raise RuntimeError(f"Unable to read duration from ffprobe output: {probe.stdout!r}") from exc

music_disc_maker-1.0.0/music_disc_maker/classes.py

@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+from music_disc_maker.models import BuildConfig, BuiltDisc, DiscInput, PackPaths
+
+__all__ = [
+    "BuildConfig",
+    "BuiltDisc",
+    "DiscInput",
+    "PackPaths",
+]

music_disc_maker-1.0.0/music_disc_maker/config.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+from music_disc_maker.defaults import *