File Sync

Keep your rules, profiles, and sessions in sync across all your devices — by writing to a folder your cloud client already watches.

How it works #

Takt writes four JSON files to a folder you choose. Your cloud desktop client — Google Drive, iCloud Drive, Dropbox, or any other — detects the new or changed files and uploads them. On your other devices, the client downloads the files, and you can pull them into Takt with Import from Folder.

Takt handles the reading and writing. Your cloud client handles the transfer. No account linking or OAuth is required on Takt's side.

Setting up sync #

1. Open the Takt Options page and go to the Settings tab.
2. Scroll to the File Sync section.
3. Click Choose Folder…. Chrome will open a folder picker.
4. Navigate to a folder inside your cloud client's local directory — for example:
   • Google Drive/My Drive/Takt/
   • iCloud Drive/Takt/
   • Dropbox/Takt/
   You can create a new subfolder called Takt inside your cloud folder directly from the picker.
5. Click Select. Takt stores a reference to that folder.
6. Click Sync Now to write your data immediately.

What gets synced #

Takt writes four files to the chosen folder:

Each file is written independently. If your cloud client supports per-file conflict resolution (like Google Drive), a change to rules on device A and profiles on device B will not conflict.

Sync Now #

Click Sync Now to write all four files to the folder immediately. The Last synced timestamp updates when the write succeeds.

Use Sync Now after making a batch of changes you want to push to your other devices right away.

Auto-sync #

Enable Auto-sync on every change to have Takt write to the folder automatically whenever your rules, profiles, or sessions change. There is a short delay (about 2 seconds) after the last change before the write happens, so rapid edits are batched into a single write.

Auto-sync runs silently in the background. If the write fails (for example, if the folder permission was lost after a browser restart), Takt surfaces a Re-authorize prompt the next time you open the Options page.

Import from Folder #

Click Import from Folder to pull data into Takt from any folder on your disk — such as a cloud-synced folder on another device:

1. A system folder picker opens. Navigate to the folder that contains the Takt sync files (rules.json, profiles.json, sessions.json).
2. Takt verifies that at least one expected file is present. If none are found, the import is cancelled with an error message.
3. Each file is read, size-checked (5 MB limit), parsed, and validated for structure and security before any data is written.
4. Valid data is merged into your current Takt data. Rules and profiles get fresh IDs to avoid collisions. Sessions each get a new ID.

If a file is missing (for example, sessions.json doesn't exist yet), that data type is skipped without error.

Re-authorizing after permission loss #

In most cases Chrome remembers your folder permission across browser restarts and sync continues to work without any action. Occasionally permission can be lost — for example if the folder was moved or deleted, the extension was reinstalled, or Chrome's permission store was cleared.

When Takt detects that folder access was lost, it shows a yellow warning in the File Sync section:

Folder access was lost. Click Re-authorize to restore sync.

Click Re-authorize and Chrome will ask for permission to access the same folder again — no folder picker, just a one-click confirmation. Once granted, sync resumes automatically.

Clearing the sync folder #

Click Clear next to the folder name to disconnect Takt from the sync folder. This removes Takt's reference to the folder and turns off auto-sync. It does not delete the files from your disk or from your cloud storage.

You can pick a different folder at any time by clicking Choose Folder… again.

Limits & behaviour #