برآمد کا فارمیٹ

برآمد، جو Deskami Plus کا حصہ ہے، منٹ بہ منٹ کا وہی ریکارڈ لکھتی ہے جو Deskami آپ کے Mac پر رکھتا ہے۔ نہ کچھ شامل کیا جاتا ہے، نہ اندازے سے لکھا جاتا ہے، نہ کوئی خالی جگہ بھری جاتی ہے۔ یہ صفحہ بتاتا ہے کہ فائل میں کیا ہے۔

ضابطے

CSV میں خالی خانے، یا JSON میں null، کا مطلب ہے پیمائش نہیں ہوئی۔ 0 کا مطلب ہے پیمائش ہوئی، اور وہ صفر تھی۔
کالموں کے نام ہر زبان میں انگریزی میں ہیں اور مقرر ہیں؛ یہ صرف نئے export_version کے ساتھ بدلتے ہیں۔
فائلیں UTF-8 میں ہیں۔ CSV کے خانے کوما سے الگ ہیں اور پہلی سطر سرخیوں کی ہے۔
اوقات UTC میں ISO 8601 کے مطابق ہیں، جیسے 2026-09-28T07:41:00Z۔ تاریخیں YYYY-MM-DD ہیں، یعنی وہ کیلنڈر دن جس کے تحت منٹ درج ہوا۔
اعشاریہ کے لیے نقطہ استعمال ہوتا ہے، ہزاروں کو الگ کرنے والا نشان کبھی نہیں۔ بولین قدریں true اور false ہیں۔
ہر اس منٹ کی ایک سطر ہے جس میں Deskami نے کچھ درج کیا، اور جن منٹوں میں کچھ درج نہیں کیا ان کی کوئی سطر نہیں۔

منٹ کے کالم

CSV میں یہ کالم اسی ترتیب سے ہیں؛ JSON میں یہی فیلڈز مل کر ہر منٹ بناتی ہیں۔ قوسین میں دیا گیا نام خام ڈیٹا بیس فائل میں کالم کا نام ہے۔

minute_utc — وقت۔ منٹ کا آغاز، UTC میں۔ (minute_utc، Unix سیکنڈز میں)
local_day — تاریخ۔ وہ کیلنڈر دن جس سے یہ منٹ تعلق رکھتا ہے، اس ٹائم زون کے مطابق جس میں Mac اس وقت تھا۔ یہ لکھتے وقت طے ہو جاتا ہے؛ بعد میں ٹائم زون بدلنے سے یہ نہیں ہلتا۔ (day_key)
setup_id — عدد صحیح۔ استعمال میں سیٹ اپ: ایک کیمرا اور ڈسپلے کی ایک ترتیب۔ JSON میں سیٹ اپ setups کے تحت درج ہیں۔ (profile_id)
seconds_at_desk — 0 سے 60۔ اس منٹ میں کیمرے نے آپ کو کتنے سیکنڈ دیکھا۔ جب camera_off کی قدر false ہو تو 0 کا مطلب ہے کہ کیمرا چل رہا تھا اور اس نے آپ کو نہیں دیکھا۔ (present_s)
posture_deviation — عدد، 0 یا زیادہ۔ آپ کا سر اور کندھے آپ کے اپنے حوالے سے کتنے نیچے تھے، پورے منٹ کا اوسط، جسے اس وقت نافذ یاددہانی کی حد کے گنا میں ظاہر کیا گیا ہے: حوالے پر 0، حد پر 1۔ جب نشست کی پیمائش نہ ہوئی ہو تو خالی۔ (posture_dev)
posture_peak — عدد، 0 یا زیادہ۔ منٹ کے اندر اسی پیمانے کی سب سے بڑی قدر۔ (posture_peak)
distance_deviation — عدد، 0 یا زیادہ۔ آپ کا چہرہ حوالے کے مقابلے میں اسکرین سے کتنا زیادہ قریب تھا، اسی پیمانے پر، تصویر میں آپ کی آنکھوں کے درمیانی فاصلے سے پڑھا گیا۔ (distance_dev)
blinks — عدد صحیح۔ وہ پلکیں جو اس دوران گنی گئیں جب آنکھوں کی پیمائش ہو سکتی تھی۔ جب نہ ہو سکی ہو تو خالی۔ (blinks)
incomplete_blinks — عدد صحیح۔ وہ پلکیں جن کا سب سے تنگ لمحہ بند ہونے کے کافی قریب نہیں آیا۔ جب کوئی فیصلہ ممکن نہ ہو تو خالی۔ (incomplete_blinks)
head_pitch_degrees — عدد۔ سر کے اوپر نیچے جھکاؤ کا اوسط، ڈگری میں، جیسا کیمرا بتاتا ہے: کیمرے کے لحاظ سے، آپ کے حوالے کے لحاظ سے نہیں۔ (head_pitch)
confidence — 0 سے 1۔ چہرہ ڈھونڈنے کا اوسط اعتماد۔ (confidence)
light — 0 سے 1۔ چہرے والے حصے کی اوسط چمک، 0 تاریک سے 1 روشن تک۔ کمرے کی نہیں۔ (light)
eyes_measured — بولین۔ اس منٹ میں آنکھوں کی کم از کم ایک بار پیمائش ہو سکی۔ جب یہ false ہو تو blinks، incomplete_blinks اور eye_observed_seconds خالی ہوتے ہیں۔ (eye_valid)
eye_observed_seconds — 0 سے 60۔ آنکھیں واقعی کتنے سیکنڈ دیکھی گئیں۔ فی منٹ پلکیں blinks × 60 ÷ eye_observed_seconds ہیں۔ (eye_observed_s)
look_aways — عدد صحیح۔ دور دیکھنے کے مکمل وقفے، یعنی 20-20-20 کی عادت۔ جب نظر ہٹانے کی پیمائش نہ ہو رہی ہو تو خالی۔ (gaze_breaks)
camera_off — بولین۔ اس منٹ کیمرا بند تھا: آپ نے بند کیا، کسی دوسری ایپ نے اسے سنبھال رکھا تھا، یا اجازت ہٹا دی گئی۔ تب کیمرے کے کالم خالی ہوتے ہیں؛ ایپ اور سرگرمی کے کالم پھر بھی بھرے ہو سکتے ہیں۔ (camera_off)
declared_break — بولین۔ آپ نے Deskami کو بتایا کہ آپ وقفے پر ہیں۔ یہ منٹ ڈیسک سے دور شمار ہوتا ہے، کیمرے نے جو بھی دیکھا ہو۔ (declared_break)
front_app — متن۔ منٹ کے زیادہ تر حصے میں سامنے رہنے والی ایپ کا بنڈل شناخت کنندہ، جیسے com.apple.Safari۔ جب یہ پڑھت بند کی گئی ہو، اسکرین لاک ہو یا سامنے کچھ نہ ہو تو خالی۔ کبھی ونڈو کا عنوان نہیں۔ (app_id)
app_switches — عدد صحیح۔ اس منٹ میں سامنے والی ایپ کتنی بار بدلی۔ (app_switches)
active_seconds — 0 سے 60۔ وہ سیکنڈ جن میں پچھلے 15 سیکنڈ کے اندر کی بورڈ یا ماؤس کو چھوا گیا تھا۔ صرف آخری حرکت کے بعد کا وقت پڑھا جاتا ہے، کلیدیں کبھی نہیں۔ جب یہ پڑھت بند کی گئی ہو تو خالی۔ (active_s)
call_seconds — 0 سے 60۔ وہ سیکنڈ جن میں کال کی کوئی ایپ سامنے تھی، یا ایک ہی ایپ نے مائیکروفون اور اسپیکر ایک ساتھ کھول رکھے تھے۔ جب پیمائش نہ ہوئی ہو تو خالی، ان سب منٹوں سمیت جو Deskami کے اس کی پیمائش شروع کرنے سے پہلے درج ہوئے۔ (meeting_s)

