pyrekordbox 0.2.0__tar.gz → 0.2.2__tar.gz

{pyrekordbox-0.2.0 → pyrekordbox-0.2.2}/.github/workflows/pypi-publish.yml

@@ -34,26 +34,28 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: "3.9"
+        python-version: "3.11"
 
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install twine
-        pip install .[build]
+        pip install --upgrade build
+        pip install --upgrade twine
 
-    - name: Build and publish distribution 📦 to Test PyPI
+    - name: Build distribution 📦
+      run: |
+        python -m build
+
+    - name: Publish distribution 📦 to Test PyPI
       env:
         TWINE_USERNAME: ${{ secrets.TEST_PYPI_USERNAME }}
         TWINE_PASSWORD: ${{ secrets.TEST_PYPI_PASSWORD }}
       run: |
-        python setup.py sdist bdist_wheel
         twine upload --repository testpypi dist/*
 
-    - name: Build and publish distribution 📦 to PyPI
+    - name: Publish distribution 📦 to PyPI
       env:
         TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
         TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
       run: |
-        python setup.py sdist bdist_wheel
         twine upload dist/*

{pyrekordbox-0.2.0 → pyrekordbox-0.2.2}/.github/workflows/tests.yml

@@ -43,7 +43,7 @@ jobs:
     strategy:
       matrix:
         os: [windows-latest, macos-latest]
-        python-version: ["3.7", "3.11"]  # check oldest and latest supported version
+        python-version: ["3.7", "3.12"]  # check oldest and latest supported version
         other-os: [true]
 
     runs-on: ${{ matrix.os }}
@@ -66,6 +66,7 @@ jobs:
     - name: Build and install
       run: |
         python -m pip install --upgrade pip
+        pip install setuptools
         pip install .[test]
 
     - name: Get package version

{pyrekordbox-0.2.0 → pyrekordbox-0.2.2}/.pre-commit-config.yaml

@@ -3,7 +3,7 @@
 
 repos:
     - repo: https://github.com/pre-commit/pre-commit-hooks
-      rev: v4.4.0
+      rev: v4.5.0
       hooks:
           - id: end-of-file-fixer
           - id: trailing-whitespace
@@ -13,7 +13,7 @@ repos:
           - id: check-yaml
 
     - repo: https://github.com/psf/black
-      rev: 23.9.1
+      rev: 23.10.0
       hooks:
         - id: black
           args: [ --safe ]
@@ -22,4 +22,4 @@ repos:
       rev: 6.1.0
       hooks:
           - id: flake8
-            args: [--config, setup.cfg]
+            additional_dependencies: [Flake8-pyproject]

{pyrekordbox-0.2.0 → pyrekordbox-0.2.2}/.readthedocs.yaml

@@ -10,6 +10,7 @@ build:
 
 sphinx:
   builder: html
+  configuration: docs/source/conf.py
 
 python:
   install:

{pyrekordbox-0.2.0 → pyrekordbox-0.2.2}/CHANGELOG.md

@@ -1,6 +1,67 @@
 # What's New
 
 
+<a name="0.2.2"></a>
+## [0.2.2] - 2023-10-26
+
+### New Features
+
+- **add new albums to the RBv6 db**  
+  New entries can now be added to the `DjmdAlbum` table.
+- **add new genres to the RBv6 db**  
+  New entries can now be added to the `DjmdGenre` table.
+- **add new artists to the RBv6 db**  
+  New entries can now be added to the `DjmdArtist` table.
+- **add new labels to the RBv6 db**  
+  New entries can now be added to the `DjmdLabel` table.
+- **support renamed Rekordbox application directory**  
+  The user can now specify the directory name of the Rekordbox application directory. 
+  This supports multiple Rekordbox installations of the same major version.
+
+### Improvements/Bug Fixes
+
+- **don't raise error if key is in cache**  
+  This fixes an issue when using the database handler for Rekordbox>6.6.5 with the cached key.
+- **de-obfuscate PSSI tag data on exported ANLZ files**  
+  The PSSI tag data of ANLZ files that rekordbox 6 *exports* is garbled with an XOR mask.
+  If the first few known fields of the PSSI tag are not valid values this indicates a garbled tag
+  and the data is de-obfuscated. 
+  Thank you [@troyhacks](https://github.com/troyhacks) for the de-obfuscation.
+- **add disabled context manager to the RBv6 `RekordboxAgentRegistry`**  
+- **only re-enable RBV6 USN tracking if it was enabled**
+
+### Documentation
+
+- **add missing documentation of the PSSI tag of ANLZ files**  
+- **Fix typo in djmdCue table documentation**  
+- **update quickstart documentation**  
+
+
+<a name="0.2.1"></a>
+## [0.2.1] - 2023-10-20
+
+This release migrates to SqlAlchemy 2.0 and fixes some bugs.
+
+### Improvements/Bug Fixes
+
+- **migrate to SqlAlchemy 2.0**  
+- **add getters/setters for the mixer gain/peak settings in the RBv6 db ([#88](https://github.com/dylanljones/pyrekordbox/issues/88)).**  
+  The gain and peak values are stored as high/low binary values. 
+  It is now possible to get or set the gain/peak as a simple decibel value. 
+  Thank you [@gsuberland](https://github.com/gsuberland) for the help!
+- **automatically set `updated_at` of tables in the RBv6 db**  
+  The `updated_at` column is automatically updated via `onupdate` if rows are modified. 
+  This only happens if the user did not set the column manually.
+- **flush the RBv6 db changes before applying USN auto-increment.**  
+  This allows the user to use `before_flush` events more easily without 
+  affecting the USN changes
+
+### BREAKING CHANGE
+
+`pyrekordbox` now only supports `sqlcipher3`. `pysqlcipher3` is no longer supported
+since it is not compatible with SqlAlchemy 2.0.
+
+
 <a name="0.2.0"></a>
 ## [0.2.0] - 2023-10-03
 
@@ -405,7 +466,9 @@ This release contains documentation fixes.
 - **add missing djmd tables to `master.db` database documentation**
 
 
-[Unreleased]: https://github.com/dylanljones/pyrekordbox/compare/0.2.0...HEAD
+[Unreleased]: https://github.com/dylanljones/pyrekordbox/compare/0.2.2...HEAD
+[0.2.2]: https://github.com/dylanljones/pyrekordbox/compare/0.2.1...0.2.2
+[0.2.1]: https://github.com/dylanljones/pyrekordbox/compare/0.2.0...0.2.1
 [0.2.0]: https://github.com/dylanljones/pyrekordbox/compare/0.1.8...0.2.0
 [0.1.8]: https://github.com/dylanljones/pyrekordbox/compare/0.1.7...0.1.8
 [0.1.7]: https://github.com/dylanljones/pyrekordbox/compare/0.1.6...0.1.7

pyrekordbox-0.2.2/INSTALLATION.md

@@ -0,0 +1,207 @@
+# Installation
+
+Pyrekordbox is available on [PyPI]:
+
+```sh
+$ pip install pyrekordbox
+```
+
+Alternatively, it can be installed via [GitHub]:
+
+```sh
+$ pip install git+https://github.com/dylanljones/pyrekordbox.git@VERSION
+```
+
+where `VERSION` is a branch, tag or release. The project can also be cloned/forked
+and installed via
+
+```sh
+$ python setup.py install
+```
+
+## Installing SQLCipher
+
+Unlocking the new Rekordbox 6 `master.db` database file requires [SQLCipher][sqlcipher].
+
+### Windows
+
+The easiest method to install SQLCipher on Windows is to build [sqlcipher3]
+against an amalgamation of the SQLite3 source code.
+
+1. **Install [Visual Studio Community Edition][VS]**
+
+   Make sure to select all the GCC options (VC++, C++, etc) in the installation process.
+   The following workloads under ``Desktop & Mobile`` should be sufficient:
+   - Desktop Development with C++
+   - .NET desktop development
+
+
+2. **Install a prebuilt [OpenSSL binary][OpenSSL]**
+
+   Choose the latest Win32/Win64 version. Make sure to download the full version,
+   not the light version.
+
+
+3. **Confirm that the `OPENSSL_CONF` environment variable is set properly in environment variables**
+
+   This should not be root openssl path (ex: `C:/Program Files/openssl-Win64`),
+   but instead should be the path to the config file, for example:
+   - 32-bit: ``C:/Program Files (x86)/openssl-Win32/bin/openssl.cfg``
+   - 64-bit: ``C:/Program Files/openssl-Win64/bin/openssl.cfg``
+
+   The library names of OpenSSL have changed in version 1.1.0 (see [this](https://stackoverflow.com/questions/65345077/unable-to-build-sqlcipher3-on-windows) discussion).
+   If you are using a newer version, you can set an environment variable
+   ``OPENSSL_LIBNAME`` to the name of the library, e.g. ``libcrypto.lib``.
+   Alternatively, you can modify the ``setup.py`` script (see step 8 below).
+
+   You might have to restart Windows for the changes to take effect.
+
+
+4. **Copy the openssl folder to the Microsoft Visual Studio 14 VC include directory**
+
+   The openssl folder can be found here:
+   - 32-bit: `C:/Program Files (x86)/OpenSSL-Win32/include/openssl`
+   - 64-bit: `C:/Program Files/OpenSSL-Win64/include/openssl`
+
+   The VC include directory (for any VS version) can be found in the
+   Visual Studio installation directory:
+   `C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/include`
+
+   Confirm the following path exists `.../include/openssl/aes.h`
+
+
+5. **Download / compile the SQLCipher 3 amalgamation files**
+
+   Pre-built SQLCipher 3 amalgamation files can be downloaded from [this repo](https://github.com/geekbrother/sqlcipher-amalgamation).
+   To compile the amalgamation files, follow [this tutorial](http://www.jerryrw.com/howtocompile.php).
+
+
+6. **Clone [sqlcipher3] into any directory**
+
+   ````commandline
+   git clone https://github.com/coleifer/sqlcipher3
+   ````
+
+
+7. **Copy amalgamation files to the `sqlcipher3` directory**
+
+   Copy files ``sqlite3.c`` and ``sqlite3.h`` from the amalgamation directory from step 5
+   to the root of the ``sqlcipher3`` directory from step 6.
+
+
+8. **Modify the ``sqlcipher3/setup.py`` script (optional)**
+
+   If building the amalgamation fails and you haven't set the ``OPENSSL_LIBNAME``
+   environment variable in step 3, you have to modify the ``setup.py`` script. Change
+   ````python
+   openssl_libname = os.environ.get('OPENSSL_LIBNAME') or 'libeay32.lib'
+   ````
+   to
+   ````python
+   openssl_libname = os.environ.get('OPENSSL_LIBNAME') or 'libcrypto.lib'
+   ````
+
+
+9. **Build using the amalgamation**
+
+    ``cd`` into the ``sqlcipher3`` directory and run
+    ````commandline
+    python setup.py build_static build
+    ````
+
+
+10. **Install ``sqlcipher3``**
+
+    ````commandline
+    python setup.py install
+    ````
+
+You now should have a working ``sqlcipher3`` installation! The directory of the
+cloned ``sqlcipher3`` repo can be deleted after installing the package.
+
+Steps 5-10 can be automated using the CLI of ``pyrekordbox``:
+````commandline
+> python3 -m pyrekordbox install-sqlcipher --help
+usage: pyrekordbox install-sqlcipher [-h] [-t TMPDIR] [-l CRYPTOLIB] [-q] [-b]
+
+  -h, --help            show this help message and exit
+  -t TMPDIR, --tmpdir TMPDIR
+                        Path for storing temporary data (default: '.tmp')
+  -l CRYPTOLIB, --cryptolib CRYPTOLIB
+                        The name of the OpenSSl crypto libary (default: 'libcrypto.lib')
+  -b, --buildonly       Don't install sqlcipher3, only build the amalgamation
+````
+
+#### Troubleshooting
+
+- **Microsoft Visual C++ error**
+
+  If you are getting an error like
+  ````commandline
+  error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools"``
+  ````
+  and have Visual Studio installed, you might not have all the necessary C/C++ components.
+
+- **LINK error**
+
+  If you are getting an error like
+  ````commandline
+  LINK : fatal error LNK1158: cannot run 'rc.exe'
+  ````
+  or
+  ````commandline
+  LINK : fatal error LNK1327: failure during running rc.exe
+  ````
+  make sure all the necessary C/C++ components are installed and that you have selected
+  the latest Win 10/11 SDK in the Visual Studio installer. If you are still getting the error,
+  follow the suggestions in this [StackOverflow post](https://stackoverflow.com/questions/14372706/visual-studio-cant-build-due-to-rc-exe).
+
+
+### MacOS
+
+For MacOS follow these steps:
+
+1) Install [Homebrew](https://brew.sh) if you do not have it on your machine.
+2) Install SQLCipher with `brew install SQLCipher`.
+3) With the python environment you are using to run pyrekordbox active execute the following:
+```shell
+git clone https://github.com/coleifer/sqlcipher3
+cd sqlcipher3
+SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py build
+SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py install
+```
+Make sure the `C_INCLUDE` and `LIBRARY_PATH` point to the installed SQLCipher path. It may differ on your machine.
+
+If you are having issues building sqlcipher on M1 Macs you might have to add some symlinks:
+```shell
+ln -s /opt/homebrew/lib/libsqlcipher.a /usr/local/lib/libsqlcipher.a
+ln -s /opt/homebrew/include/sqlcipher /usr/local/include/sqlcipher
+```
+Alternatively, you can also build [sqlcipher3] against an amalgamation (as described above for Windows, steps 5-10).
+
+
+## Using SQLCipher
+
+After the installation SQLCipher-databases can be unlocked via the `sqlcipher3` package:
+````python
+from sqlcipher3 import dbapi2 as sqlite3
+
+conn = sqlite3.connect('test.db')
+c = conn.cursor()
+c.execute("PRAGMA key='password'")
+````
+
+
+### References:
+
+- [https://stackoverflow.com/questions/33618565/how-to-build-sql-cipher-python-binding-for-windows](https://stackoverflow.com/questions/33618565/how-to-build-sql-cipher-python-binding-for-windows)
+- [https://github.com/Monogi/pysqlcipher3_install_win10](https://github.com/Monogi/pysqlcipher3_install_win10)
+
+
+
+[VS]: https://visualstudio.microsoft.com/de/vs/community/
+[OpenSSL]: https://slproweb.com/products/Win32OpenSSL.html
+[sqlcipher3]: https://github.com/coleifer/sqlcipher3
+[Pypi]: https://pypi.org/project/pyrekordbox/
+[GitHub]: https://github.com/dylanljones/pyrekordbox
+[sqlcipher]: https://www.zetetic.net/sqlcipher/open-source/

{pyrekordbox-0.2.0/pyrekordbox.egg-info → pyrekordbox-0.2.2}/PKG-INFO

@@ -1,14 +1,34 @@
 Metadata-Version: 2.1
 Name: pyrekordbox
-Version: 0.2.0
+Version: 0.2.2
 Summary: Inofficial Python package for interacting with the library of Pioneers Rekordbox DJ software.
-Home-page: https://github.com/dylanljones/pyrekordbox
-Author: Dylan Jones
-Author-email: dylanljones94@gmail.com
-License: MIT
+Author-email: Dylan Jones <dylanljones94@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2022-2023, 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
+        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.
+        
 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: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
@@ -30,19 +50,14 @@ License-File: LICENSE
 Requires-Dist: bidict>=0.21.0
 Requires-Dist: blowfish>=0.6.0
 Requires-Dist: construct>=2.10.0
-Requires-Dist: hypothesis>=6.0.0
 Requires-Dist: numpy>=1.19.0
 Requires-Dist: packaging
-Requires-Dist: pytest>=6.2.0
 Requires-Dist: psutil>=5.9.0
-Requires-Dist: setuptools>=60.0.0
-Requires-Dist: setuptools-scm[toml]>=4
-Requires-Dist: sqlalchemy~=1.4.0
-Provides-Extra: build
-Requires-Dist: wheel>=0.37.0; extra == "build"
+Requires-Dist: sqlalchemy>=2.0.0
 Provides-Extra: test
+Requires-Dist: hypothesis>=6.0.0; extra == "test"
+Requires-Dist: pytest>=6.2.0; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
-Requires-Dist: wheel>=0.37.0; extra == "test"
 
 
 <p align="center">
@@ -68,7 +83,7 @@ Pioneers Rekordbox DJ Software. It currently supports
 - Analysis files (ANLZ)
 - My-Setting files
 
-Tested Rekordbox versions: ``5.8.6 | 6.5.3``
+Tested Rekordbox versions: ``5.8.6 | 6.5.3 | 6.7.7``
 
 
 |⚠️| This project is still under development and might contain bugs or have breaking API changes in the future.   |
@@ -92,12 +107,12 @@ where `VERSION` is a release, tag or branch name.
 
 Unlocking the new Rekordbox 6 `master.db` database file requires [SQLCipher][sqlcipher].
 Pyrekordbox makes no attempt to download/install SQLCipher, as it is a
-pure Python package - whereas the SQLCipher/pysqlcipher3 installation is
+pure Python package - whereas the SQLCipher/sqlcipher3 installation is
 platform-dependent and can not be installed via ``pip``.
 
 #### Windows
 
-SQLCipher can be used by building the libary against an amalgamation with [pysqlcipher3].
+SQLCipher can be used by building the libary against an amalgamation with [sqlcipher3].
 For a detailed instruction, see [INSTALLATION].
 
 #### MacOS
@@ -108,12 +123,13 @@ For MacOS follow these steps:
 2) Install SQLCipher with `brew install SQLCipher`.
 3) With the python environment you are using to run pyrekordbox active execute the following:
 ```shell
-git clone https://github.com/rigglemania/pysqlcipher3
-cd pysqlcipher3
+git clone https://github.com/coleifer/sqlcipher3
+cd sqlcipher3
 SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py build
 SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py install
 ```
 Make sure the `C_INCLUDE` and `LIBRARY_PATH` point to the installed SQLCipher path. It may differ on your machine.
+If you are having issues installing [sqlcipher3] on M1 Macs please refer to [INSTALLATION].
 
 
 ## 🚀 Quick-Start
@@ -184,7 +200,7 @@ So far only a few tables support adding or deleting entries:
 - ``DjmdSongPlaylist``: Songs in a playlist
 
 Starting from Rekordbox version ``6.6.5`` Pioneer obfuscated the ``app.asar`` file
-contents, breaking the key extraction (see [this issue](https://github.com/dylanljones/pyrekordbox/issues/64) for more details).
+contents, breaking the key extraction (see [this discussion](https://github.com/dylanljones/pyrekordbox/discussions/97) for more details).
 If you are using a later version of Rekorbox and have no cached key from a previous
 version, the database can not be unlocked automatically.
 The command line interface of ``pyrekordbox`` provides a command for downloading
@@ -283,6 +299,8 @@ sync = mysett.get("sync")
 quant = mysett.get("quantize")
 ````
 
+The `DEVSETTING.DAT` file is still not supported
+
 
 ## 💡 File formats
 
@@ -302,6 +320,9 @@ If you encounter an issue or want to contribute to pyrekordbox, please feel free
 `pyrekordbox` and the commit-message style can be found in
 [CONTRIBUTING].
 
+For general questions or discussions about Rekordbox, please use [GitHub Discussions][discussions]
+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.
 
@@ -353,13 +374,14 @@ the CI setup since it requires a working Rekordbox installation.
 [mysettings-doc]: https://pyrekordbox.readthedocs.io/en/stable/formats/mysetting.html
 
 [new-issue]: https://github.com/dylanljones/pyrekordbox/issues/new/choose
+[discussions]: https://github.com/dylanljones/pyrekordbox/discussions
 [CONTRIBUTING]: https://github.com/dylanljones/pyrekordbox/blob/master/CONTRIBUTING.md
 [CHANGELOG]: https://github.com/dylanljones/pyrekordbox/blob/master/CHANGELOG.md
 [INSTALLATION]: https://github.com/dylanljones/pyrekordbox/blob/master/INSTALLATION.md
 
 [repo]: https://github.com/dylanljones/pyrekordbox
 [sqlcipher]: https://www.zetetic.net/sqlcipher/open-source/
-[pysqlcipher3]: https://github.com/rigglemania/pysqlcipher3
+[sqlcipher3]: https://github.com/coleifer/sqlcipher3
 [rekordcrate]: https://github.com/Holzhaus/rekordcrate
 [crate-digger]: https://github.com/Deep-Symmetry/crate-digger
 [supbox]: https://github.com/gabek/supbox

{pyrekordbox-0.2.0 → pyrekordbox-0.2.2}/README.md

@@ -22,7 +22,7 @@ Pioneers Rekordbox DJ Software. It currently supports
 - Analysis files (ANLZ)
 - My-Setting files
 
-Tested Rekordbox versions: ``5.8.6 | 6.5.3``
+Tested Rekordbox versions: ``5.8.6 | 6.5.3 | 6.7.7``
 
 
 |⚠️| This project is still under development and might contain bugs or have breaking API changes in the future.   |
@@ -46,12 +46,12 @@ where `VERSION` is a release, tag or branch name.
 
 Unlocking the new Rekordbox 6 `master.db` database file requires [SQLCipher][sqlcipher].
 Pyrekordbox makes no attempt to download/install SQLCipher, as it is a
-pure Python package - whereas the SQLCipher/pysqlcipher3 installation is
+pure Python package - whereas the SQLCipher/sqlcipher3 installation is
 platform-dependent and can not be installed via ``pip``.
 
 #### Windows
 
-SQLCipher can be used by building the libary against an amalgamation with [pysqlcipher3].
+SQLCipher can be used by building the libary against an amalgamation with [sqlcipher3].
 For a detailed instruction, see [INSTALLATION].
 
 #### MacOS
@@ -62,12 +62,13 @@ For MacOS follow these steps:
 2) Install SQLCipher with `brew install SQLCipher`.
 3) With the python environment you are using to run pyrekordbox active execute the following:
 ```shell
-git clone https://github.com/rigglemania/pysqlcipher3
-cd pysqlcipher3
+git clone https://github.com/coleifer/sqlcipher3
+cd sqlcipher3
 SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py build
 SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py install
 ```
 Make sure the `C_INCLUDE` and `LIBRARY_PATH` point to the installed SQLCipher path. It may differ on your machine.
+If you are having issues installing [sqlcipher3] on M1 Macs please refer to [INSTALLATION].
 
 
 ## 🚀 Quick-Start
@@ -138,7 +139,7 @@ So far only a few tables support adding or deleting entries:
 - ``DjmdSongPlaylist``: Songs in a playlist
 
 Starting from Rekordbox version ``6.6.5`` Pioneer obfuscated the ``app.asar`` file
-contents, breaking the key extraction (see [this issue](https://github.com/dylanljones/pyrekordbox/issues/64) for more details).
+contents, breaking the key extraction (see [this discussion](https://github.com/dylanljones/pyrekordbox/discussions/97) for more details).
 If you are using a later version of Rekorbox and have no cached key from a previous
 version, the database can not be unlocked automatically.
 The command line interface of ``pyrekordbox`` provides a command for downloading
@@ -237,6 +238,8 @@ sync = mysett.get("sync")
 quant = mysett.get("quantize")
 ````
 
+The `DEVSETTING.DAT` file is still not supported
+
 
 ## 💡 File formats
 
@@ -256,6 +259,9 @@ If you encounter an issue or want to contribute to pyrekordbox, please feel free
 `pyrekordbox` and the commit-message style can be found in
 [CONTRIBUTING].
 
+For general questions or discussions about Rekordbox, please use [GitHub Discussions][discussions]
+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.
 
@@ -307,13 +313,14 @@ the CI setup since it requires a working Rekordbox installation.
 [mysettings-doc]: https://pyrekordbox.readthedocs.io/en/stable/formats/mysetting.html
 
 [new-issue]: https://github.com/dylanljones/pyrekordbox/issues/new/choose
+[discussions]: https://github.com/dylanljones/pyrekordbox/discussions
 [CONTRIBUTING]: https://github.com/dylanljones/pyrekordbox/blob/master/CONTRIBUTING.md
 [CHANGELOG]: https://github.com/dylanljones/pyrekordbox/blob/master/CHANGELOG.md
 [INSTALLATION]: https://github.com/dylanljones/pyrekordbox/blob/master/INSTALLATION.md
 
 [repo]: https://github.com/dylanljones/pyrekordbox
 [sqlcipher]: https://www.zetetic.net/sqlcipher/open-source/
-[pysqlcipher3]: https://github.com/rigglemania/pysqlcipher3
+[sqlcipher3]: https://github.com/coleifer/sqlcipher3
 [rekordcrate]: https://github.com/Holzhaus/rekordcrate
 [crate-digger]: https://github.com/Deep-Symmetry/crate-digger
 [supbox]: https://github.com/gabek/supbox