pyrekordbox 0.4.2__py3-none-any.whl → 0.4.4__py3-none-any.whl

pyrekordbox/utils.py

@@ -4,17 +4,21 @@
 
 """This module contains common constants and methods used in other modules."""
 
+import base64
 import os
 import warnings
 import xml.etree.cElementTree as xml
+import zlib
 from xml.dom import minidom
 
 import psutil
 
 warnings.simplefilter("always", DeprecationWarning)
 
+BLOB_KEY = b"657f48f84c437cc1"
 
-def warn_deprecated(name, new_name="", hint="", remove_in=""):
+
+def warn_deprecated(name: str, new_name: str = "", hint: str = "", remove_in: str = "") -> None:
     s = f"'{name}' is deprecated"
     if remove_in:
         s += f" and will be removed in version '{remove_in}'"
@@ -30,7 +34,7 @@ def warn_deprecated(name, new_name="", hint="", remove_in=""):
     warnings.warn(s, DeprecationWarning, stacklevel=3)
 
 
-def get_process_id(name: str, raise_exec=False) -> int:
+def get_process_id(name: str, raise_exec: bool = False) -> int:
     """Returns the ID of a process if it exists.
 
     Parameters
@@ -62,7 +66,8 @@ def get_process_id(name: str, raise_exec=False) -> int:
         try:
             proc_name = os.path.splitext(proc.name())[0]  # needed on Windows (.exe)
             if proc_name == name:
-                return proc.pid
+                pid: int = proc.pid
+                return pid
         except (psutil.AccessDenied, psutil.NoSuchProcess):
             pass
     if raise_exec:
@@ -70,7 +75,7 @@ def get_process_id(name: str, raise_exec=False) -> int:
     return 0
 
 
-def get_rekordbox_pid(raise_exec=False):
+def get_rekordbox_pid(raise_exec: bool = False) -> int:
     """Returns the process ID of the Rekordbox application.
 
     Parameters
@@ -96,7 +101,7 @@ def get_rekordbox_pid(raise_exec=False):
     return get_process_id("rekordbox", raise_exec)
 
 
-def get_rekordbox_agent_pid(raise_exec=False):
+def get_rekordbox_agent_pid(raise_exec: bool = False) -> int:
     """Returns the process ID of the RekordboxAgent application.
 
     Parameters
@@ -122,7 +127,7 @@ def get_rekordbox_agent_pid(raise_exec=False):
     return get_process_id("rekordboxAgent", raise_exec)
 
 
-def pretty_xml(element, indent=None, encoding="utf-8"):
+def pretty_xml(element: xml.Element, indent: str = None, encoding: str = "utf-8") -> str:
     r"""Generates a formatted string of an XML element.
 
     Parameters
@@ -161,3 +166,19 @@ def pretty_xml(element, indent=None, encoding="utf-8"):
     # Remove annoying empty lines
     string = "\n".join([line for line in string.splitlines() if line.strip()])
     return string
+
+
+def obfuscate(plaintext: str) -> bytes:
+    """Obfuscates a plaintext string using zlib compression and XOR encryption."""
+    key = BLOB_KEY
+    data = zlib.compress(plaintext.encode("utf-8"))
+    xored = bytes(b ^ key[i % len(key)] for i, b in enumerate(data))
+    return base64.b85encode(xored)  # bytes
+
+
+def deobfuscate(blob: bytes) -> str:
+    """Deobfuscates a previously obfuscated string."""
+    key = BLOB_KEY
+    data = base64.b85decode(blob)
+    xored = bytes(b ^ key[i % len(key)] for i, b in enumerate(data))
+    return zlib.decompress(xored).decode("utf-8")