JSON

JSON فائل ایک آبجیکٹ ہے۔ یہ ایک ہیڈر سے شروع ہوتی ہے: export_version، app_version، exported_at، time_zone (برآمد کے وقت کا)، database_schema_version، range (kind، from، to) اور setups (id، camera_name، created_at)۔

اس کے بعد days آتا ہے، چنی گئی مدت کے ہر درج شدہ دن کا ایک آبجیکٹ۔ ہر دن اپنا خلاصہ، اپنے منٹ اور اپنی یاددہانیاں ساتھ رکھتا ہے:

local_day اور minutes_at_desk، یعنی seconds_at_desk کا مجموعہ 60 سے تقسیم۔
breaks: ڈیسک سے 5 منٹ یا زیادہ اور 2 گھنٹے سے کم کی دوری، ڈیسک پر گزرے دو حصوں کے درمیان۔ کیمرا بند ہونے کا وقت کسی طرف شمار نہیں ہوتا۔
posture_fine_minutes (posture_deviation 1 سے کم) اور posture_attention_minutes (1 یا زیادہ)۔
blink_rate: آنکھیں جتنی دیر دیکھی گئیں اس دوران فی منٹ پلکیں؛ اگر دیکھنے کا وقت ایک منٹ سے کم ہو تو null۔
incomplete_blink_ratio: جب بہت کم پلکوں پر فیصلہ ہو سکا ہو تو null۔
reminders_by_signal: دکھائی گئی یاددہانیاں، اشارے کے حساب سے گنی ہوئی۔
minutes: اوپر والے منٹ کے کالم، ہر منٹ کا ایک آبجیکٹ۔
reminders: ہر یاددہانی کا ایک آبجیکٹ، جس میں time_utc، local_day، setup_id، signal (posture، distance، blink، incompleteBlink یا gaze)، build_up_seconds (یاددہانی سے پہلے حد سے اوپر گزرا وقت)، recover_seconds (واپس حد سے نیچے آنے تک کا وقت؛ اگر پیمائش پہلے رک گئی تو null)، asked (کیا آپ کے حوالے کے بارے میں سوال دکھایا گیا) اور answer (اگر سوال نہیں پوچھا گیا تو null، ورنہ true یا false) ہوتے ہیں۔

PDF

PDF کوئی جدول نہیں: یہ خود خلاصہ ہے — دن کا خلاصہ، ہفتہ یا مہینہ — ایک صفحے پر بالکل ویسا ہی چھپا ہوا جیسا اسکرین پر نظر آتا ہے۔ اس کا ہر عدد وہی ہے جو اسکرین پر ہے۔

خام فائل

ترتیبات › عام › ڈیٹا › Finder میں دکھائیں سے history.sqlite سامنے آتی ہے، history.sqlite-wal اور history.sqlite-shm کے ساتھ۔ جب تک Deskami چل رہا ہو، تازہ ترین منٹ ابھی -wal فائل میں ہو سکتے ہیں؛ تینوں فائلیں کاپی کریں، یا پہلے Deskami سے نکلیں۔ اگر آپ Deskami کے چلتے ہوئے انہیں حذف کر دیں تو وہ چند سیکنڈ میں ایک نیا، خالی ریکارڈ شروع کر دیتا ہے۔ برآمد ہمیشہ ایک مکمل اسنیپ شاٹ لکھتی ہے۔ ڈیٹا بیس میں کیا ہے، اس کی فہرست رازداری کے صفحے پر ہے۔