Skip to content

Releases: lestephen/cherry-studio-sync

v1.1.0: PySide6 GUI, Skip Knowledge Bases, Backup Pruning

27 Dec 05:43

Choose a tag to compare

What's New

GUI Improvements

  • Switched from tkinter to PySide6 for better cross-platform support (especially on macOS with uv)
  • Added cherry icon to the application window
  • New options in GUI:
    • Skip Knowledge Bases checkbox (enabled by default)
    • Prune old merged backups option with configurable retention

New Features

  • Skip Knowledge Bases: Excludes KB files from merged backups by default, avoiding restore issues
  • Backup Pruning: Automatically delete old merged backups, keeping only N most recent per computer
  • Format Migration: Automatically upgrades old backups to work with newer Cherry Studio versions

CLI Changes

  • --include-knowledge-base: Include KB files in merged backups (excluded by default)
  • --prune N: Keep only N merged backups per computer

Dependency Management

  • Added pyproject.toml for automatic dependency installation with uv run

Known Issues

There is a known issue in Cherry Studio where restoring backups fails when Knowledge Bases are in use. This release works around the issue by excluding KB files by default.

Workarounds:

  1. Use Cherry Studio's "Slim Backup" feature
  2. Keep "Skip Knowledge Bases" enabled (default)
  3. Delete knowledge bases before restoring

Installation

# Using uv (recommended)
uv run cherry_studio_sync.py --gui

# Using pip
pip install -r requirements.txt
python cherry_studio_sync.py --gui

v1.0.0 - Initial Release

24 Dec 17:45

Choose a tag to compare

Initial release of Cherry Studio Sync.

See CHANGELOG.md for details.