DeskamiEn lille følgesvend på dit skrivebord

Eksportformat

Eksport, som er en del af Deskami Plus, skriver den samme minut-for-minut-registrering, som Deskami gemmer på din Mac. Intet bliver tilføjet, anslået eller udfyldt. Denne side beskriver, hvad der står i filen.

Konventioner

  • En tom celle i CSV, eller null i JSON, betyder ikke målt. Et 0 betyder målt, og det var nul.
  • Kolonnenavnene er på engelsk på alle sprog og ligger fast; de ændres kun sammen med en ny export_version.
  • Filerne er i UTF-8. CSV er kommasepareret med en overskriftsrække.
  • Tidspunkter er i UTC efter ISO 8601, fx 2026-09-28T07:41:00Z. Datoer er YYYY-MM-DD: den kalenderdag, minuttet blev registreret under.
  • Decimaltal bruger punktum og aldrig tusindtalsseparator. Booleske værdier er true og false.
  • Der er én række for hvert minut, hvor Deskami registrerede noget, og ingen række for minutter, hvor den ikke gjorde.

Minutkolonner

CSV-filen har disse kolonner i denne rækkefølge; i JSON udgør de samme felter hvert minut. Navnet i parentes er kolonnen i den rå databasefil.

  • minute_utc — tidspunkt. Minuttets start i UTC. (minute_utc, i Unix-sekunder)
  • local_day — dato. Den kalenderdag, minuttet hører til, i den tidszone, Mac'en var i på det tidspunkt. Den ligger fast, når den er skrevet; et senere skift af tidszone flytter den ikke. (day_key)
  • setup_id — heltal. Den opsætning, der var i brug: et kamera plus en skærmopstilling. I JSON står opsætningerne under setups. (profile_id)
  • seconds_at_desk — 0 til 60. Sekunder, hvor kameraet så dig i dette minut. Når camera_off er false, betyder 0, at kameraet var tændt og ikke så dig. (present_s)
  • posture_deviation — tal, 0 eller mere. Hvor langt dit hoved og dine skuldre sad under din egen reference, i gennemsnit over minuttet, som et multiplum af den grænse for påmindelser, der gjaldt på det tidspunkt: 0 ved referencen, 1 ved grænsen. Tom, når holdningen ikke blev målt. (posture_dev)
  • posture_peak — tal, 0 eller mere. Den største værdi af samme mål inden for minuttet. (posture_peak)
  • distance_deviation — tal, 0 eller mere. Hvor meget tættere dit ansigt var på skærmen end ved din reference, på samme skala, aflæst ud fra afstanden mellem dine øjne i billedet. (distance_dev)
  • blinks — heltal. Blink, talt mens øjnene kunne måles. Tom, når de ikke kunne. (blinks)
  • incomplete_blinks — heltal. Blink, hvor øjet i det smalleste øjeblik ikke kom tæt nok på at lukke. Tom, når ingen vurdering var mulig. (incomplete_blinks)
  • head_pitch_degrees — tal. Hovedets gennemsnitlige hældning forover eller bagover i grader, som kameraet angiver den: i forhold til kameraet, ikke til din reference. (head_pitch)
  • confidence — 0 til 1. Gennemsnitlig sikkerhed i ansigtsdetektionen. (confidence)
  • light — 0 til 1. Gennemsnitlig lysstyrke i området omkring ansigtet, fra 0 mørkt til 1 lyst. Ikke rummet. (light)
  • eyes_measured — boolesk. Øjnene kunne måles mindst én gang i dette minut. Når den er false, er blinks, incomplete_blinks og eye_observed_seconds tomme. (eye_valid)
  • eye_observed_seconds — 0 til 60. Sekunder, hvor øjnene faktisk blev observeret. Blink pr. minut er blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
  • look_aways — heltal. Gennemførte blik ud i det fjerne, 20-20-20-vanen. Tom, når det ikke blev målt, om du kiggede væk. (gaze_breaks)
  • camera_off — boolesk. Kameraet var slukket i dette minut: du slukkede det, en anden app brugte det, eller tilladelsen blev fjernet. Kamerakolonnerne er så tomme; app- og aktivitetskolonnerne kan stadig være udfyldt. (camera_off)
  • declared_break — boolesk. Du fortalte Deskami, at du holdt pause. Minuttet tæller som væk fra skrivebordet, uanset hvad kameraet så. (declared_break)
  • front_app — tekst. Bundle-id'et for den app, der var forrest det meste af minuttet, fx com.apple.Safari. Tom, når den måling var slået fra, skærmen var låst, eller intet var forrest. Aldrig en vinduestitel. (app_id)
  • app_switches — heltal. Hvor mange gange appen forrest skiftede i dette minut. (app_switches)
  • active_seconds — 0 til 60. Sekunder, hvor tastaturet eller musen var blevet rørt inden for de seneste 15 sekunder. Kun tiden siden den sidste hændelse læses, aldrig tasterne. Tom, når den måling var slået fra. (active_s)
  • call_seconds — 0 til 60. Sekunder, hvor en opkaldsapp var forrest, eller én app havde mikrofonen og højttaleren åbne samtidig. Tom, når det ikke blev målt, også i hvert minut, der blev registreret, før Deskami målte det. (meeting_s)

JSON

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

Derefter kommer days, ét objekt for hver registreret dag i perioden. Hver dag har sin egen oversigt, sine egne minutter og påmindelser:

  • local_day og minutes_at_desk, summen af seconds_at_desk divideret med 60.
  • breaks: perioder på 5 minutter eller mere væk fra skrivebordet og under 2 timer, mellem to perioder ved skrivebordet. Tid med kameraet slukket tæller ikke med til nogen af siderne.
  • posture_fine_minutes (posture_deviation under 1) og posture_attention_minutes (1 eller mere).
  • blink_rate: blink pr. minut i den tid, øjnene blev observeret; null ved under ét minuts observation.
  • incomplete_blink_ratio: null, når for få blink kunne vurderes.
  • reminders_by_signal: viste påmindelser, talt pr. signal.
  • minutes: minutkolonnerne ovenfor, ét objekt pr. minut.
  • reminders: ét objekt pr. påmindelse med time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink eller gaze), build_up_seconds (tid over grænsen før påmindelsen), recover_seconds (tid, til du var under den igen; null, når målingen stoppede først), asked (om spørgsmålet om din reference blev vist) og answer (null, når det ikke blev stillet, ellers true eller false).

PDF

PDF'en er ikke en tabel: den er selve oversigten — dagsoversigten, ugen eller måneden — gengivet på én side, præcis som den ser ud på skærmen. Hvert tal i den er tallet på skærmen.

Den rå fil

Indstillinger › Generelt › Data › Vis i Finder fremhæver history.sqlite, som ligger ved siden af history.sqlite-wal og history.sqlite-shm. Mens Deskami kører, kan de nyeste minutter stadig ligge i -wal-filen; kopiér alle tre filer, eller afslut Deskami først. Sletter du dem, mens Deskami kører, starter appen en ny, tom registrering inden for få sekunder. Eksport skriver altid et komplet øjebliksbillede. Hvad databasen indeholder, står på siden om privatliv.