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

Ontwikkeltools

Alternatieve editors

Omarchy wordt standaard geleverd met Neovim, maar als je iets mainstreamers en vertrouwders wilt, kun je het Omarchy Menu (Super + Space) openen en de opties onder Install > Editor bekijken. Daar staan VSCode, Cursor, Zed, Sublime Text, Helix, Vim en Emacs voor je klaar. Als je niet vindt wat je zoekt, kijk dan bij Install > Package of het niet in een Arch-pakket zit (en zo niet, probeer Install > AUR om in de AUR te zoeken).

De originele vi-editor is ook standaard beschikbaar. Voer vi filename uit om een bestand in de terminal te bewerken.

Thema-afstemming wordt aangeboden voor VSCode, Cursor, VSCodium en Helix.

Je kunt de systeemwijde standaardeditor instellen via Setup > Defaults > Editor.

Omgeving

Omarchy ondersteunt het instellen van een hele reeks ontwikkelomgevingen via de sectie Install > Development van het Omarchy Menu (Super + Space). Je vindt er natuurlijk Ruby on Rails, maar ook alle drie de grote runtimes voor JavaScript (Node.js, Bun, Deno), evenals populaire PHP-frameworks zoals Laravel en Symfony. Oh, en er zijn ook Go, Rust, Python, Java, Elixir (met Phoenix), .NET, OCaml, Zig, Clojure en Scala. Het is een zeer brede selectie!

De meeste van deze omgevingen worden beheerd door Mise. Het is een tool waarmee je meerdere versies van een programmeertaal op dezelfde machine kunt installeren en uitvoeren. Het is net als rbenv of rvm voor Ruby of virtualenv voor Python, maar dan voor een heleboel verschillende omgevingen.

Om bijvoorbeeld Ruby te installeren, voer je mise use -g ruby uit. Daarmee installeer je Ruby én stel je het in als de globale standaard. Of, als je project een .ruby-version-bestand heeft, kun je gewoon mise i uitvoeren in de hoofdmap van dat project.

Vooraf geïnstalleerde CLI-tools

Omarchy maakt tools zoals gh, uv en de meeste codeeragents beschikbaar via mise’s lazy installation. De eerste keer dat je er een uitvoert, installeert mise deze. Latere uitvoeringen hergebruiken de geïnstalleerde versie; ze controleren niet bij elke start op een update.

Je kunt ook de standaardinstellingen bekijken of ze vooraf installeren:

mise ls --current              # List the tools configured for this directory
mise install gh               # Install one tool now
mise install --include-lazy    # Install all configured tools, including lazy tools

Voer omarchy update uit om geïnstalleerde tools bij te werken samen met de rest van Omarchy. De alias mup werkt alleen mise-beheerde tools bij. Om nog een tool aan je eigen configuratie toe te voegen, gebruik je mise use -g <tool>.

De Python-installatie installeert ook uv via mise. Als je de Python-ontwikkelomgeving verwijdert, blijft uv beschikbaar als onafhankelijke tool.

Je eigen installatie gebruiken

De commando’s van mise komen vóór ~/.local/bin in PATH, dus een tool die je zelf hebt geïnstalleerd, bijvoorbeeld met de eigen installer van Claude Code of Cursor, voert nog steeds de kopie van mise uit. Apps die vanaf het bureaublad worden gestart, vinden de commando’s van mise ook vóór systeempakketten, dus een app die gh uitvoert, krijgt de kopie van mise, zelfs als je github-cli met pacman hebt geïnstalleerd, en mise installeert die kopie bij de eerste uitvoering. Om in plaats daarvan de jouwe te gebruiken, schakel je de kopie van mise uit in ~/.config/mise/config.toml. Bijvoorbeeld, als je Cursor CLI zelf hebt geïnstalleerd:

[settings]
disable_tools = ["cursor-agent"]

Als je al een [settings]-tabel hebt, voeg je het item daar toe; breid een bestaande disable_tools-lijst uit in plaats van deze te vervangen. Zorg ervoor dat je installatie in PATH staat. Gebruik de mise-toolnaam, die kan verschillen van het bijbehorende commando: oh-my-pi levert bijvoorbeeld omp. De launcher voor de standaardagent geeft ook de voorkeur aan een door de gebruiker geïnstalleerde Cursor of Muse in ~/.local/bin.

Standaardinstellingen verwijderen en herstellen

Remove Preinstalls zorgt ervoor dat mise Omarchy’s tooldeclaraties voor jouw gebruiker overslaat, door ze toe te voegen aan ignored_config_paths in ~/.config/mise/miserc.toml. Restore Preinstalls verwijdert die regel weer. Tools die je zelf declareert, in je eigen configuratie of in de mise.toml van een project, blijven in beide gevallen werken. Als je een standaardagent kiest of Python instelt nadat je de preinstalls hebt verwijderd, wordt die tool toegevoegd aan je eigen configuratie. Beide gelden alleen voor jouw gebruiker; andere gebruikers op de machine behouden hun eigen keuze.

Docker

Docker behoeft nauwelijks introductie. Hiermee kun je geïsoleerde containers draaien, en Omarchy installeert alles wat nodig is om het goed te laten werken, inclusief Docker zelf en Docker Compose.

Standaard zit je gebruiker niet in de groep docker. Die groep is in feite root zonder wachtwoord - alles wat erin zit, kan docker run -v /:/host uitvoeren en de machine overnemen - dus één enkel kwaadaardig script of één enkele afhankelijkheid die als jou draait, zou anders met één commando root kunnen worden. Dus op de commandoregel voer je Docker uit met sudo (sudo docker ps, sudo docker compose up), en de grafische tools die met de daemon praten - de Windows VM - vragen om autorisatie wanneer ze die nodig hebben. Als je het gemak van een setup zonder groep terug wilt en de afweging begrijpt, schakel dit dan in via Setup > Security > Sudoless Docker (of voer omarchy-setup-security-sudoless-docker uit). Daarmee word je na een waarschuwing toegevoegd aan de groep docker; daarna werken gewoon docker en de alias d weer zonder sudo.

Je kunt de gangbare databases voor lokale ontwikkeling in Docker instellen via Install > Development > Docker DB in het Omarchy-menu.

GitHub CLI

GitHub CLI is beschikbaar als gh om vanuit de terminal met repositories, issues en pull requests te werken. Voer gh auth login uit om het bij het eerste gebruik te installeren en je te authenticeren, en daarna gh repo clone org/repo om een repository te klonen. Voer gh --help uit om de commando’s te verkennen.

Voor een terminalinterface voor pull requests voer je ghui uit; mise installeert dit ook bij het eerste gebruik. Lazygit is vooraf geïnstalleerd om met Git zelf te werken.