{pyrekordbox-0.4.2.dist-info → pyrekordbox-0.4.4.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: pyrekordbox
-Version: 0.4.2
+Version: 0.4.4
 Summary: Inofficial Python package for interacting with the library of Pioneers Rekordbox DJ software.
 Author-email: Dylan Jones <dylanljones94@gmail.com>
 License: MIT License
         
-        Copyright (c) 2022-2024, Dylan Jones
+        Copyright (c) 2022-2025, Dylan Jones
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
@@ -29,7 +29,7 @@ Project-URL: Source, https://github.com/dylanljones/pyrekordbox
 Project-URL: Documentation, https://pyrekordbox.readthedocs.io/en/stable/
 Project-URL: Tracker, https://github.com/dylanljones/pyrekordbox/issues
 Platform: any
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
 Classifier: License :: OSI Approved :: MIT License
@@ -48,14 +48,12 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: bidict>=0.21.0
-Requires-Dist: blowfish>=0.6.0
 Requires-Dist: construct>=2.10.0
 Requires-Dist: numpy>=1.19.0
 Requires-Dist: packaging
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: sqlalchemy>=2.0.0
 Requires-Dist: sqlcipher3-wheels
-Requires-Dist: frida-tools
 Requires-Dist: python-dateutil
 Provides-Extra: test
 Requires-Dist: hypothesis>=6.0.0; extra == "test"
@@ -87,11 +85,9 @@ Pioneers Rekordbox DJ Software. It currently supports
 - Analysis files (ANLZ)
 - My-Setting files
 
-Tested Rekordbox versions: ``5.8.6 | 6.7.7 | 7.0.9``
+Check the [changelog][CHANGELOG] for recent changes!
 
-> [!WARNING]
-> This project is still under development and might contain bugs or have breaking API changes in the future.
-> Check the [changelog][CHANGELOG] for recent changes!
+Tested Rekordbox versions: ``5.8.6 | 6.7.7 | 7.0.9``
 
 
 ## 🔧 Installation
@@ -143,10 +139,6 @@ from pyrekordbox.config import update_config
 update_config("<pioneer_install_dir>", "<pioneer_app_dir>")
 ````
 
-Alternatively the two paths can be specified in a configuration file under the section
-`rekordbox`. Supported configuration files are pyproject.toml, setup.cfg, pyrekordbox.toml,
-pyrekordbox.cfg and pyrekordbox.yaml.
-
 
 ### Rekordbox 6/7 database
 
@@ -193,19 +185,6 @@ So far only a few tables support adding or deleting entries:
 - ``DjmdGenre``: Genres
 - ``DjmdLabel``: Labels
 
-If the automatic key extraction fails the command line interface of ``pyrekordbox``
-provides a command for downloading the key from known sources and writing it to the
-cache file:
-````shell
-python -m pyrekordbox download-key
-````
-Once the key is cached the database can be opened without providing the key.
-The key can also be provided manually:
-````python
-db = Rekordbox6Database(key="<insert key here>")
-````
-
-
 ### Rekordbox XML
 
 The Rekordbox XML database is used for importing (and exporting) Rekordbox collections
@@ -263,9 +242,6 @@ Changing and creating the Rekordbox analysis files is planned as well, but for t
 full structure of the analysis files has to be understood.
 
 Unsupported ANLZ tags:
-  - PCOB
-  - PCO2
-  - PSSI
   - PWV6
   - PWV7
   - PWVC
@@ -317,22 +293,20 @@ instead of opening an issue.
 Pyrekordbox is tested on Windows and MacOS, however some features can't be tested in
 the CI setup since it requires a working Rekordbox installation.
 
+## ♡ Sponsor
+
+If pyrekordbox has helped you or saved you time, consider supporting its development - every coffee makes a difference!
+
+[![BuyMeACoffee](https://raw.githubusercontent.com/pachadotdev/buymeacoffee-badges/main/bmc-white.svg)](https://www.buymeacoffee.com/dylanljones)
+
 
 ## 🔗 Related Projects and References
 
 - [crate-digger]: Java library for fetching and parsing rekordbox exports and track analysis files.
 - [rekordcrate]: Library for parsing Pioneer Rekordbox device exports
 - [supbox]: Get the currently playing track from Rekordbox v6 as Audio Hijack Shoutcast/Icecast metadata, display in your OBS video broadcast or export as JSON.
-- Deep Symmetry has an extensive analysis of Rekordbox's ANLZ and .edb export file formats
+- [Deep Symmetry] has an extensive analysis of Rekordbox's ANLZ and .edb export file formats
   https://djl-analysis.deepsymmetry.org/djl-analysis
-- rekordcrate reverse engineered the format of the Rekordbox MySetting files
-  https://holzhaus.github.io/rekordcrate/rekordcrate/setting/index.html
-- rekordcloud went into detail about the internals of Rekordbox 6
-  https://rekord.cloud/blog/technical-inspection-of-rekordbox-6-and-its-new-internals.
-- supbox has a nice implementation on finding the Rekordbox 6 database key
-  https://github.com/gabek/supbox
-
-
 
 
 [tests-badge]: https://img.shields.io/github/actions/workflow/status/dylanljones/pyrekordbox/tests.yml?branch=master&label=tests&logo=github&style=flat
@@ -379,3 +353,4 @@ the CI setup since it requires a working Rekordbox installation.
 [rekordcrate]: https://github.com/Holzhaus/rekordcrate
 [crate-digger]: https://github.com/Deep-Symmetry/crate-digger
 [supbox]: https://github.com/gabek/supbox
+[Deep Symmetry]: https://deepsymmetry.org/

pyrekordbox-0.4.4.dist-info/RECORD

@@ -0,0 +1,25 @@
+pyrekordbox/__init__.py,sha256=XtHMC6j7c11dxpf2mrXGz8Ux8TJnlIGcGZTwhs6NpVU,664
+pyrekordbox/__main__.py,sha256=uo_UyoTBXQ-mE3oxe45YWuWH9N2t9HJ5RuzEXQYELVY,4431
+pyrekordbox/_version.py,sha256=ReYqsThJkI0PbGcOHlpeQrPIWshdyOrU6h3QkRk8bHw,704
+pyrekordbox/config.py,sha256=roJEkEoKJ8Nj4OlzyE8NXaxa8riXp1GR2tYZnhS1hxI,16485
+pyrekordbox/logger.py,sha256=dq1BtXBGavuAjuc45mvjF6mOWaeZqZFzo2aBOJdJ0Ik,483
+pyrekordbox/rbxml.py,sha256=rb7bRnr_Bmf3P3bMOh8VDtR2EsVe7E4VYuClLkA-_Lc,46764
+pyrekordbox/utils.py,sha256=JGFvmXY7P_Kn1-yvSvWPILpaEVBe_gkNtDH_DWsbIK0,5133
+pyrekordbox/anlz/__init__.py,sha256=1sArQ6P-bxBJFdcnzW4CAN20pNl3YbmDvm-8pQizTZY,3308
+pyrekordbox/anlz/file.py,sha256=oUYuAjFj7hr1Y0EoAyNsLfk0W4ryqdkdzEEKs25nPF4,7898
+pyrekordbox/anlz/structs.py,sha256=Lt4fkb3SAE8w146eWeWGnpgRoP6jhLMWrSMoMwPjG04,7925
+pyrekordbox/anlz/tags.py,sha256=rlbUAyLc-J5_l4g4xiw59Rl3dW-SClDEb7ZLRXu1xLg,16791
+pyrekordbox/db6/__init__.py,sha256=TZX_BPGZIkc4zSTULIc8yd_bf91MAezGtZevKNh3kZ0,856
+pyrekordbox/db6/aux_files.py,sha256=kKRTj2UWJdHx043MX3-yK5HUWrnxjDNZYBDOHp5Oi14,8726
+pyrekordbox/db6/database.py,sha256=CXqhCx4dmyG9yI_QhuPp1tV-Tefmw4UGQ0lek7jsTdk,86111
+pyrekordbox/db6/registry.py,sha256=a7qpCdvoM9EzL8iQIq4WeYDcwgdhMZtM17xOo3uXftk,10617
+pyrekordbox/db6/smartlist.py,sha256=ukQpKmA06iWAfdzS81Vb0g0qaTVnXQ7pgKa28KcMkiY,12300
+pyrekordbox/db6/tables.py,sha256=vKjFsAE49JHnc7470z5T9DJMxBGaIGULgzDNcw2h1UE,69268
+pyrekordbox/mysettings/__init__.py,sha256=czSTZpv8pHYJGbqsNrwxvmpt2zHV1LPEF6f2aVoqpB8,795
+pyrekordbox/mysettings/file.py,sha256=yAPQmkT5eTRyhJJ-7hKLmyw1EzQxrkFueFBmu3jGJSY,13181
+pyrekordbox/mysettings/structs.py,sha256=5Y1F3qTmsP1fRB39_BEHpQVxKx2DO9BytEuJUG_RNcY,8472
+pyrekordbox-0.4.4.dist-info/licenses/LICENSE,sha256=JfWrNYI7JQpFyPTnZJmttDJqrJLIJKN9qVARn9m9Hyk,1074
+pyrekordbox-0.4.4.dist-info/METADATA,sha256=HYouMIPHbHZEopQN9LgNNIhP12MuBDpH0nzznJ98vaE,14555
+pyrekordbox-0.4.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyrekordbox-0.4.4.dist-info/top_level.txt,sha256=bUHkyxIHZDgSB6zhYnF1o4Yf1EQlTGGIkVRq9uEtsa4,12
+pyrekordbox-0.4.4.dist-info/RECORD,,

{pyrekordbox-0.4.2.dist-info → pyrekordbox-0.4.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{pyrekordbox-0.4.2.dist-info → pyrekordbox-0.4.4.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2024, Dylan Jones
+Copyright (c) 2022-2025, Dylan Jones
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

pyrekordbox-0.4.2.dist-info/RECORD

@@ -1,25 +0,0 @@
-pyrekordbox/__init__.py,sha256=hvg2dB7qhgGB6SmcRg8AION6mTGdlsThdHhsDZ9WYfs,622
-pyrekordbox/__main__.py,sha256=ogn1wEOue1RUjGA0BxmgVIphcSCkoM1jZKRND0cAVLA,6016
-pyrekordbox/_version.py,sha256=_F8vLxUxrAtC2alXNPGVa9l3P6_vLpQAzemS6QlnPGQ,511
-pyrekordbox/config.py,sha256=yKRE0N_YU68kek-7bz0vouTgoQOVMXGKLZA21ydePd0,28333
-pyrekordbox/logger.py,sha256=dq1BtXBGavuAjuc45mvjF6mOWaeZqZFzo2aBOJdJ0Ik,483
-pyrekordbox/rbxml.py,sha256=4qx7YX2UegsYQ2ETfqR-Qyus-8jQ89mer1YjEvq1WtQ,38422
-pyrekordbox/utils.py,sha256=hkYIgG5U4rzl2tjN9ESzLnf8OysEFybRQgmr6J7xq-k,4363
-pyrekordbox/anlz/__init__.py,sha256=SEVY0oPX9ohCVViUbsoOLTrBrFewTh-61qJxwXgAJKg,3155
-pyrekordbox/anlz/file.py,sha256=F6axHmprnp0j3pZkqmmp5iiJBUpqtWiAhSzlAJp2H6Y,6951
-pyrekordbox/anlz/structs.py,sha256=Lt4fkb3SAE8w146eWeWGnpgRoP6jhLMWrSMoMwPjG04,7925
-pyrekordbox/anlz/tags.py,sha256=nlPBKyRB8Z9J69bX2K8ZPQk_g1tMazKeVf2ViAqMX-c,13947
-pyrekordbox/db6/__init__.py,sha256=TZX_BPGZIkc4zSTULIc8yd_bf91MAezGtZevKNh3kZ0,856
-pyrekordbox/db6/aux_files.py,sha256=MehdQSc4iryiHvH8RfE9_9xMnD5qjRRDhTo0o0KRLw0,7592
-pyrekordbox/db6/database.py,sha256=IHEEg8X3BiQF2MMfvYg36BvL6yqYY_jpCO-ysP8tU3Q,80738
-pyrekordbox/db6/registry.py,sha256=zYq_B7INM97de7vUTxqmA4N_P53loDkBkYdzdoeSnvY,9725
-pyrekordbox/db6/smartlist.py,sha256=GG6jE0BHMtx0RHgiVRpWYuL-Ex5edTNSLSDQNiCGzK0,12170
-pyrekordbox/db6/tables.py,sha256=rQZ1qtJBtxiSrvmqGQEG61um5sf6UL5GeppFKO2p_zo,68539
-pyrekordbox/mysettings/__init__.py,sha256=6iLTQ1KIjuoq8Zt3thmkjqJSxrRVIi7BrQpxNcsQK04,706
-pyrekordbox/mysettings/file.py,sha256=JBfVe3jsmah_mGJjyC20_EqJZyJ7ftcOcCkRDKcWgv0,12671
-pyrekordbox/mysettings/structs.py,sha256=5Y1F3qTmsP1fRB39_BEHpQVxKx2DO9BytEuJUG_RNcY,8472
-pyrekordbox-0.4.2.dist-info/licenses/LICENSE,sha256=VwG9ZgC2UZnI0gTezGz1qkcAZ7sknBUQ1M62Z2nht54,1074
-pyrekordbox-0.4.2.dist-info/METADATA,sha256=XhI0TjehrWsupNOK1AEQcomb29sE2ydlb2wuU9WEXQ0,15480
-pyrekordbox-0.4.2.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-pyrekordbox-0.4.2.dist-info/top_level.txt,sha256=bUHkyxIHZDgSB6zhYnF1o4Yf1EQlTGGIkVRq9uEtsa4,12
-pyrekordbox-0.4.2.dist-info/RECORD,,