Migration: v2.x → v3#

V3 introduces the NFC Payment service integration and the upgrade from PyQt5 to PyQt6.

The NFC change just needs a couple of shell commands. The PyQt6 library, however, needs a recent Raspberry Pi OS to install cleanly — older OS releases ship with PyQt5 only.

NFC payment integration#

To add the USB NFC reader integration, run:

cd ~/CocktailBerry
bash scripts/setup_usb_nfc.sh

The script installs the system-level dependencies for the reader. After that, the NFC payment options become available in the settings.

PyQt5 → PyQt6#

There is a good chance your existing setup will work immediately — the migrator handles most of the heavy lifting and you end up with PyQt6.

It is not guaranteed to work on older OS releases though. If you hit issues:

1. Update to the latest Raspberry Pi OS (Trixie or newer). Recommended path: fresh install (see general guide).
2. Or, on an existing system, install PyQt6 via apt:

sudo apt update
sudo apt install python3-pyqt6

In-place OS upgrades are not recommended unless you already know how to fix the issues that come with them.