Preskočiť na obsah
Chapters
  1. Vitajte v Omarchy!
  2. Začíname
  3. Prechod z Macu alebo Windowsu
  4. Navigácia
  5. Horný panel
  6. Témy
  7. Klávesové skratky
  8. Jednotná schránka a história
  9. Pripomienky
  10. Oznámenia
  11. Extrakcia textu a diktovanie
  12. Snímky obrazovky a nahrávanie
  13. Prepínače, nečinnosť a šetrič obrazovky
  14. Omarchy CLI
  15. Terminál
  16. Neovim
  17. AI
  18. Vývojárske nástroje
  19. Shell nástroje
  20. Shell funkcie
  21. TUIs
  22. Grafické rozhrania
  23. Prehliadače
  24. Komerčné aplikácie/služby
  25. Webové aplikácie
  26. Hranie hier
  27. Vypĺňanie PDF
  28. Virtuálny stroj s Windowsom
  29. Ostatné balíčky
  30. Aktualizácie
  31. Dotfiles
  32. Pluginy shellu
  33. Monitory
  34. Klávesnica, myš, trackpad
  35. Sieť
  36. Spánok systému
  37. Hardvérová autentifikácia
  38. Písma
  39. Pozadia
  40. Výzva príkazového riadka
  41. Branding
  42. Bežné úpravy
  43. Vytvorenie vlastnej témy
  44. Podpora pre Mac
  45. Riešenie problémov
  46. Časté otázky
  47. Systémové snímky
  48. Bezpečnosť
  49. Omarchy na...
  50. Inštalácia Dual Boot
  51. Bezobslužné inštalácie

Manuál

Pluginy shellu

Pracovná plocha Omarchy beží ako jeden dlho žijúci proces Quickshell s názvom omarchy-shell a takmer všetko, čo vidíš na obrazovke, je plugin vnútri neho. Lišta je plugin. Rovnako panely, ktoré z nej padajú, celoobrazovkové prekrytia ako výber emoji a správca schránky, samotné menu Omarchy, zamykacia obrazovka, dialóg polkit a bezhlavé služby, ktoré sledujú tvoju batériu a v noci zohrievajú tvoju obrazovku.

To nie je len detail implementácie. To znamená, že môžeš vypnúť časti pracovnej plochy, vymeniť ich alebo napísať vlastné bez toho, aby si sa dotkol jediného riadka zdrojového kódu Omarchy.

Pluginy prvej strany sa dodávajú s Omarchy a žijú v $OMARCHY_PATH/shell/plugins/. Všetko, čo pridáš sám - vlastné experimenty alebo niečo, čo si našiel na GitHube - žije v ~/.config/omarchy/plugins/. Oba sa zisťujú rovnakým spôsobom pri spustení, ale zabudované získavajú dôveryhodné rozhrania shellu, zatiaľ čo pluginy tretích strán získavajú obmedzené rozhranie obmedzené na ich vlastnú službu a životný cyklus. Klony zabudovaných si zachovávajú len konfiguráciu špecifickú pre zdroj a volania používateľského rozhrania potrebné pre pôvodné správanie.

Zobrazenie toho, čo máš

omarchy plugin list

Tým sa vypíše každý zistený plugin s jeho id, či je zapnutý, či je prvej alebo tretej strany, jeho druhmi a jeho zobrazovaným názvom. Pridaj --json, ak ho posúvaš niečomu inému.

Id pluginov sú v menných priestoroch. Zabudované sa všetky začínajú reťazcom omarchy. - omarchy.clock, omarchy.network, omarchy.notifications - a tento menný priestor je vyhradený, takže plugin tretej strany si ho nikdy nemôže nárokovať.

Zapínanie a vypínanie

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

Alebo použi menu: Nastavenie > Pluginy má položky Zapnúť, Vypnúť, Pridať, Klonovať a Odstrániť, každú s výberom, ktorý ponúka len pluginy, ktoré majú pre danú akciu zmysel.

Stav zapnutia je uložený v ~/.config/omarchy/shell.json a pravidlo sa pre tieto dva druhy pluginov mierne líši. Plugin tretej strany je zapnutý presne vtedy, keď sa jeho id objaví niekde v tomto súbore - ako položka rozloženia lišty, ako položka v plugins[] alebo ako bar.id. Pluginy prvej strany, ktoré nie sú widgetmi lišty, fungujú opačne: predvolene sú zapnuté a vypnú sa len uvedením v disabledPlugins[].

Plný plugin lišty vôbec nemá stav vypnutia. Vždy existuje presne jedna lišta, takže ju nahradíš zapnutím inej. Umiestnenie widgetov lišty je popísané v časti horná lišta.

Pridanie pluginu z gitu

Plugin tretej strany je len git repozitár so súborom manifest.json v koreňovom adresári.

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

Skôr než niečo urobí, jasne ti povie, že pluginy bežia ako ľubovoľný, nesandboxovaný kód vnútri tvojho dlho žijúceho procesu shellu, ukáže ti URL a požiada ťa o potvrdenie. Ber to vážne. Rozhranie pluginov tretích strán priamo nesprístupňuje autentifikačné služby a náhradná lišta získava len obmedzené možnosti pre nakonfigurované neautentifikačné používateľské rozhranie. Vizuálne pluginy stále zdieľajú scénu QML shellu a môžu prechádzať bežnými rodičovskými objektmi, zatiaľ čo všetok kód pluginov beží so všetkým, na čo sa môže dostať tvoj používateľský účet. Stav overovania je chránený samostatne tak, že sa tieto služby uchovávajú mimo dosiahnuteľného grafu hostiteľských objektov. Pridávaj len repozitáre, ktoré si ochotný spustiť, a prečítaj si ich, skôr než ich zapneš.

