پرش به محتوا
Chapters
  1. به Omarchy خوش آمدید!
  2. شروع به کار
  3. آمدن از Mac یا Windows
  4. ناوبری
  5. نوار بالایی
  6. تم‌ها
  7. کلیدهای میانبر
  8. کلیپ‌بورد یکپارچه و تاریخچه
  9. یادآورها
  10. اعلان‌ها
  11. استخراج متن و دیکته
  12. اسکرین‌شات‌ها و ضبط
  13. تغییر وضعیت‌ها، بیکاری و محافظ صفحه
  14. Omarchy CLI
  15. ترمینال
  16. Neovim
  17. هوش مصنوعی
  18. ابزارهای توسعه
  19. ابزارهای شل
  20. توابع شل
  21. TUIs
  22. رابط‌های گرافیکی
  23. مرورگرها
  24. برنامه‌ها/خدمات تجاری
  25. برنامه‌های وب
  26. بازی
  27. پر کردن PDFها
  28. ماشین مجازی Windows
  29. بسته‌های دیگر
  30. به‌روزرسانی‌ها
  31. دات‌فایل‌ها
  32. افزونه‌های شل
  33. نمایشگرها
  34. صفحه‌کلید، ماوس، ترک‌پد
  35. شبکه
  36. خواب سیستم
  37. احراز هویت سخت‌افزاری
  38. قلم‌ها
  39. پس‌زمینه‌ها
  40. اعلان
  41. برندینگ
  42. تغییرات رایج
  43. ساختن تم خودتان
  44. پشتیبانی از Mac
  45. عیب‌یابی
  46. پرسش‌های متداول
  47. اسنپ‌شات‌های سیستم
  48. امنیت
  49. Omarchy روی...
  50. نصب دوگانه
  51. نصب‌های بدون ناظر

راهنما

نوار بالایی

نوار باریک بالای صفحه‌تان، نوار Omarchy است. این یک نوار وضعیتِ وصله‌پینه‌ای نیست، بلکه بخشی از پوسته Omarchy است؛ همان فرایند دیرپای Quickshell که منو، اعلان‌ها، پنجره‌های بازشوی OSD و صفحه قفل را هم رسم می‌کند. به همین دلیل است که با همه‌چیز دیگر بی‌نقص هماهنگ می‌شود و به همین دلیل یک پنل فوراً باز می‌شود، به‌جای اینکه یک برنامه جدید اجرا شود.

همچنین تنها بخش دسکتاپ است که همیشه روی صفحه می‌ماند، پس ارزشش را دارد که بدانید همه آن نمادهای کوچک چه کار می‌کنند.

به‌طور پیش‌فرض چه چیزهایی روی آن است

نوار سه بخش دارد. در سمت چپ، لوگوی Omarchy (اجرا‌کننده منو) و نشانگرهای فضای کاری قرار دارند. در مرکز، نشانگرهای وضعیت، ساعت، Elsewhen (یک ساعت جهانی)، آب‌وهوا و یک نشان به‌روزرسانی Omarchy را می‌بینید. در سمت راست: سینی سیستم، چیدمان صفحه‌کلید (وقتی بیش از یکی پیکربندی شده باشد)، agents، bluetooth، شبکه، صدا، نمایشگر و توان.

چند مورد از این‌ها فقط وقتی ظاهر می‌شوند که حرفی برای گفتن داشته باشند. چیدمان صفحه‌کلید فقط اگر بیش از یک چیدمان پیکربندی کرده باشید ظاهر می‌شود. نشان به‌روزرسانی فقط وقتی ظاهر می‌شود که یک به‌روزرسانی Omarchy در انتظار باشد. و نماد agents اولین باری ظاهر می‌شود که Omarchy استفاده از کدنویسی با هوش مصنوعی را روی دستگاه پیدا کند (ببینید: هوش مصنوعی).

کلیک کردن این‌طرف و آن‌طرف

تقریباً هر ابزارک با کلیک چپ، راست و وسط کاری انجام می‌دهد و چند مورد هم به اسکرول پاسخ می‌دهند. این همان بخشی است که مردم از دست می‌دهند - خیلی از چیزهای خوب زیر دکمه‌های راست و وسط پنهان شده‌اند.

