Native iCloud apps for Windows and Linux, built in Rust. Notes, Reminders, Calendar, Contacts, Drive and Photos, offline and in sync with your iPhone.
Rust apple-notesapple-reminderscloudkitcrdtdesktop-appicloudicloud-calendaricloud-driveicloud-notesicloud-photosiphonelinuxlinux-desktoplocal-firstoffline-firstprivacyrusttauritauri-appwindows
README: shorter, store badges first, what makes it trustworthy up front, a Linux and Windows table
Yashwanth Kamireddi68bdfb8793c2
diff --git a/README.md b/README.mdindex bd5cb47..b42eaba 100644--- a/README.md+++ b/README.md@@ -1,59 +1,41 @@<div align="center">-<img src="packaging/icons/skykeep-1024.png" alt="Skykeep" width="112">+<img src="packaging/icons/skykeep-1024.png" alt="Skykeep" width="104"># Skykeep-### Your iCloud, at home on Linux and Windows.+### Your iPhone's iCloud, on Windows and Linux.-Six real desktop apps for Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos,<br>on a native Rust engine that keeps your library on your computer. They open instantly,<br>work offline and stay in sync with your iPhone. Free and open source.+Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos as real desktop apps.<br>Kept on your computer, so they open instantly and work offline. In sync with your iPhone.-<a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-windows-x64-setup.exe"><img src="https://img.shields.io/badge/Download%20for-Windows-2f6fd6?style=for-the-badge" alt="Download for Windows" height="36"></a> -<a href="#install"><img src="https://img.shields.io/badge/Download%20for-Linux-2f6fd6?style=for-the-badge" alt="Download for Linux" height="36"></a>+<p><a href="https://apps.microsoft.com/detail/9P6B042JNK54"><img src="https://get.microsoft.com/images/en-us%20dark.svg" alt="Get it from Microsoft" height="52"></a> <a href="https://snapcraft.io/skykeep"><img src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg" alt="Get it from the Snap Store" height="52"></a></p>-<sub><b>Windows 10/11:</b> <a href="https://apps.microsoft.com/detail/9P6B042JNK54">Microsoft Store</a> or <a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-windows-x64-setup.exe"><code>setup.exe</code></a> · <b>Ubuntu, Debian, Mint:</b> <a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-amd64.deb"><code>.deb</code></a> · <b>Fedora, openSUSE:</b> <a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.rpm"><code>.rpm</code></a> · <b>Any other Linux:</b> <a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.AppImage"><code>.AppImage</code></a> · <a href="#install">All install options</a></sub>--<sub>Works offline · No extra account · No analytics · GPL-3.0</sub>+<sub><a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-windows-x64-setup.exe">Windows installer</a> · <a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-amd64.deb">.deb</a> · <a href="https://copr.fedorainfracloud.org/coprs/yashonfed/skykeep/">Fedora</a> · <a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.AppImage">AppImage</a> · <a href="#install">All options</a></sub><br><img src="docs/media/hero.webp" alt="Skykeep ticking off a reminder, switching to the week in Calendar, opening a note, then a contact card, an iCloud Drive folder and the photo library" width="880">-[](LICENSE)-[](#install)+<p><a href="https://github.com/YashwanthKamireddi/Skykeep/releases/latest"><img src="https://img.shields.io/github/v/release/YashwanthKamireddi/Skykeep?label=release&color=2f6fd6" alt="Latest release"></a> <a href="https://github.com/YashwanthKamireddi/Skykeep/releases"><img src="https://img.shields.io/github/downloads/YashwanthKamireddi/Skykeep/total?label=downloads&color=2f6fd6" alt="Downloads"></a> <a href="https://github.com/YashwanthKamireddi/Skykeep/actions/workflows/ci.yml"><img src="https://github.com/YashwanthKamireddi/Skykeep/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-4a5568" alt="License: GPL-3.0"></a></p>-[Why](#why-skykeep) · [Features](#features) · [Install](#install) · [Privacy](#privacy-and-security) · [How it works](#how-it-works) · [FAQ](#faq) · [Contributing](#contributing)+<sub>Free and open source · No Skykeep account · No analytics</sub></div>-## Why Skykeep--Plenty of people love their iPhone and choose Linux or Windows for their computer. On those computers, iCloud lives in a browser tab. It needs a connection, there are no alerts, and iCloud Drive isn't in your file manager.--Skykeep brings your iCloud onto the computer itself. Your notes, reminders, calendar, contacts, files and photos are kept on your disk, so they open instantly and work offline. Change something on your iPhone and it shows up here. Change it here and it's on your iPhone.+## Built to be trusted-- **Instant.** Your library lives on your computer. Every app opens right away, and your own edits show the moment you make them.-- **Live.** Notes and Reminders from your iPhone usually arrive in about a second, over Apple's push channel. Calendar and Contacts are checked every few seconds while you use Skykeep.-- **Offline.** On a train with no Wi-Fi? Keep writing. Notes, reminders, events and contacts sync when you're back online.-- **Real apps.** Six apps, one sign-in. Each has its own entry in your app launcher or Start menu, with alerts, a tray icon and quick capture.-- **Drive as a folder.** On Linux, iCloud Drive and Photos also appear as real folders in your file manager.-- **Yours.** Open source, no Skykeep account, no analytics. Export everything whenever you like.+Skykeep asks for your Apple Account, so it's built to deserve it.-## At a glance+- **Your password is never sent.** Sign-in uses Apple's SRP protocol with Apple's own two-factor, the same way icloud.com signs in.+- **It talks to Apple.** Every connection is locked to its hosts in code. The only others are calendars you subscribe to yourself, and GitHub to check for Skykeep updates, which you can turn off.+- **No Skykeep servers, accounts, analytics or crash reports.** Your iCloud data goes between your computer and Apple only.+- **Your library stays on your disk,** readable only by you. Export everything to Markdown, iCalendar and vCard any time.+- **The Hidden album is locked** behind your Apple Account password.+- **Every release is built in public** by this repository's workflow, with SHA-256 checksums and signature-checked updates. On the Microsoft Store and the Snap Store.-| | Linux | Windows |-|---|:-:|:-:|-| Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos | ✅ | ✅ |-| Kept on your computer: opens instantly, works offline, in sync with your iPhone | ✅ | ✅ |-| Reminder alerts with Complete and Snooze | ✅ | ✅ |-| Its own launcher or Start-menu entry for each app | ✅ | ✅ |-| Tray icon and quick capture | ✅ | ✅ |-| Export Everything to Markdown, iCalendar and vCard | ✅ | ✅ |-| Updates itself | ✅ AppImage | ✅ |-| iCloud Drive and Photos as folders in your file manager | ✅ | In the app |-| Notes, reminders and contacts in system search | ✅ GNOME, KDE | |+[SECURITY.md](SECURITY.md) shows the code behind each point.-## Features+## Six apps, one sign-in<table><tr>@@ -106,191 +88,112 @@ Skykeep brings your iCloud onto the computer itself. Your notes, reminders, cale</tr></table>-### iCloud Notes--Headings, styles, lists and checklists. Add pictures and files, edit the text in tables, and see #tags, scans, PDFs and drawings in place. Folders, pinned notes, search and Recently Deleted. If you edit a note here while it changes on your phone, the two are merged, not overwritten.--### Apple Reminders--Lists with colours, icons and sections, plus Today, Scheduled, Flagged and your smart lists. Subtasks, due dates, repeats, flags, priorities, tags, links and early alerts. Type "Call Alex tomorrow at 5" and it's set for you. Desktop alerts with **Complete** and **Snooze**.--### iCloud Calendar+- **Instant.** Your library lives on your computer, so every app opens right away and your edits show the moment you make them.+- **Live.** A note or reminder from your iPhone usually arrives in about a second, over Apple's push channel.+- **Offline.** Keep writing with no Wi-Fi. Your changes sync when you're back online.+- **At home on your desktop.** Each app has its own launcher or Start-menu entry, with alerts, a tray icon and quick capture. On Linux, iCloud Drive and Photos are real folders in your file manager.-Day, Week, Month and Year. Drag to create, move and resize. Repeating events, alerts, time zones, birthdays and holidays. A **Join** button for video calls, the guest list, and your reminders on the schedule. Subscribe to any `webcal://` calendar and open `.ics` files.--### iCloud Contacts--Nearly every field, with Apple's labels, and contact photos. Lists, My Card, and finding and merging duplicates. Import vCard or a Google or Outlook CSV, and export vCard.--### iCloud Drive--List or grid with thumbnails. Upload files and folders, rename, move, duplicate, and preview with Space. On Linux, iCloud Drive is also a real folder in Files, Dolphin or any file manager.--### iCloud Photos--Your library by month, albums and shared albums, Favourites and Videos. Live Photos and videos play in the viewer. Slideshow, upload, and original-quality download.--### Everywhere+| | Linux | Windows |+|---|:-:|:-:|+| Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos | ✅ | ✅ |+| Opens instantly and works offline, in sync with your iPhone | ✅ | ✅ |+| Reminder alerts with Complete and Snooze | ✅ | ✅ |+| Its own launcher or Start-menu entry for each app | ✅ | ✅ |+| Shared albums, and a password-locked Hidden album | ✅ | ✅ |+| Export everything to Markdown, iCalendar and vCard | ✅ | ✅ |+| Keeps itself up to date | ✅ Snap, COPR, AppImage | ✅ |+| iCloud Drive and Photos as folders in your file manager | ✅ | Coming |+| Results in system search | ✅ GNOME, KDE | |-- Search across every app at once.-- Quick capture for a new note or reminder.-- Results in GNOME and KDE search.-- On Windows, each app has its own Start-menu entry and taskbar button, plus a jump list.-- Light and dark.-- **Export Everything** to Markdown, iCalendar, vCard and your original files.-- Updates itself on Windows and as an AppImage.+<details>+<summary><b>Everything each app does</b></summary>++- **Notes:** headings, styles, lists and checklists; pictures, files and tables; #tags, scans, PDFs and drawings in place; folders, pinned notes, search and Recently Deleted. Edits made here and on your phone at the same moment are merged, not overwritten.+- **Reminders:** lists with colours, icons and sections; Today, Scheduled, Flagged and smart lists; subtasks, due dates, repeats, flags, priorities, tags and early alerts. Type "Call Alex tomorrow at 5" and it's set. Desktop alerts with Complete and Snooze.+- **Calendar:** Day, Week, Month and Year; drag to create, move and resize; repeating events, alerts, time zones, birthdays and holidays; a Join button for video calls; your reminders on the schedule; `webcal://` subscriptions and `.ics` files.+- **Contacts:** nearly every field with Apple's labels, contact photos, lists, My Card, finding and merging duplicates; vCard and Google or Outlook CSV import, vCard export.+- **iCloud Drive:** list or grid with thumbnails; upload files and folders, rename, move, duplicate, Space to preview; download whole folders, which carry on where they stopped if interrupted.+- **Photos:** your library by month, albums, shared albums, Favourites and Videos; Live Photos and videos play; slideshow, upload, copy and original-quality download.+- **Everywhere:** search across every app, light and dark, results in GNOME and KDE search, and a jump list and taskbar button for each app on Windows.+</details>## Install-Skykeep is free. Each link below downloads the newest version straight away. The [latest release](https://github.com/YashwanthKamireddi/Skykeep/releases/latest) has every file, with SHA-256 checksums.--| Your system | Download | |-|---|---|---|-| **Windows 10 and 11, from the Microsoft Store** | [Skykeep in the Microsoft Store](https://apps.microsoft.com/detail/9P6B042JNK54) | Installs and updates through the Store |-| **Windows 10 and 11** | [`Skykeep-windows-x64-setup.exe`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-windows-x64-setup.exe) | Installs just for you, no administrator password |-| **Windows, with Scoop** | [Scoop bucket](https://github.com/YashwanthKamireddi/scoop-bucket) | `scoop bucket add skykeep https://github.com/YashwanthKamireddi/scoop-bucket` then `scoop install skykeep/skykeep` |-| **Ubuntu 24.04+, Debian 13, Linux Mint 22** | [`Skykeep-linux-amd64.deb`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-amd64.deb) | `sudo apt install ./Skykeep-linux-amd64.deb` |-| **Fedora 43+, updated by dnf** | [COPR](https://copr.fedorainfracloud.org/coprs/yashonfed/skykeep/) | `sudo dnf copr enable yashonfed/skykeep && sudo dnf install skykeep` |-| **Fedora 41+** | [`Skykeep-linux-x86_64.rpm`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.rpm) | `sudo dnf install ./Skykeep-linux-x86_64.rpm` |-| **openSUSE Tumbleweed** | [`Skykeep-linux-x86_64.rpm`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.rpm) | `sudo zypper install --allow-unsigned-rpm ./Skykeep-linux-x86_64.rpm` |-| **Ubuntu, or any Linux with Snap** | [Snap Store](https://snapcraft.io/skykeep) | `sudo snap install skykeep` |-| **Any other Linux** | [`Skykeep-linux-x86_64.AppImage`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.AppImage) | `chmod +x Skykeep-linux-x86_64.AppImage && ./Skykeep-linux-x86_64.AppImage` |-| **Arch, CachyOS, EndeavourOS, Manjaro** | [Build from the PKGBUILD](#arch-linux) | Coming to the AUR as `skykeep` |+| Your system | Get Skykeep |+|---|---|+| **Windows 10 and 11** | [Microsoft Store](https://apps.microsoft.com/detail/9P6B042JNK54) · [installer](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-windows-x64-setup.exe) · [Scoop](https://github.com/YashwanthKamireddi/scoop-bucket) |+| **Ubuntu, Debian, Mint** | [Snap Store](https://snapcraft.io/skykeep) · [`.deb`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-amd64.deb) |+| **Fedora** | [COPR](https://copr.fedorainfracloud.org/coprs/yashonfed/skykeep/): `sudo dnf copr enable yashonfed/skykeep && sudo dnf install skykeep` |+| **openSUSE** | [`.rpm`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.rpm) |+| **Arch, CachyOS, Manjaro** | [PKGBUILD](#arch-linux) |+| **Any other Linux** | [AppImage](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-linux-x86_64.AppImage) |-### Windows+Then open **Skykeep**, sign in with your Apple Account, and approve the sign-in on your iPhone. Each app fills in as your library arrives. Every file, with checksums, is on the [latest release](https://github.com/YashwanthKamireddi/Skykeep/releases/latest).-The simplest way is [Skykeep in the Microsoft Store](https://apps.microsoft.com/detail/9P6B042JNK54): **Get**, then open **Skykeep** from the Start menu and sign in. The Store keeps it up to date.--Or with the installer:+<details>+<summary><b>Commands for each Linux file</b></summary>-1. Download [`Skykeep-windows-x64-setup.exe`](https://github.com/YashwanthKamireddi/Skykeep/releases/latest/download/Skykeep-windows-x64-setup.exe).-2. Double-click it. Windows may say **Windows protected your PC**: that's normal for a new free app that isn't code-signed yet. Click **More info**, then **Run anyway**.-3. Open **Skykeep** from the Start menu and sign in.+```sh+sudo apt install ./Skykeep-linux-amd64.deb # Ubuntu 24.04+, Debian 13, Mint 22+sudo dnf install ./Skykeep-linux-x86_64.rpm # Fedora 41++sudo zypper install --allow-unsigned-rpm ./Skykeep-linux-x86_64.rpm # openSUSE Tumbleweed+chmod +x Skykeep-linux-x86_64.AppImage && ./Skykeep-linux-x86_64.AppImage+sudo snap install skykeep && sudo snap connect skykeep:password-manager-service+```-On Windows, iCloud Drive and Photos open inside the app.+Run them in your Downloads folder (right-click an empty spot, **Open in Terminal**). The Snap's second command lets it keep you signed in through your keyring.+</details>-### Linux+<details>+<summary><b>The Windows installer says "Windows protected your PC"</b></summary>-1. Download the file for your system from the table above.-2. Open your **Downloads** folder, right-click an empty spot and choose **Open in Terminal**. (Or open a terminal and type `cd ~/Downloads`.)-3. Copy the command for your system from the table, paste it into the terminal and press Enter. Type your password if it asks.-4. Open **Skykeep** from your apps menu and sign in.+The installer isn't code-signed with a certificate yet, so SmartScreen asks you to confirm: **More info**, then **Run anyway**. The [Microsoft Store](https://apps.microsoft.com/detail/9P6B042JNK54) copy is checked by Microsoft and installs without asking.+</details><details><summary><b>iPhone photos (HEIC) on Fedora or openSUSE</b></summary>-Fedora and openSUSE don't include the decoder for Apple's photo and video format, for patent reasons. Everything else in Skykeep works without it. To see iPhone photos and videos, run these once:--**Fedora** (adds [RPM Fusion](https://rpmfusion.org/Howto/Multimedia)):+Fedora and openSUSE leave out the decoder for Apple's photo format, for patent reasons. Everything else works without it. To see iPhone photos and videos:```sh+# Fedora, with RPM Fusionsudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm-sudo dnf swap ffmpeg-free ffmpeg --allowerasing-sudo dnf install libheif-freeworld-```+sudo dnf swap ffmpeg-free ffmpeg --allowerasing && sudo dnf install libheif-freeworld-**openSUSE Tumbleweed** (adds [Packman](https://en.opensuse.org/Additional_package_repositories#Packman)):--```sh+# openSUSE Tumbleweed, with Packmansudo zypper ar -cfp 90 https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Tumbleweed/ packman-sudo zypper refresh-sudo zypper install --allow-vendor-change --from packman libavcodec62 libheif1 libde265-0 libheif-HEIF+sudo zypper refresh && sudo zypper install --allow-vendor-change --from packman libavcodec62 libheif1 libde265-0 libheif-HEIF```</details><details><summary><b>The AppImage doesn't open on Ubuntu</b></summary>-Ubuntu leaves out a small library AppImages usually use. Start it this way instead:--```sh-./Skykeep-linux-x86_64.AppImage --appimage-extract-and-run-```--Or install the library once with `sudo apt install libfuse2t64` (`libfuse2` on Ubuntu 22.04), and the AppImage opens normally.+Start it with `./Skykeep-linux-x86_64.AppImage --appimage-extract-and-run`, or install the library it needs once: `sudo apt install libfuse2t64` (`libfuse2` on Ubuntu 22.04).</details><a id="arch-linux"></a><details><summary><b>Arch, CachyOS, EndeavourOS, Manjaro</b></summary>-Skykeep is coming to the AUR as `skykeep`, with `skykeep-bin` for the ready-built release. Until then, build it from this repository:+Coming to the AUR as `skykeep`. Until then:```shgit clone https://github.com/YashwanthKamireddi/Skykeep.gitcd Skykeep/packaging/arch && makepkg -si```-For iCloud Drive and Photos as folders, install `fuse3` too: `sudo pacman -S fuse3`.+For iCloud Drive and Photos as folders, also `sudo pacman -S fuse3`.</details><details>-<summary><b>Snap</b></summary>+<summary><b>Updates and system requirements</b></summary>-```sh-sudo snap install skykeep-sudo snap connect skykeep:password-manager-service-```--The second line lets Skykeep keep you signed in through your system keyring; Snap asks for it once. Snap keeps Skykeep up to date by itself. In the Snap, iCloud Drive and Photos open inside the app.-</details>--<details>-<summary><b>Flatpak</b></summary>+The Windows installer and the AppImage update themselves: a notice offers **Update and Restart**, and a new version installs only after its signature check, never while a change is still on its way to iCloud. The Microsoft Store, Snap, COPR and Scoop keep their copies current. For the `.deb` or `.rpm`, install a new version over the old one; your library and sign-in stay.-The Flatpak manifest is in [`packaging/flatpak`](packaging/flatpak). In the Flatpak, iCloud Drive and Photos open inside the app.+Skykeep needs Windows 10 or 11, or a Linux desktop with WebKitGTK 4.1 and a keyring (GNOME Keyring or KWallet), on Wayland or X11, with glibc 2.39 or newer: Ubuntu 24.04, Mint 22, Debian 13, Fedora 41, openSUSE Tumbleweed or later. The AppImage runs on Ubuntu 22.04 too.</details>-<details>-<summary><b>What your system needs</b></summary>--Windows 10 or 11. Or a Linux desktop with WebKitGTK 4.1 and a keyring (GNOME Keyring or KWallet), on Wayland or X11, with glibc 2.39 and libheif 1.17 or newer: Ubuntu 24.04, Linux Mint 22, Debian 13, Fedora 41, openSUSE Tumbleweed, or later. The `.deb` and `.rpm` check this when you install, so an older system finds out then rather than at launch. The AppImage carries its own libheif and runs on Ubuntu 22.04 or later.-</details>--### Staying up to date--The Windows installer and the AppImage keep Skykeep current on their own. A new version appears as a notice with **Update and Restart**. It installs only after it passes its signature check, and never while a change is still on its way to iCloud or while you're typing. The Microsoft Store, Snap, COPR and Scoop copies are updated by the Store, Snap, dnf and Scoop. For the `.deb` or `.rpm`, install a new version from the [Releases page](https://github.com/YashwanthKamireddi/Skykeep/releases/latest) over the old one; your library and sign-in stay.--**Settings ▸ Software Update** has **Check for Updates**, and a switch for the daily automatic check.--## First run--1. **Sign in** with your Apple Account and password.-2. **Approve** the sign-in on your iPhone or another Apple device, then type the six-digit code it shows. No prompt? Choose **Didn't get a code?** to get one by text message.-3. **You're set.** Each app fills in as your library arrives. From then on, everything opens instantly.--On Linux, your desktop may ask you to unlock its keyring the first time. That's where Skykeep keeps your sign-in.--## Privacy and security--Skykeep asks for your Apple Account, so here is exactly what it does with it. [SECURITY.md](SECURITY.md) has every detail, with the code behind each one.--- **What it connects to.** Apple, for your iCloud. The calendars you subscribe to, if you do. GitHub's release servers, to check for new versions of Skykeep (the AppImage and Windows copies only, and you can turn it off). Each connection is locked to its own hosts in code and can reach nothing else.-- **What it doesn't have.** No Skykeep account, no Skykeep servers, no analytics, no telemetry, no crash reporting.-- **Your password.** Sign-in uses Apple's SRP protocol, so your password is never sent, not even to Apple. Two-factor is Apple's own. Your password and session are kept in your system keyring (GNOME Keyring or KWallet on Linux, Credential Manager on Windows) so Skykeep can sign back in by itself. Like any keyring entry, it can be read by programs running as you. Signing out erases it.-- **Your library.** It's in your own data folder, readable by you alone on Linux. Skykeep doesn't encrypt it, so use full-disk encryption as you would on any laptop.-- **Independent.** Skykeep is an open-source project, not affiliated with or endorsed by Apple.--## How it works--Skykeep is a Rust engine with a Tauri 2 window on top. Every screen reads a local SQLite library, never the network, which is why it's instant and works offline.--```text- window (React) Skykeep (Rust) iCloud- ────────────── ────────────── ──────- screens read ──▶ local library (SQLite + full-text search)- an edit ──▶ outbox: saved and shown at once ──────────▶ CloudKit and web services- push + sync: changes come in ◀──────────── Apple's push channel-```--- **Sign-in** is Apple's SRP and two-factor, the same one icloud.com uses.-- **Notes and Reminders** are read and written as CloudKit records. Their text sits in `ENCRYPTED_BYTES` fields that turn out to be gzip around a protobuf, and note edits merge through Apple's own CRDT (topotext), so a note typed on both sides at once comes out whole.-- **Calendar, Contacts and Drive** use Apple's web services. **Photos** uses CloudKit.-- **The outbox** records every edit and shows it at once, then sends it in order. Offline, it waits and retries. Every change is safe to send twice.-- **On Linux, a FUSE mount** puts iCloud Drive and Photos in your file manager.--Five crates do the work: `quince-auth` (sign-in and the locked connections), `quince-icloud` (each iCloud service), `quince-core` (the library, search, outbox and export), `quince-vfs` (the folders) and `quince-media` (HEIC and thumbnails). Over 1,000 Rust tests hold it together. The full tour is in [ARCHITECTURE.md](ARCHITECTURE.md).-## FAQ<details>@@ -299,111 +202,72 @@ Five crates do the work: `quince-auth` (sign-in and the locked connections), `quNo. It's an independent, open-source app that works with iCloud. Apple, iCloud and iPhone are trademarks of Apple Inc.</details>-<details>-<summary><b>Is it free?</b></summary>--Yes, free and open source under the GPL-3.0. There's nothing to buy and no account to make.-</details>-<details><summary><b>Why does it need my Apple Account password?</b></summary>-Notes, Reminders, Drive and Photos open only to a full sign-in with two-factor, the same one icloud.com uses. An app-specific password reaches only mail, contacts and calendars. Skykeep never sends your password, not even to Apple: it proves it with Apple's SRP sign-in. It keeps it in your system keyring so it can sign back in by itself.-</details>--<details>-<summary><b>Is this allowed by Apple's terms?</b></summary>--Skykeep signs in the way icloud.com does, with Apple's own two-factor, and syncs your own data while you use it. Unofficial iCloud clients such as icloudpd and rclone's iCloud backend have existed for years. I can't speak for how Apple reads its terms. It's your account, and the code is open, so you can see exactly what it does.+Notes, Reminders, Drive and Photos open only to a full sign-in with two-factor, the same one icloud.com uses. Skykeep proves your password to Apple with SRP rather than sending it, and keeps it in your system keyring so it can sign back in by itself. Like any keyring entry, programs running as you can read it, and signing out erases it.</details><details><summary><b>I use Advanced Data Protection. Will it work?</b></summary>-Yes, with **Access iCloud Data on the Web** turned on: on your iPhone, Settings → your name → iCloud. Skykeep tells you when it's needed. Calendar and Contacts open right away. For Notes, Reminders, Photos and iCloud Drive, approve Skykeep on your iPhone, iPad or Mac when it asks, just as you would for icloud.com. Apple's approval lasts about an hour at a time.-</details>--<details>-<summary><b>Does it work offline?</b></summary>--Yes. Everything you've synced is on your disk. Notes, reminders, events and contacts can be edited offline and sync when you reconnect.-</details>--<details>-<summary><b>How fast do changes from my iPhone appear?</b></summary>--Notes and Reminders usually arrive in about a second. Calendar and Contacts are checked every few seconds while you're using Skykeep. Your own edits show the moment you make them.-</details>--<details>-<summary><b>Windows says it protected my PC. Is Skykeep safe?</b></summary>--The installer isn't code-signed with a certificate yet, so SmartScreen asks you to confirm: **More info**, then **Run anyway**. The copy in the [Microsoft Store](https://apps.microsoft.com/detail/9P6B042JNK54) is checked by Microsoft and installs without that question. Every release is built by the release workflow in this repository, the release page lists SHA-256 checksums, and in-app updates are signature-checked.+Yes, with **Access iCloud Data on the Web** turned on (iPhone: Settings → your name → iCloud). Calendar and Contacts open right away. For Notes, Reminders, Photos and iCloud Drive, approve Skykeep on your iPhone, iPad or Mac when it asks, as you would for icloud.com.</details><details><summary><b>How is this different from iCloud for Windows?</b></summary>-Skykeep gives you Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos as six apps of their own, each with its own Start-menu entry, taskbar button and offline library.+Skykeep gives you Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos as six apps of their own, each with its own Start-menu entry, taskbar button and offline library. And it runs on Linux too.</details><details>-<summary><b>Which Apple Accounts work?</b></summary>+<summary><b>Is my library encrypted on disk?</b></summary>-Personal Apple Accounts. Managed Apple Accounts from a school or workplace aren't supported yet.+Your library is in your own data folder, readable only by you. Turn on your system's disk encryption (BitLocker on Windows, LUKS on Linux) to protect it if your computer is lost, as you would for any app.</details><details>-<summary><b>Can I take my data with me?</b></summary>+<summary><b>Something fails only on my account. How do I send a log?</b></summary>-Any time. **Settings → Export Everything** saves your notes as Markdown, events as iCalendar, contacts as vCard, and your files as they are.+Quit Skykeep, then start it with `SKYKEEP_LOG=1 skykeep` (Windows PowerShell: `$env:SKYKEEP_LOG=1`, then `skykeep.exe`). It writes `diagnostics.log` in its data folder with the addresses it asked and Apple's answer codes, never passwords, tokens, your name or anything from your library. Attach it to an [issue](https://github.com/YashwanthKamireddi/Skykeep/issues).</details><details>-<summary><b>Something fails only on my account. How do I send a log?</b></summary>+<summary><b>How does it work?</b></summary>-Quit Skykeep (from the tray too), then start it from a terminal with diagnostics turned on:+A Rust engine with a Tauri 2 window. Every screen reads a local SQLite library, never the network, which is why it's instant and works offline. Edits go into an outbox that shows them at once, sends them in order, waits when you're offline, and is safe to send twice.-```sh-SKYKEEP_LOG=1 skykeep-# Flatpak: flatpak run --env=SKYKEEP_LOG=1 io.github.yashwanthkamireddi.Skykeep-```--On Windows, run `$env:SKYKEEP_LOG=1` in PowerShell, then start `skykeep.exe` from that same window.+- **Sign-in** is Apple's SRP and two-factor, as on icloud.com.+- **Notes and Reminders** are CloudKit records. A note's text sits in `ENCRYPTED_BYTES` fields that turn out to be gzip around a protobuf, and edits merge through Apple's own CRDT, so a note typed on both sides at once comes out whole.+- **Calendar, Contacts and Drive** use Apple's web services, **Photos** CloudKit, and changes arrive over Apple's push channel.+- **On Linux**, a FUSE mount puts iCloud Drive and Photos in your file manager.-Skykeep prints where it writes `diagnostics.log`, in its data folder (on Linux, usually `~/.local/share/io.github.yashwanthkamireddi.Skykeep/`). Sign in or sync, then attach the file to your issue. It lists which iCloud addresses Skykeep asked, Apple's answer codes, and the names of the cookies that were sent. It never contains cookie values, tokens, passwords, your name, your email or anything from your library, and Skykeep never uploads it. Start Skykeep normally again to turn diagnostics off.+Over 1,000 Rust tests hold it together. The full tour is in [ARCHITECTURE.md](ARCHITECTURE.md).</details>## Roadmap-What I'd like to add next:-- iCloud Drive and Photos as folders on Windows-- Adding and removing rows and columns in note tables-- Creating #tags in Notes-- Replying to calendar invitations, and shared calendars and notes+- Replying to calendar invitations+- Shared notes, shared reminder lists and the iCloud Shared Photo Library+- Downloading a whole photo album to a folder- Skykeep on the AUR, Flathub and winget-- A code-signed Windows installer-Got an idea or something you miss? [Open an issue](https://github.com/YashwanthKamireddi/Skykeep/issues). I read everything.+Something you miss? [Open an issue](https://github.com/YashwanthKamireddi/Skykeep/issues). I read every one.## Contributing-Skykeep is made by one person, me, [Yashwanth](https://github.com/YashwanthKamireddi). I use an iPhone and a Linux desktop every day, and I wanted my notes, reminders and photos on both without a browser tab. If you'd like to help, you're very welcome: a bug report, a packaging recipe for your distro, a design idea or code all make a real difference.--[CONTRIBUTING.md](.github/CONTRIBUTING.md) has the setup, a map of the code and the checks. Run `./check.sh` before you open a pull request.+Skykeep is made by [Yashwanth](https://github.com/YashwanthKamireddi), who uses an iPhone with a Linux desktop every day. Bug reports, packaging for your distro, design ideas and code are all welcome. [CONTRIBUTING.md](.github/CONTRIBUTING.md) has the setup and a map of the code; run `./check.sh` before a pull request.```shgit clone https://github.com/YashwanthKamireddi/Skykeep.gitcd Skykeep && npm ci && ./run.sh```-Found a security problem? Please tell me privately, as [SECURITY.md](SECURITY.md) explains.+Found a security problem? Please report it privately, as [SECURITY.md](SECURITY.md) explains.-If Skykeep saves you a trip to the browser, a star helps other iPhone owners on Linux and Windows find it. Thank you.+If Skykeep saves you a trip to the browser, a star helps other iPhone owners find it.## License-Copyright (C) 2026 Yashwanth Kamireddi. Skykeep was created by Yashwanth Kamireddi, and the code is released under [GPL-3.0](LICENSE): if you share a copy or a changed version, keep this notice and the same licence.--Skykeep is an independent project, not affiliated with or endorsed by Apple Inc. iCloud is a trademark of Apple Inc.+Copyright (C) 2026 Yashwanth Kamireddi. Released under [GPL-3.0](LICENSE): if you share a copy or a changed version, keep this notice and the same licence. Skykeep is an independent project, not affiliated with or endorsed by Apple Inc. iCloud is a trademark of Apple Inc.