Skip to main content

Gigaset QuickSync for Linux

Project description

QuickSync4Linux

It is annoying that companies always forget to implement their software for the most important operating system. This is a minimal implementation of the Gigaset QuickSync software for Linux.

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.

Hardware Setup

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 membership

Usage

First, find out the correct serial port device. After connecting, a serial port like /dev/ttyACM0 (USB on Linux), /dev/tty.usbmodem (USB on macOS) or /dev/rfcomm0 (Bluetooth on Linux) should appear. /dev/ttyACM0 is used by default. If your device differs, you can use the --device parameter for every command or create a config file ~/.config/quicksync4linux.ini.

Example: ~/.config/quicksync4linux.ini
[general]
device = /dev/rfcomm0
baud = 9600

Then, you can use one of the following commands:

# read device metadata
python3 -m QuickSync4Linux info
python3 -m QuickSync4Linux obexinfo

# read device contacts and print VCF to stdout (use --file to store it into a file instead)
python3 -m QuickSync4Linux getcontacts

# create new contacts on device from vcf file
python3 -m QuickSync4Linux createcontacts --file mycontacts.vcf

# overwrite a contact with given luid 517
# luid = Local Unique IDentifier; can be found in `getcontacts` vcf output
python3 -m QuickSync4Linux editcontact 517 --file mycontact.vcf

# delete contact with luid 517 from device
python3 -m QuickSync4Linux deletecontact 517

# show files on device
python3 -m QuickSync4Linux listfiles

# download file "/Pictures/Gigaset.jpg" from device into local file "gigaset.jpg"
python3 -m QuickSync4Linux download "/Pictures/Gigaset.jpg" --file gigaset.jpg

# upload local file "cousin.jpg" into "/Clip Pictures/cousin.jpg" on device
python3 -m QuickSync4Linux upload "/Clip Pictures/cousin.jpg" --file cousin.jpg

# delete file "/Clip Pictures/cousin.jpg" on device
python3 -m QuickSync4Linux delete "/Clip Pictures/cousin.jpg"

# start a call
python3 -m QuickSync4Linux dial 1234567890

For debug purposes and reporting issues, please start the script with the -v parameter and have a look at the serial communication.

Formats

VCF Structure

The Gigaset devices expect a VCF like the following example:

BEGIN:VCARD
VERSION:2.1
X-IRMC-LUID:769
N:Last Name;First Name
TEL;HOME:+49123456789
TEL;CELL:+49456789123
TEL;WORK:+49789123456
BDAY:2020-01-01T09:00
END:VCARD

And with special chars encoded as Quoted Printable:

BEGIN:VCARD
VERSION:2.1
X-IRMC-LUID:1099
N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:|\\=C2=A7\;;=C3=A4=C3=B6=C3=BC=
=C3=9F
TEL;HOME:+49123
END:VCARD

Picture Format

Important: your image size should match the screen/clip size which can be found by the info command. The device will crash and reboot otherwise when trying to open a non-conform file.

When using GIMP for image creation, use the following values in the JPG export dialog:

  • set "Quality" to 80 or below
  • disable "Save Exif data"
  • disable "Save XMP data"
  • disable "Save thumbnail"
  • disable "Save color profile"
  • disable "Progressive" in the "Advanced Options"

Sound Format

Sounds must use the g722 codec and must be uploaded with the .L22 file extension. Own sounds can easily be converted into g722 using ffmpeg:

ffmpeg -i "Another brick in the wall part2.wav" -ar 16000 -acodec g722 "AnotherBrick2.g722"

python3 -m QuickSync4Linux upload "/Sounds/AnotherBrick2.L22" --file "AnotherBrick2.g722"

Please cut your audio track into a reasonable length before converting and uploading it.

Dial When Clicking tel: Links

To start a call with you Gigaset when clicking tel: links, you need to register QuickSync4Linux as tel: handler in your operating system. On Linux, you do this by copying quicksync4linux.desktop into /usr/share/applications and then execute update-desktop-database.

quicksync must be in you PATH variable. You can simply create a symlink for this: sudo ln -s /path/to/your/quicksync.py /usr/local/bin/quicksync.

Tested Devices

Please let me know if you tested this script with another device (regardless of whether it was successful or not).

  • Gigaset S68H (Bluetooth working, no USB port)
  • Gigaset CL660HX (USB working, no Bluetooth)
  • Gigaset SL450HX (USB + Bluetooth working)
  • Gigaset S700H PRO (USB + Bluetooth working)
  • Gigaset SL400H (USB working, Bluetooth is impossible to pair in GNOME because the PIN is not visible on the desktop at the moment you need to enter it in the handset)

Common Errors

  • Device reported an AT command error Make sure you are on the home screen on the device. Do not open the contacts, menu or Media Pool when transferring data.

Support

If you like this project please consider making a donation using the sponsor button on GitHub to support further development. If your financial resources do not allow this, you can at least leave a star for the Github repo.

Furthermore, you can hire me for commercial support or adjustments and support for new devices. Please contact me if you are interested.

Project details


Release history Release notifications | RSS feed

This version

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quicksync4linux-1.0.tar.gz (36.2 kB view hashes)

Uploaded Source

Built Distribution

quicksync4linux-1.0-py3-none-any.whl (36.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page