Ga naar de inhoud
Chapters
  1. Welkom bij Omarchy!
  2. Aan de slag
  3. Kom je van Mac of Windows
  4. Navigatie
  5. De bovenbalk
  6. Thema's
  7. Sneltoetsen
  8. Uniform klembord & geschiedenis
  9. Herinneringen
  10. Meldingen
  11. Tekstextractie & dicteren
  12. Schermafbeeldingen & opname
  13. Schakelaars, inactiviteit en de schermbeveiliging
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Ontwikkeltools
  19. Shell-tools
  20. Shell-functies
  21. TUIs
  22. GUI's
  23. Browsers
  24. Commerciële apps/diensten
  25. Webapps
  26. Gaming
  27. Pdf's invullen
  28. Windows-VM
  29. Andere pakketten
  30. Updates
  31. Dotfiles
  32. Shell-plugins
  33. Monitoren
  34. Toetsenbord, muis, trackpad
  35. Netwerken
  36. Slaapstand van het systeem
  37. Hardware-authenticatie
  38. Lettertypen
  39. Achtergronden
  40. Prompt
  41. Branding
  42. Veelvoorkomende aanpassingen
  43. Je eigen thema maken
  44. Mac-ondersteuning
  45. Probleemoplossing
  46. Veelgestelde vragen
  47. Systeemsnapshots
  48. Beveiliging
  49. Omarchy op...
  50. Dualboot-installatie
  51. Installaties zonder toezicht

Handleiding

Je eigen thema maken

Je kunt je eigen thema’s toevoegen aan ~/.config/omarchy/themes. Kopieer gewoon een van de bestaande thema’s als basis (kijk in /usr/share/omarchy/themes) en pas het daarna naar hartenlust aan. Zolang je thema in die map staat, wordt het opgenomen in het menu voor themaselectie.

Het belangrijkste bestand dat je moet aanpassen is colors.toml. Dat definieert de kleurenset die vervolgens wordt gebruikt om configuraties te genereren voor de terminal (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian en de volledige Omarchy-shell (bovenbalk, menu, meldingen, OSD en vergrendelscherm).

Je kunt ook de meegeleverde applicatie Aether gebruiken om een nieuw thema te maken met een mooie GUI-interface om met kleuren te spelen en naar achtergronden te zoeken. Start hem gewoon vanuit het app-raster met Super + Alt + Space.

Wat een geïnstalleerd thema kan bevatten

Een thema dat je zelf schrijft in ~/.config/omarchy/themes kan bevatten wat je maar wilt - het is jouw machine en jouw bestand, en Omarchy past alles toe.

Een thema dat je installeert vanuit de repo van iemand anders met omarchy theme install behoudt alles wat kleur is, en verliest het handjevol bestanden dat code zou uitvoeren op jouw machine: elk .lua-bestand, de terminalconfiguraties (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) en vscode.json. De hyprland.lua van een thema is Lua die je compositor uitvoert bij het inloggen, een terminalconfiguratie benoemt het programma dat je terminal start, en vscode.json benoemt een VSCode-extensie om te installeren. Het installeren van iemands thema moet veranderen hoe je bureaublad eruitziet, nooit wat het uitvoert.

Al het andere werkt nog steeds precies zoals de auteur van het thema het heeft geschreven - btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, de achtergronden en de previews blijven allemaal behouden. Alleen wat is weggelaten, wordt op jouw machine opnieuw gegenereerd vanuit colors.toml.

Omarchy onderscheidt de twee aan de hand van of het thema een eigen git-repo in zich heeft, wat omarchy theme install achterlaat wanneer het kloont. Dus een thema dat je zelf hebt geschreven blijft van jou, en een thema dat je van het internet hebt gehaald blijft kleuren.

Lichte modus

Als je een thema in lichte modus maakt, zet dan mode = "light" bovenaan je colors.toml. Dan wordt het automatisch gekoppeld aan de lichte modus voor alle apps. (De oude manier, een leeg bestand met de naam light.mode in de hoofdmap van je thema plaatsen, werkt ook nog steeds.)

Pictogramkleuren

Als je de pictogrammen van de bestandsbeheerder qua kleur wilt afstemmen op je thema, voeg dan een bestand toe met de naam icons.theme met de naam van de pictogrammenset die je wilt gebruiken. Standaard zijn de opties: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

Ontgrendelingsafbeelding

Thema’s die worden geleverd met unlock.png- en preview-unlock.png-afbeeldingen worden weergegeven onder Weergave > Ontgrendelen. Je unlock.png moet bij voorkeur een transparante png zijn. En je kunt de preview-afbeelding maken met omarchy plymouth preview.

Thema toepassen op apps die Omarchy niet dekt

Als je een app gebruikt die niet in die lijst staat, kun je Omarchy zelf leren die te thematiseren met een sjabloon. Plaats een bestand in ~/.config/omarchy/themed/ met de naam van de configuratie die het genereert plus een .tpl-extensie, en schrijf de configuratie met {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} tot en met {{ color15 }} en de rest van het palet als placeholders. Elke keer dat je van thema wisselt, wordt het bestand opnieuw gegenereerd met de kleuren van dat thema.

In die map staat een volledig van commentaar voorzien alacritty.toml.tpl.sample om van te kopiëren - het vermeldt elke variabele die je kunt gebruiken, plus de modifiers _strip en _rgb voor apps die hun kleuren willen zonder de # of als decimale RGB. Je sjablonen hebben voorrang op die van Omarchy zelf, dus je kunt dit ook gebruiken om te overschrijven hoe een ingebouwde app wordt gethematiseerd.

Je thema distribueren

Als je je thema wilt distribueren zodat anderen het kunnen gebruiken, moet je het op een openbare git-server zetten, zoals GitHub. Vervolgens kunnen mensen het installeren via Installeren > Stijl > Thema in het Omarchy-menu met die URL. Het wordt aanbevolen dat je de naamgevingsconventie omarchy-[themename]-theme volgt, omdat het thema na installatie dan correct wordt weergegeven als alleen [themename] in het menu voor themaselectie.

Die overgebleven [themename] wordt de mapnaam van het thema, dus het moet er een zijn die Omarchy veilig kan doorgeven: het moet beginnen met een letter, een cijfer of een underscore, en de rest mag letters, cijfers, ., _, + en - bevatten. Hoofdletters worden voor je omgezet naar kleine letters, maar al het andere - een spatie, een aanhalingsteken, een niet-Engels teken - wordt bij de installatie geweigerd in plaats van te worden omgezet in een mapnaam. Dus omarchy-tokyo-night-theme, omarchy-flexoki_light-theme en omarchy-c++-theme installeren allemaal probleemloos.

Onthoud dat zodra het is geïnstalleerd vanuit een repo, elke .lua, terminalconfiguratie of vscode.json die het meelevert wordt weggelaten, dus bouw het thema niet rond die bestanden.

Je kunt je thema laten toevoegen aan de pagina met extra thema’s door een pull request te sturen naar de omarchy-site-repo.