familiar
← Handbook

Privacy

familiar is a desktop application. Your boards, images, and notes stay on your computer. There is no account, and the application works without a network connection.

One optional feature talks to familiar's own server: an anonymous count of installations and reports. This page describes what the software does. It is a plain-language description, not a legal document. Last updated 11 November 2026.

What is sent

At most once per calendar day, after the first-run choice, familiar sends a small request with three fields:

FieldMeaning
schemaThe report format number, currently 1.
install_idA random identifier created on this computer when reporting first runs.
versionThe version of familiar being used.
{"schema":1,"install_id":"0842050c-1917-462a-b2e5-9fbcdb75cebb","version":"0.1.0"}

The identifier is random. It is not derived from a serial number, MAC address, account, disk, or other hardware detail. It is created only once reporting is allowed; declining leaves no identifier behind. It lives beside the settings file, so reinstalling familiar or updating it normally keeps the same identifier. A new configuration folder gets a new one. Published “installations” therefore means configuration profiles that reported at least once, not people or computers.

The request uses no cookies. Its User-Agent is fixed to familiar-telemetry and Accept-Language is fixed to en, rather than exposing your system locale or library version.

What is never sent

No file names or paths, images, canvas contents, board titles, notes, settings, name, email address, hardware details, operating system version, language, screen size, location, or crash data.

When it happens

A day on which you open familiar several times produces at most one report. A day on which you do not open it produces none. Nothing is sent before the first-run question has been answered.

The checkbox in that dialog starts checked. Closing it with × keeps the checkbox's current answer; untick it before closing or continuing to decline. The answer is remembered and can later be changed in Settings.

What the server stores

The server keeps a salted SHA-256 hash of the installation ID, never the ID itself; the first and last calendar day it reported; and the last version reported. It also keeps daily counts by version. There is no time of day in the database.

It stores no IP addresses, including in logs or hashes. The address is visible while the request is received and is used in memory for rate limiting. Those temporary limits are forgotten after their window passes or the server restarts.

What is public

The totals are public on the statistics page and through a JSON endpoint. Nothing about an individual installation is published. The count is a lower bound because reporting is optional; the open endpoint also means it is not a precise measurement.

Turning it off

In Settings, disable Send the anonymous count. The change takes effect immediately. Turning it off cannot remove previous counts because the server does not retain an identifier that can be matched back to your installation.

The counter can be compiled out entirely. Builds without a configured server address send nothing. Packages from a distribution may be configured by that package maintainer.

This page is maintained from the application's source privacy description.