Mazmunga oʻtish
Chapters
  1. Omarchyga xush kelibsiz!
  2. Boshlash
  3. Mac yoki Windows'dan kelayotganlar uchun
  4. Navigatsiya
  5. Yuqori panel
  6. Mavzular
  7. Tezkor tugmalar
  8. Yagona almashinuv buferi va tarixi
  9. Eslatmalar
  10. Bildirishnomalar
  11. Matn ajratish va diktovka
  12. Skrinshotlar va yozib olish
  13. Almashmalar, Bo‘sh turish va Ekran saqlovchisi
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Ishlab chiqish vositalari
  19. Shell vositalari
  20. Shell funksiyalari
  21. TUIs
  22. GUIlar
  23. Brauzerlar
  24. Tijorat ilovalari/xizmatlari
  25. Veb-ilovalar
  26. Oʻyin
  27. PDFlarni toʻldirish
  28. Windows VM
  29. Boshqa paketlar
  30. Yangilanishlar
  31. Dotfayllar
  32. Shell plaginlari
  33. Monitorlar
  34. Klaviatura, Sichqoncha, Trekpad
  35. Tarmoq
  36. Tizim uyqusi
  37. Apparat autentifikatsiyasi
  38. Shriftlar
  39. Fonlar
  40. Prompt
  41. Brending
  42. Keng tarqalgan tuzatishlar
  43. O'z mavzungizni yaratish
  44. Mac qo'llab-quvvatlovi
  45. Muammolarni hal qilish
  46. FAQ
  47. Tizim snapshotlari
  48. Xavfsizlik
  49. Omarchy ...da
  50. Dual Boot o'rnatish
  51. Nazoratsiz o'rnatishlar

Qoʻllanma

Shell plaginlari

Omarchy ish stoli omarchy-shell deb ataluvchi bitta uzoq yashovchi Quickshell jarayoni sifatida ishlaydi va ekranda koʻrgan deyarli hamma narsa uning ichidagi plagindir. Panel plagindir. Undan tushadigan panellar, emoji tanlagich va almashish buferi boshqaruvchisi kabi toʻliq ekran ustqoplamalari, Omarchy menyusining oʻzi, qulflash ekrani, polkit dialogi va batareyangizni kuzatuvchi hamda kechasi ekraningizni isituvchi boshsiz xizmatlar ham shunday.

Bu shunchaki amalga oshirish tafsiloti emas. Bu siz ish stolining qismlarini oʻchirishingiz, ularni almashtirishingiz yoki Omarchy manbasining bir qatoriga tegmasdan oʻzingiznikini yozishingiz mumkinligini anglatadi.

Birinchi tomon plaginlari Omarchy bilan keladi va $OMARCHY_PATH/shell/plugins/ da yashaydi. Oʻzingiz qoʻshgan har qanday narsa - oʻz tajribalaringiz yoki GitHub da topgan biror narsangiz - ~/.config/omarchy/plugins/ da yashaydi. Ikkalasi ham boshlangʻichda bir xil tarzda topiladi, lekin oʻrnatilganlar ishonchli shell interfeyslarini oladi, uchinchi tomon plaginlari esa oʻz xizmati va hayot aylanishi bilan cheklangan interfeys oladi. Oʻrnatilganlarning klonlari faqat asl xulq-atvor uchun kerak boʻlgan manbaga xos konfiguratsiya va UI chaqiruvlarini saqlaydi.

Sizda nima borligini koʻrish

omarchy plugin list

Bu har bir topilgan plaginni uning id si, yoqilganligi, birinchi tomon yoki uchinchi tomon ekanligi, uning turlari va koʻrinish nomi bilan chop etadi. Agar uni boshqa narsaga berayotgan boʻlsangiz, --json ni qoʻshing.

Plagin id lari nom maydoniga ega. Oʻrnatilganlarning hammasi omarchy. bilan boshlanadi - omarchy.clock, omarchy.network, omarchy.notifications - va oʻsha nom maydoni zaxiralangan, shuning uchun uchinchi tomon plagini hech qachon uni daʼvo qila olmaydi.

Ularni yoqish va oʻchirish

omarchy plugin enable omarchy.tailscale
omarchy plugin disable omarchy.weather

Yoki menyudan foydalaning: Sozlash > Plugins da Enable, Disable, Add, Clone va Remove bor, har biri faqat oʻsha amal uchun mantiqiy boʻlgan plaginlarni taklif qiluvchi tanlagich bilan.

