Sync and backup

Tisty always works on this computer. To reach your work from another one, tell it where to leave the copies — and the rest it does on its own.

There is nothing in the middle: no account, no server, no daemon of ours. If you sync nothing, Tisty never opens a connection at all.

Choosing the folder

Tisty offers Google Drive, OneDrive, iCloud and Dropbox — whichever it finds installed, with the folder already worked out — or any other folder both computers reach: a NAS, Syncthing, an external disk you plug in on Fridays.

Important Whoever moves that folder up and down is your provider’s program, not Tisty. If it is not running, your work waits in the folder until it is. Syncing gives you redundancy, not time travel: if you delete a task, the deletion travels too.

Settings › Your data › Syncing has Sync now, which says when it ran and whether something came back or was written to the folder.

Google Drive can also be connected directly, with no Google program on the computer: see Syncing through Google Drive directly.

When a machine leaves a folder, it writes a short note in it, README - Tisty.txt, saying where its copies went and how to come back. It takes the note away when it chooses that folder again.

A place that already holds a Tisty

A new computer joins without asking. If this computer holds nothing of yours yet — only the guide and the starting lists Tisty puts there the first time it opens — it simply takes what the folder or your Google Drive already holds. What it had is kept first in a backup inside Tisty’s private folder.

If it holds anything you made — a task, a document, a list of your own, a change to the guide — Tisty asks instead: merge the two, keep this computer, or keep what the folder or your Google Drive holds. Whatever you pick, a backup is written first.

Confirming your machines

Each machine signs what it writes. One you already knew is recognised on its own when it updates. A new one — just installed or reinstalled — waits until you confirm it is yours:

1. A notice in the sidebar names that computer, and Confirm… shows its twenty-digit code.
2. On that machine, open Settings › Your data › Syncing. Show large makes the code easy to read from across the desk.
3. If the codes match, Yes, it is the same lets it through and brings in what it wrote. If not, It doesn’t match keeps it out.

You do it once on each of your other machines. From a terminal, tisty sync --confirm <machine> does the same. Until then nothing that machine writes comes in, and from then on whatever does not answer to its key is turned away — and Tisty says so.

Rename there chooses how your other machines show this one; left empty, it goes back to the system’s name.

When two machines write the same document

Tisty merges block by block: you edit the introduction on one machine, someone edits the closing paragraph on the other, and both land with nothing to answer. Only a real overlap becomes a question: the window shows the two side by side and you keep This one, The other or Both.

Large attachments

By default every machine carries every attachment, so any of them opens anything with the network off. For files above 25 MB, Settings offers two other ways:

• keep only what this machine attached, and fetch the rest when you open it;
• leave them in the shared folder and nowhere else.

A local copy is only let go of after the one in the shared folder is found to hash the same. If the folder is not reachable, Tisty says so plainly.

Backups

Back up by hand, shared folder or not — a shared folder is not a backup. Settings › Your data writes one zip with your whole history, kept wherever you like, and restores from the same place.

Syncing through Google Drive directly

Since 1.30, Tisty can sync through your own Google Drive without Google’s desktop program. Here Tisty is the one talking to Drive, so unlike with a folder, it knows when something is wrong and says so on the Google Drive card in Settings › Your data › Syncing. Whatever the card says, what you write is safe on this machine and goes up once the cause is gone.

Connecting it

Settings › Your data › Syncing › Your cloud service › Google Drive › Connect. Your browser opens on Google’s own page; sign in and allow Tisty to keep its copies there. Tisty asks only for a hidden space of its own in your Drive, so it cannot see anything else there, and its copies do not show up among your files. Then Start uploading: the first time everything you have goes up, and if you close Tisty or lose the network it carries on where it left off. Do the same on your other computer, with the same Google account.

It can only be connected from the window. The command line and assistants never reach the network, and a copy of Tisty built without the project’s Google credentials does not offer the cloud at all.

Before you sign in, and before a move to Drive starts, Tisty checks that Google answers: one request to www.googleapis.com with nothing of yours in it, given up after 10 seconds. If a proxy, a filter at work or an antivirus is in the way, or if it inspects secure connections, or if Google is having trouble, Tisty says so in red there, in plain words, with Check again. It never stops you from connecting, never goes around a proxy, and never runs on a round of syncing.

What travels, and what stays

Your history, your documents and their settings go up. Attachments stay on the computer they were added on; on another one each comes down the first time you open it there. Free space lets go of the attachments you have not opened in a while; the next time you open one, it comes down again. Attachments are capped at 25 MB per task and 650 MB inside a document, as with a folder, and nothing over 750 MB is taken in from the cloud.

What the card says