ابزارک چپ راست وسط / اسکرول
منو منوی Omarchy ترمینال جدید -
فضاهای کاری تمرکز روی آن فضای کاری در این نمایشگر - اسکرول: فضای کاری بعدی/قبلی
ساعت پنجره بازشوی تقویم چرخش قالب برچسب وسط: انتخابگر منطقه زمانی
آب‌وهوا پنجره بازشوی پیش‌بینی آب‌وهوای کامل به‌صورت یک اعلان وسط: تازه‌سازی
صدا پنل صدا بی‌صدا وسط: پنل · اسکرول: بلندی صدا
میکروفون بی‌صدا کردن میکروفون - وسط: پنل صدا · اسکرول: بلندی صدای ورودی
شبکه پنل شبکه - -
Bluetooth پنل Bluetooth روشن/خاموش کردن رادیو -
نمایشگر پنل نمایشگر - اسکرول: روشنایی
توان پنل توان روشن/خاموش کردن درصد باتری -
رسانه پخش/توقف پنجره بازشوی کاور آلبوم وسط: بعدی · اسکرول: قبلی/بعدی
Agents پنل Agents اجرای agent شما وسط: اشتراک بعدی
سینی نگه داشتن نشانگر برای آشکار کردن کشو راست روی شورون برای مدیریت -
به‌روزرسانی Omarchy اجرای به‌روزرسانی - -

همه‌چیز در آن جدول از همان ابتدا روی نوار شما نیست. ابزارک رسانه (در حال پخش MPRIS، با آهنگ و هنرمندِ در حال اسکرول) و ابزارک میکروفون هر دو داخلی هستند اما به‌طور پیش‌فرض خاموش‌اند - اگر آن‌ها را می‌خواهید اضافه‌شان کنید، همان‌طور که در ادامه توضیح داده شده است.

پنل‌ها

کلیک کردن روی یک نماد نوار یک پنل باز می‌کند، که یک پنجره بازشوی درست‌وحسابی با لغزنده‌ها، فهرست‌ها و پیمایش با صفحه‌کلید است، نه یک راهنمای شناور. هر کدام هم یک میانبر دارند، تا هرگز مجبور نباشید یک نماد 16 پیکسلی را هدف بگیرید:

میانبر پنل
Super + Ctrl + A صدا
Super + Ctrl + N شبکه
Super + Ctrl + B Bluetooth
Super + Ctrl + D نمایشگر
Super + Ctrl + P توان
Super + Ctrl + Alt + D تقویم
Super + Ctrl + Alt + E ساعت جهانی
Super + Ctrl + 1-9 روشن/خاموش کردن nامین پنل در بخش راست

پنل‌ها فقط برای نمایش اطلاعات نیستند. آن‌ها جایی هستند که واقعاً کار را انجام می‌دهید:

  • صدا یک لغزنده بلندی صدای اصلی، یک انتخابگر دستگاه خروجی و یک میکسر برای هر برنامه دارد، تا بتوانید صدای همان یک زبانه مرورگر را کم کنید بدون اینکه به بقیه‌چیزها دست بزنید.
  • شبکه برای Wi-Fi جستجو می‌کند، قدرت سیگنال را نشان می‌دهد، متصل می‌شود و به شما امکان می‌دهد یک ارائه‌دهنده DNS انتخاب کنید.
  • Bluetooth دستگاه‌های شما را با اتصال/قطع اتصال و سطح باتری فهرست می‌کند.
  • توان آمار باتری را نشان می‌دهد، پروفایل‌های توان را عوض می‌کند (یک انتخاب جدا برای باتری و AC به خاطر می‌سپارد) و مقداری اطلاعات سیستم چاپ می‌کند.
  • نمایشگر یک لغزنده روشنایی، اندازه متن، پیش‌تنظیم‌های مقیاس‌بندی نمایشگر و - وقتی بیش از یک صفحه دارید - کنترل‌های هر نمایشگر را دارد. برای داستان عمیق‌تر ببینید: نمایشگرها.
  • ساعت یک جدول ماهانه با شماره هفته‌های ISO و جابه‌جایی بین ماه‌ها باز می‌کند.
  • ساعت جهانی برای هر شهر یک ردیف نگه می‌دارد، با آب‌وهوای آن و اینکه روزش چطور پیش می‌رود. جستجو شهرها را هم مثل مناطق زمانی پیدا می‌کند، پس Fort Lauderdale همان Fort Lauderdale است و نه New York. اگر خط بالای صفحه شهر اشتباهی را نام می‌برد، رویش کلیک کنید و بگویید کجا هستید؛ جایی در یک منطقه زمانی دیگر انتخاب کنید و ساعت سیستم هم به آنجا می‌رود، که وقتی سفر می‌کنید به کار می‌آید. نشانگر را روی یک شهر نگه دارید و روی دکمه شخص کلیک کنید تا بگویید چه کسی آنجا زندگی می‌کند - نام‌های ساده، یا شناسه‌های GitHub با @ تا چهره‌هایشان را هم بیاورد.

هر پنل صفحه‌کلید را هم مثل ماوس می‌پذیرد: جهت‌نما‌ها حرکت می‌کنند، Return فعال می‌کند، Tab به پنل همسایه می‌رود و Escape می‌بندد.