Yoqilgan holat ~/.config/omarchy/shell.json da saqlanadi va qoida ikki turdagi plagin uchun biroz farq qiladi. Uchinchi tomon plagini uning id si oʻsha faylning qayeridadir paydo boʻlganda aynan yoqilgan boʻladi - panel tartibi yozuvi sifatida, plugins[] dagi yozuv sifatida yoki bar.id sifatida. Panel vidjetlari boʻlmagan birinchi tomon plaginlari teskari ravishda: ular standart tarzda yoniq va faqat disabledPlugins[] da roʻyxatga olinishi orqali oʻchadi.

Toʻliq panel plagini umuman oʻchirilgan holatga ega emas. Har doim aynan bitta panel bor, shuning uchun uni boshqasini yoqish orqali almashtirasiz. Panel vidjeti joylashuvi yuqori panel da qoplangan.

Git dan plagin qoʻshish

Uchinchi tomon plagini shunchaki ildizida manifest.json ga ega git repo dir.

omarchy plugin add https://github.com/acme/omarchy-weather.git --enable

U biror narsa qilishidan oldin, u sizga ochiq aytadiki, plaginlar uzoq yashovchi shell jarayoningiz ichida ixtiyoriy, sandboxsiz kod sifatida ishlaydi, sizga URL ni koʻrsatadi va tasdiqlashni soʻraydi. Buni jiddiy qabul qiling. Uchinchi tomon plagin interfeysi autentifikatsiya xizmatlarini toʻgʻridan-toʻgʻri ochmaydi va almashtirish paneli sozlangan autentifikatsiya boʻlmagan UI uchun faqat cheklangan imkoniyatlar oladi. Vizual plaginlar baribir shellning QML sahnasini ulashadi va oddiy ona obʼektlarni aylanib oʻtishi mumkin, barcha plagin kodi esa foydalanuvchi hisobingiz yeta oladigan hamma narsa bilan ishlaydi. Autentifikatsiya holati oʻsha xizmatlarni yetib boʻlmaydigan host obʼekt grafidan tashqarida saqlash orqali alohida himoyalanadi. Faqat ishlatishga tayyor boʻlgan repolarni qoʻshing va ularni yoqishdan oldin oʻqing.

Almashtirish paneli oʻrnatilgan vidjetlarni chizishi mumkin, lekin xizmatga tayangan uchinchi tomon vidjetlari u yerda kamaygan funksionallikka ega boʻlishi mumkin, chunki panel boshqa plaginning jonli xizmat obʼektini soʻray olmaydi. Agar bunday vidjetga sherik xizmati kerak boʻlsa, oʻrnatilgan omarchy.bar ga qayting.

Keyin u reponi oraliq katalogga klonlaydi, manifestni tekshiradi, agar boshqa plagin allaqachon oʻsha id ni daʼvo qilsa oʻrnatishni rad etadi va uni ~/.config/omarchy/plugins/<id>/ ga koʻchiradi. --enable siz u hozir uni yoqishni xohlaysizmi deb soʻraydi va siz yoʻq deyib avval kodni oʻqib chiqishingiz mumkin. U hech qachon plagindan biror narsani ishga tushirmaydi, hech qachon oʻrnatish hookini bajarmaydi va hech qachon sudo soʻramaydi - u fayllarni klonlaydi, manifestni tekshiradi va IPC orqali bitni aylantiradi.

Yangilash oʻsha bir xil checkoutning fast-forward tortilishidir:

omarchy plugin update acme.weather
omarchy plugin update

Id siz u sizda bor har bir git tomonidan boshqariladigan plaginni yangilaydi. U fargini qoʻllashdan oldin koʻrsatadi, agar u fast-forward qilib oʻta olmaydigan mahalliy oʻzgarishlaringiz boʻlsa yangilashni rad etadi va yangi reviziya tekshirishdan oʻtmasa qaytarib beradi.

omarchy plugin remove acme.weather

Olib tashlash avval plaginni oʻchiradi, keyin agar u git checkout boʻlsa uni oʻchiradi (repo baribir yuqori oqimda) yoki agar u symlink boʻlsa uni uzadi. Git repori yoʻq qoʻlda yasalgan plagin jildi toʻgʻridan-toʻgʻri oʻchirish oʻrniga plaginlar katalogi ichidagi vaqt tamgʻalangan zaxiraga koʻchiriladi.

Uni oʻzgartirish uchun oʻrnatilganni klonlash

