Cloud Sync (Snapshot Sync) Setup and Usage

This article explains how to use Snapshot Sync to back up your task data.

What Is Snapshot Sync?

Snapshot Sync is a feature that saves your entire data state at a given point in time (a snapshot) and automatically synchronizes data across multiple devices. It automatically backs up kakiko’s task data to a specified folder. By selecting a cloud storage folder such as iCloud Drive, OneDrive, or Google Drive, your data is synced to the cloud.

This feature is available exclusively with the Pro plan.

Set Up Snapshot Sync

Select a Sync Folder

1. Click the settings icon at the bottom of the sidebar.
2. Select the “Sync” section in the left sidebar.
3. Click the “Select” button next to “Snapshot Folder”.
4. Choose a destination folder in the file browser.
5. Click “Open” to confirm.

To sync with cloud storage, select a sync folder from iCloud Drive, OneDrive, Dropbox, or similar services.

Enable Sync

1. Open the “Sync” section in the settings panel.
2. Turn on the “Enable Snapshot Sync” switch.
3. Click the “Save” button at the bottom of the screen.

Once configured, the status badge will change to “Configured” (green).

Sync Now Manually

1. Open the “Sync” section in the settings panel.
2. Click the “Sync Now” button.
3. The button will change to “Syncing…” and the sync will begin.

After sync completes, the button will be grayed out for 1.5 seconds to prevent duplicate syncs from rapid clicking.

How Automatic Sync Works

Snapshot Sync runs automatically at three different timings.

1. Auto-Sync After Task Edits

After editing a task, if there is no activity for 8 seconds, an automatic sync runs. Based on the sync interval setting, no re-sync occurs until the specified time (default: 10 minutes) has passed since the last sync.

2. Auto-Sync on App Launch

A single automatic sync runs 30 seconds after the app launches.

3. Auto-Sync on Idle

When enabled in settings, an automatic sync runs when there has been no mouse or keyboard activity for a set period.

Configure Idle Auto-Sync

1. Open the “Sync” section in the settings panel.
2. Turn on the “Auto-sync on idle detection” switch.
3. Set the “Idle detection seconds” (default: 300 seconds).
4. Set the “Minimum sync interval (minutes)” (default: 10 minutes).
5. Click the “Save” button.

The minimum idle detection is 30 seconds, and the minimum sync interval is 5 minutes.

Snapshot Retention Settings

You can configure automatic deletion of old snapshots.

1. Open the “Sync” section in the settings panel.
2. Set the “Maximum generations” (default: 10).
3. Set the “Retention days” (default: 14 days).
4. Click the “Save” button.

Old snapshots that exceed the specified conditions will be automatically deleted.

Check Sync Status

You can check the following statuses in the “Sync” section of the settings panel.

Status	Display	Meaning
Configured	Green badge	Sync folder is set
Not configured	Gray badge	Sync folder is not set
Pending sync	Yellow badge	There are unsynced changes

The time elapsed since the last sync is displayed next to “Last synced”.

Offline Behavior

Snapshot Sync is a backup feature to a local folder. Even without an internet connection, backup files are saved locally. Uploading to the cloud depends on the sync functionality of your cloud storage app (iCloud, OneDrive, etc.).

Restore Data on Another Device

To restore data from a snapshot, specify the same snapshot folder on the new device.

1. Install kakiko on the new device.
2. Sync the same cloud storage snapshot folder.
3. In kakiko’s settings, select the same folder as the “Snapshot Folder”.
4. Restart the app, and data will be restored from the latest snapshot.

During restoration, the most recent snapshot is automatically selected based on the latest save number and update timestamp.