CDSync

Troubleshooting

Quick diagnostic

cdsync status                         # daemon + tray running state
systemctl --user status cdsync-watcher.service
systemctl --user status cdsync-poll.timer
journalctl --user -u cdsync-watcher.service -f
tail -50 ~/.cdsync/log/cdsync.log

"License state: invalid / verifying"

  • First run / new machine: Run cdsync activate [email protected]
  • After hardware change / OS reinstall: Re-activate (fingerprint changed)
  • License file missing: Copy your license.lic to ~/.cdsync/license/license.lic

"OAuth Google not configured"

Edit the OAUTH_CLIENT_ID / OAUTH_CLIENT_SECRET constants in cdsync_bin/oauth_google.py with your Google Cloud Console "Desktop app" credentials (scope drive). Rebuild with bash tools/build.sh.

"No Google Drive remote found"

Run cdsync activate — it creates the Google Drive remote automatically.

Sync stuck / not starting

cdsync status                                # is the daemon running?
cdsync restart                               # restart daemon + tray
journalctl --user -u cdsync-watcher.service -f
tail -100 ~/.cdsync/log/cdsync.log            # rclone errors land here

Tray icon missing (KDE / Sway / Wayland)

Ensure gir1.2-appindicator3-0.1 is installed and your panel supports AppIndicator (most do). For pure Wayland compositors without AppIndicator support, the tray may not appear — use cdsync status / cdsync stop / cdsync start from the CLI instead.

OAuth scope / testing overrides

CDSync requests full Drive access (https://www.googleapis.com/auth/drive) by default. For development/testing only, override the requested scope:

export CDSYNC_OAUTH_SCOPE="https://www.googleapis.com/auth/drive.metadata.readonly"
cdsync activate

cdsync install fails with "Text file busy" / Errno 26

The installer now gracefully stops a running tray BEFORE copying (SIGTERM, wait, retry). If this still fails, kill the tray manually:

pkill -f cdsync-tray
./cdsync install

Want to reinstall cleanly (full uninstall + wipe state)

cdsync uninstall --purge    # stops services, removes everything in ~/.cdsync/

Your license.lic and OAuth tokens are removed. After this, copy your license file back to ~/.cdsync/license/license.lic and run cdsync install → cdsync activate.

Where to get support

  • License issues / email changes: Contact the vendor with your license serial
  • Bug reports: include cdsync --version output, relevant log snippets (~/.cdsync/log/cdsync.log), and steps to reproduce. For service-control issues, also include cdsync status and journalctl --user -u cdsync-watcher.service -n 50 --no-pager output
  • Updates: download the latest package, replace the cdsync and cdsync-tray binaries, then run ./cdsync install. Your license.lic, OAuth tokens, and config are preserved
  • No auto-update — manual reinstall by design