Unless you DONT have a Spanish Keyboard that is…
I dont , so it was a bit.;. tricky for a bit. (hours actually)
As, I have a GB English one.
so lets begin. and explain that issue at the end.
History.
Omarchy Linux
Its here
and is
Omarchy: the Linux distro built for the agentic AI age
So, since PineGrow has gone all Ai Flavoured, … This might be of interest around here.
check this out if you live under a rock.. with WiFi.
Omarchy Linux is Based on ARCH linux (EEK historically the most difficult to install) and runs native on BARE METAL.. on an Apple Silicon M1/2 Mac ( M1 and M2 works, M3 under development, any newer and your out of luck)), BUT, it CAN’T dual boot.. so wipes your Mac OS. .. And moves into you Apple Silicon house.. thank you very much.. Replacing Mac OS altogether.
er, No!
SO how about a Virtual machine?
Oh Go on then! You persuaded me.
bring on UTM!
wow.
Virtalization Or Emulation.
SO install UTM, on your SIlicon Mac (Currently this is the only way to go about this Omarchy Install on this ARM architecture.)
it even comes with a gallery of links to pre built .UTM image files you can download and install in your Virtualised environment, on your mac…
but, there isn’t one for Omarchy as… the actual developer of it, hasnt built one…
Well, there was version 3 of Omarchy which said NO ARM Macs (Intel ok),
But now there is Version 4 which doesn’t have that stipulation but, the installer is broken when it comes to grabbing libraries, URLs etc during installs and fails.
which is explained VERY well, by this Spanish chap … remember the keyboard issue?
well, yeah… your going to find out about that.
So this chap.. Developer God mode engaged…
has
Created a fixed Omarchy .UTM image file (the ones which arent in the Gallery)
And tells you about it here →
And he has created the FIXED .UTM Omarchy m1/m2, Apple Silicon, ARM Omarchy linux install image file available… here
… its … sloooooooooooow.
TO download!
I opted to download the latest version 4 of Omarchy (Config files are in .lua format, Omarchy 3 are .config) via torrent.
the torrent contains BOTH versions.
Using the Torrent client I was able to inspect the torrent and download ONLY the V2 of the image (the smaller 3.x GB installer Image.- the older version 3, has some install bugs and is nearly twice the size)
It’s a zip file…
when it Finallly downloads, you have.
omarchy-arm-utm-v2.zip
unzip it…
you now have …
Omarchy ARM.utm
Now… double click it.
BANG!
UTM program opens up and… in and incredibly short moment (maybe a minute?)
You have a fully functioning, configured installed Virtualisation of Omarchy Linux, Running in UTM.
..
thats it!
its done!
oh wait. did I mention the keyboard?
ah yes…
… so, I have a Spanish ghost in the machine, I will have to address.
So you will be presented with …well a pretty screen saver and basically … NOTHING! else.
until you press
Option + Space.
then a menu pops up.
THIS…is how you navigate… Keystrokes!
Just check out key bindings Opt + k
So I selected Setup and then… Input
And now I could work my input, keyboard adjusting magic
now, say you want to change some settings (for me… the Monitor Resolution)
… you click Monitor…
and.. oh , dear god!
Welcome to Arch… Linux.
You’re now greeted by a .lua config file
… which you now have to edit…>
In…
NeoVIm. (for me, sad face)
so… to do this…
You click i … to enter insert mode and then… oh no what the hell?
I cant find the characters? what , is my keyboard broken?
OH!
NO!?
… i was writing gobbledegook!
all sorts of accented letters.
it took me a while to try and figure this out.
as I needed to edit the Monitor file resolution and use
( ) { } " symbols and instead I got…
) = ^ * Ñ
now!
that last one was a peach!
But led to me figuring out how to do this.
The developer’s other docs are in Spanish…
So I figured out that maybe what had gone pear shaped, as in his Github brief of what he’d created and how it worked , he said,
It asks six values that it pre-fills from your Mac — timezone from /etc/localtime, keyboard from macOS preferences, cores and RAM from sysctl
So I figured he’s built this with HIS keyboard, which was Spanish…
I couldnt get Copy and paste to work between Host and Guest OS (Linux Clipboards…Buffers, Ill work it out)
And I couldnt remember how to use NeoVIm, but I KNEW i needed
the : to enter into Save mode… after editing, after using i for insert mode in NeoVIm, in order to edit it…
and instead I got…
Ñ
curses!
So I hunted around and found this Useful site.
WHAT characters were where on a Spanish Keyboard and … where the ones I actually needed were!
its this one, the SPANISH keyboard -the 2nd Image.. as the 1st is LATIN AMERICAN Spanish…
… Sheesh!
So thank you to
Xah Lee, for Creating that online info page.
SO I could now type all the wrong characters on my physical keyboard and see the correct ones appear in the config file and then
:wq to Save and quit the .lua config file…
2… TWO… and a half hours.
Because I then had to edit the keyboard one… to set it to English…
when I COULDNT type the characters… in order to .. set my keyboard … to English and Mac using
hl.config({
input = {
-- Set the primary layout to GB
kb_layout = "gb",
-- Optional: Add variants or multiple layouts (e.g., "gb,us")
kb_variant = "mac",
-- Optional: Configure switching options if using multiple layouts
-- kb_options = "grp:alts_toggle"
},
})
So there is a morning of my life I will never get back, but,
Once I Edited the Keyboard config , saved and exited, It was VERY satisfying. but .>
Neovim.. I mean, check this out…
TRY and find… the save command .. here.
try searching that page for .. save… good luck!
A clue,
Try searching it for
:wq
I know!! Obvious right, yeah?
where you will find it buried in
When writing the buffer, the default is to use the current file name. Thus
when you give the “ZZ” or “:wq” command, the original file will be
overwritten. If you do not want this, the buffer can be written into another
file by giving a file name argument to the “:write” command. For example:
This is Better!
Id also tried adding the Spanish Language Keyboard to my Host Mac OS,
Turning on Accessibilty,
Enabling Pop UP Visual Keyboard under Motor setion…
AAAAnd…
Fail.
and then … I stared at the blanks wallpaper, filled with trepidation.
so, if you want to experience that liberating experience like I did and set up an
Agentic Centric LInux OS on you M1/2 Mac in a virtual machine…
- Install UTM
- Download the OMARCHY V4 .utm image file… (which is helpfully labelled V2.. as the zipped file in the torrent- as the original image in the download is Omarchy V3).
… takes ages.
then double click the V2 .UTM file.
BOOM Its installed and running.
UNLESS YOU’RE USING A SPANISH KEYBOARD.. edit the config file to change /add your keyboard to the System config file.
(See the whole sketch above)
And thats it.
Im now exploring
Combining Ollama with Hermes Agents to see if I can get that combo to DO things in this new Linux OS, not just chat to an LLM in Ollama.
have fun!
Docs are here
for V3
more
Watch the Video here
or…
You could just build it yourself.
This Image Creators explanation and walkthrough of the process he went through and description of all the broken stuff and fixes is a masterclass in documentation.. IN my opinion anyway.
OH! AND GET USED TO PRESSING OPT+CTRL .. a lot! to make sure your your mouse is Captured
ok Ciao.
This took ages to write, to hopefully make this look accessible and easy…
Along with my big keyboard issue 
Ok
Ciao.. or. in this case..
Adios!