Exportformat

Export, som är en del av Deskami Plus, skriver samma minut-för-minut-logg som Deskami sparar på din Mac. Ingenting läggs till, uppskattas eller fylls i. Den här sidan beskriver vad som finns i filen.

Konventioner

En tom cell i CSV, eller null i JSON, betyder inte mätt. Siffran 0 betyder mätt, och det var noll.
Kolumnnamnen är på engelska på alla språk och ligger fast; de ändras bara tillsammans med en ny export_version.
Filerna är i UTF-8. CSV är kommaseparerad med en rubrikrad.
Tider anges i UTC enligt ISO 8601, till exempel 2026-09-28T07:41:00Z. Datum anges som YYYY-MM-DD: den kalenderdag som minuten registrerades under.
Decimaltal skrivs med punkt, aldrig med tusentalsavgränsare. Booleska värden är true och false.
Det finns en rad för varje minut då Deskami registrerade något, och ingen rad för minuter då den inte gjorde det.

Minutkolumner

CSV-filen har de här kolumnerna i den här ordningen; i JSON utgör samma fält varje minut. Namnet inom parentes är kolumnen i den råa databasfilen.

minute_utc — tid. Minutens början, i UTC. (minute_utc, i Unix-sekunder)
local_day — datum. Den kalenderdag minuten hör till, i den tidszon Macen befann sig i vid tillfället. Den ligger fast när den har skrivits; ett senare byte av tidszon flyttar den inte. (day_key)
setup_id — heltal. Uppsättningen som användes: en kamera plus en skärmplacering. I JSON listas uppsättningarna under setups. (profile_id)
seconds_at_desk — 0 till 60. Sekunder som kameran såg dig den här minuten. När camera_off är false betyder 0 att kameran var på och inte såg dig. (present_s)
posture_deviation — tal, 0 eller mer. Hur långt under din egen referens huvud och axlar satt, i genomsnitt över minuten, som en multipel av påminnelsegränsen som gällde då: 0 vid referensen, 1 vid gränsen. Tom när hållningen inte mättes. (posture_dev)
posture_peak — tal, 0 eller mer. Det högsta värdet av samma mått inom minuten. (posture_peak)
distance_deviation — tal, 0 eller mer. Hur mycket närmare skärmen ditt ansikte var än vid referensen, på samma skala, avläst från avståndet mellan dina ögon i bilden. (distance_dev)
blinks — heltal. Blinkningar som räknades medan ögonen gick att mäta. Tom när de inte gick att mäta. (blinks)
incomplete_blinks — heltal. Blinkningar där ögat i sitt smalaste ögonblick inte kom tillräckligt nära att slutas. Tom när ingen bedömning var möjlig. (incomplete_blinks)
head_pitch_degrees — tal. Huvudets genomsnittliga lutning framåt eller bakåt i grader, så som kameran rapporterar den: i förhållande till kameran, inte till din referens. (head_pitch)
confidence — 0 till 1. Ansiktsdetekteringens genomsnittliga säkerhet. (confidence)
light — 0 till 1. Genomsnittlig ljusstyrka i ansiktsområdet, från 0 mörkt till 1 ljust. Inte rummet. (light)
eyes_measured — boolesk. Ögonen gick att mäta minst en gång den här minuten. När den är false är blinks, incomplete_blinks och eye_observed_seconds tomma. (eye_valid)
eye_observed_seconds — 0 till 60. Sekunder då ögonen faktiskt observerades. Blinkningar per minut är blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
look_aways — heltal. Fullbordade blickar i fjärran, 20-20-20-vanan. Tom när bortblickar inte mättes. (gaze_breaks)
camera_off — boolesk. Kameran var av den här minuten: du stängde av den, en annan app använde den eller behörigheten togs bort. Kamerakolumnerna är då tomma; app- och aktivitetskolumnerna kan ändå vara ifyllda. (camera_off)
declared_break — boolesk. Du sa till Deskami att du hade paus. Minuten räknas som borta från skrivbordet, oavsett vad kameran såg. (declared_break)
front_app — text. Paket-ID:t (bundle identifier) för appen som var i förgrunden större delen av minuten, till exempel com.apple.Safari. Tom när den avläsningen var avstängd, skärmen var låst eller ingenting var i förgrunden. Aldrig en fönstertitel. (app_id)
app_switches — heltal. Hur många gånger appen i förgrunden byttes den här minuten. (app_switches)
active_seconds — 0 till 60. Sekunder då tangentbordet eller musen hade rörts inom de senaste 15 sekunderna. Bara tiden sedan den senaste händelsen läses, aldrig tangenterna. Tom när den avläsningen var avstängd. (active_s)
call_seconds — 0 till 60. Sekunder då en mötesapp var i förgrunden, eller en app hade mikrofonen och högtalaren öppna samtidigt. Tom när det inte mättes, vilket gäller varje minut som registrerades innan Deskami mätte det här. (meeting_s)

JSON

JSON-filen är ett enda objekt. Den börjar med ett huvud: export_version, app_version, exported_at, time_zone (vid exporttillfället), database_schema_version, range (kind, from, to) och setups (id, camera_name, created_at).

Sedan kommer days, ett objekt för varje registrerad dag i perioden. Varje dag har sin egen sammanfattning, sina minuter och sina påminnelser:

local_day och minutes_at_desk, summan av seconds_at_desk delad med 60.
breaks: perioder på 5 minuter eller mer borta från skrivbordet och kortare än 2 timmar, mellan två perioder vid skrivbordet. Tid med kameran avstängd räknas åt inget håll.
posture_fine_minutes (posture_deviation under 1) och posture_attention_minutes (1 eller mer).
blink_rate: blinkningar per minut under den tid ögonen observerades; null vid mindre än en minuts observation.
incomplete_blink_ratio: null när för få blinkningar gick att bedöma.
reminders_by_signal: visade påminnelser, räknade per signal.
minutes: minutkolumnerna ovan, ett objekt per minut.
reminders: ett objekt per påminnelse, med time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink eller gaze), build_up_seconds (tid över gränsen före påminnelsen), recover_seconds (tid tills du var under den igen; null när mätningen slutade först), asked (om frågan om din referens visades) och answer (null när den inte ställdes, annars true eller false).

PDF

PDF:en är ingen tabell: den är själva sammanfattningen — dagssammanfattningen, veckan eller månaden — återgiven på en sida, precis som den ser ut på skärmen. Varje siffra i den är siffran på skärmen.

Den råa filen

Inställningar › Allmänt › Data › Visa i Finder pekar ut history.sqlite, bredvid history.sqlite-wal och history.sqlite-shm. Medan Deskami körs kan de senaste minuterna fortfarande ligga i -wal-filen; kopiera alla tre filerna, eller avsluta Deskami först. Om du raderar dem medan Deskami körs startar appen en ny, tom logg inom några sekunder. Export skriver alltid en fullständig ögonblicksbild. Vad databasen innehåller står på integritetssidan.