omarchohard documentation
omarchohard documentation
Install omarchohard on Omarchy, sign in to Microsoft 365, put OneDrive on disk, open Office files from Files, switch release channels and uninstall.
Install
You need Omarchy, or Arch Linux with Hyprland, and a Chromium-based browser such as Chromium, Chrome, Edge, Brave or Helium. In a terminal:
curl -fsSL https://raw.githubusercontent.com/baney75/omarchohard/main/install.sh | bashThe installer downloads the stable release, checks its sha256, unpacks it under ~/.local/share/omarchohard, links omarchohard into ~/.local/bin, and starts omarchohard setup. Setup asks one thing per step: your browser, your email (optional), which apps to install, whether email links open Outlook, signing in, and OneDrive. It finishes by running doctor. Run it again any time, or open Microsoft 365 Setup from the launcher. Add -s -- --channel nightly after bash for the nightly build, or -s -- --yes to take every default with no questions.
Setup covers the next two sections for you. They are here for when you want to do a step by hand.
Sign in
omarchohard loginThis opens the Microsoft 365 home page in its own window. Sign in with your school, work or personal account on Microsoft's page; single sign-on works the same as in your browser. The app windows share that sign-in. Run omarchohard install --isolated instead if you want the apps in a profile of their own, apart from your everyday browser.
OneDrive
omarchohard onedrive setupThis signs in to OneDrive through your default browser and mounts it at ~/OneDrive with rclone. It then asks for your OneDrive web address, which looks like https://contoso-my.sharepoint.com/personal/you_contoso_edu/Documents for school and work accounts, so files can open in place. Some schools have to approve rclone for their tenant first. omarchohard onedrive status shows the mount and anything still uploading, omarchohard onedrive sync waits until every save is up, and omarchohard onedrive remove undoes it.
Open files
Double-click a .docx, .xlsx or .pptx in Files, or run xdg-open file.docx. A file inside ~/OneDrive opens in place. The web apps only open files in OneDrive, so a file from anywhere else is uploaded as a copy to ~/OneDrive/Omarchohard first, and the original is left alone. Email links open a new message in Outlook, and Teams meeting links open in Teams.
Share
omarchohard share Report.docx
omarchohard share --link Photo.jpgAn Office document opens in its app, where Share sends it to people by name. --link copies a OneDrive link to the clipboard instead, and --edit makes it an edit link. School and work accounts get a link for people in the organization. In Files, right-click a file and choose Scripts for the same actions.
Choose apps
omarchohard add teams
omarchohard remove onenoteA removed app leaves the launcher and hands its file types back to whatever had them before.
Add-ins
Office Add-ins from the store run in the web apps and follow your Microsoft account; omarchohard addins word opens Word and says where they are. Browser extensions in your everyday profile work in every app window. COM, VSTO and VBA add-ins need the desktop tier.
For agents
omarchohard probe --json reports the machine and what omarchohard recommends for it, omarchohard setup --yes runs setup with no questions, and omarchohard optimize --apply tunes the OneDrive cache and prewarm. The two sign-ins still need a person.
Check it
omarchohard doctorDoctor checks the browser, every launcher, icon and file handler, and the OneDrive mount. It exits with an error when any of them is missing, and omarchohard doctor --json prints the same checks for scripts.
Channels and updates
omarchohard channel nightly # stable, nightly or dev
omarchohard updateStable follows tagged releases, nightly is built from main each day after the full test suite passes, and dev follows every change that passes CI. A failed download or checksum leaves the installed version as it was.
Desktop Office
omarchohard desktop check
omarchohard desktop install --office m365
omarchohard desktop activateThe desktop tier runs Windows in a virtual machine with WinApps and installs Office there, so Word, Excel and PowerPoint open as their own windows on your desktop. It needs KVM, Docker or Podman, FreeRDP, about 16 GB of memory and 80 GB of disk, and desktop check tells you what is missing. desktop activate takes a product key you bought from a hidden prompt or a file and never prints it. It has not run start to finish on real hardware yet.
Uninstall
omarchohard uninstall # keeps your config
omarchohard uninstall --purge # removes config, state and the isolated profile tooUninstall removes the launchers and icons and puts back whatever apps handled Office files before.
Something unclear or out of date? Open an issue on GitHub.