Super + Ctrl + 1-9 پنل‌ها را در بخش راست از چپ به راست می‌شمارد و از سینی رد می‌شود، چون سینی پنل مخصوص خودش را ندارد. پس عدد با نمادی که به آن اشاره می‌کردید جور درمی‌آید.

Tailscale و Dropbox

دو ابزارک دیگر فقط وقتی روی نوار ظاهر می‌شوند که سرویس مربوطه را از Install → Service نصب کنید، و هر دو ارزش شناختن دارند چون بیشتر از گزارش وضعیت کار انجام می‌دهند.

پنل Tailscale به tailnet متصل و از آن جدا می‌شود، بین حساب‌ها جابه‌جا می‌شود و یک گره خروجی انتخاب می‌کند (هم دستگاه‌های خودتان و هم مناطق Mullvad در آن فهرست ظاهر می‌شوند). همچنین دستگاه‌های شما را مرور می‌کند - و وقتی یکی انتخاب شده باشد، s فایل‌ها را از طریق Taildrop برای آن می‌فرستد، که سریع‌ترین راه برای انتقال یک فایل به گوشی یا لپ‌تاپ دیگرتان است. c، IP دستگاه را کپی می‌کند، n نامش را و d نام کامل DNS آن را. روی هر ردیف دستگاه یک دکمه ارسال هم هست، اگر ترجیح می‌دهید کلیک کنید. همین کار از ترمینال این است: omarchy tailscale send <machine> [file...].

پنل Dropbox ورود را مدیریت می‌کند، نشان می‌دهد چقدر از فضای ذخیره‌سازی را استفاده کرده‌اید و فایل‌های اخیراً همگام‌سازی‌شده را فهرست می‌کند.

حذف هر یک از این سرویس‌ها ابزارکش را دوباره از نوار برمی‌دارد.

نشانگرها

خوشه کوچک در مرکز، ابزارک نشانگرهاست. این‌ها نمادهای وضعیت برای حالت‌هایی هستند که روشن کرده‌اید: مزاحم نشوید، نور شب، یک یادآور در صف، یک ضبط فعال صفحه، بیدار ماندن و دیکته. وقتی حالت فعال باشد روشن می‌شوند و در غیر این صورت سر راه نمی‌ایستند - نشانگر را هر جای نوار نگه دارید تا آن‌هایی را که غیرفعال‌اند یواشکی ببینید. کلیک کردن روی یک نشانگر آن حالت را روشن/خاموش می‌کند. یکی دیگر فقط برای وضعیت است: یک نشست راه دور تا وقتی کسی از طریق gliff به این دستگاه متصل است قرمز می‌ماند.

اگر ترجیح می‌دهید همیشه قابل مشاهده باشند، alwaysShow را روی ابزارک روی true بگذارید. و اگر فقط به بعضی از آن‌ها اهمیت می‌دهید، آن‌هایی را که می‌خواهید در items فهرست کنید: ["Dnd", "Reminder", "NightLight"]. می‌توانید بیش از یک ابزارک نشانگر داشته باشید، تا بخش‌های مختلف بتوانند زیرمجموعه‌های متفاوتی نشان دهند.

جابه‌جا کردن چیدمان نوار

نوار خودش خودش را پیکربندی می‌کند. مجبور نیستید برای جابه‌جا کردن چیزها یک فایل پیکربندی باز کنید.

یک تکه خالی از نوار دور مرکز را بگیرید و به سمت لبه دیگری از صفحه بکشید، و نوار به آنجا می‌رود - چپ، راست، بالا یا پایین، همه کار می‌کنند و هر ابزارک خودش را وفق می‌دهد (نوارهای عمودی به شکل‌های فشرده فقط‌نمادی برمی‌گردند). کلیک و نگه داشتن همان کشیدن را شروع می‌کند. روی همان فضای خالی دو بار کلیک چپ کنید تا پس‌زمینه نوار از شفاف به شیشه‌ای به مات بچرخد. و هر ابزارکی را بکشید تا ترتیبش را عوض کنید یا آن را به بخش دیگری بیندازید؛ ابزارک‌های دیگر از هم فاصله می‌گیرند تا جایی که قرار است فرود بیاید جا باز کنند.

وسط نوار یک جعبه است: هرچه در آن باشد به‌صورت یک گروه در مرکز می‌ماند و ابزارک‌های دو طرف آن از لبه‌هایش آویزان می‌شوند. وقتی یک ابزارک را می‌کشید جعبه به‌صورت یک خط دور نمایش داده می‌شود، یا وقتی خالی است به‌صورت یک خط در عرض نوار، و می‌توانید آن را درون آن یا کنار آن بیندازید. وقتی یک انداختن قرار باشد در جعبه فرود بیاید، جعبه بزرگ می‌شود تا ابزارک را در خود بگیرد.

