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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for quicksync4linux-1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 896311957b98db98e30eec2fb47eb9af5c7c4ab31fc1c93238c29c88bfb8a0b7 |
|
MD5 | b5e491ea45349bbfd1f63592bf1d98ab |
|
BLAKE2b-256 | a2f06682ac6afc1dcbb4a2a0c84849dbbc25e60e149eb101b1c884fd60186919 |