• «Google no longer lets Tisty in» — the permission was removed, from your Google account or with Remove Tisty’s access on every computer, or it expired. Press Reconnect and sign in again. Removing access on one machine removes it on all of them, so each one will ask.
• «This copy belongs to another account» — you signed in with a different Google account from the one this copy already syncs with. Tisty stops rather than mix two accounts. Press Change account and sign in with the one you used before. If you really mean to sync with a different account, move there instead (below).
• «Your Google Drive is full» — your Drive has no room left. Tisty sends your tasks first; the rest, including what your other computers send, waits until you free up space in Drive or get more. See storage opens Google’s page for it.
• «Your cloud reached today’s limit» — every computer has its own daily allowance, 2,000,000 requests’ worth and 50 GB downloaded, so no single copy can spend the quota Google grants the project. It is per computer, not per person. When it runs out, syncing carries on the next day by itself. Cloud use today, on the same card, shows how much is left; tisty doctor prints it too.
• «Google asked to wait a little» — Google is slowing everyone down for a moment. Tisty waits as long as Google says and carries on by itself. There is nothing to do.
• «The cloud is paused for now» — the project can pause syncing on every copy for a while, should its shared quota with Google be at risk; the notice is signed, so nobody else can send it. It lifts by itself. Turn off on the card does the same on this computer only, until you turn it on again.

Leaving Google Drive

Move to another place… takes your copies to a folder or back to this machine alone. Tisty first brings home everything that lived only in Drive, then tells your other computers where you went so each one follows when it syncs. Nothing is deleted in Drive unless you ask; Delete my copies in Google Drive for good deletes them afterwards, and since Tisty’s space in Drive has no bin, they cannot be brought back. To stop one computer without moving the others, use Disconnect this computer: the copies stay in Drive.

Where are my copies in Drive?

In a hidden space of your Drive that belongs to Tisty: they do not show up among your files, and only Tisty opens them. To take them out, move to a folder from Tisty. Disconnecting keeps them, and coming back later to the same account picks them up again, also after Disconnect from Drive in Google Drive › Settings › Manage apps, which only withdraws Tisty’s access. Only Delete hidden app data there deletes them, as does Delete my copies in Google Drive for good in Tisty.

After an update

Every event carries a version, and a machine only reads what it understands. When one machine updates to a version that writes something new, the other stops syncing in both directions until it updates too. Nothing is lost and nothing lands half understood: update the machine that is behind, and the two carry on.

Something changed on one machine and is not on the other

With a folder, Tisty writes to it and reads from it, and what uploads it is your provider’s own program — Google Drive, OneDrive, iCloud, Dropbox, Syncthing. If that program is not running, Tisty keeps saving your work fine and has no way to tell that nobody is picking it up. If you connected Google Drive directly instead, Tisty says what is wrong on its own card: see What the card says.

Go through this in order; the first three cover almost every case.

1. Is your cloud program running? Look for its icon in the menu bar, top right (macOS), or in the system tray next to the clock, hidden icons included (Windows). If its start-at-login is off, a reboot is enough to stop it. Open it and give it a few minutes.
2. Is it paused or signed out? An open client is not always syncing: check in its own panel that it is not paused, that the account is still signed in, and that you have not run out of space.
3. Is that folder among the ones it syncs? Many clients let you choose folders. If the one you gave Tisty fell outside that selection, everything works except the one thing that matters.
4. Is the other machine on? It has to open Tisty to pick changes up. While it is off, your work waits in the folder.
5. Is the other machine waiting on you? In Settings › Maintenance › The machines it shows as Waiting — confirm it (see above), checking the key is the same character by character. What it wrote meanwhile stays in the folder and arrives whole.
6. Check with your own eyes. Settings › Your data shows two dates: My last round (when Tisty read and wrote in the folder — it does not mean anything was uploaded) and Something last arrived from another machine. If the second has been still for days and your machines are on, the problem is there. Open the folder, look for your recent files, and check with your provider — from its website, say — whether they are up there too.

If all of that is fine, Settings › Your data › Send again copies everything of this machine’s to the folder again without asking whether it is already there, which is what you want when a cloud client skipped a file.

Why does Tisty not warn me on its own?

Because it cannot know. With a folder, Tisty talks to no cloud: it has no account of yours, no credentials, and no idea which provider — if any — is behind the folder. It could ask your provider’s program, and it may one day; today it does not, so it shows you the facts it does know instead of a verdict it cannot back.

Is anything lost meanwhile?

No. Your work is complete on the machine where you did it, and the log only appends: nothing is overwritten or dropped. As soon as the folder moves again, both machines catch up on their own, even if both were working at once. If both wrote the same part of a document, you choose which stays (see above).