serato-tools 1.5.0__tar.gz

serato_tools-1.5.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright 2019 Jan Holthuis
+
+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.

serato_tools-1.5.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: serato_tools
+Version: 1.5.0
+Summary: Serato track metadata tags
+Author-email: bvandercar-vt <bvandercar@outlook.com>
+License: Copyright 2019 Jan Holthuis
+        
+        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.
+        
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mutagen
+Provides-Extra: waveform-drawing
+Requires-Dist: pillow; extra == "waveform-drawing"
+Dynamic: license-file
+
+Fork of https://github.com/Holzhaus/serato-tags , which appears to be no longer maintained.
+
+# Installation
+
+Can install using pip:
+
+`pip install git+https://github.com/bvandercar-vt/serato-tags@main`
+
+Or add this line to your `requirements.txt`:
+
+`git+https://github.com/bvandercar-vt/serato-tags@main`
+
+# Serato Tags
+
+This repository aims to document the GEOB ID3 tags that the Serato DJ software uses to store its metadata.
+You can also have a look at [this lengthy blog post](https://homepage.ruhr-uni-bochum.de/jan.holthuis/posts/reversing-seratos-geob-tags) that goes into detail how I reversed the contents of the `Serato Markers2` GEOB tag.
+
+| Tag                                          | Progress      | Contents                   | Example script
+| -------------------------------------------- | ------------- | -------------------------- | --------------
+| [`Serato Analysis`](docs/serato_analysis.md) | Done          | Serato version information |
+| [`Serato Autotags`](docs/serato_autotags.md) | Done          | BPM and Gain values        | [`serato_autotags.py`](scripts/serato_autotags.py)
+| [`Serato BeatGrid`](docs/serato_beatgrid.md) | Mostly done   | Beatgrid Markers           | [`serato_beatgrid.py`](scripts/serato_beatgrid.py)
+| [`Serato Markers2`](docs/serato_markers2.md) | Mostly done   | Hotcues, Saved Loops, etc. | [`serato_markers2.py`](scripts/serato_markers2.py)
+| [`Serato Markers_`](docs/serato_markers_.md) | Mostly done   | Hotcues, Saved Loops, etc. | [`serato_markers_.py`](scripts/serato_markers_.py)
+| [`Serato Offsets_`](docs/serato_offsets_.md) | *Not started* |                            |
+| [`Serato Overview`](docs/serato_overview.md) | Done          | Waveform data              | [`serato_overview.py`](scripts/serato_overview.py)
+
+The different file/tag formats that Serato uses to store the information are documented in [`docs/fileformats.md`](docs/fileformats.md), a script to dump the tag data can be found at [`scripts/tagdump.py`](scripts/tagdump.py).

serato_tools-1.5.0/README.md

@@ -0,0 +1,28 @@
+Fork of https://github.com/Holzhaus/serato-tags , which appears to be no longer maintained.
+
+# Installation
+
+Can install using pip:
+
+`pip install git+https://github.com/bvandercar-vt/serato-tags@main`
+
+Or add this line to your `requirements.txt`:
+
+`git+https://github.com/bvandercar-vt/serato-tags@main`
+
+# Serato Tags
+
+This repository aims to document the GEOB ID3 tags that the Serato DJ software uses to store its metadata.
+You can also have a look at [this lengthy blog post](https://homepage.ruhr-uni-bochum.de/jan.holthuis/posts/reversing-seratos-geob-tags) that goes into detail how I reversed the contents of the `Serato Markers2` GEOB tag.
+
+| Tag                                          | Progress      | Contents                   | Example script
+| -------------------------------------------- | ------------- | -------------------------- | --------------
+| [`Serato Analysis`](docs/serato_analysis.md) | Done          | Serato version information |
+| [`Serato Autotags`](docs/serato_autotags.md) | Done          | BPM and Gain values        | [`serato_autotags.py`](scripts/serato_autotags.py)
+| [`Serato BeatGrid`](docs/serato_beatgrid.md) | Mostly done   | Beatgrid Markers           | [`serato_beatgrid.py`](scripts/serato_beatgrid.py)
+| [`Serato Markers2`](docs/serato_markers2.md) | Mostly done   | Hotcues, Saved Loops, etc. | [`serato_markers2.py`](scripts/serato_markers2.py)
+| [`Serato Markers_`](docs/serato_markers_.md) | Mostly done   | Hotcues, Saved Loops, etc. | [`serato_markers_.py`](scripts/serato_markers_.py)
+| [`Serato Offsets_`](docs/serato_offsets_.md) | *Not started* |                            |
+| [`Serato Overview`](docs/serato_overview.md) | Done          | Waveform data              | [`serato_overview.py`](scripts/serato_overview.py)
+
+The different file/tag formats that Serato uses to store the information are documented in [`docs/fileformats.md`](docs/fileformats.md), a script to dump the tag data can be found at [`scripts/tagdump.py`](scripts/tagdump.py).

serato_tools-1.5.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "serato_tools"
+version = "1.5.0"
+description = "Serato track metadata tags"
+readme = "README.md"
+authors = [
+    { name = "bvandercar-vt", email = "bvandercar@outlook.com" }
+]
+license = { file = "LICENSE" }
+dependencies = [
+    "mutagen"
+]
+optional-dependencies.waveform_drawing = [
+    "pillow"
+]
+
+[tool.setuptools]
+packages = ["serato_tools", "serato_tools.utils"]
+
+[tool.setuptools.package-dir]
+serato_tools = "src"

serato_tools-1.5.0/serato_tools.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: serato_tools
+Version: 1.5.0
+Summary: Serato track metadata tags
+Author-email: bvandercar-vt <bvandercar@outlook.com>
+License: Copyright 2019 Jan Holthuis
+        
+        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.
+        
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mutagen
+Provides-Extra: waveform-drawing
+Requires-Dist: pillow; extra == "waveform-drawing"
+Dynamic: license-file
+
+Fork of https://github.com/Holzhaus/serato-tags , which appears to be no longer maintained.
+
+# Installation
+
+Can install using pip:
+
+`pip install git+https://github.com/bvandercar-vt/serato-tags@main`
+
+Or add this line to your `requirements.txt`:
+
+`git+https://github.com/bvandercar-vt/serato-tags@main`
+
+# Serato Tags
+
+This repository aims to document the GEOB ID3 tags that the Serato DJ software uses to store its metadata.
+You can also have a look at [this lengthy blog post](https://homepage.ruhr-uni-bochum.de/jan.holthuis/posts/reversing-seratos-geob-tags) that goes into detail how I reversed the contents of the `Serato Markers2` GEOB tag.
+
+| Tag                                          | Progress      | Contents                   | Example script
+| -------------------------------------------- | ------------- | -------------------------- | --------------
+| [`Serato Analysis`](docs/serato_analysis.md) | Done          | Serato version information |
+| [`Serato Autotags`](docs/serato_autotags.md) | Done          | BPM and Gain values        | [`serato_autotags.py`](scripts/serato_autotags.py)
+| [`Serato BeatGrid`](docs/serato_beatgrid.md) | Mostly done   | Beatgrid Markers           | [`serato_beatgrid.py`](scripts/serato_beatgrid.py)
+| [`Serato Markers2`](docs/serato_markers2.md) | Mostly done   | Hotcues, Saved Loops, etc. | [`serato_markers2.py`](scripts/serato_markers2.py)
+| [`Serato Markers_`](docs/serato_markers_.md) | Mostly done   | Hotcues, Saved Loops, etc. | [`serato_markers_.py`](scripts/serato_markers_.py)
+| [`Serato Offsets_`](docs/serato_offsets_.md) | *Not started* |                            |
+| [`Serato Overview`](docs/serato_overview.md) | Done          | Waveform data              | [`serato_overview.py`](scripts/serato_overview.py)
+
+The different file/tag formats that Serato uses to store the information are documented in [`docs/fileformats.md`](docs/fileformats.md), a script to dump the tag data can be found at [`scripts/tagdump.py`](scripts/tagdump.py).

serato_tools-1.5.0/serato_tools.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+serato_tools.egg-info/PKG-INFO
+serato_tools.egg-info/SOURCES.txt
+serato_tools.egg-info/dependency_links.txt
+serato_tools.egg-info/requires.txt
+serato_tools.egg-info/top_level.txt
+src/__init__.py
+src/database_v2.py
+src/serato_autotags.py
+src/serato_beatgrid.py
+src/serato_gain.py
+src/serato_markers2.py
+src/serato_markers_.py
+src/serato_overview.py
+src/tagdump.py
+src/utils/__init__.py
+src/utils/tags.py
+src/utils/ui.py

serato_tools-1.5.0/serato_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

serato_tools-1.5.0/serato_tools.egg-info/requires.txt

@@ -0,0 +1,4 @@
+mutagen
+
+[waveform_drawing]
+pillow

serato_tools-1.5.0/serato_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+serato_tools

serato_tools-1.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

serato_tools-1.5.0/src/database_v2.py

@@ -0,0 +1,212 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+import io
+import os
+import struct
+import sys
+from typing import Any, Callable, Generator, Iterable, Tuple, TypedDict
+
+DATABASE_FILE = os.path.join(os.path.expanduser("~"), "Music\\_Serato_\\database V2")
+
+
+class DbEntry(TypedDict):
+    field: str
+    field_name: str
+    value: str | int | bool | list["DbEntry"]
+    size_bytes: int
+
+
+FIELDNAMES = {
+    # Database
+    "vrsn": "Version",
+    "otrk": "Track",
+    "ttyp": "File Type",
+    "pfil": "File Path",
+    "tsng": "Song Title",
+    "tart": "Artist",
+    "talb": "Album",
+    "tgen": "Genre",
+    "tlen": "Length",
+    "tbit": "Bitrate",
+    "tsmp": "Sample Rate",
+    "tsiz": "Size",
+    "tbpm": "BPM",
+    "tkey": "Key",
+    "tart": "Artist",
+    "utme": "File Time",
+    "bmis": "Missing",
+    "tgrp": "Grouping",
+    "tlbl": "Publisher",
+    "ttyr": "Year",
+    # Serato stuff
+    "tadd": "Date added",
+    "uadd": "Date added",
+    "bbgl": "Beatgrid Locked",
+    # Crates
+    "osrt": "Sorting",
+    "brev": "Reverse Order",
+    "ovct": "Column Title",
+    "tvcn": "Column Name",
+    "tvcw": "Column Width",
+    "ptrk": "Track Path",
+}
+
+
+def _get_type_id(name: str) -> str:
+    # vrsn field has no type_id, but contains text
+    return "t" if name == "vrsn" else name[0]
+
+
+ParsedType = Tuple[str, int, Any, bytes]
+
+
+def parse(fp: io.BytesIO | io.BufferedReader) -> Generator[ParsedType]:
+    for header in iter(lambda: fp.read(8), b""):
+        assert len(header) == 8
+        name_ascii: bytes
+        length: int
+        name_ascii, length = struct.unpack(">4sI", header)
+        name: str = name_ascii.decode("ascii")
+        type_id: str = _get_type_id(name)
+
+        data = fp.read(length)
+        assert len(data) == length
+
+        value: Any
+        if type_id == "b":
+            value = struct.unpack("?", data)[0]
+        elif type_id in ("o", "r"):
+            value = tuple(parse(io.BytesIO(data)))
+        elif type_id in ("p", "t"):
+            value = (data[1:] + b"\00").decode("utf-16")
+        elif type_id == "s":
+            value = struct.unpack(">H", data)[0]
+        elif type_id == "u":
+            value = struct.unpack(">I", data)[0]
+        else:
+            value = data
+
+        yield name, length, value, data
+
+
+class ModifyRule(TypedDict):
+    field: str
+    func: Callable[[str, Any], Any]
+
+
+def modify(
+    fp: io.BytesIO | io.BufferedWriter,
+    parsed: Iterable[ParsedType],
+    rules: list[ModifyRule] = [],
+):
+    track_filename: str = ""
+    for name, length, value, data in parsed:
+        name_bytes = name.encode("ascii")
+        assert len(name_bytes) == 4
+
+        type_id: str = _get_type_id(name)
+
+        if name == "pfil":
+            assert isinstance(value, str)
+            track_filename = os.path.normpath(value)
+
+        rule_has_been_done = False
+        for rule in rules:
+            if name == rule["field"]:
+                maybe_new_value = rule["func"](track_filename, value)
+                if maybe_new_value is not None:
+                    assert (
+                        not rule_has_been_done
+                    ), f"Should only pass one rule per field (field: {name})"
+                    rule_has_been_done = True
+                    value = maybe_new_value
+
+        if type_id == "b":
+            data = struct.pack("?", value)
+        elif type_id in ("o", "r"):
+            assert isinstance(value, tuple)
+            nested_buffer = io.BytesIO()
+            modify(nested_buffer, value, rules)
+            data = nested_buffer.getvalue()
+        elif type_id in ("p", "t"):
+            new_data = str(value).encode("utf-16")[2:]
+            assert new_data[-1:] == b"\x00"
+            data = data[:1] + new_data[:-1]
+        elif type_id == "s":
+            data = struct.pack(">H", value)
+        elif type_id == "u":
+            data = struct.pack(">I", value)
+
+        length = len(data)
+
+        header = struct.pack(">4sI", name_bytes, length)
+        fp.write(header)
+        fp.write(data)
+
+
+def modify_file(file: str, rules: list[ModifyRule]):
+    with open(file, "rb") as read_file:
+        parsed = list(parse(read_file))
+
+    output = io.BytesIO()
+    modify(output, parsed, rules)
+
+    with open(file, "wb") as write_file:
+        output.seek(0)
+        write_file.write(output.read())
+
+
+def parse_to_objects(fp: io.BytesIO | io.BufferedReader | str) -> Generator[DbEntry]:
+    if isinstance(fp, str):
+        fp = open(fp, "rb")
+
+    for name, length, value, data in parse(fp):
+        if isinstance(value, tuple):
+            try:
+                new_val: list[DbEntry] = [
+                    {
+                        "field": n,
+                        "field_name": FIELDNAMES.get(n, "Unknown"),
+                        "size_bytes": l,
+                        "value": v,
+                    }
+                    for n, l, v, d in value
+                ]
+            except:
+                print(f"error on {value}")
+                raise
+            value = new_val
+        else:
+            value = repr(value)
+
+        yield {
+            "field": name,
+            "field_name": FIELDNAMES.get(name, "Unknown"),
+            "size_bytes": length,
+            "value": value,
+        }
+
+
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "file",
+        type=argparse.FileType("rb"),
+        default=open(DATABASE_FILE, "rb"),
+        nargs="?",
+    )
+    args = parser.parse_args()
+
+    for entry in parse_to_objects(args.file):
+        if isinstance(entry["value"], list):
+            print(f"{entry['field']} ({entry['field_name']}, {entry['size_bytes']} B)")
+            for e in entry["value"]:
+                print(
+                    f"    {e['field']} ({e['field_name']}, {e['size_bytes']} B): {e['value']}"
+                )
+        else:
+            print(
+                f"{entry['field']} ({entry['field_name']}, {entry['size_bytes']} B): {entry['value']}"
+            )

serato_tools-1.5.0/src/serato_autotags.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+import io
+import struct
+import sys
+
+FMT_VERSION = "BB"
+
+GEOB_KEY = "Serato Autotags"
+
+
+def readbytes(fp: io.BytesIO | io.BufferedReader):
+    for x in iter(lambda: fp.read(1), b""):
+        if x == b"\00":
+            break
+        yield x
+
+
+def parse(fp: io.BytesIO | io.BufferedReader):
+    version = struct.unpack(FMT_VERSION, fp.read(2))
+    assert version == (0x01, 0x01)
+
+    for i in range(3):
+        data = b"".join(readbytes(fp))
+        yield float(data.decode("ascii"))
+
+
+def dump(bpm: float, autogain: float, gaindb: float):
+    data = struct.pack(FMT_VERSION, 0x01, 0x01)
+    for value, decimals in ((bpm, 2), (autogain, 3), (gaindb, 3)):
+        data += "{:.{}f}".format(value, decimals).encode("ascii")
+        data += b"\x00"
+    return data
+
+
+if __name__ == "__main__":
+    import argparse
+    import configparser
+    import subprocess
+    import tempfile
+
+    import mutagen._file
+
+    from .utils.tags import get_geob, tag_geob
+    from .utils.ui import get_text_editor
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("file")
+    parser.add_argument("-e", "--edit", action="store_true")
+    args = parser.parse_args()
+
+    tagfile = mutagen._file.File(args.file)
+    if tagfile is not None:
+        fp = io.BytesIO(get_geob(tagfile, GEOB_KEY))
+    else:
+        fp = open(args.file, mode="rb")
+
+    with fp:
+        bpm, autogain, gaindb = parse(fp)
+
+    if args.edit:
+        editor = get_text_editor()
+
+        with tempfile.NamedTemporaryFile() as f:
+            f.write(
+                (f"bpm: {bpm}\n" "autogain: {autogain}\n" "gaindb: {gaindb}\n").encode(
+                    "ascii"
+                )
+            )
+            f.flush()
+            status = subprocess.call((editor, f.name))
+            f.seek(0)
+            output = f.read()
+
+        if status != 0:
+            error_str = (f"Command executation failed with status: {status}",)
+            print(error_str, file=sys.stderr)
+            raise Exception(error_str)
+
+        cp = configparser.ConfigParser()
+        try:
+            cp.read_string("[Autotags]\n" + output.decode())
+            bpm = cp.getfloat("Autotags", "bpm")
+            autogain = cp.getfloat("Autotags", "autogain")
+            gaindb = cp.getfloat("Autotags", "gaindb")
+        except Exception:
+            print("Invalid input, no changes made", file=sys.stderr)
+            raise
+
+        new_data = dump(bpm, autogain, gaindb)
+        if tagfile:
+            if tagfile is not None:
+                tag_geob(tagfile, GEOB_KEY, new_data)
+                tagfile.save()
+        else:
+            with open(args.file, mode="wb") as fp:
+                fp.write(new_data)
+    else:
+        print(f"BPM: {bpm}")
+        print(f"Auto Gain: {autogain}")
+        print(f"Gain dB: {gaindb}")

serato_tools-1.5.0/src/serato_beatgrid.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+import collections
+import io
+import struct
+import sys
+
+FMT_VERSION = "BB"
+
+GEOB_KEY = "Serato BeatGrid"
+
+NonTerminalBeatgridMarker = collections.namedtuple(
+    "NonTerminalBeatgridMarker",
+    (
+        "position",
+        "beats_till_next_marker",
+    ),
+)
+TerminalBeatgridMarker = collections.namedtuple(
+    "TerminalBeatgridMarker",
+    (
+        "position",
+        "bpm",
+    ),
+)
+
+Footer = collections.namedtuple("Footer", ("unknown",))
+
+
+def parse(fp: io.BytesIO | io.BufferedReader):
+    version = struct.unpack(FMT_VERSION, fp.read(2))
+    assert version == (0x01, 0x00)
+
+    num_markers = struct.unpack(">I", fp.read(4))[0]
+    for i in range(num_markers):
+        position = struct.unpack(">f", fp.read(4))[0]
+        data = fp.read(4)
+        if i == num_markers - 1:
+            bpm = struct.unpack(">f", data)[0]
+            yield TerminalBeatgridMarker(position, bpm)
+        else:
+            beats_till_next_marker = struct.unpack(">I", data)[0]
+            yield NonTerminalBeatgridMarker(position, beats_till_next_marker)
+
+    # TODO: What's the meaning of the footer byte?
+    yield Footer(struct.unpack("B", fp.read(1))[0])
+    assert fp.read() == b""
+
+
+if __name__ == "__main__":
+    import argparse
+
+    import mutagen._file
+
+    from .utils.tags import get_geob
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("file")
+    args = parser.parse_args()
+
+    tagfile = mutagen._file.File(args.file)
+    if tagfile is not None:
+        fp = io.BytesIO(get_geob(tagfile, GEOB_KEY))
+    else:
+        fp = open(args.file, mode="rb")
+
+    with fp:
+        for marker in parse(fp):
+            print(marker)

serato_tools-1.5.0/src/serato_gain.py

@@ -0,0 +1,21 @@
+import sys
+
+REPLAY_GAIN_GAIN_KEY = "replaygain_SeratoGain_gain"
+REPLAY_GAIN_PEAK_KEY = "replaygain_SeratoGain_peak"
+
+
+if __name__ == "__main__":
+    import argparse
+
+    import mutagen._file
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("file")
+    args = parser.parse_args()
+
+    tagfile = mutagen._file.File(args.file)
+    if tagfile is not None:
+        gain = tagfile.get(REPLAY_GAIN_GAIN_KEY, None)
+        peak = tagfile.get(REPLAY_GAIN_PEAK_KEY, None)
+        print(f"gain: {gain}")
+        print(f"peak: {peak}")