Náhradná lišta môže vykresľovať nainštalované widgety, ale widgety tretích strán podporované službami tam môžu mať obmedzenú funkcionalitu, pretože lišta nesmie požadovať živý objekt služby iného pluginu. Prepni späť na zabudovanú omarchy.bar, ak takýto widget potrebuje svoju sprievodnú službu.

Potom repozitár naklonuje do prípravného (staging) adresára, overí manifest, odmietne inštaláciu, ak si toto id už nárokuje iný plugin, a presunie ho do ~/.config/omarchy/plugins/<id>/. Bez príznaku --enable sa spýta, či ho chceš zapnúť teraz, a môžeš povedať nie a najprv si prejsť kód. Nikdy z pluginu nič nespustí, nikdy nevykoná inštalačný hák a nikdy si nevyžiada sudo - klonuje súbory, skontroluje manifest a prostredníctvom IPC prepne bit.

Aktualizácia je „fast-forward pull“ tohto istého checkoutu:

omarchy plugin update acme.weather
omarchy plugin update

Bez id aktualizuje každý gitom spravovaný plugin, ktorý máš. Pred použitím ti ukáže diff, odmietne aktualizovať, ak máš lokálne zmeny, cez ktoré nemôže urobiť fast-forward, a vráti zmeny späť, ak nová revízia zlyhá pri overovaní.

omarchy plugin remove acme.weather

Odstránenie plugin najprv vypne a potom ho odstráni, ak ide o git checkout (repozitár je stále upstream), alebo ho odlinkuje, ak ide o symbolický odkaz. Ručne vytvorený priečinok pluginu bez git repozitára sa presunie do zálohy s časovou pečiatkou vnútri adresára pluginov, namiesto toho, aby sa úplne odstránil.

Klonovanie zabudovaného pluginu na jeho úpravu

Toto je moja obľúbená časť. Ak chceš zmeniť, ako sa správa zabudovaný widget, neupravuj súbory pod $OMARCHY_PATH - patria balíčku a ďalšia aktualizácia ich prepíše. Namiesto toho ho naklonuj:

omarchy plugin clone omarchy.clock

Tým sa celý plugin skopíruje do ~/.config/omarchy/plugins/dhh.clock (tvoje používateľské meno, nie moje), premenuje sa na „My Clock“, zapne sa a shell sa prepne zo zabudovaného na tvoju kópiu - pričom sa zachová poloha a nastavenia existujúceho widgetu lišty. Pridaj príznak --edit a nový adresár sa okamžite otvorí v tvojom $EDITOR, čo pre teba robí položka menu Nastavenie > Pluginy > Klonovať plugin.

Prefix používateľského mena udržuje id tvojho klonu tvoje, takže jeho zdieľanie nebude kolidovať s cudzím. Volania na pôvodné zabudované id sa smerujú do tvojho klonu, takže nič, čo odkazovalo na omarchy.clock, nepotrebuje aktualizáciu. A ak v ňom narobíš neporiadok, omarchy plugin remove dhh.clock vráti zabudovaný späť.

Uloženie súboru kdekoľvek pod ~/.config/omarchy/plugins/ automaticky znova načíta kód pluginu, takže môžeš nechať editor otvorený a sledovať, ako tvoje zmeny pristávajú.

Písanie vlastného pluginu

Plugin je adresár so súborom manifest.json a nejakým QML. Manifest deklaruje schemaVersion: 1, id, name, version, jeden alebo viacero druhov (kinds) a objekt entryPoints, ktorý ukazuje na súbor QML pre každý druh:

Druh Čo to je
bar-widget Komponent, ktorý môže aktívna lišta vložiť do sekcie
panel Trvalé alebo vyvolávané plávajúce okno
overlay Celoobrazovkové prekrytie
menu Vyvolávaná plocha menu
service Bezhlavý singleton bez používateľského rozhrania
bar Plná lišta, ktorá nahrádza zabudovanú

Plugin môže deklarovať niekoľko druhov naraz - mediálny plugin je service aj bar-widget. Widgety lišty získavajú ďalší blok barWidget so zobrazovaným názvom, kategóriou, voliteľným defaultSection a allowMultiple, čo hovorí, či má zmysel mať ich na lište viac než jeden. Väčšina widgetov to nastavuje na false; rozpery a indikátory to nastavujú na true.

Skôr než niečo zverejníš, skontroluj to:

omarchy plugin validate ./my-plugin

Tým sa spustia tie isté kontroly, ktoré shell vykonáva pri načítavaní: verzia schémy, povinné polia, id, ktoré nie je vyhradené, vstupné body, ktoré sú bezpečnými relatívnymi cestami a skutočne existujú, vstupný bod pre každý druh, ktorý si deklaroval, a žiadne symbolické odkazy kdekoľvek vnútri priečinka.

Informácie o vývoji pluginov nájdeš v referencii shellu a v katalógu pluginov prvej strany.

Zdieľanie svojho pluginu so svetom

Keď vytvoríš niečo, čo sa ti páči, umiestni to do verejného git repozitára. To je celý distribučný mechanizmus - ktokoľvek potom môže spustiť omarchy plugin add na tvoju URL a mať to spustené za pár sekúnd.

Aby ľudia tvoj plugin skutočne našli, uveď ho na plugins.omarchy.org. To je trh s pluginmi shellu Omarchy a prvé miesto, kam sa pozrieť, keď rozmýšľaš, či už niekto vytvoril widget, ktorý sa chystáš napísať. Skôr než začneš, prezri si to!