Anonymous usage statistics

Last updated Screenshots show Folora 0.2.0.

Folora sends anonymous usage statistics so we know how many installations there are and which versions and systems are in use; this is on by default and can be turned off in Settings ▸ About Folora.

What is sent

Each packet is one JSON object, sent with POST to https://t.folora.ai/p. It contains only the fields in the table below, all of them fixed codes or numbers, with no free text.

Field Example Sent with Purpose
id 9f1c… (UUID v4) Every packet Identifies this installation; the number of installations = the number of distinct ids
k install / launch / beat / off Every packet Packet type. The first launch is install, later launches are launch, every 30 minutes beat, and off when the switch is turned off
v 0.1.2 Every packet Version distribution, update adoption curve
ch release / dev Every packet Daily development builds and release builds are counted separately; the dashboard shows only release by default
os mac / win Every packet Platform distribution
osv 15.1 / 10.0.22631 Every packet What to look at when deciding the minimum supported version
arch arm64 / x64 Every packet Shows whether an Intel Mac version is needed
lang zh-TW Every packet How many installations use each of the 16 languages; translation priorities
up 47 (minutes) beat How long Folora has been open since this launch; the value of the last beat is the session length
act 1 / 0 beat Whether any document was edited in the past 30 minutes. Tells “open” apart from “in use”
mode write / source / split beat The editing mode at the moment the packet is sent (how many installations actually use each of the three modes)
pv 0.1.1 launch The version that ran last time; if it differs from v, an update succeeded
pc 1 / 0 launch Whether the last run ended normally; the share of 0 is the crash rate (forced shutdowns included, so slightly overestimated)
pm 132 (minutes) launch How long the last session was open (exact when it ended normally)

The server also takes country (such as TW), region (such as TPE) and the time of receipt from Cloudflare’s connection information. It does not read or store the IP address, and it does not read the User-Agent.

When it is sent

  • Once at launch: 3 seconds after the window appears, plus a random delay of 0 to 60 seconds. The first launch sends install; every later launch sends launch.
  • While Folora is open, a beat every 30 minutes, with the same random delay of 0 to 60 seconds.
  • When the Windows version is uninstalled, the uninstaller sends one request that contains only the id.

What is never collected

Folora does not collect document contents, the IP address, the computer name, the user name, hardware serial numbers, the screen size, memory, the number of documents, word counts, file names, paths, the workspace location, any keystrokes or commands, or AI settings — not even whether AI is turned on.

Turning it off

In Settings ▸ About Folora, clear Send anonymous usage statistics:

  1. Folora sends one last packet, off. When the server receives it, it deletes all records of this installation.
  2. After that, Folora sends no statistics at all. The line under the switch changes to “Off. This installation’s records have been deleted from the server.”
  3. The identifier file install-id stays in the app’s data folder (on a Mac ~/Library/Application Support/ai.folora.markdown/, on Windows %APPDATA%\ai.folora.markdown\), so after you turn the statistics back on it is still the same installation.

Where the data is kept

The data is kept in a D1 database hosted by Cloudflare. The raw record of each packet is kept for 90 days. After 90 days, only the daily totals remain, plus one summary per installation: when its first and last packets arrived, its first and current version, system and system version, architecture, language, country and region, whether it has been uninstalled or sent nothing for more than 30 days, and its number of launches and abnormal exits. Turning the statistics off deletes this summary as well.

FOLORA