Theca

Features

What Theca does that you might not see at first.

Ignored files

Some files are never uploaded: those your operating system leaves, and those you choose.

What your operating system leaves

macOS leaves .DS_Store in the folders it opens and a ._name beside every file it copies to a network drive; Windows leaves Thumbs.db, ehthumbs.db and desktop.ini. The computer app, the web app and WebDAV skip them without a word. Files already stored under these names stay.

Ignore files

A file named .thecaignore keeps what it names from being uploaded, in its folder and every folder below it. It's written like a .gitignore, and follows git's rules:

# a project's dependencies and build, wherever they are
node_modules/
build/
# logs, but not this one
*.log
!keep.log
# only at the top of this folder
/scratch.txt
  • One pattern per line; # starts a comment. A pattern ending in / matches folders only, one starting with / only in the ignore file's own folder, and ** any number of folders.
  • ! brings back what an earlier line ignored, and a deeper ignore file wins over a parent's. Nothing comes back inside an ignored folder.
  • Names match without case, as everywhere in Theca.

The ignore file itself is stored and synced like any other file, so every computer follows it, and so do the web app and WebDAV:

  • The computer app never uploads what it names: not a new file, an edit, a folder, a move or a deletion. What the server already holds there still comes down onto the copies nobody changed: new files and new versions, and a deletion on the server removes them; a copy you changed stays as it is. Deleting a folder that isn't ignored still moves everything in it to the trash. An ignore file that names itself stays on that computer only.
  • The web app skips what it names when you upload a folder or files, and says how many it skipped.
  • WebDAV accepts those writes and stores nothing, so a copy from Finder or Explorer goes on.

What's already stored stays as it is: listed, downloadable, and deletable from the web app. A line that isn't text (UTF-8) is skipped, and the computer app and the web app say which; past 64 KiB, only the beginning of an ignore file applies.

A limitation

An ignore file only applies once it's there. During a copy (through WebDAV, into a synced folder, or a move from another disk), the files that arrive before the folder's ignore file may be uploaded. Moving a folder within the same disk is fine: it arrives all at once.