# 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.

Project page: https://dbaney.com/projects/omarchohard/

## 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:

```sh
curl -fsSL https://raw.githubusercontent.com/baney75/omarchohard/main/install.sh | bash
```

The 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

```sh
omarchohard login
```

This 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

```sh
omarchohard onedrive setup
```

This 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

```sh
omarchohard share Report.docx
omarchohard share --link Photo.jpg
```

An 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

```sh
omarchohard add teams
omarchohard remove onenote
```

A 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

```sh
omarchohard doctor
```

Doctor 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

```sh
omarchohard channel nightly   # stable, nightly or dev
omarchohard update
```

Stable 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

```sh
omarchohard desktop check
omarchohard desktop install --office m365
omarchohard desktop activate
```

The 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

```sh
omarchohard uninstall           # keeps your config
omarchohard uninstall --purge   # removes config, state and the isolated profile too
```

Uninstall removes the launchers and icons and puts back whatever apps handled Office files before.
