پرش به محتوا
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 عمدتاً از طریق به‌اصطلاح دات‌فایل‌هایی که در ~/.config زندگی می‌کنند پیکربندی می‌شود. آن‌ها فایل‌های شما برای تغییرات شما در نظر گرفته می‌شوند. فایل‌هایی که در /usr/share/omarchy زندگی می‌کنند متعلق به خود Omarchy هستند، و نباید با آن‌ها ور بروید. اگر نیاز دارید چیزی در /usr/share/omarchy تغییر دهید، باید به جای آن مقدار را در ~/.config بازنویسی کنید.

پیکربندی‌های کلیدی را می‌توان مستقیم از منوی Omarchy (Super + Space) ویرایش کرد، مانند تنظیمات > Monitors، تنظیمات > Keybindings، تنظیمات > Input و تنظیمات > Config > [file]. وقتی این‌طور انجام می‌دهید، هر فرایندی که پس از ویرایش پیکربندی نیاز به راه‌اندازی مجدد دارد به‌طور خودکار پس از خروج از ویرایشگر خواهد شد (Neovim به‌طور پیش‌فرض - :wq، به یاد داشته باشید! - اما می‌توانید آن را از طریق تنظیمات > Defaults > Editor تغییر دهید).

در اینجا فهرستی از فایل‌های کلیدی در ~/.config و آنچه کنترل می‌کنند آمده است:

File Purpose
~/.config/hypr/hyprland.lua پیکربندی اصلی Hyprland. پیش‌فرض‌های Omarchy به‌علاوه فایل‌های بازنویسی شما در زیر را بار می‌کند. درباره پیکربندی‌های Hyprland بیشتر بدانید.
~/.config/hypr/bindings.lua میانبرهای خود شما و بازنویسی‌های پیش‌فرض‌ها.
~/.config/hypr/monitors.lua مانیتورها، وضوح و موقعیت شما را کنترل می‌کند.
~/.config/hypr/input.lua چیدمان صفحه‌کلید، ماوس و تنظیمات تاچ‌پد شما را کنترل می‌کند.
~/.config/hypr/looknfeel.lua فاصله‌ها، حاشیه‌ها، پویانمایی‌ها و بقیه ظاهر را کنترل می‌کند.
~/.config/hypr/autostart.lua فرایندهای اضافی شروع‌شده با نشست را کنترل می‌کند.
~/.config/omarchy/shell.json شل Omarchy را کنترل می‌کند: موقعیت نوار، چیدمان و ویجت‌ها، به‌علاوه محافظ صفحه، قفل و زمان‌بندی‌های بیکار.
~/.config/foot/foot.ini ترمینال شما را کنترل می‌کند (foot پیش‌فرض است).
~/.XCompose ایموجی دسترسی سریع و تکمیل خودکار نام/ایمیل شما را تعریف می‌کند. مطمئن شوید پس از انجام تغییرات omarchy-restart-xcompose را اجرا کنید.

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

شروع برنامه‌های خود با نشست

اگر می‌خواهید چیزی هر بار که وارد می‌شوید اجرا شود - یک دیمون همگام‌سازی، یک برنامه گپ، اسکریپت خودتان - آن را در ~/.config/hypr/autostart.lua بگذارید:

o.launch_on_start("my-service")

این دستور را به‌عنوان بخشی از نشست شروع می‌کند، پس وقتی دوباره خارج می‌شوید به‌درستی پاک‌سازی می‌شود.

اجرای اسکریپت‌ها روی رویدادهای سیستم

Omarchy در تعداد کمی از لحظات قلاب‌هایی شلیک می‌کند، و می‌توانید اسکریپت‌های خود را به آن‌ها آویزان کنید. آن‌ها در ~/.config/omarchy/hooks/<event>.d/ زندگی می‌کنند، یک پوشه به ازای هر رویداد، و هر فایل اجرایی در آنجا وقتی رویداد اتفاق می‌افتد اجرا می‌شود:

Event When it runs
post-boot درست پس از شروع دسکتاپ
post-update نزدیک پایان omarchy update، پس از بسته‌ها، مهاجرت‌ها و راه‌اندازی مجدد خدمات، پیش از به‌روزرسانی ابزارهای mise
pre-refresh-pacman پس از همگام‌سازی دوباره پیکربندی بسته توسط omarchy refresh pacman، پیش از به‌روزرسانی بسته‌ها؛ یک جابه‌جایی کانال آن را در طول همان گام تازه‌سازی اجرا می‌کند
theme-set پس از تغییر تم (نام تم در $1)
font-set پس از تغییر قلم (نام قلم در $1)
battery-low وقتی باتری کم می‌شود (درصد در $1)