Bu mening sevimli qismim. Agar oʻrnatilgan vidjetning qanday ishlashini oʻzgartirmoqchi boʻlsangiz, $OMARCHY_PATH ostidagi fayllarni tahrirlamang - ular paketga tegishli va keyingi yangilanish ularni ustiga yozadi. Uning oʻrniga uni klonlang:

omarchy plugin clone omarchy.clock

Bu butun plaginni ~/.config/omarchy/plugins/dhh.clock ga nusxalaydi (sizning foydalanuvchi nomingiz, menikimas), uni “My Clock” deb qayta nomlaydi, yoqadi va shellni oʻrnatilgandan sizning nusxangizga oʻtkazadi - mavjud panel vidjetining joyi va sozlamalarini saqlab qoladi. Yangi katalogni darhol $EDITOR ingizda ochish uchun --edit ni qoʻshing, menyuning Sozlash > Plugins > Clone Plugin i siz uchun shuni qiladi.

Foydalanuvchi nomi prefiksi kloningiz id sini sizniki qilib saqlaydi, shuning uchun uni ulashish boshqalarniki bilan toʻqnashmaydi. Asl oʻrnatilgan id ga qilingan chaqiruvlar kloningizga yoʻnaltiriladi, shuning uchun omarchy.clock ga ishora qilgan hech narsani yangilash kerak emas. Va agar uni tartibsiz qilib qoʻysangiz, omarchy plugin remove dhh.clock oʻrnatilganni qaytarib qoʻyadi.

~/.config/omarchy/plugins/ ostidagi istalgan joydagi faylni saqlash plagin kodini avtomatik qayta yuklaydi, shuning uchun muharrirni ochiq qoldirib, oʻzgarishlaringiz tushishini kuzatishingiz mumkin.

Oʻzingiznikini yozish

Plagin manifest.json va biroz QML ga ega katalogdir. Manifest schemaVersion: 1, id, name, version, bir yoki bir nechta kinds va har bir tur uchun QML fayliga ishora qiluvchi entryPoints obʼektini eʼlon qiladi:

Tur U nima
bar-widget Faol panel boʻlimga tushira oladigan komponent
panel Doimiy yoki chaqirilgan suzuvchi oyna
overlay Toʻliq ekran ustqoplama
menu Chaqirilgan menyu yuzasi
service UI si yoʻq boshsiz singleton
bar Oʻrnatilganni almashtiruvchi toʻliq panel

Plagin bir vaqtning oʻzida bir nechta turni eʼlon qilishi mumkin - media plagini ham service, ham bar-widget dir. Panel vidjetlari koʻrinish nomi, kategoriyasi, ixtiyoriy defaultSection va panelda bittadan koʻp boʻlish mantiqiymi yoki yoʻqligini aytuvchi allowMultiple bilan qoʻshimcha barWidget blokini oladi. Koʻpchilik vidjetlar uni false ga belgilaydi; kengaytiruvchilar va koʻrsatkichlar uni true ga belgilaydi.

Biror narsani chop etishdan oldin uni tekshiring:

omarchy plugin validate ./my-plugin

Bu shell yuklash vaqtida bajaradigan bir xil tekshiruvlarni ishga tushiradi: sxema versiyasi, talab qilinadigan maydonlar, zaxiralanmagan id, xavfsiz nisbiy yoʻllar boʻlgan va haqiqatan ham mavjud boʻlgan kirish nuqtalari, daʼvo qilgan har bir turingiz uchun kirish nuqtasi va jild ichida hech qanday symlinklar yoʻqligi.

Plagin dasturlash uchun shell maʼlumotnoma va birinchi tomon plagin katalogi ga qarang.

Oʻzingiznikini dunyo bilan ulashish

Oʻzingizga yoqqan narsani yasaganingizdan soʻng, uni ommaviy git reporiga qoʻying. Bu butun tarqatish mexanizmidir - har kim keyin URL ingizga qarshi omarchy plugin add ni ishga tushirib, uni soniyalar ichida ishlatishi mumkin.

Odamlar uni haqiqatan ham topishiga yordam berish uchun uni plugins.omarchy.org da roʻyxat qiling. Bu Omarchy shell plaginlari uchun bozor va siz yozmoqchi boʻlgan vidjetni kimdir allaqachon yasagan-yasamagani haqida hayron boʻlganingizda qarash kerak boʻlgan birinchi joy. Boshlashdan oldin uni koʻrib chiqing!