Skip to content

Backups and Your Data

Kristopher Barrantes edited this page Oct 30, 2026 · 4 revisions

Backups and your data

Where Cuebot keeps things

Everything Cuebot knows (settings, actions, sign-ins, logs and backups) is in its data folder:

System Folder
Windows %APPDATA%\Cuebot
Linux ~/.config/Cuebot

The program folder holds no settings, so you can replace it when updating. Start Cuebot with --data <folder> (or set the CUEBOT_DATA environment variable) to use another folder, for example a portable copy on a USB stick or a second profile. Only one Cuebot runs per data folder; different folders can run side by side.

Sign-ins, API keys and passwords are stored encrypted. On Windows the key is protected by your Windows account; on Linux by your desktop keyring (GNOME Keyring, KWallet and similar), or by a file only your user can read where there is no keyring. Sign-ins and keys are never included in backups (or their copies on Google Drive). Restoring a backup on the same computer keeps your current sign-ins; on a new computer, sign in again after restoring.

Backups

On every start, and before every import, Cuebot zips the data folder into backups/ inside the data folder (logs, the Python runtime and older backups are left out). The newest 10 are kept; change that under Settings > Backups.

Settings > Backups can also back up right now, open the backups folder, and restore a backup. A restore is applied while Cuebot restarts, before anything is loaded, after a safety backup of your current data.

Google Drive backups

Cuebot can copy its backups to your own Google Drive (Settings > Google Drive):

  1. Click Sign in with Google, pick the account and allow access.
  2. Every new backup is uploaded into a Cuebot Backups folder that Cuebot creates. The newest 10 are kept there (configurable separately). At start, the newest local backup is uploaded if Drive does not have it yet.
  3. The page lists the backups on Drive; Restore... downloads one and schedules it like a local restore.

Cuebot asks only for the drive.file permission, so it can see and change nothing in your Drive except the files it created. Sign out revokes its access; backups already on Drive stay there.

Privacy

Cuebot has no analytics and no telemetry. It connects to a service only when you set it up, and sends it only what that job needs. See the privacy policy for the full list.

Clone this wiki locally