iCloud for Omarchy
iCloud apps for Omarchy (and any Arch Linux), sharing
one Apple sign-in, published as one signed pacman repository.
Screenshots use demo data.
- Notes: your Apple Notes as a folder of Markdown files, synced both
ways. Edit, rename, move or delete them in the app, in Neovim or Obsidian,
or with
mv and rm, and iCloud follows.
- Photos: browse, download, upload and delete (with undo) your iCloud
Photos, copy one or make it your wallpaper.
- Find My: your devices on a map, with play sound, Lost Mode and a
location trail.
- iCloud Drive:
~/iCloud Drive, a folder kept in sync both ways. No
app: use your file manager.
- Every window action also works from the terminal, with JSON output
for scripts and AI agents.
curl -fsSL https://github.com/ferdousbhai/icloud-for-omarchy/releases/latest/download/install.sh | sudo bash
| Directory | Package | What it is |
|---|
| notes/, notes-sync/ | icloud-notes | Apple Notes as a Qt/QML app and the icloud-notes command, synced with iCloud by its engine, icloud-notes-sync (notes-sync/, in Rust, originally derived from icloud-md), which the package installs off PATH. |
| photos/ | icloud-photos | iCloud Photos in GTK4/libadwaita: browse, download, upload and delete. |
| findmy/ | icloud-findmy | Find My devices in GTK4/libadwaita: locate, play a sound, Lost Mode, history trail. |
| drive/ | icloud-drive | iCloud Drive as the folder ~/iCloud Drive, synced both ways by a background service; icloud-drive start turns it on. |
| session/, sessiond/ | icloud-session | The shared sign-in: a D-Bus daemon, a sign-in window and a CLI (sessiond/), plus the Rust client crate every app links (session/). |
The shared sign-in's design (the daemon, its D-Bus interface, the session
files) is in session/README.md.
Calendar, Mail and the rest of iCloud
Two more iCloud apps live in their own repositories, because they also
show other accounts in the same window. Both use this project's
icloud-session sign-in, so you don't sign in again:
- iCloud Calendar: Cloud Calendar
(
cloud-calendar account add icloud) shows your iCloud, Google and HEY
calendars together, with event notifications.
- iCloud Mail: Cloudmail
(
cloudmail account add icloud) reads, sends and searches iCloud Mail
next to your own domains' mail, HEY and Gmail.
Messages, Phone and Maps are not covered. iMessage and phone calls need an
Apple device: iCloud has no web service for them. Apple Maps' saved places
aren't available from iCloud on the web either.
Command line and agents
Notes, Photos, Find My, iCloud Drive and the shared sign-in have scriptable CLIs with one
output contract: text on a terminal, a JSON envelope when piped (--quiet
for the bare result), JSON errors with stable codes, and shared exit codes;
see docs/AGENTS.md and docs/CLI.md.
icloud-session skill install installs the agent skill
(docs/skills/icloud/SKILL.md) to ~/.agents/skills/icloud, linked
into ~/.claude/skills for Claude Code; icloud-session skill remove removes it, and a new
release refreshes it.
Contacts and tasks moved
The standalone icloud-contacts and icloud-reminders apps/packages are retired.
Use Cloud Contacts and
Cloud Tasks, which combine Apple and
Google and own the extracted iCloud backends. Their migration instructions
preserve existing cache and notification history; only icloud-session remains a
shared dependency. The old apps and per-app installers are no longer built here.
Is this safe?
- You sign in on Apple's own page, password and two-factor code
included, in a window opened by
icloud-session sign-in. The apps never
see your password.
- What's kept is the session cookies, in your system keyring (the
Secret Service, e.g. GNOME Keyring). Only who is signed in and when the
session was last checked are in a file,
~/.local/state/icloud-session/account.json, readable only by you.
- Your password is stored only if you choose to, for Find My, which asks
for it again from time to time:
icloud-session set-password puts it in
your system keyring (the Secret Service, e.g. GNOME Keyring), and
icloud-session forget-password removes it.
- The apps talk only to Apple, plus OpenStreetMap for Find My's map
tiles.
- Notes and Photos deletes are recoverable: a note or photo you
delete goes to Recently Deleted in iCloud (about 30 days).
- It's all open source, and the packages are signed with a key whose
fingerprint is pinned in install.sh.
Install
Coming from a Mac? One command installs these together with Mail, Calendar, Contacts and Reminders (the Cloud apps) and signs you in to iCloud once for all of them (what it does):
curl -fsSL https://ferdousbhai.com/icloud/install.sh | sudo bash
To install only the apps in this repository:
curl -fsSL https://github.com/ferdousbhai/icloud-for-omarchy/releases/latest/download/install.sh | sudo bash
installs Notes, Photos, Find My and iCloud Drive (icloud-notes, icloud-photos, icloud-findmy, icloud-drive), which pull in icloud-session. iCloud Drive syncs nothing until you run icloud-drive start. To install only some, name them:
curl -fsSL .../install.sh | sudo bash -s -- icloud-photos icloud-findmy
This is the beginning of the README. Read the rest at the original. Read the full README ↗
