A graphical user interface (GUI) for QuickSync4Linux. It extends the original command-line utility with a modern PySide6-based interface to manage your Gigaset device, contacts, and files without touching the command line.
The communication with the device is based on AT commands over a USB/Bluetooth serial port. For file transfer, the device is set into Obex mode.
Make sure your user is in the dialout group in order to access the serial port.
sudo usermod -aG dialout <username>
# logout and login again to apply group membershipInstall the CLI package only:
pip install -e .To install the GUI as well, install the separate GUI package. This also installs QuickSync4Linux and the required Qt libraries:
pip install -e ./QuickSync4LinuxGuibluez/bluez-utils(providesbluetoothctlfor automatic Bluetooth device discovery)xdg-utils(providesxdg-opento view log files from the GUI)
To start the graphical interface:
python3 -m QuickSync4LinuxGuiAlternatively, install the desktop entry to launch the GUI from your application menu or file manager:
cp QuickSync4LinuxGui.desktop ~/.local/share/applications/
update-desktop-database ~/.local/share/applications/The CLI remains fully usable without GUI components:
python3 -m QuickSync4Linux listfiles -d <MAC>
python3 -m QuickSync4Linux getcontacts -d <MAC> -f contacts.vcf- Automatic Device Discovery: Scans paired Bluetooth devices and available serial ports (
/dev/ttyACM*,/dev/ttyUSB*,/dev/rfcomm*). - Device Information: Displays manufacturer, model, firmware version, and contact count.
- Contact Manager: Browse, add, edit, or delete contacts and sync them back to the device.
- File Manager: Dolphin-styled file browser with folder navigation, download, upload, and image preview.
- Settings: Configure timeouts and serial baud rate via settings dialogs.
- Logging: Logs are saved to
~/.config/QuickSync4LinuxGui/and can be opened via the sidebar.
Main window:
Contact manager:
File manager:
Settings:
