التوثيقDocs / الإعدادات (config.json)Settings (config.json)
الإعدادات (config.json)Settings (config.json)
كل إعدادات KaldrivoAI في ملف واحد. هنا مكانه، وكيف تعدّله، وماذا يعني كل حقل.All of KaldrivoAI’s settings live in one file. Where it is, how to edit it, and what each field means.
أين الملفWhere the file is
بعد التثبيت، ملف الإعدادات هنا:
%LOCALAPPDATA%\Programs\KaldrivoAI\config.jsonأسهل طريقة لفتحه: أيقونة البرنامج بجانب الساعة ← «الإعدادات config.json». أو اضغط Win+R والصق المسار أعلاه.
Once installed, the settings file is here:
%LOCALAPPDATA%\Programs\KaldrivoAI\config.jsonEasiest way to open it: the tray icon next to the clock → “config.json”. Or press Win+R and paste the path above.
كيف تعدّله بأمانHow to edit it safely
- افتحه بالمفكرة (Notepad).
- غيّر القيمة فقط، واترك علامات التنصيص
"والفواصل,كما هي. - احفظ بـ Ctrl+S.
- أعد تشغيل KaldrivoAI: Ctrl+Alt+Q ثم شغّله من قائمة ابدأ.
الحقول التي تبدأ بـ _help شروحات داخل الملف نفسه، ولا تؤثر على شيء. إذا توقّف البرنامج بعد التعديل، فغالباً سقطت فاصلة أو علامة تنصيص.
- Open it with Notepad.
- Change only the value; leave the quotes
"and commas,exactly as they are. - Save with Ctrl+S.
- Restart KaldrivoAI: Ctrl+Alt+Q, then start it from the Start menu.
Fields starting with _help are explanations inside the file; they change nothing. If the app stops starting after an edit, a comma or quote has usually gone missing.
الاسم واللغة والاختصارNames, language and hotkey
| الحقلField | الافتراضيDefault | ماذا يفعلWhat it does |
|---|---|---|
assistant_name | "KaldrivoAI" | اسم المساعد. يظهر في صفحة الجوال ويصبح كلمة إيقاظ أيضاً. أو قل «غير اسمك إلى …».The assistant’s name. Shown on the phone page and also works as a wake word. Or say «غير اسمك إلى …». |
owner_name | "" | اسمك أنت، صاحب الجهاز.Your name, the PC’s owner. |
persona | "jarvis" | jarvis يتكلم بأسلوب جارفيس ويناديك «سيدي». اتركه فارغاً "" لمساعد عادي.jarvis talks like JARVIS and calls you “sir”. Empty "" = a plain assistant. |
stt_lang | "ar-SA" | لهجتك للتعرّف على الكلام: ar-SA سعودي، ar-AE خليجي، ar-EG مصري، ar-JO شامي، ar-IQ عراقي، ar-YE يمني، ar-MA مغربي. أو قل «لهجتي مصرية».Your Arabic dialect for speech recognition: ar-SA Saudi, ar-AE Gulf, ar-EG Egyptian, ar-JO Levantine, ar-IQ Iraqi, ar-YE Yemeni, ar-MA Moroccan. Or say “set my dialect to egyptian”. |
language_order | ["ar-SA","en-US"] | يسمع العربية والإنجليزية معاً؛ اللغة الأولى تفوز عند التعادل. ضع en-US أولاً إذا كنت تتكلم الإنجليزية غالباً.It listens for Arabic and English at once; the first wins a tie. Put en-US first if you mostly speak English. |
hotkey | "ctrl+alt+k" | اختصار الاستماع وإغلاق المحادثة.The listen / close-conversation hotkey. |
quit_hotkey | "ctrl+alt+q" | اختصار الخروج من البرنامج.The quit hotkey. |
mic_device | null | null = ميكروفون ويندوز الافتراضي. أو جزء من اسم الميكروفون مثل "USB".null = the Windows default mic. Or part of the mic’s name, e.g. "USB". |
الإيقاظ: التصفيق وكلمة الإيقاظWaking: claps and wake word
| الحقلField | الافتراضيDefault | ماذا يفعلWhat it does |
|---|---|---|
clap.enabled | true | تشغيل/إيقاف الإيقاظ بالتصفيق.Turn clap waking on or off. |
clap.threshold | 0.16 | الحساسية. يستيقظ بسهولة زائدة؟ ارفعها (0.3 إلى 0.45). لا يلتقط التصفيق؟ اخفضها (0.12 إلى 0.18).Sensitivity. Wakes too easily? Raise it (0.3–0.45). Misses claps? Lower it (0.12–0.18). |
clap.claps_required | 2 | عدد التصفيقات: 2 أو 3.How many claps: 2 or 3. |
wake_word.enabled | true | تشغيل/إيقاف كلمة الإيقاظ (تحتاج إنترنت).Turn the spoken wake word on or off (needs internet). |
wake_word.words | ["استيقظ", "wake up", …] | كلمات الإيقاظ. اسم المساعد يُضاف تلقائياً.The wake words. The assistant’s name is added automatically. |
wake_word.max_checks_per_minute | 12 | أقصى عدد فحوصات لكلمة الإيقاظ في الدقيقة.At most this many wake-word checks a minute. |
conversation_mode | true | true: صفّق مرة وتابع الكلام. false: صفّق قبل كل أمر.true: clap once, keep talking. false: clap before every command. |
follow_up_seconds | 0 | 0 = تبقى المحادثة مفتوحة حتى تغلقها. 10 = تنام بعد ١٠ ثوانٍ صمت.0 = stays open until you close it. 10 = sleeps after 10 silent seconds. |
wake_timeout_seconds | 8 | إذا لم يتكلم أحد بعد التصفيق (تصفيق خاطئ) يعود للنوم.If nobody speaks right after the claps (a false clap), it goes back to sleep. |
الصوت والردVoice replies
| الحقلField | الافتراضيDefault | ماذا يفعلWhat it does |
|---|---|---|
voice.enabled | true | false = بدون رد صوتي.false = silent. |
voice.arabic_voice | "ar-SA-HamedNeural" | الصوت العربي. صوت نسائي: ar-SA-ZariyahNeural.The Arabic voice. A female voice: ar-SA-ZariyahNeural. |
voice.english_voice | "en-US-AndrewNeural" | الصوت الإنجليزي. صوت نسائي: en-US-AvaNeural.The English voice. A female voice: en-US-AvaNeural. |
voice.speak_each_step | false | true = يقول كل خطوة في الأوامر المتتالية.true = speaks every step of a chained command. |
startup_greeting | true | ترحيب قصير عند كل تشغيل.A short welcome on each start. |
المتصفح والإيميل والتقويمBrowser, email, calendar
| الحقلField | الافتراضيDefault | ماذا يفعلWhat it does |
|---|---|---|
gemini_api_key | "" | مفتاح Gemini الخاص بك (اختياري). التفاصيلYour own Gemini key (optional). Details |
browser | "chrome" | chrome أو edge أو default.chrome, edge or default. |
email_client | "gmail" | gmail يفتح نافذة كتابة في Gmail وتقول «ارسل» للإرسال. mailto = برنامج البريد الافتراضي.gmail opens Gmail compose; say “send” to send. mailto = your default mail app. |
contacts | {} | أسماء تقولها ← عناوين إيميل. أضف التهجئة العربية والإنجليزية.Names you say → email addresses. Add Arabic and English spellings. |
calendar | "google" | google (تقويم Google) أو ics (Outlook / تقويم ويندوز) أو both.google (Google Calendar), ics (Outlook / Windows Calendar) or both. |
timezone | "Asia/Riyadh" | منطقتك الزمنية للمواعيد.Your time zone for appointments. |
home_city | "Riyadh" | مدينتك للطقس.Your city for the weather. |
save_folder | "documents" | أين يحفظ الملفات الجديدة عند «سكر واحفظ»: documents أو desktop أو pictures.Where “close and save” puts new files: documents, desktop or pictures. |
الكاميرا والتلفاز والجوال والتشغيلCamera, TV, phone, startup
| الحقلField | الافتراضيDefault | ماذا يفعلWhat it does |
|---|---|---|
hand_mouse.camera | 0 | 0 = كاميرا اللابتوب. أو رابط كاميرا الجوال مثل "http://192.168.1.20:8080/video".0 = the laptop camera. Or a phone camera URL like "http://192.168.1.20:8080/video". |
hand_mouse.preview | true | نافذة معاينة صغيرة للكاميرا.A small camera preview window. |
tv_name | "" | اسم التلفاز كما يظهر عند الضغط على Win+K. فارغ = تفتح القائمة وتختار بنفسك.Your TV’s name as it appears under Win+K. Empty = the list opens and you pick. |
phone.enabled | true | صفحة التحكم من الجوال.The phone control page. |
phone.port | 8765 | منفذ صفحة الجوال على شبكتك.The phone page’s port on your network. |
auto_start | false | التشغيل مع ويندوز. الأسهل: أيقونة البرنامج ← «شغّل مع الويندوز».Start with Windows. Easiest: tray icon → “Start with Windows”. |
confirm_power | ["shutdown","restart","sleep","lock"] | الأوامر التي تطلب تأكيداً صوتياً قبل التنفيذ.The actions that need a spoken “yes” first. |
مثالExample
مقتطف من ملف إعدادات بعد التعديل:
"assistant_name": "Kaldrivo",
"owner_name": "Sara",
"stt_lang": "ar-EG",
"hotkey": "ctrl+alt+k",
"clap": { "threshold": 0.3, "claps_required": 2 },
"tv_name": "Living Room TV",
"hand_mouse": { "camera": 0 },
"auto_start": trueAn excerpt of an edited settings file:
"assistant_name": "Kaldrivo",
"owner_name": "Sara",
"stt_lang": "ar-EG",
"hotkey": "ctrl+alt+k",
"clap": { "threshold": 0.3, "claps_required": 2 },
"tv_name": "Living Room TV",
"hand_mouse": { "camera": 0 },
"auto_start": true