Eksportformat

Eksport, som er en del av Deskami Plus, skriver den samme minutt-for-minutt-registreringen som Deskami lagrer på Macen din. Ingenting legges til, anslås eller fylles inn. Denne siden beskriver hva som står i filen.

Konvensjoner

En tom celle i CSV, eller null i JSON, betyr ikke målt. Tallet 0 betyr målt, og det var null.
Kolonnenavnene er på engelsk på alle språk og ligger fast; de endres bare sammen med en ny export_version.
Filene er i UTF-8. CSV er kommaseparert med en overskriftsrad.
Tidspunkter er i UTC etter ISO 8601, for eksempel 2026-09-28T07:41:00Z. Datoer er YYYY-MM-DD: kalenderdagen minuttet ble registrert under.
Desimaltall bruker punktum, aldri tusenskilletegn. Boolske verdier er true og false.
Det er én rad for hvert minutt der Deskami registrerte noe, og ingen rad for minutter der den ikke gjorde det.

Minuttkolonner

CSV-filen har disse kolonnene, i denne rekkefølgen; i JSON utgjør de samme feltene hvert minutt. Navnet i parentes er kolonnen i den rå databasefilen.

minute_utc – tidspunkt. Starten av minuttet, i UTC. (minute_utc, i Unix-sekunder)
local_day – dato. Kalenderdagen minuttet hører til, i tidssonen Macen var i på det tidspunktet. Den ligger fast når den er skrevet; et senere bytte av tidssone flytter den ikke. (day_key)
setup_id – heltall. Oppsettet som var i bruk: et kamera pluss en skjermplassering. I JSON står oppsettene under setups. (profile_id)
seconds_at_desk – 0 til 60. Sekunder kameraet så deg i dette minuttet. Når camera_off er false, betyr 0 at kameraet var på og ikke så deg. (present_s)
posture_deviation – tall, 0 eller mer. Hvor langt under din egen referanse hodet og skuldrene dine lå, i snitt over minuttet, som et multiplum av påminnelsesgrensen som gjaldt da: 0 ved referansen, 1 ved grensen. Tom når holdningen ikke ble målt. (posture_dev)
posture_peak – tall, 0 eller mer. Den største verdien av det samme målet innenfor minuttet. (posture_peak)
distance_deviation – tall, 0 eller mer. Hvor mye nærmere skjermen ansiktet ditt var enn ved referansen, på samme skala, lest ut fra avstanden mellom øynene dine i bildet. (distance_dev)
blinks – heltall. Blunk talt mens øynene kunne måles. Tom når de ikke kunne det. (blinks)
incomplete_blinks – heltall. Blunk der øyet i det smaleste øyeblikket ikke kom nær nok til å lukke seg. Tom når ingen vurdering var mulig. (incomplete_blinks)
head_pitch_degrees – tall. Hodets gjennomsnittlige helning forover eller bakover i grader, slik kameraet oppgir den: i forhold til kameraet, ikke til referansen din. (head_pitch)
confidence – 0 til 1. Gjennomsnittlig sikkerhet i ansiktsdeteksjonen. (confidence)
light – 0 til 1. Gjennomsnittlig lysstyrke i området rundt ansiktet, fra 0 mørkt til 1 lyst. Ikke rommet. (light)
eyes_measured – boolsk. Øynene kunne måles minst én gang i dette minuttet. Når den er false, er blinks, incomplete_blinks og eye_observed_seconds tomme. (eye_valid)
eye_observed_seconds – 0 til 60. Sekunder øynene faktisk ble observert. Blunk per minutt er blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
look_aways – heltall. Fullførte blikk ut i det fjerne, 20-20-20-vanen. Tom når det ikke ble målt om du så vekk. (gaze_breaks)
camera_off – boolsk. Kameraet var av dette minuttet: du slo det av, en annen app brukte det, eller tillatelsen ble fjernet. Kamerakolonnene er da tomme; app- og aktivitetskolonnene kan likevel være fylt ut. (camera_off)
declared_break – boolsk. Du sa fra til Deskami at du hadde pause. Minuttet teller som borte fra pulten, uansett hva kameraet så. (declared_break)
front_app – tekst. Pakke-ID-en (bundle identifier) til appen som var i forgrunnen mesteparten av minuttet, for eksempel com.apple.Safari. Tom når den lesningen var slått av, skjermen var låst eller ingenting var i forgrunnen. Aldri en vindustittel. (app_id)
app_switches – heltall. Hvor mange ganger appen i forgrunnen byttet i dette minuttet. (app_switches)
active_seconds – 0 til 60. Sekunder der tastaturet eller musen var blitt rørt i løpet av de siste 15 sekundene. Bare tiden siden den siste hendelsen leses, aldri tastene. Tom når den lesningen var slått av. (active_s)
call_seconds – 0 til 60. Sekunder der en samtaleapp var i forgrunnen, eller én app hadde mikrofonen og høyttaleren åpne samtidig. Tom når det ikke ble målt, også for hvert minutt som ble registrert før Deskami målte dette. (meeting_s)

JSON

JSON-filen er ett objekt. Den begynner med et hode: export_version, app_version, exported_at, time_zone (på eksporttidspunktet), database_schema_version, range (kind, from, to) og setups (id, camera_name, created_at).

Deretter kommer days, ett objekt for hver registrert dag i perioden. Hver dag har sin egen oppsummering, sine egne minutter og påminnelser:

local_day og minutes_at_desk, summen av seconds_at_desk delt på 60.
breaks: perioder på 5 minutter eller mer borte fra pulten og under 2 timer, mellom to perioder ved pulten. Tid med kameraet av teller ikke i noen retning.
posture_fine_minutes (posture_deviation under 1) og posture_attention_minutes (1 eller mer).
blink_rate: blunk per minutt over tiden øynene ble observert; null ved under ett minutts observasjon.
incomplete_blink_ratio: null når for få blunk kunne vurderes.
reminders_by_signal: viste påminnelser, telt per signal.
minutes: minuttkolonnene ovenfor, ett objekt per minutt.
reminders: ett objekt per påminnelse, med time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink eller gaze), build_up_seconds (tid over grensen før påminnelsen), recover_seconds (tid til du var under den igjen; null når målingen stoppet først), asked (om spørsmålet om referansen din ble vist) og answer (null når det ikke ble stilt, ellers true eller false).

PDF

PDF-en er ikke en tabell: den er selve oppsummeringen – dagsoppsummeringen, uken eller måneden – gjengitt på én side, nøyaktig slik den ser ut på skjermen. Hvert tall i den er tallet på skjermen.

Den rå filen

Innstillinger › Generelt › Data › Vis i Finder peker ut history.sqlite, som ligger ved siden av history.sqlite-wal og history.sqlite-shm. Mens Deskami kjører, kan de nyeste minuttene fortsatt ligge i -wal-filen; kopier alle tre filene, eller avslutt Deskami først. Sletter du dem mens Deskami kjører, starter appen en ny, tom logg i løpet av noen sekunder. Eksport skriver alltid et fullstendig øyeblikksbilde. Hva databasen inneholder, står på personvernsiden.