قلاب pre-refresh-pacman جایی است که مخازن سفارشی یا خطوط IgnorePkg تعلق دارند، چون پیش از تراکنش بسته اجرا می‌شود. هر دو قلاب مرتبط با به‌روزرسانی به‌عنوان کاربر شما پس از پاک کردن مجوز sudo کش‌شده خود توسط Omarchy اجرا می‌شوند، پس قلابی که از sudo استفاده می‌کند به مجوز خودش نیاز دارد و ممکن است گذرواژه شما را بپرسد.

هر یک از آن پوشه‌ها از قبل یک فایل .sample دارد که شکل یک قلاب را نشان می‌دهد - .sample را از نام حذف کنید تا آن را به کار بیندازید. برای نصب اسکریپتی که جای دیگری نوشته‌اید، از omarchy hook install post-boot ~/my-hook استفاده کنید، که آن را کپی می‌کند و اجرایی می‌کند.

افزودن ورودی‌های منوی خود

منوی Omarchy (Super + Space) را می‌توان با ردیف‌های خود با ویرایش ~/.config/omarchy/extensions/omarchy-menu.jsonc گسترش داد. ورودی‌ها با یک شناسه نقطه‌دار کلیدگذاری می‌شوند، و شناسه همان چیزی است که آن‌ها را در درخت قرار می‌دهد، پس personal روی منوی ریشه ظاهر می‌شود و personal.notes داخل آن ظاهر می‌شود:

"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"󰎞","label":"Notes","action":"omarchy-launch-editor ~/notes"},

از یک شناسه موجود دوباره استفاده کنید و آن ردیف را به جای افزودن یک ردیف جدید بازنویسی می‌کنید. فایل با همه فیلدهای موجود مستندشده به‌صورت نظر ارائه می‌شود.

افزودن خروجی‌ها، توابع و نام‌های مستعار شل خود

Omarchy با کلی نام مستعار ارگونومیک و توابع مفید ارائه می‌شود، اما بسیار رایج است که بخواهید مال خود را اضافه کنید. باید هم نام‌های مستعار، هم توابع و هم خروجی‌ها را در ~/.bashrc اضافه کنید. این فایل در به‌روزرسانی‌ها بازنویسی نمی‌شود. اگر می‌خواهید هر یک از پیش‌فرض‌های Omarchy را تغییر دهید، همچنین می‌توانید آن‌ها را با خیال راحت اینجا اضافه کنید.

تغییر فایل‌های داخلی Omarchy

ببینید، این رایانه شماست. می‌توانید هر چه می‌خواهید با آن انجام دهید، اما توصیه نمی‌کنم مستقیم تغییراتی در فایل‌های /usr/share/omarchy انجام دهید. آن‌ها متعلق به بسته pacman Omarchy هستند، پس تغییرات شما به‌سادگی در به‌روزرسانی بعدی بازنویسی می‌شوند. بهتر است فقط هر مقدار پیش‌فرضی را که دوست ندارید در پوشه ~/.config/* بازنویسی کنید.

تقریباً هر چیزی را این‌طور می‌توانید تغییر دهید، مانند میانبرهای پیش‌فرض. فقط ~/.config/hypr/bindings.lua را ویرایش کنید تا، مثلاً، Obsidian را با Joplin جایگزین کنید (با omarchy-pkg-add joplin-bin نصب کنید):

o.rebind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")

o.rebind میانبر موجود را پیش از افزودن جایگزین آن حذف می‌کند. همان آرگومان‌های o.bind را می‌گیرد، از جمله یاورهای اجرا و گزینه‌های میانبر. از o.bind برای افزودن یک میانبر استفاده کنید، یا از hl.unbind برای حذف یکی بدون جایگزینی آن.

اگر اصرار دارید روی فایل‌های داخلی Omarchy هک کنید، از طریق به‌روزرسانی > Channel > Dev به کانال dev جابه‌جا شوید. این Omarchy را به یک چک‌اوت git از کد منبع در ~/omarchy پیوند می‌دهد، که آزاد هستید تا دلتان می‌خواهد تغییر دهید. هیچ‌کس اینجا نیست که به شما بگوید چه کار کنید!

بازنشانی هر تغییراتی

اگر در نهایت پیکربندی‌ها را به‌هم بریزید، همیشه می‌توانید آن‌ها را از طریق به‌روزرسانی > Config در منوی Omarchy به پیش‌فرض‌ها بازگردانید. یا با اجرای omarchy reinstall configs برای بازنشانی همه چیز.