ابزارکی که می‌خواهید دوروبر باشد اما همیشه در معرض دید نباشد می‌تواند به کشوی سینی برود: آن را روی سینی بکشید و کشو باز می‌شود تا آن را بگیرد. آنجا بعد از نمادهای برنامه می‌نشیند، هر وقت کشو ظاهر شود ظاهر می‌شود و تا وقتی پنلش باز است کشویش را باز نگه می‌دارد. آن را دوباره روی نوار بکشید تا سر جایش برگردد.

اگر ترجیح می‌دهید از یک منو انتخاب کنید، ظاهر → نوار منو موقعیت را دارد و پس‌زمینه نوار انتخاب می‌کند نوار چطور رسم شود: نوار مات، نوار شیشه‌ای (شفاف، با محو شدن آنچه پشت آن است) یا نوار شفاف.

همین چیزها دستور هم دارند، که همان چیزی است که برای یک راه‌اندازی dotfiles می‌خواهید:

omarchy bar position bottom
omarchy bar background glassy  # opaque, glassy, none, or cycle
omarchy bar move omarchy.weather --section centerBegin --index 0
omarchy bar move omarchy.bluetooth --section tray  # into the tray's drawer
omarchy bar set omarchy.clock format "HH:mm"
omarchy bar defaults          # back to the shipped layout

برای اضافه یا حذف کامل یک ابزارک، از دستورات افزونه استفاده کنید. omarchy plugin list هر ابزارکی را که پوسته می‌شناسد با شناسه‌اش چاپ می‌کند، و بعد:

omarchy plugin enable omarchy.media --section centerEnd
omarchy plugin disable omarchy.weather

پنهان کردن نوار

Super + Shift + Space نوار را خاموش و دوباره روشن می‌کند بدون اینکه پوسته را بکشد - پنل‌ها و میانبرها همچنان کار می‌کنند، فقط پیکسل‌ها را پس می‌گیرید. در منو هم زیر ظاهر → نوار منو → پنهان کردن نوار هست.

فایل پیکربندی

همه آن در ~/.config/omarchy/shell.json، زیر کلید bar ذخیره می‌شود. این یک نسخه خلاصه‌شده است:

{
  "version": 1,
  "bar": {
    "position": "top",
    "background": "opaque",
    "layout": {
      "left": [{ "id": "omarchy.menu" }, { "id": "omarchy.workspaces" }],
      "centerBegin": [{ "id": "omarchy.indicators" }],
      "center": [{ "id": "omarchy.clock", "format": "HH:mm" }],
      "centerEnd": [{ "id": "omarchy.weather" }],
      "right": [{ "id": "omarchy.audio" }, { "id": "omarchy.power" }]
    }
  }
}

هر ابزارک یک ورودی در یکی از پنج آرایه چیدمان است و تنظیماتش درون همان ورودی می‌نشیند - هیچ فایل تنظیمات جداگانه‌ای و هیچ زیرشیء config وجود ندارد. format ساعت، formatAlt (آنچه کلیک راست به آن می‌چرخد) و verticalFormat همه همان‌جا روی { "id": "omarchy.clock" } زندگی می‌کنند.

center جعبه وسط نوار است: همه‌چیز در آن به‌صورت یک گروه در مرکز صفحه قرار می‌گیرد. centerBegin و centerEnd از دو طرف جعبه آویزان می‌شوند، و این‌طوری است که ساعت دقیقاً در مرکز می‌ماند حتی وقتی آب‌وهوا و نشان به‌روزرسانی می‌آیند و می‌روند. بیش از یک ابزارک در center بگذارید و آن‌ها با هم در مرکز قرار می‌گیرند؛ آن را خالی بگذارید و centerBegin و centerEnd در وسط نوار به هم می‌رسند.

یک قانون که ارزش درونی کردن دارد: وقتی shell.json خودتان را داشته باشید، همان مرجع نهایی است. تا وقتی چیزی را شخصی‌سازی نکنید، پوسته فایل پیش‌فرض Omarchy را می‌خواند. لحظه‌ای که یک ابزارک را بکشید، omarchy bar را اجرا کنید یا خودتان فایل را ویرایش کنید، مالک آن می‌شوید - هیچ ادغام عمیقی وجود ندارد، پس ابزارک‌های پیش‌فرض جدید در نسخه‌های آینده Omarchy خودبه‌خود روی نوار شما ظاهر نمی‌شوند. omarchy bar defaults هر وقت یک شروع پاک بخواهید، چیدمان عرضه‌شده را برمی‌گرداند.

همان فایل زمان‌بندی‌های بیکاری شما را هم در سطح بالا، بیرون از کلید bar نگه می‌دارد: idle.screensaver و idle.lock، هر دو بر حسب ثانیه از وقتی بیکار شده‌اید. پس محافظ صفحه پیش‌فرض در 150 ثانیه فعال می‌شود و قفل در 300.