diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 8664fb5..0890db0 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -5,13 +5,13 @@ on:
pull_request:
jobs:
- rust-preview:
+ rust:
runs-on: ubuntu-latest
container: archlinux:latest
timeout-minutes: 30
steps:
- name: Install native build dependencies
- run: pacman -Syu --noconfirm base-devel clang cmake git pkgconf rustup python qt6-base sqlite cairo pango noto-fonts noto-fonts-cjk noto-fonts-emoji ttf-liberation poppler qpdf fontconfig freetype2 libxkbcommon libxcb wayland vulkan-headers vulkan-icd-loader
+ run: pacman -Syu --noconfirm base-devel clang cmake git pkgconf rustup python cairo pango noto-fonts noto-fonts-cjk noto-fonts-emoji ttf-liberation poppler qpdf fontconfig freetype2 libxkbcommon libxcb wayland vulkan-headers vulkan-icd-loader
- uses: actions/checkout@v4
- name: Create unprivileged build user
run: |
@@ -27,13 +27,13 @@ jobs:
runuser -u builder -- cargo test --workspace --locked
runuser -u builder -- cargo test -p accesskit_unix --lib --locked
runuser -u builder -- cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
- - name: Check Qt-free PDF structure and content
+ - name: Check PDF structure and content
env:
CARGO_BUILD_JOBS: 4
run: |
runuser -u builder -- cargo build -p notes-export --example pdf-check --locked
runuser -u builder -- python tests/test-rust-pdf.py target/debug/examples/pdf-check
- - name: Check Rust and Qt storage compatibility
+ - name: Check Rust storage and backups
env:
CARGO_BUILD_JOBS: 4
run: |
@@ -44,18 +44,14 @@ jobs:
runuser -u builder -- python tests/test-rust-backups.py target/debug/omarchy-notes-preview --quote-driver target/debug/examples/quote-upgrade
runuser -u builder -- cargo build -p notes-storage --example organization-roundtrip --locked
runuser -u builder -- python tests/test-rust-organization.py target/debug/examples/organization-roundtrip
+ runuser -u builder -- cargo build -p notes-storage --example table-roundtrip --locked
+ runuser -u builder -- python tests/test-rust-tables.py target/debug/examples/table-roundtrip
- name: Check durable capture and instance protocol without a display
env:
CARGO_BUILD_JOBS: 4
run: |
runuser -u builder -- cargo build -p notes-platform --example instance-owner --locked
runuser -u builder -- python tests/test-rust-capture.py target/debug/omarchy-notes-preview target/debug/examples/instance-owner
- - name: Check editable table compatibility with Qt
- env:
- CARGO_BUILD_JOBS: 4
- run: |
- runuser -u builder -- cargo build -p notes-storage --example table-roundtrip --locked
- runuser -u builder -- python tests/test-rust-tables.py target/debug/examples/table-roundtrip
installer:
runs-on: ubuntu-latest
@@ -63,7 +59,7 @@ jobs:
timeout-minutes: 5
steps:
- name: Install installer test tools
- run: pacman -Syu --noconfirm bash curl python ripgrep shellcheck sudo util-linux
+ run: pacman -Syu --noconfirm bash curl git python ripgrep shellcheck sudo util-linux
- uses: actions/checkout@v4
- name: Create unprivileged test user
run: |
@@ -71,70 +67,12 @@ jobs:
chown -R builder:builder "$GITHUB_WORKSPACE"
- name: Check installer syntax and lint
run: |
- bash -n install.sh tests/test-installer.sh tests/test-installer-package.sh
- shellcheck install.sh tests/test-installer.sh tests/test-installer-package.sh
+ bash -n install.sh tests/test-installer.sh tests/check-rust-arch-package.sh tests/test-rust-installer-package.sh
+ shellcheck install.sh tests/test-installer.sh tests/check-rust-arch-package.sh tests/test-rust-installer-package.sh
- name: Test installer without network or system changes
run: runuser -u builder -- ./tests/test-installer.sh
- - name: Check separate Rust identity and immutable preparation
- run: |
- pacman -S --noconfirm --needed git
- runuser -u builder -- python3 tests/test_rust_release.py
-
- build-and-test:
- runs-on: ubuntu-latest
- container: archlinux:latest
- timeout-minutes: 30
- steps:
- - name: Install build dependencies
- run: pacman -Syu --noconfirm appstream base-devel cmake desktop-file-utils git ninja qt6-base qt6-declarative qt6-svg sqlite ttf-dejavu
- - uses: actions/checkout@v4
- - name: Create unprivileged test user
- run: |
- useradd --create-home builder
- chown -R builder:builder "$GITHUB_WORKSPACE"
- - name: Check release metadata
- run: runuser -u builder -- ./tests/test-release-metadata.sh
- - name: Verify production install tree
- run: runuser -u builder -- ./tests/test-package-install.sh
- - name: Build and test
- run: |
- runuser -u builder -- cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
- runuser -u builder -- cmake --build build
- runuser -u builder -- env QT_QPA_PLATFORM=offscreen QT_QUICK_BACKEND=software \
- ctest --test-dir build --output-on-failure --timeout 300
- - name: Keep editor screenshots
- if: always()
- uses: actions/upload-artifact@v4
- with:
- name: editor-screenshots
- path: build/screenshots
- if-no-files-found: ignore
-
- arch-package:
- runs-on: ubuntu-latest
- container: archlinux:latest
- timeout-minutes: 30
- steps:
- - name: Install packaging tools
- run: pacman -Syu --noconfirm base-devel curl git namcap python ripgrep sudo util-linux
- - uses: actions/checkout@v4
- - name: Prepare source and AUR files
- run: |
- useradd --create-home builder
- echo 'builder ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/builder
- chmod 440 /etc/sudoers.d/builder
- chown -R builder:builder "$GITHUB_WORKSPACE"
- runuser -u builder -- git config --global --add safe.directory "$GITHUB_WORKSPACE"
- runuser -u builder -- python3 packaging/prepare-release.py --ref HEAD --output build-aur-ci
- # A systemd-nspawn chroot (extra-x86_64-build) can't run inside the
- # job container; the container itself is fresh, and --syncdeps installs
- # only the dependencies the PKGBUILD declares.
- - name: Build the package from the AUR files
- run: runuser -u builder -- bash -c 'cd build-aur-ci/aur && makepkg --syncdeps --noconfirm --cleanbuild'
- - name: Validate package contents and dependencies
- run: ./tests/check-arch-package.sh build-aur-ci/aur
- - name: Install and verify through the installer in the disposable container
- run: runuser -u builder -- ./tests/test-installer-package.sh build-aur-ci/aur
+ - name: Check Rust identity and immutable preparation
+ run: runuser -u builder -- python3 tests/test_rust_release.py
rust-arch-candidate:
runs-on: ubuntu-latest
@@ -144,19 +82,19 @@ jobs:
- name: Install Rust packaging tools
run: pacman -Syu --noconfirm appstream base-devel clang cmake curl desktop-file-utils git namcap pkgconf python ripgrep rustup shellcheck sudo util-linux
- uses: actions/checkout@v4
- - name: Prepare immutable separate Rust candidate
+ - name: Prepare immutable Rust candidate
run: |
useradd --create-home builder
echo 'builder ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/builder
chmod 440 /etc/sudoers.d/builder
chown -R builder:builder "$GITHUB_WORKSPACE"
runuser -u builder -- git config --global --add safe.directory "$GITHUB_WORKSPACE"
- runuser -u builder -- python3 packaging/prepare-release.py --edition rust --candidate --ref HEAD --output build-rust-ci
- - name: Build from the archived Rust recipe and locked dependencies
+ runuser -u builder -- python3 packaging/prepare-release.py --candidate --ref HEAD --output build-rust-ci
+ - name: Build from the archived recipe and locked dependencies
run: runuser -u builder -- bash -c 'cd build-rust-ci/aur && makepkg --syncdeps --noconfirm --cleanbuild'
- - name: Validate separate package metadata and files
+ - name: Validate package metadata and files
run: ./tests/check-rust-arch-package.sh build-rust-ci/aur
- - name: Verify actual Rust install, alias, headless capture and retained data on removal
+ - name: Verify install, alias, headless capture and retained data on removal
run: runuser -u builder -- ./tests/test-rust-installer-package.sh build-rust-ci/aur
- name: Retain exact candidate identity
uses: actions/upload-artifact@v4
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 179b69a..c37dc68 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -2,68 +2,19 @@ name: Release
on:
push:
- tags: ["v*", "rust-v*"]
+ tags: ["rust-v*"]
permissions:
contents: write
jobs:
- release:
- if: startsWith(github.ref, 'refs/tags/v')
- runs-on: ubuntu-latest
- container: archlinux:latest
- timeout-minutes: 40
- steps:
- - name: Install release dependencies
- run: pacman -Syu --noconfirm appstream base-devel cmake curl desktop-file-utils git github-cli namcap ninja python qt6-base qt6-declarative qt6-svg shellcheck sqlite sudo util-linux
- - uses: actions/checkout@v4
- with:
- fetch-depth: 0
- - name: Create unprivileged build user
- run: |
- useradd --create-home builder
- chown -R builder:builder "$GITHUB_WORKSPACE"
- runuser -u builder -- git config --global --add safe.directory "$GITHUB_WORKSPACE"
- # gh (run as root below) also reads the checkout, now owned by builder.
- git config --global --add safe.directory "$GITHUB_WORKSPACE"
- - name: Verify tag and release metadata
- run: runuser -u builder -- env GITHUB_REF_NAME="$GITHUB_REF_NAME" GITHUB_REF_TYPE="$GITHUB_REF_TYPE" ./tests/test-release-metadata.sh
- - name: Verify production install
- run: runuser -u builder -- ./tests/test-package-install.sh
- - name: Verify installer
- run: |
- bash -n install.sh tests/test-installer.sh tests/test-installer-package.sh
- shellcheck install.sh tests/test-installer.sh tests/test-installer-package.sh
- runuser -u builder -- ./tests/test-installer.sh
- - name: Prepare and validate release artifacts
- run: |
- runuser -u builder -- python3 packaging/prepare-release.py --ref "$GITHUB_REF_NAME" --output dist
- runuser -u builder -- bash -c 'cd dist/aur && makepkg --noconfirm --cleanbuild'
- ./tests/check-arch-package.sh dist/aur
- cp dist/aur/omarchy-notes-*.pkg.tar.zst dist/
- cp install.sh dist/install.sh
- cd dist
- sha256sum ./*.tar.gz ./*.pkg.tar.zst install.sh SOURCE_REVISION > SHA256SUMS
- - name: Write release notes from the changelog
- run: |
- version="${GITHUB_REF_NAME#v}"
- awk -v v="$version" '$0 ~ "^## \\[" v "\\]" {on=1; next} /^## \[/ {on=0} on' CHANGELOG.md > dist/NOTES.md
- test -s dist/NOTES.md
- - name: Create draft GitHub release
- env:
- GH_TOKEN: ${{ github.token }}
- run: >-
- gh release create "$GITHUB_REF_NAME" dist/*.tar.gz dist/*.pkg.tar.zst
- dist/install.sh dist/SHA256SUMS dist/SOURCE_REVISION --title "Omarchy Notes ${GITHUB_REF_NAME}"
- --notes-file dist/NOTES.md --verify-tag --draft
-
rust-release:
if: startsWith(github.ref, 'refs/tags/rust-v')
runs-on: ubuntu-latest
container: archlinux:latest
timeout-minutes: 90
steps:
- - name: Install separate Rust release dependencies
+ - name: Install Rust release dependencies
run: pacman -Syu --noconfirm appstream base-devel clang cmake curl desktop-file-utils git github-cli namcap pkgconf python ripgrep rustup shellcheck sudo util-linux
- uses: actions/checkout@v4
with:
@@ -76,15 +27,15 @@ jobs:
chown -R builder:builder "$GITHUB_WORKSPACE"
runuser -u builder -- git config --global --add safe.directory "$GITHUB_WORKSPACE"
git config --global --add safe.directory "$GITHUB_WORKSPACE"
- - name: Verify immutable Rust metadata and installer
+ - name: Verify immutable metadata and installer
run: |
runuser -u builder -- python3 tests/test_rust_release.py
- bash -n install.sh tests/check-rust-arch-package.sh tests/test-rust-installer-package.sh
- shellcheck install.sh tests/check-rust-arch-package.sh tests/test-rust-installer-package.sh
+ bash -n install.sh tests/test-installer.sh tests/check-rust-arch-package.sh tests/test-rust-installer-package.sh
+ shellcheck install.sh tests/test-installer.sh tests/check-rust-arch-package.sh tests/test-rust-installer-package.sh
runuser -u builder -- ./tests/test-installer.sh
- - name: Prepare stable Rust artifacts from the exact Rust tag
+ - name: Prepare stable artifacts from the exact Rust tag
run: |
- runuser -u builder -- python3 packaging/prepare-release.py --edition rust --ref "$GITHUB_REF_NAME" --output dist-rust
+ runuser -u builder -- python3 packaging/prepare-release.py --ref "$GITHUB_REF_NAME" --output dist-rust
runuser -u builder -- bash -c 'cd dist-rust/aur && makepkg --syncdeps --noconfirm --cleanbuild'
./tests/check-rust-arch-package.sh dist-rust/aur
runuser -u builder -- ./tests/test-rust-installer-package.sh dist-rust/aur
@@ -102,7 +53,7 @@ jobs:
exit 1
fi
cp docs/rust-release-notes.md dist-rust/NOTES.md
- - name: Create separate draft Rust release
+ - name: Create draft Rust release
env:
GH_TOKEN: ${{ github.token }}
run: |
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 698fae2..647514f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,16 @@ All notable changes to Omarchy Notes are documented here. The project uses
## [Unreleased]
+### Changed
+
+- Rust/GPUI is now the only app implementation and installer target. Existing
+ Rust executable names and data directories remain unchanged.
+
+### Removed
+
+- Retired Qt/C++/QML app, CMake build, Qt packages and live Qt test probes.
+ Frozen legacy library fixtures remain for Rust migration regression tests.
+
### Added
- Command-line installer with formatted progress, verified Arch release
diff --git a/CMakeLists.txt b/CMakeLists.txt
deleted file mode 100644
index 7f3ff90..0000000
--- a/CMakeLists.txt
+++ /dev/null
@@ -1,41 +0,0 @@
-cmake_minimum_required(VERSION 3.24)
-
-project(omarchy-notes
- VERSION 1.0.0
- DESCRIPTION "Native notes for Omarchy"
- LANGUAGES CXX)
-
-# Working name; the application ID is what desktop files, Hyprland rules and
-# D-Bus activation will key on, so it lives in exactly one place.
-set(ONOTES_APP_ID "org.omarchy.Notes" CACHE STRING "Reverse-DNS application ID")
-set(ONOTES_BINARY_NAME "omarchy-notes")
-
-set(CMAKE_CXX_STANDARD 20)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-set(CMAKE_CXX_EXTENSIONS OFF)
-set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
-
-# Qt 6.8 is the LTS floor; the editor relies on TextEdit.textDocument (6.7+).
-find_package(Qt6 6.8 REQUIRED COMPONENTS Core Gui Network Qml Quick QuickControls2 Test)
-find_package(PkgConfig REQUIRED)
-pkg_check_modules(SQLITE3 REQUIRED IMPORTED_TARGET sqlite3>=3.35)
-
-qt_standard_project_setup(REQUIRES 6.8)
-include(GNUInstallDirs)
-# Packages install into system paths; no runtime library search paths.
-set(CMAKE_SKIP_INSTALL_RPATH ON)
-
-add_compile_options(-Wall -Wextra -Wpedantic)
-
-add_subdirectory(src/core)
-add_subdirectory(src/app)
-
-include(CTest)
-if(BUILD_TESTING)
- add_subdirectory(tests)
-endif()
-
-# Documentation, license and man page.
-install(FILES README.md CHANGELOG.md SECURITY.md DESTINATION ${CMAKE_INSTALL_DOCDIR})
-install(FILES LICENSE DESTINATION ${CMAKE_INSTALL_DATADIR}/licenses/${ONOTES_BINARY_NAME})
-install(FILES packaging/man/omarchy-notes.1 DESTINATION ${CMAKE_INSTALL_MANDIR}/man1)
diff --git a/README.md b/README.md
index b468f49..0a88304 100644
--- a/README.md
+++ b/README.md
@@ -4,318 +4,149 @@
**Local, offline notes for [Omarchy](https://omarchy.org).**
-Two native editions: **Rust 1.0 with GPUI**, and the existing **Qt edition**.
-Rich notes stay on your machine, with no account required.
+A native app built with **Rust and GPUI**. Rich notes stay on your machine,
+with no account required. Rust is the only maintained implementation.
[](LICENSE)
[](https://github.com/last-refuge/omarchy-notes/releases/tag/rust-v1.0.0)
-


-[Download Rust 1.0](https://github.com/last-refuge/omarchy-notes/releases/tag/rust-v1.0.0) · [Qt edition](#qt-edition)
+[Download Rust 1.0](https://github.com/last-refuge/omarchy-notes/releases/tag/rust-v1.0.0)
-## Rust 1.0
+## What’s included
-The separate Rust edition ships for **x86_64 Arch/Omarchy on Wayland/Hyprland**.
-It includes rich writing, headings, lists, checklists, basic tables, links,
-images and files; autosave and recovery; Quick Note and durable CLI capture;
-nested folders, pins, sorting, prefix search and Recently Deleted.
+Omarchy Notes ships for **x86_64 Arch/Omarchy on Wayland/Hyprland**. It includes
+rich writing, headings, lists, checklists, basic tables, links, images and files;
+autosave and recovery; Quick Note and durable CLI capture; nested folders, pins,
+sorting, prefix search and Recently Deleted.
-**Settings → Data** provides reviewed Markdown/text file or folder imports,
-Markdown/HTML note exports, library Markdown with assets, complete backups,
-inspection and restore into a new library. Export a note as PDF from the toolbar
-or with **Ctrl+Shift+P**. Portable exports are useful copies; use a library backup
-when you need exact preservation.
+**Settings → Your notes and files → Import, export & backups** provides reviewed
+Markdown/text file or folder imports, Markdown/HTML note exports, library Markdown
+with assets, complete backups, inspection and restore into a new library. Export
+a note as PDF from the toolbar or with **Ctrl+Shift+P**. Portable exports are useful
+copies; use a library backup when you need exact preservation.
-| Workflow | Rust 1.0 | Qt edition |
-|---|---|---|
-| Rich notes, basic tables, images and files | Available; existing merged cells are preserved | Available |
-| Folders, pins, search, sorting and deletion recovery | Available | Available |
-| Quick Note, import/export and library backups | Available | Available |
-| Tags and Smart Folders | Interfaces deferred; existing metadata preserved | Available |
-| Gallery and library-wide attachment browser | Deferred | Available |
-| Automatic Hyprland Quick Note setup | Desktop action or a distinct manual binding | Optional setup command |
+**Scope limits:** Tags/Smart Folder interfaces, advanced table operations (including
+new merges), gallery, library-wide attachment browsing, drag filing, bulk
+organization and browsable revision history are deferred. Existing metadata,
+merged tables and revisions are preserved. Automatic Hyprland shortcut setup is
+not implemented. X11 and other architectures are not advertised as tested.
-Rust is a separate edition, not a complete replacement for Qt. See the
-[Rust release notes](docs/rust-release-notes.md) for scope and recorded follow-up,
-and the [installation and recovery guide](docs/rust-release.md) for details.
+The Qt app is **retired**, not a current install, build or support option. Legacy
+Qt data compatibility remains for [migration](docs/migrating.md); retirement does
+not imply full parity with its former features. See the
+[release notes](docs/rust-release-notes.md) for remaining native/package and human
+usability verification gaps.
-### Install Rust 1.0
+## Install
-Download the **published Rust release installer** and inspect it before running:
+Download the **published Rust 1.0 release installer** and inspect it before
+running. That release's installer requires `--edition rust`:
```bash
curl -fsSL https://github.com/last-refuge/omarchy-notes/releases/download/rust-v1.0.0/install.sh -o install.sh
+less install.sh
bash install.sh --edition rust --version rust-v1.0.0 --dry-run
bash install.sh --edition rust --version rust-v1.0.0 --no-quick-note
```
+The `install.sh` in this repository is now Rust-only: omit `--edition rust`
+when using that version. Qt releases are no longer installation targets.
+
The installer verifies the release checksum and package identity, then uses
pacman. Open **Omarchy Notes (Rust)** from your launcher, or run
`omarchy-notes-rust`. The `omarchy-notes-preview` compatibility launcher forwards
to Rust; an older manual preview earlier on `PATH` may need moving aside.
+The binary and Arch package remain `omarchy-notes-rust`, and the desktop ID remains
+`org.omarchy.Notes.Rust`.
-Choose **Rust Quick Note** from the desktop launcher's actions, run
-`omarchy-notes-rust --quick-note`, or press **Ctrl+Shift+N** inside Rust.
-**Ctrl+Shift+O** moves Quick Note into the main window. Use a distinct compositor
-binding if you want a global shortcut; Rust does not run Qt's automatic setup.
-
-Rust keeps notes in `~/.local/share/omarchy-notes-gpui/` and preferences in
-`~/.config/omarchy-notes-gpui/` (or the corresponding XDG locations). Qt uses
-separate directories. Removing `omarchy-notes-rust` retains your data.
-Use copies and verified backups when opening Qt libraries. Quotation/schema-3
-libraries require Rust; returning to Qt uses the pre-upgrade backup and excludes
-later Rust edits. Keep the newer library and export or back it up before rollback.
-
-### Rust screenshots
-
-The dark writing view is shown above. These are screenshots of the released
-Rust 1.0 application, using a sample library.
-
-| Light writing | Quick Note |
-|---|---|
-| [](docs/images/rust-v1-writing-light.png) | [](docs/images/rust-v1-quick-note.png) |
-| **Folders** | **Data and backups** |
-| [](docs/images/rust-v1-folders.png) | [](docs/images/rust-v1-portability.png) |
-
-[](docs/images/rust-v1-recovery.png)
-
-## Qt edition
-
-Qt remains available as `omarchy-notes`, with its own library and desktop
-identity. It supports tags, Smart Folders, gallery and the attachment browser,
-in addition to the writing workflows below. The installer **defaults to Qt**;
-Rust always requires explicit edition selection.
-
-
-Qt features
-
-- ⚡ **Start typing right away.** Notes save automatically, usually within a second. "Saved" only appears once your note is actually on disk.
-- ✍️ **Format like you'd expect:** title, heading and subheading styles, plus bold, italic, underline, strikethrough, highlight and monospace.
-- ✅ **Checklists and lists.** Bulleted, numbered and checklist items, nested as deep as you like. Click a checkbox to tick it off.
-- 📊 **Tables.** Tab moves between cells, and Tab in the last cell adds a new row.
-- 🖼️ **Images and attachments.** Add images from the toolbar or paste them in, and attach PDFs or any other file. Double-click one to open it in its usual app.
-- 🔗 **Link notes together.** Ctrl+L links to another note, and Ctrl+click follows a link.
-- 🗂️ **Folders.** Nest folders as deep as you like, move notes between them, and use All Notes to see everything at once.
-- 🏷️ **Tags.** Type `#anything` in a note and it becomes a tag, listed in the sidebar with a count. Ctrl+click a tag to see every note that has it.
-- ✨ **Smart Folders.** Save a filter, like "tagged #work, has a checklist, edited this week", and it stays up to date by itself.
-- 🖼️ **Gallery and attachments.** Flip the note list to a gallery of cards with image previews, or browse every image and file across all your notes in one place.
-- ⚡ **Quick Note.** A small window for jotting something down without opening the whole app. It's in the launcher menu, and you can bind it to a key (see below).
-- 🔍 **Search everything.** Results appear as you type, with the matching words in bold. Partial words work too: "bench" finds "benchmark". Ctrl+F finds text inside the note you're reading.
-- 📤 **Your notes aren't locked in.** Import Markdown and text files (including their images), export any note as Markdown, HTML or PDF, or export everything as a folder of Markdown files.
-- 📌 **Pin what matters.** Pinned notes stay at the top. Sort the rest by date edited, date created or title.
-- 🗑️ **Undo a delete.** Deleted notes wait in Recently Deleted for 30 days before they're gone for good. Deleting a folder moves its notes there too.
-- 💾 **Backups you can trust.** One click saves a complete copy of your library, attachments included. Restoring checks the backup first and keeps your current notes aside, so you can always go back.
-- 📋 **Copy and paste that behaves.** Copying between notes keeps everything intact. Text pasted from the web gets tidied into clean note formatting, and anything that can't come along, like images from other sites, gets a heads-up instead of vanishing silently.
-- 🎨 **Matches your theme.** Colours come from your active Omarchy theme and are adjusted automatically when they'd be hard to read.
-- 🌐 **Every language.** Emoji, right-to-left scripts, CJK and input methods (IME) all work.
-- 🛟 **Hard to lose work.** If a save fails, your text stays on screen with Retry and Export buttons, and the app won't quit until your changes are safe or you choose to discard them.
-
-
-
-
-Qt edition screenshots
-
-
-
-
-
-
-
-
-
-### Install Qt
-
-The published edition-aware installer supports both apps. Without
-`--edition rust`, it selects Qt; these commands pin the existing Qt release:
-
-```bash
-curl -fsSL https://github.com/last-refuge/omarchy-notes/releases/download/rust-v1.0.0/install.sh -o install.sh
-bash install.sh --version v1.0.0
-```
-
-After installation, open **Omarchy Notes** from your launcher. To preview, build
-from source, or request Qt's optional Quick Note setup:
-
-```bash
-bash install.sh --version v1.0.0 --dry-run
-bash install.sh --version v1.0.0 --source
-bash install.sh --version v1.0.0 --quick-note
-```
-
-`--yes` accepts package installation, but does not enable Quick Note by itself.
-`--no-quick-note` skips setup. `NO_COLOR=1` disables colour and animation.
-Downloads never switch to a source build automatically. Run the installer again
-to update, then close and reopen the app normally. Removing Qt keeps its notes:
-
-```bash
-sudo pacman -R omarchy-notes
-```
-
-### Qt package installation
-
-You can also install the **v1.0.0 x86_64 package** directly:
+Run the installer again to update, then close and reopen the app normally.
+Downloads do not silently fall back to source builds. Removing the package with
+`sudo pacman -R omarchy-notes-rust` retains your notes and preferences.
+See the [build, install and recovery guide](docs/rust-release.md).
-```bash
-sudo pacman -U https://github.com/last-refuge/omarchy-notes/releases/download/v1.0.0/omarchy-notes-1.0.0-1-x86_64.pkg.tar.zst
-```
-
-### Building Qt from source
-
-For a Qt release package on Arch, use `bash install.sh --version v1.0.0 --source`. To build a user-local
-copy yourself, follow the steps below. Other Linux systems need equivalent build
-tools, Qt 6.8 or newer, and SQLite.
-
-**1. Install the build tools:**
-
-```bash
-sudo pacman -S --needed qt6-base qt6-declarative qt6-wayland qt6-svg sqlite cmake ninja gcc pkgconf
-```
-
-**2. Build and install it for your user:**
-
-```bash
-git clone https://github.com/last-refuge/omarchy-notes.git
-cd omarchy-notes
-cmake -S . -B build-release -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="$HOME/.local"
-cmake --build build-release
-cmake --install build-release
-```
-
-That puts `omarchy-notes` in `~/.local/bin` and adds it to your app launcher.
-
-> [!TIP]
-> If it doesn't show up in the launcher right away, run `omarchy restart shell` so the launcher picks up the new app.
-
-To update later, `git pull` and run the last two `cmake` commands again. Your notes aren't touched.
+### Quick Note
-### Qt Quick Note on a key (optional)
-
-Let the app set it up. It checks your existing bindings (and Omarchy's) first, never overwrites a key that's taken, and backs up anything it changes:
+Choose **Rust Quick Note** from the desktop launcher's actions, run
+`omarchy-notes-rust --quick-note`, or press **Ctrl+Shift+N** inside the app.
+**Ctrl+Shift+O** moves Quick Note into the main window. Use a distinct, unused
+compositor binding if you want a global shortcut; automatic setup is unavailable.
```bash
-omarchy-notes --setup-hyprland
+printf 'A thought to keep\nSome details.' | omarchy-notes-rust --capture -
```
-Or do it by hand. Add a binding to `~/.config/hypr/bindings.lua`. SuperAltN is free in a default Omarchy setup:
+Capture supports durable receipts and safe retry with `--request-id UUID` and
+`--capture-status UUID`; see the [writing and capture guide](docs/gpui-preview.md).
-```lua
-o.bind("SUPER + ALT + N", "Quick Note", { launch = "omarchy-notes --quick-note" })
-```
+### Data and migration
-To make the Quick Note window float, add this to `~/.config/hypr/hyprland.lua`:
-
-```lua
-o.window({ class = "^org\\.omarchy\\.Notes$", title = "^Quick Note$" }, { tag = "+floating-window" })
-```
+Notes remain in `~/.local/share/omarchy-notes-gpui/` and preferences in
+`~/.config/omarchy-notes-gpui/` (or the corresponding XDG locations). These
+historical profile names are unchanged. Data and backups are not encrypted.
-### Qt data and backups
+Use copies and verified backups when bringing in retired Qt libraries; the original
+library is never selected automatically. Quotation/schema-3 libraries require
+Rust. A legacy rollback can only use the pre-upgrade backup and excludes later
+Rust edits; preserve the newer library and export or back it up first.
+See [migration](docs/migrating.md) and [data ownership](docs/rust-data-ownership.md).
-Everything is stored in `~/.local/share/omarchy-notes/`: an SQLite database for your notes, plus a folder of attached files. Reinstalling or removing the app never touches it.
+## Screenshots
-To back up, click **⋯** at the bottom of the folder list and choose **Back Up Library…**. You get a normal folder with a consistent copy of everything, which is safe to make while you're writing. **Restore from Backup…** in the same menu checks a backup before using it and sets your current notes aside next to the library, so nothing is lost if you change your mind.
+These are screenshots of the released Rust 1.0 application using a sample library.
-Coming from Apple Notes, Obsidian or another app? See [moving your notes in](docs/migrating.md).
-
-Want a sandbox to play in? Point the app at a different folder and fill it with sample notes:
-
-```bash
-omarchy-notes --data-dir /tmp/notes-playground --samples
-```
-
-
-All command-line options
-
-| Option | What it does |
+| Light writing | Quick Note |
|---|---|
-| `--data-dir ` | Use a notes library in a different folder |
-| `--new` | Start with a fresh note |
-| `--note ` | Open a specific note |
-| `--quick-note` | Open a Quick Note window |
-| `--capture ` | Save text as a new note without opening a window (use `-` to read from a pipe, like `echo "idea" \| omarchy-notes --capture -`) |
-| `--setup-hyprland` | Add a Quick Note key (Super+Alt+N) and floating rule to Hyprland, if the key is free |
-| `--samples` | Fill an empty library with example notes (a meeting note with a table, image and PDF, some research links, and a grocery list) |
-| `--simulate-save-failure` | Make saves fail on purpose, to see how the app handles it. Ctrl+Alt+Shift+F toggles this while running |
+| [](docs/images/rust-v1-writing-light.png) | [](docs/images/rust-v1-quick-note.png) |
+| **Folders** | **Data and backups** |
+| [](docs/images/rust-v1-folders.png) | [](docs/images/rust-v1-portability.png) |
-
+[](docs/images/rust-v1-recovery.png)
-### Qt keyboard shortcuts
+## Development
-| | Shortcut |
-|---|---|
-| New note · New folder | CtrlN · CtrlShiftN |
-| Search all notes · Find in note | CtrlShiftF · CtrlF (then F3 / Enter for the next match) |
-| Delete the selected note | Delete (in the note list) |
-| Duplicate note | CtrlD |
-| Show or hide folders | CtrlShiftS |
-| Bold · Italic · Underline | CtrlB · CtrlI · CtrlU |
-| Strikethrough · Highlight · Monospace | CtrlShiftX · CtrlShiftY · CtrlE |
-| Title · Heading · Subheading · Body | CtrlShift + T · H · J · B |
-| Checklist · Tick an item | CtrlShiftL · CtrlShiftU |
-| Bulleted · Numbered list | CtrlShift8 · CtrlShift7 |
-| Indent · Outdent a list item | Tab · ShiftTab |
-| Insert a table | CtrlAltT |
-| Attach a file · Link to a note | CtrlShiftA · CtrlL |
-| Follow a link or #tag · Open an attachment | Ctrl + click · double-click (or CtrlEnter next to it) |
-
-### Qt roadmap
-
-| | Milestone | What it brings |
-|---|---|---|
-| ✅ | **Editor & storage** | Rich editing, autosave, crash-safe storage, theme support |
-| ✅ | **Daily-use alpha** | Delete & trash, folders, pinning, search, backup & restore |
-| ✅ | **Local beta** | Tags, Smart Folders, gallery view, import/export, Quick Note, find in note |
-| ✅ | **1.0** | Arch package, accessibility polish, performance targets met ([numbers](docs/performance.md)) |
-| 💭 | **After 1.0** | Locked notes, OCR, audio, sync between devices, sharing |
-
-The Qt plan is in [`llm-docs/omarchy-notes-plan.md`](llm-docs/omarchy-notes-plan.md), with a visual version in [`llm-docs/roadmap.html`](llm-docs/roadmap.html) (download it and open it in a browser). Big technical decisions are written up in [`docs/decisions/`](docs/decisions/).
-
-## 🛠️ Hacking on it
-
-For Rust development, see the [Rust build guide](docs/rust-release.md) and the
-[`crates/`](crates/) workspace. The Cargo package retains its historical name;
-the application executable is `omarchy-notes-rust`.
+See the [Rust build guide](docs/rust-release.md),
+[writing guide](docs/gpui-preview.md), [performance diagnostics](docs/rust-performance.md)
+and [native acceptance guide](docs/rust-native-acceptance.md).
+Build with Cargo using the pinned toolchain in `rust-toolchain.toml`. See the
+build guide for native system dependencies. There is no Qt or CMake app build.
+The Cargo package retains its historical name, `omarchy-notes-preview`; the
+executable is `omarchy-notes-rust`:
```bash
-cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust
-cargo test --workspace --locked
+cargo build --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust
+./target/release/omarchy-notes-rust
```
-For Qt development, build a debug version and run the tests:
+Run the Rust checks:
```bash
-cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
-cmake --build build
-ctest --test-dir build --output-on-failure
+cargo test --workspace --locked
+cargo fmt --all --check
+cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
```
-The Qt editor tests drive the real app off-screen and save screenshots to `build/screenshots/`, which is handy for checking what changed visually. `tests/bench_library` measures the performance targets, and [docs/arch-release.md](docs/arch-release.md) explains how releases are made.
+Frozen legacy Qt library fixtures remain for migration regression tests; the
+Qt source, QML, packaging and live Qt test probes have been removed.
-| Folder | What's inside |
+| Folder | Contents |
|---|---|
-| [`crates`](crates) | Rust core, editor, UI, platform, storage and import/export libraries. |
-| [`src/core`](src/core) | The engine: the note format, saving to SQLite, attachment storage and theme colours. There's no UI code in here. |
-| [`src/app`](src/app) | The app itself: the editor logic and the Qt Quick (QML) interface. |
-| [`tests`](tests) | Round-trip, storage (including a "kill it mid-save" durability test), theme contrast, end-to-end editor and launch tests, plus packaging checks. |
-| [`packaging`](packaging) | Desktop entry, icon, AppStream metadata, man page and the AUR recipe template. |
-
-Found a bug or have an idea? [Open an issue](https://github.com/last-refuge/omarchy-notes/issues). It's early days, so feedback shapes where this goes.
+| [`crates`](crates) | Rust core, editor, UI, platform, storage and import/export libraries |
+| [`packaging`](packaging) | Package recipes, desktop metadata, icons and man pages |
+| [`tests`](tests) | Storage, editor, native acceptance, migration and packaging checks |
+| [`docs/decisions`](docs/decisions) | Historical architecture decisions, not current installation guidance |
+| [`llm-docs`](llm-docs) | Historical plans and evidence ledgers; old Qt support/default statements are superseded |
-## 🔒 Security
+Found a bug or idea? [Open an issue](https://github.com/last-refuge/omarchy-notes/issues).
-If you find a security issue, please **don't** open a public issue. Report it privately by following the steps in [SECURITY.md](SECURITY.md).
-
-## 📄 License
+## Security and license
+Report security issues privately via [SECURITY.md](SECURITY.md).
Omarchy Notes is released under the [MIT License](LICENSE).
----
-
-
-Made for Omarchy 🖤 · Not affiliated with Apple or the Omarchy project
-
+Not affiliated with Apple or the Omarchy project.
diff --git a/SECURITY.md b/SECURITY.md
index eaac7ae..477d83d 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -2,7 +2,9 @@
## Supported versions
-Security fixes are provided for the latest published Omarchy Notes release.
+Security fixes are provided for the latest published Rust Omarchy Notes release
+(`rust-v*`, package/executable `omarchy-notes-rust`). The Qt app is retired and no
+longer supported; legacy format compatibility is for migration only.
Pre-release builds from `master` receive fixes as they are developed, but are not
supported releases.
@@ -20,10 +22,17 @@ investigate it, and coordinate disclosure and a fixed release with the reporter.
## Data and storage
-Omarchy Notes works offline and has no accounts, sync or network access. Notes
-are stored locally in SQLite under `$XDG_DATA_HOME/omarchy-notes`, with
-attachments kept as files beside the database. Neither is encrypted by the app,
-so they're protected only by your user account and any disk encryption on your
-system. Backups made with **Back Up Library…** are plain, unencrypted copies of
-that data; store them somewhere you trust. Encrypted locked notes are planned but
-not yet available.
+Omarchy Notes works offline and has no accounts or sync. Notes are stored locally
+in SQLite under `$XDG_DATA_HOME/omarchy-notes-gpui` (by default
+`~/.local/share/omarchy-notes-gpui`), with attachments beside the database.
+Preferences remain under `$XDG_CONFIG_HOME/omarchy-notes-gpui`. `--data-dir` can
+select a different library. Neither notes nor attachments are encrypted by the
+app; protection depends on your user account and any system disk encryption.
+Backups made through Settings → Your notes and files are plain, unencrypted
+copies; store them somewhere trusted. Encrypted locked notes are not available.
+
+Imported files are untrusted input. Review import warnings; external links and
+attachments can open other applications whose network and security behavior is
+outside the notes app. Installation and dependency fetching require network
+access. Preserve original legacy Qt data and verified backups when migrating;
+see [migration guidance](docs/migrating.md).
diff --git a/crates/notes-ui/assets/NOTICE.md b/crates/notes-ui/assets/NOTICE.md
index 68b74cd..284f6ee 100644
--- a/crates/notes-ui/assets/NOTICE.md
+++ b/crates/notes-ui/assets/NOTICE.md
@@ -7,8 +7,9 @@ https://github.com/notofonts/latin-greek-cyrillic/blob/main/OFL.txt.
They were copied from the installed Arch `noto-fonts` package; the embedded license
was checked independently of the package's aggregate license file.
-Existing line icons were adapted from this project's `src/app/icons/`, under the
-repository MIT license, changing black strokes to `currentColor`. The additional
+Existing line icons were adapted from the retired Qt app's `src/app/icons/`
+(preserved in Git history), under the repository MIT license, changing black
+strokes to `currentColor`. The additional
simple geometric icons were authored for this preview under the same license.
The search adapter's input-handler and custom paint integration follows the GPUI
diff --git a/docs/arch-release.md b/docs/arch-release.md
index c24b997..327b136 100644
--- a/docs/arch-release.md
+++ b/docs/arch-release.md
@@ -1,98 +1,14 @@
-# Releasing Omarchy Notes
+# Arch releases
-Releases follow the same flow as Omarchy Calendar. `packaging/arch/PKGBUILD.in` is a template,
-not an AUR submission: release preparation generates `PKGBUILD` and `.SRCINFO` with the checksum
-of the exact source archive users will download.
+Omarchy Notes now ships only the Rust app. The Qt release route is retired;
+old Qt release plans and ADRs are historical records, not current build or
+publication instructions.
-## 1. Prepare the version
+Use [Building and installing Omarchy Notes (Rust)](rust-release.md) for candidate
+source preparation, Arch packaging, installer verification and release freeze.
+The package/executable remains `omarchy-notes-rust`, desktop ID remains
+`org.omarchy.Notes.Rust`, and release tags remain `rust-vVERSION`.
+Do not reuse the retired Qt `vVERSION` tags or replace published archives.
-Update the version in `CMakeLists.txt` (`project(omarchy-notes VERSION …)`),
-`packaging/arch/PKGBUILD.in`, `packaging/metainfo/org.omarchy.Notes.metainfo.xml`,
-`packaging/man/omarchy-notes.1` and `CHANGELOG.md`, then check them together:
-
-```bash
-shellcheck install.sh tests/test-installer.sh tests/test-installer-package.sh
-./tests/test-installer.sh
-./tests/test-release-metadata.sh
-./tests/test-package-install.sh
-```
-
-## 2. Build and check the package locally (optional)
-
-Commit first: the generator archives a committed revision, not the working tree. It never
-creates tags, pushes, or publishes anything.
-
-```bash
-python3 packaging/prepare-release.py --ref HEAD --output build-aur-release
-cd build-aur-release/aur && makepkg --cleanbuild && cd ../..
-./tests/check-arch-package.sh build-aur-release/aur
-```
-
-For a clean-chroot build, use `extra-x86_64-build` instead of `makepkg` (needs `devtools`).
-CI builds with `makepkg --syncdeps` in a fresh container, since a chroot can't run inside it.
-CI also runs `tests/test-installer-package.sh` as the build user in that disposable
-container: it checks a dry run, installs the real package through the installer,
-and verifies a repeat run. Only release transport is replaced with local artifacts.
-
-## 3. Tag and publish
-
-```bash
-git tag v1.0.0 && git push origin v1.0.0
-```
-
-The Release workflow checks the metadata, builds and validates the package, and creates a
-**draft** GitHub release with:
-
-- `omarchy-notes-VERSION.tar.gz`: the source archive the AUR package downloads
-- `omarchy-notes-VERSION-aur.tar.gz`: `aur/PKGBUILD` and `aur/.SRCINFO`
-- the built package, `SHA256SUMS` and `SOURCE_REVISION`
-- `install.sh`, also covered by `SHA256SUMS`
-
-Review the draft: confirm `install.sh` is attached and its checksum is present.
-Publish it, then check the AUR files fetch the published archive:
-
-```bash
-tar xf omarchy-notes-1.0.0-aur.tar.gz && cd aur && makepkg --verifysource
-```
-
-Verify the installer in a disposable Arch system as an unprivileged user, using
-the version just published:
-
-```bash
-curl -fsSL https://github.com/last-refuge/omarchy-notes/releases/latest/download/install.sh -o install.sh
-less install.sh
-bash install.sh --version vVERSION --dry-run
-bash install.sh --version vVERSION --no-quick-note
-```
-
-Before the first release containing an installer, keep the README and website's
-primary command pointing at the existing package. After publishing and checking
-the installer asset, update both primary commands to:
-
-```bash
-curl -fsSL https://github.com/last-refuge/omarchy-notes/releases/latest/download/install.sh | bash
-```
-
-Keep the download-and-inspect instructions, direct package command, and CMake
-build instructions available. The old v1.0.0 release does not contain an installer;
-do not replace its published archives to add one.
-
-## 4. Submit to the AUR
-
-The first time, create the package on the AUR by pushing to a new repo:
-
-```bash
-git clone ssh://aur@aur.archlinux.org/omarchy-notes.git aur-omarchy-notes
-cp aur/PKGBUILD aur/.SRCINFO aur-omarchy-notes/
-cd aur-omarchy-notes
-git add PKGBUILD .SRCINFO && git commit -m "omarchy-notes 1.0.0" && git push
-```
-
-Only commit `PKGBUILD` and `.SRCINFO`. Never upload the source archive, binaries or
-`PKGBUILD.in`. Don't replace a published source archive in place: any change needs a new
-version (or `pkgrel` bump) and freshly generated checksums.
-
-## Screenshots
-
-`tools/capture-screenshots.sh BUILD_DIR` regenerates the website and README images from the
-real app with the sample library, in stock Omarchy themes.
+See [release identity](rust-edition.md), [dependency notices](rust-v1-dependency-inventory.md)
+and [release notes](rust-release-notes.md) for scope and remaining acceptance work.
diff --git a/docs/gpui-preview.md b/docs/gpui-preview.md
index b8bcdc1..f3590bb 100644
--- a/docs/gpui-preview.md
+++ b/docs/gpui-preview.md
@@ -1,11 +1,17 @@
-# Rust / GPUI writing preview
+# Rust / GPUI writing and capture guide
+
+Omarchy Notes is Rust-only; Qt is retired and mentioned below only for legacy
+format migration. This guide retains incremental screenshots and verification
+notes from development. Old milestone gates are historical, not current support
+policy. For current release scope and unverified acceptance items, see the
+[release notes](rust-release-notes.md).
The Rust edition creates, edits and saves real notes with inline images,
attachment cards, rich clipboard exchange and carefully typeset PDF export. It pairs a quiet,
serif writing surface with graphite/champagne and warm-paper appearances,
selection-aware formatting controls, focus mode and layouts down to 420 logical
-pixels. **This is early access.** The Qt app remains the supported release and
-installer; the complete rebuild feasibility gate is still open.
+pixels. The current installer defaults to Rust. Retirement of Qt does not close
+the native/package or human usability verification gaps.

@@ -24,16 +30,16 @@ uses installed fonts: `noto-fonts` is recommended, with `noto-fonts-cjk`,
`noto-fonts-emoji` and fonts for the languages you write in. Do not run Cargo as root.
```sh
-cargo run --release -p omarchy-notes-preview -- --reference
-cargo run --release -p omarchy-notes-preview -- --light
+cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust -- --reference
+cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust -- --light
# Choose a new library explicitly:
-cargo run --release -p omarchy-notes-preview -- --data-dir /tmp/my-rust-notebook
+cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust -- --data-dir /tmp/my-rust-notebook
# The original disposable design sample remains opt-in:
-cargo run --release -p omarchy-notes-preview -- --demo --reference
+cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust -- --demo --reference
```
Normal launches use `$XDG_DATA_HOME/omarchy-notes-gpui`, falling back to
-`~/.local/share/omarchy-notes-gpui`. The installed Qt library is never selected
+`~/.local/share/omarchy-notes-gpui`. The retired Qt library is never selected
automatically. `--data-dir` can open a compatible library; use a consistent
backup/copy for compatibility testing, and close the other edition first.
The editions exclude each other through the same `.lock` protocol. Rust forwards
@@ -121,8 +127,9 @@ acknowledgement; errors keep your input ready to correct and retry.
Filing keeps your current text, caret and undo/redo history and returns you to
the editor. Existing rich documents and the Qt-compatible schema are preserved.
-Folder deletion, trash, drag-and-drop filing, persistent expansion state and
-complete keyboard tree navigation remain pending. See
+Folder deletion, Recently Deleted and keyboard tree navigation are available.
+Drag-and-drop filing remains deferred; folder deletion Undo restores notes unfiled
+rather than rebuilding the deleted folders. See
[ADR 0016](decisions/0016-folders-and-filing.md).
## Make yourself at home
@@ -234,8 +241,9 @@ path and database digest, but cannot protect a backup that is later moved or del
JSON and rich clipboard preserve quotation blocks. HTML uses `blockquote`, and
the Markdown conversion backend uses `>`. Pasting a quote into prose keeps its
boundaries; nested HTML/Markdown quotes flatten with an explicit warning. PDF
-preserves the inset rule across page breaks. Full Markdown file import/export and
-media packaging remain pending; the conversion backend is not yet a file UI.
+preserves the inset rule across page breaks. Reviewed Markdown/text file import
+and portable Markdown/HTML exports with assets are available through Settings;
+see [data ownership](rust-data-ownership.md).
## Connect a thought
@@ -358,7 +366,7 @@ other Wayland clipboard protocols remain pending.
Headless capture, help and version do not initialize a window or GPU:
```sh
-printf 'A thought to keep\nSome details.' | cargo run --release -p omarchy-notes-preview -- --capture -
+printf 'A thought to keep\nSome details.' | omarchy-notes-rust --capture -
```
Capture now also works while the Rust app owns that library. The note appears in
@@ -389,7 +397,7 @@ Use **Ctrl+Shift+N** or the notebook icon beside New Note to open Quick Note.
Start directly in its compact writing window, or reach the existing Quick Note:
```sh
-cargo run --release -p omarchy-notes-preview -- --reference --quick-note
+cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust -- --reference --quick-note
```
Quick Note has the same rich formatting, images, files and clipboard as the main
@@ -416,9 +424,9 @@ It preserves the current note and caret. These options work at startup and when
that Rust library is already open:
```sh
-target/release/omarchy-notes-preview --new
-target/release/omarchy-notes-preview --note NOTE_UUID
-target/release/omarchy-notes-preview --quick-note
+omarchy-notes-rust --new
+omarchy-notes-rust --note NOTE_UUID
+omarchy-notes-rust --quick-note
```
Add `--data-dir PATH` when using a different library. `--new` creates and opens
@@ -482,15 +490,15 @@ blocks creation. Never use your only copy of a library for fault testing.
### Full-library backups and safe restore
-Close the edition using the source library, then use the preview's headless
+Close the writer using the source library, then use the Rust app's headless
commands. The destination's parent must exist; its final folder must be new.
```sh
# Replace the example paths with your library, backup and recovery locations.
-target/release/omarchy-notes-preview --data-dir /path/to/library --backup /path/to/new-backup
-target/release/omarchy-notes-preview --inspect-backup /path/to/new-backup
-target/release/omarchy-notes-preview --restore /path/to/new-backup --data-dir /path/to/new-restored-library
-target/release/omarchy-notes-preview --data-dir /path/to/new-restored-library --reference
+omarchy-notes-rust --data-dir /path/to/library --backup /path/to/new-backup
+omarchy-notes-rust --inspect-backup /path/to/new-backup
+omarchy-notes-rust --restore /path/to/new-backup --data-dir /path/to/new-restored-library
+omarchy-notes-rust --data-dir /path/to/new-restored-library --reference
```
These commands need no display or running app. Backup takes the shared library
@@ -521,15 +529,17 @@ such a directory as a completed backup. An error syncing the parent after
publication preserves the completed destination and names it for inspection.
The commands refuse missing/damaged assets and unsupported future formats.
-Actual Qt backup creation → Rust restore and Rust backup → Qt inspection/open
-pass in the scratch-library oracle. SIGKILL tests cover snapshot, blob, manifest
+Historical Qt backup creation → Rust restore and Rust backup → Qt inspection/open
+passed in the scratch-library oracle. SIGKILL tests cover snapshot, blob, manifest
and publication boundaries; injected write failures cover ENOSPC paths. Physical
disk-full, sudden power loss, network filesystems and production-scale timing are
not verified. The quote-upgrade panel uses this backup path with progress and
-cancellation. General in-app backup/restore and Settings routes remain pending.
-Schema-3 backups restore in Rust; Qt rejects them. Actual Qt refusal and restoring
-the pre-upgrade schema-2 backup are covered by the cross-edition oracle; see
-[ADR 0011](decisions/0011-backups-and-quote-migration.md).
+cancellation. General in-app backup/restore and Settings routes are now available;
+see [data ownership](rust-data-ownership.md).
+Schema-3 backups restore in Rust. Historical cross-edition checks verified that
+Qt rejected them and could reopen the restored pre-upgrade schema-2 backup; see
+[ADR 0011](decisions/0011-backups-and-quote-migration.md). Current regressions use
+Rust and frozen legacy fixtures; the live Qt oracle has been retired.
## A page worth sharing
@@ -576,17 +586,18 @@ large-document performance guarantees.
## Remaining work
-New table merges, trash and folder deletion, tags/Smart Folders,
-remaining library views, non-PDF import/export and the in-app backup/restore workflow
-remain pending. Personal writing/appearance Settings are available; their
-remaining library-action routes still need implementation. Window forwarding, Quick Note and headless verified
-backup/restore commands are available.
-Library search uses loaded text; SQLite FTS is maintained for compatibility but
-is not yet the search backend. Large-document layout and undo memory have not
-been optimized or benchmarked. Loaded documents and undo snapshots are in memory.
-
-The input adapter implements UTF-16 ranges, marked text and caret geometry, with
-composition logic tested through GPUI. **Real IME and Orca are not verified.**
+New table merges and advanced table operations, tags/Smart Folder interfaces,
+gallery and library-wide attachment browsing, drag filing, bulk organization and
+browsable revision history remain deferred. Trash, folder deletion, prefix search
+with snippets, reviewed imports, portable exports and in-app backup/restore are
+implemented. Editor retention and layout have bounded implementations and measured
+CPU budgets; broader native fairness/performance acceptance remains follow-up.
+
+The input adapter implements UTF-16 ranges, marked text and caret geometry.
+Release checks recorded actual CJK composition and silent Orca processing, but
+**complete human accessibility usability is unverified**. The native Unicode
+editing/undo test stopped on stale accessible node traversal; see the
+[release notes](rust-release-notes.md) for the evidence boundary.
The installed AT-SPI client reports cache-signature warnings and can retain
closed-window nodes; the multi-window oracle explicitly selects the active
window's accessibility frame. Screen-reader behavior across handoff still needs
@@ -601,7 +612,8 @@ geometry need deeper coverage.
The pinned Linux AccessKit adapter exposes `Text`, but not AT-SPI `EditableText`;
editing uses the keyboard after accessible caret/selection changes.
X11 runtime, mixed-DPI, suspend/resume and long-session behavior remain unverified.
-These gaps keep M2 open and prevent installer cutover.
+These were open M2 gates. Rust is now the installer default, but retirement does
+not establish that these checks passed; consult the current release evidence.
## Development checks
@@ -625,17 +637,10 @@ cargo run -p notes-ui --example pdf-ui-check --features visual-tests -- target/p
# PDF checks also require Poppler and qpdf; --output must name a new directory:
cargo build -p notes-export --example pdf-check --locked
python tests/test-rust-pdf.py target/debug/examples/pdf-check --output target/pdf-review
-# Cross-version checks additionally require Qt6Core, sqlite3, Python and g++:
-cargo build --release -p omarchy-notes-preview --locked
-cargo build -p notes-storage --example compatibility-edit --locked
-python tests/test-rust-compatibility.py target/release/omarchy-notes-preview target/debug/examples/compatibility-edit
-cargo build -p notes-storage --example quote-upgrade --locked
-python tests/test-rust-backups.py target/release/omarchy-notes-preview --quote-driver target/debug/examples/quote-upgrade
-cargo build -p notes-storage --example organization-roundtrip --locked
-python tests/test-rust-organization.py target/debug/examples/organization-roundtrip
# Durable capture and local Unix IPC, with no graphical session:
+cargo build --release -p omarchy-notes-preview --bin omarchy-notes-rust --locked
cargo build -p notes-platform --example instance-owner --locked
-python tests/test-rust-capture.py target/release/omarchy-notes-preview target/debug/examples/instance-owner
+python tests/test-rust-capture.py target/release/omarchy-notes-rust target/debug/examples/instance-owner
```
The writing harness routes real GPUI input through the rich editor and storage
@@ -648,8 +653,9 @@ The media harness imports images/files through the real writer queue, checks
cached image rendering, removal/undo, stale-cursor confirmation, cancellation,
failed import and compact reopen. Storage tests also verify exact portable bytes,
remapped ownership, corrupt/missing files, size limits and nonblocking rejection
-of special files. The compatibility probe uses the actual Qt document reader and `QLockFile` APIs
-against scratch copies; it checks both lock directions and unchanged blob hashes.
+of special files. Historical legacy migration oracles used the actual Qt document
+reader and `QLockFile` APIs against scratch copies to check both lock directions
+and unchanged blob hashes. Those results are migration evidence, not Qt support.
For opt-in desktop clipboard/input checks (Hyprland, `wtype`, `wl-clipboard`):
diff --git a/docs/index.html b/docs/index.html
index b7b4ca8..9d76942 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,10 +4,10 @@
Omarchy Notes
-
+
-
+
@@ -208,20 +208,20 @@
- For Omarchy · Native Qt · Free and open source
+ For Omarchy · Native Rust / GPUI · Free and open source
Notes that feel at home on Omarchy.
-
Apple Notes' easy capture, rebuilt as a fast native app for your desktop. Start typing and it's saved: checklists, tables, images, #tags and search, stored on your machine and dressed in your theme.
+
Local, offline notes in a native Rust app. Rich writing, checklists, basic tables, images, Quick Note and search, stored on your machine with no account required.
Coming soon to the AUR. The AUR has paused new account sign-ups while it deals with a wave of automated registrations. Omarchy Notes will be published there as soon as registration reopens, and then yay -S omarchy-notes will work too.
+
Download and inspect
+
Use the published Rust 1.0 release installer on x86_64 Arch/Omarchy, as your normal user:
The current installer installs Rust by default and needs no edition selector. Older edition-aware installers require --edition rust. Checksums and package identity are verified before pacman installation. Run it again to update; data is retained. Binary/package remains omarchy-notes-rust, desktop ID org.omarchy.Notes.Rust.
-
Install with guided progress
-
The checkout installer checks release checksums, shows progress, and offers optional Quick Note setup. Download and inspect it, then run it as your normal user:
Run it again to update. Use --version v1.0.0 to choose a release or --source to build with makepkg. --yes accepts package installation; Quick Note requires --quick-note for unattended runs. Your notes are kept. The v1.0.0 release has no installer asset yet.
+
Open and capture
+
Search your launcher for Omarchy Notes (Rust). Use its Rust Quick Note action, omarchy-notes-rust --quick-note, or CtrlShiftN in the app. A global shortcut needs a manual unused compositor binding; automatic setup is not implemented.
-
Then open it
-
Press SuperSpace and search for Omarchy Notes. Optional: put Quick Note on SuperAltN. This checks your existing key bindings first and never overwrites one:
-
$omarchy-notes --setup-hyprland
+
Build from source
+
Install the pinned Rust toolchain and native dependencies from the Rust build guide. The Cargo package name is historical:
+
cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust
+cargo test --workspace --locked
-
Or build it yourself
-
You'll need Qt 6.8 or newer, SQLite, CMake and Ninja.
Advanced table operations, drag filing, bulk organization and browsable revision history are deferred. X11 and other architectures are not advertised. Native/package and human usability checks still have gaps; see release notes.
+
Qt is retired, not a current install or support option. Migrate copies with verified backups; schema-3 quotation libraries require Rust. See migration and data and backups. Profile names remain unchanged; data and backups are unencrypted.
diff --git a/docs/migrating.md b/docs/migrating.md
index 94947e6..852933d 100644
--- a/docs/migrating.md
+++ b/docs/migrating.md
@@ -1,43 +1,66 @@
# Moving your notes into Omarchy Notes
-Omarchy Notes imports Markdown (`.md`) and plain-text (`.txt`) files, one at a time or as whole
-folders. Folders become folders, checklists stay checklists, tables stay tables, and images a
-note points to are copied into your library. Anything that can't come across (for example
-images hosted on the web) is listed after the import, never silently dropped.
+The current app is Rust-only. Qt is retired; compatibility with its library and
+backup formats exists for legacy migration, not as a supported installation route.
-Both options are in the **⋯** menu at the bottom of the folder list:
+## Markdown and text imports
-- **Import Markdown or Text…** for individual files
-- **Import a Folder of Notes…** for a whole exported library
+Open **Settings → Your notes and files → Import, export & backups** and choose
+Markdown/text files or a folder. Sources are never edited. Review counts and
+warnings before **Accept & import**. Folder structure and links between imported
+notes receive new identities; supported local assets are copied.
-## From Apple Notes
+Imports are bounded to 1,000 text files and 64 MiB of text and unique asset bytes.
+Symbolic links are refused, and local resources must be within the selected folder
+or file's parent. Missing/remote assets and unsupported formatting are reported
+before copying. Quotation content requires an explicit format upgrade with a
+verified backup. See [data ownership](rust-data-ownership.md) for exact boundaries.
-Apple Notes can't export to Markdown by itself, so use an exporter on your Mac first:
+### From Apple Notes
-1. Install **Exporter** (free) from the Mac App Store.
-2. Export all folders as **Markdown**. Exporter writes one folder per Notes folder, with
- images alongside.
-3. Copy the exported folder to your Omarchy machine.
-4. In Omarchy Notes choose **Import a Folder of Notes…** and pick it.
+Use a Markdown exporter on your Mac, then copy its exported folders and assets to
+your Omarchy machine and import the folder. Exporter output varies: review warnings
+and check important notes after import. Unlock protected notes before export;
+drawings or scans need an exporter that includes their image files.
-Locked (password-protected) notes can't be exported by any tool; unlock them in Apple Notes
-first. Drawings and scanned documents come across as images.
+### From Obsidian, Logseq, Bear, Joplin and others
-## From Obsidian, Logseq, Bear or any Markdown folder
+Export to Markdown or select a copy of the Markdown folder. For Joplin, use
+**File → Export all → MD – Markdown**. Application-specific metadata and wiki links
+may not transfer as functional structures. Tags and Smart Folder interfaces are
+not implemented in Rust; do not expect `#tags` to create browsable tag filters.
+Review the supported formatting and asset warnings rather than assuming parity
+with the source app.
-Choose **Import a Folder of Notes…** and pick your vault or export folder. Front matter at the
-top of files is skipped, `#tags` in the text become tags, and GitHub-style task lists
-(`- [ ]`) become checklists. Wiki links (`[[Note]]`) come across as plain text.
+## From the retired Qt app
-## From Joplin, Standard Notes and others
+The former default library is `~/.local/share/omarchy-notes/`; the Rust profile
+remains `~/.local/share/omarchy-notes-gpui/`. Corresponding XDG overrides apply.
+Rust does not automatically open, rename or upgrade the former library, and does
+not import Qt's `settings.ini` as Rust preferences.
-Export to Markdown from the app (Joplin: **File → Export all → MD – Markdown**), then import the
-folder.
+1. Close any legacy app using the library and preserve a consistent copy plus a
+ verified backup. Never experiment on the only original.
+2. Open the copied compatible library with **Open Library** in Settings, or
+ `omarchy-notes-rust --data-dir /path/to/copied-library`. For a format-1 backup,
+ use **Inspect Backup**, then restore into a new directory.
+3. Check notes and assets. Existing tags/Smart Folder metadata, merged tables and
+ revisions are preserved, but their deferred interfaces do not become available.
+4. Enabling quotations explicitly upgrades to schema 3 and creates a verified
+ pre-upgrade backup. Legacy Qt cannot read the upgraded library. A legacy rollback
+ uses that backup and excludes later Rust edits; preserve the newer library and
+ back it up or export before any rollback.
+
+Only Rust owners provide the durable Rust capture/launch protocol. A legacy owner
+must close before Rust can acquire the same library. Legacy media clipboard data
+requires referenced assets already in the receiving library; cross-library rich
+media exchange with Qt is not supported.
## Leaving again
-You're never locked in. Use **Export All Notes as Markdown…** in the same menu to get a folder
-of Markdown files that mirrors your folders. Images and attachments are included, and links
-between notes become relative links. To move to another machine running Omarchy Notes, use
-**Back Up Library…** and **Restore from Backup…** instead: that keeps everything exactly as it
-is, including pins, Smart Folders and history.
+Use Settings to export a note as Markdown/HTML, or a library as Markdown with
+assets. PDF is a separate snapshot export and does not include attached file bytes.
+Portable formats cannot preserve every application attribute or revision history.
+For an exact move to another Rust installation, **Back Up Library**, inspect the
+backup, and restore into a new library. The source backup and current notebook
+remain intact. Backups are unencrypted; store them somewhere trusted.
diff --git a/docs/performance.md b/docs/performance.md
index 3eaac29..455050b 100644
--- a/docs/performance.md
+++ b/docs/performance.md
@@ -1,7 +1,9 @@
-# Performance
+# Historical Qt performance report
-Release gate results for Omarchy Notes 1.0.0, from `tests/bench_library` (build it, then run
-`./tests/bench_library 10000 1024` in the build directory).
+> Qt is retired. These recorded measurements describe the former Qt 1.0.0 app,
+> not the current Rust app. See [Rust performance diagnostics](rust-performance.md).
+
+Historical release gate results from `tests/bench_library` on the Qt build.
The benchmark builds a library of 10,000 generated notes (3–15 paragraphs each, with
checklists and #tags mixed in) and 1 GB of image attachments. It then measures storage and
diff --git a/docs/rust-data-ownership.md b/docs/rust-data-ownership.md
index a9ccf74..f09412d 100644
--- a/docs/rust-data-ownership.md
+++ b/docs/rust-data-ownership.md
@@ -1,5 +1,8 @@
# Rust notes: import, export and backups
+Omarchy Notes is Rust-only. Qt is retired; references to it below describe legacy
+migration compatibility, not current support.
+
Open **Settings → Your notes and files → Import, export & backups**. These
routes are implemented in the release branch; final native/package acceptance
is still pending.
@@ -59,7 +62,7 @@ required before the app reports success. Current main and Quick Note drafts stay
available, including when verification or opening fails. Close the old window
when convenient; its ordinary save/recovery guards still apply. Opening an
already owned Rust library routes to its existing window. A Qt owner must close
-before the separate Rust edition can acquire that library.
+before the Rust app can acquire that library. See [migration](migrating.md).
Use copies and verified backups when moving Qt data. A quotation-format upgrade
requires Rust; the pre-upgrade backup is the rollback boundary for Qt.
diff --git a/docs/rust-edition.md b/docs/rust-edition.md
index bed291c..23dc56b 100644
--- a/docs/rust-edition.md
+++ b/docs/rust-edition.md
@@ -1,197 +1,105 @@
-# Rust edition: release identity and compatibility contract
-
-Discovery recorded 13 October 2026 for R0 of the
-[Rust v1 release plan](../llm-docs/rust-v1-release-plan.md).
-This is the release contract and implementation map for Rust **1.0.0**.
-The owner directed release of the implemented build on 13 October 2026.
-The evidence ledger records completed checks and remaining follow-up;
-the study and five-day trial also follow after release.
-R4 source now provides the separate Rust executable/package, compatibility
-launcher and metadata, candidate preparation, edition-filtered installer and
-CI routes. Focused identity/installer checks pass; clean package builds,
-installed/native matrices and the complete license audit remain acceptance work.
-
-## Separate editions
-
-| Identity | Supported Qt edition | Planned stable Rust edition |
-|---|---|---|
-| Arch package / executable | `omarchy-notes` | `omarchy-notes-rust` |
-| Desktop / AppStream ID | `org.omarchy.Notes` | `org.omarchy.Notes.Rust` |
-| Release tag | `v1.0.0` | `rust-v1.0.0` |
-| Default library | `$XDG_DATA_HOME/omarchy-notes` | `$XDG_DATA_HOME/omarchy-notes-gpui` |
-| Preferences | `$XDG_CONFIG_HOME/omarchy-notes/settings.ini` | `$XDG_CONFIG_HOME/omarchy-notes-gpui/preferences.json` |
-| Initial advertised platform | Existing Qt contract | x86_64 Arch/Omarchy, Wayland/Hyprland |
-
-The XDG fallbacks are `~/.local/share` and `~/.config`. Stable Rust retains the
-preview library and preference locations. The Rust instance protocol already
-uses a private `$XDG_RUNTIME_DIR/omarchy-notes-rust` directory; retaining that
-protocol and its library-specific identity prevents a preview/stable process
-from independently writing the same library.
-
-Keep the Qt installer as the default. Select Rust explicitly with an edition
-option and the Rust tag; do not infer the edition from version `1.0.0`. Rust
-must not provide, conflict with, overwrite or silently replace the Qt package.
-Desktop names and icons must allow a person to distinguish both editions.
-
-For the preview executable transition, install an `omarchy-notes-preview`
-compatibility launcher that executes the stable Rust binary with the same
-arguments and exit status. It should report the Rust executable and version,
-preserve the preview data/preferences locations, and never invoke Qt. Test both
-direct and compatibility launch paths, including capture without a display.
-An older manually installed preview earlier on `PATH` requires a clear warning
-and instructions to move that specific old executable aside.
-
-Availability checks on 13 October 2026:
-
-- AUR's public RPC for `omarchy-notes-rust` returned `resultcount: 0`. This is
- an absence check, not reservation of the name. [AUR lookup](https://aur.archlinux.org/rpc/v5/info?arg%5B%5D=omarchy-notes-rust).
-- `git ls-remote --tags origin rust-v1.0.0 rust-v1.0.0-rc.1` returned no refs.
- Local Git contains the existing Qt `v1.0.0` tag. Recheck before publishing.
-- `org.omarchy.Notes.Rust` is distinct from the Qt and preview IDs in this
- repository. Desktop IDs have no central reservation mechanism; this audit
- does not claim a global registry check.
-
-## Feature boundary
-
-The full port remains larger than the first stable Rust release. The following
-comparison is a target scope statement; the release evidence ledger determines
-whether each Rust requirement is complete.
-
-| Workflow | Qt | Rust v1 requirement / limitation |
-|---|---|---|
-| Rich writing, lists, checks, links, images/files | Available | Required |
-| Basic tables and existing merged tables | Available | Basic editing required; preserve and display existing merges; new merges deferred |
-| Autosave, conflict recovery, undo/redo | Available | Required |
-| Quick Note and installed launch actions | Available | Required |
-| Folders, pins, duplication, sorting | Available | Required, including full keyboard tree navigation |
-| Search | FTS prefix search | FTS prefix search/snippets, scope and stable keyboard selection required |
-| Delete, undo, Recently Deleted, restore | Available | Required, including 30-day retention |
-| Markdown/text import | Available | App file/folder routes required |
-| Markdown/HTML/PDF export | Available | App per-note routes and library Markdown/assets export required |
-| Exact backup, inspect, restore | App routes; restore sets the old library aside | App routes required; restore into a new verified library |
-| Palettes, fonts, writing size, pane choices | Available | Existing Rust preferences required |
-| Tags and Smart Folders | Available | UI deferred; preserve records and references |
-| Gallery, library-wide attachment browser | Available | Deferred |
-| Browsable revision history | Stored revisions; no browsable UI found | UI deferred; preserve revisions and referenced media |
-| Drag filing, bulk organization, date groups | No corresponding shipped controls found | Deferred |
-
-Qt libraries are imported as copies with verified backups. Never select or
-upgrade the original Qt library automatically. Schema-3 quotation libraries
-require Rust; rollback to Qt uses the pre-upgrade backup and excludes later
-Rust edits. Offer backup and portable export before rollback. Portable exports
-may be lossy and must not be described as lossless backups.
-
-## Command routes
-
-These are the advertised Qt application options in `README.md`, its man page
-and `src/app/main.cpp`, compared with `crates/omarchy-notes/src/main.rs`.
-
-| Advertised Qt option | Rust preview route | Stable Rust decision |
-|---|---|---|
-| `--help`, `--version` | Source builds provide both executable names; the installed alias reports Rust identity | Match Rust workspace/package version; no stable claim while version is 0.x |
-| `--data-dir PATH` | Opens any compatible directory supplied by the caller | Retain; guide Qt imports to copies and verified backups |
-| `--new` | Main-window launch/forwarding | Retain |
-| `--note UUID` | Specific-note launch/forwarding | Retain |
-| `--quick-note` | Quick-window launch/forwarding | Retain |
-| `--capture TEXT`, stdin `-` | Durable capture/receipt | Retain; verify without display |
-| `--setup-hyprland` | Absent | Implement edition-specific setup or an explicit supported installation route before advertising it |
-| `--samples` | Absent; `--demo` opens disposable samples | Document distinct behavior; do not silently populate a real library |
-| `--simulate-save-failure` | Implemented; developer fixture | Retain as testing option; no success claims on failed writes |
-
-Rust additionally implements `--request-id UUID` for safe capture retries,
-`--capture-status UUID` for read-only receipt checks, `--backup PATH`,
-`--inspect-backup PATH`, `--restore PATH --data-dir NEW`, `--reference`,
-`--light` and `--demo`. These need Rust-specific help/man documentation.
-CLI backup requires closing the writer. Settings → Data provides in-app import,
-export, backup, inspection, restore and library opening. In-app backup waits for
-pending edits and declares its committed revision boundary. No import/export
-CLI is advertised by either edition.
-
-## Keyboard contracts
-
-| Advertised Qt action | Qt shortcut | Current Rust route |
-|---|---|---|
-| New note | Ctrl+N | Same |
-| New folder | Ctrl+Shift+N | **Ctrl+Alt+N**; Ctrl+Shift+N opens Rust Quick Note |
-| Library search | Ctrl+Shift+F | Same; Ctrl+K also focuses search |
-| Find in note, next | Ctrl+F, F3 / Enter | Same |
-| Delete selected note | Delete in note list | Keyboard-accessible Note actions → Delete; editor Delete remains text editing |
-| Duplicate | Ctrl+D | Keyboard-accessible Note actions → Duplicate; Qt's Ctrl+D shortcut is not assigned |
-| Show/hide folders | Ctrl+Shift+S | Absent; do not advertise until implemented |
-| Bold / italic / underline | Ctrl+B / I / U | Same |
-| Strikethrough / highlight / monospace | Ctrl+Shift+X / Y, Ctrl+E | Same |
-| Title / heading / subheading / body | Ctrl+Shift+T / H / J / B | Same; Ctrl+Alt+1 / 2 / 3 / 0 are Rust aliases |
-| Checklist / tick | Ctrl+Shift+L / U | Same; Ctrl+Shift+C is a Rust checklist alias |
-| Bullet / numbered list | Ctrl+Shift+8 / 7 | Same, including shifted-symbol aliases |
-| List indent / outdent | Tab / Shift+Tab | Same; Ctrl+] / [ also available |
-| Insert table | Ctrl+Alt+T | Rust opens basic table tools; document that behavior |
-| Attach / link note | Ctrl+Shift+A / Ctrl+L | Same |
-| Open attachment / object | Double click / Ctrl+Enter | Ctrl+Enter implemented; verify installed cross-app opening |
-| Follow link / tag | Ctrl+click | Links require native evidence; tags UI deferred |
-| Developer save-failure toggle | Ctrl+Alt+Shift+F | No Rust runtime toggle; CLI fixture only |
-
-The New Folder / Quick Note collision is deliberate for the separate edition,
-not a transparent Qt shortcut migration. Stable documentation and desktop
-actions must expose the Rust keys. Additional Rust keys include Ctrl+Shift+O
-for Quick-to-main handoff, Ctrl+, for Settings, Ctrl+Backslash for focus mode,
-Ctrl+S for Save and Ctrl+Shift+P for PDF. Full folder and recovery keyboard
-contracts are R2 work and need focused-context tests so editor keys are not
-captured by the tree.
-
-## Packaging implementation map
-
-| Files / route | Required change and verification |
+# Rust app: release identity and compatibility contract
+
+Omarchy Notes is a Rust-only app. Qt is retired and relevant only to legacy data
+migration. Historical rebuild plans and ADRs record earlier decisions; their Qt
+support and installer-default statements are not current policy.
+
+## Unchanged identity
+
+| Identity | Rust app |
+|---|---|
+| Arch package / executable | `omarchy-notes-rust` |
+| Cargo application package | `omarchy-notes-preview` |
+| Desktop / AppStream ID | `org.omarchy.Notes.Rust` |
+| Release tag | `rust-v1.0.0` (future releases: `rust-vVERSION`) |
+| Default library | `$XDG_DATA_HOME/omarchy-notes-gpui` |
+| Preferences | `$XDG_CONFIG_HOME/omarchy-notes-gpui/preferences.json` |
+| Runtime instance directory | `$XDG_RUNTIME_DIR/omarchy-notes-rust` |
+| Advertised platform | x86_64 Arch/Omarchy, Wayland/Hyprland |
+
+The XDG fallbacks are `~/.local/share` and `~/.config`. Retirement does not rename
+profiles, binaries or packages. The installed `omarchy-notes-preview` compatibility
+launcher executes `omarchy-notes-rust` with the same arguments and exit status,
+never Qt. An older manual preview earlier on `PATH` can shadow it; inspect and move
+that specific old executable aside rather than deleting profiles.
+
+The current installer installs Rust by default and needs no edition selector.
+Older edition-aware installers require `--edition rust`. Use Rust tags, not the retired `v1.0.0` tag.
+Checksums, assets, package metadata and the package-owned executable must match
+Rust identity. The package does not provide or conflict with the former
+`omarchy-notes` package; retirement is not an automatic package or data replacement.
+See [installation and release instructions](rust-release.md).
+
+## Scope and evidence
+
+Rich writing, basic tables, images/files, autosave, Quick Note, durable capture,
+folders, pins, duplication, sorting, prefix search, Recently Deleted, reviewed
+Markdown/text imports, portable exports and exact backup/restore are implemented.
+Existing merged tables, tags/Smart Folder metadata and stored revisions are
+preserved. New merges and other advanced table operations, tag/Smart Folder UI,
+gallery, library-wide attachment browsing, browsable revisions, drag filing and
+bulk organization remain deferred.
+
+Automatic `--setup-hyprland` and the old `--samples` option are not current app
+routes. Use the desktop Quick Note action or a manual unused compositor binding;
+`--demo` opens disposable samples. X11 and other architectures are not advertised.
+Retirement does not resolve native performance/fairness, portal/scaling/suspend,
+installed upgrade/rollback verification or human accessibility/usability gaps.
+See the [release notes](rust-release-notes.md) and historical
+[release evidence](../llm-docs/rust-v1-release-evidence.md) for exact results and limits.
+
+## Current command routes
+
+| Option | Behavior |
+|---|---|
+| `--help`, `--version` | Show Rust app help/version |
+| `--data-dir PATH` | Open a selected compatible library |
+| `--new`, `--note UUID` | Launch/forward a new or specific note |
+| `--quick-note` | Launch/forward Quick Note |
+| `--capture TEXT` (or `-` for stdin) | Durable text capture |
+| `--request-id UUID`, `--capture-status UUID` | Safe capture retry and read-only receipt checks |
+| `--backup PATH`, `--inspect-backup PATH` | Headless backup/inspection; close the writer for CLI backup |
+| `--restore PATH --data-dir NEW` | Restore into a new library |
+| `--reference`, `--light` | Launch palette overrides |
+| `--demo` | Disposable design sample |
+| `--simulate-save-failure` | Developer fixture, not a runtime keyboard toggle |
+
+Settings → Your notes and files supplies reviewed import/export, backup,
+inspection, safe restore and library opening. No import/export CLI is advertised.
+See [data ownership](rust-data-ownership.md) and the [writing guide](gpui-preview.md).
+
+## Keyboard routes
+
+| Action | Rust shortcut / route |
|---|---|
-| Workspace and `crates/omarchy-notes/Cargo.toml` | Stable executable/package identity; preserve compatibility launcher; align version only at final freeze |
-| `notes-ui/src/lib.rs`, `quick_note.rs` | Use stable desktop ID for all windows; keep IDs distinct from Qt; update native tests that locate the launched test window |
-| New Rust desktop, AppStream, man and icon metadata | Explicit Rust names, new/quick actions, stable app ID, help/version and target feature scope; validate desktop/AppStream syntax |
-| New `packaging/arch/PKGBUILD-rust.in` | x86_64 only; pinned locked Cargo build; install app, alias, metadata, icon and all notices; no dependency on cached checkout |
-| `packaging/prepare-release.py` | Explicit edition selection; version/tag checks per edition; immutable archive names and recipes; preserve Qt route |
-| `install.sh` | Explicit opt-in edition; tag/asset/package/executable allowlists; separate dependency sets and default data paths; keep strict package identity checks |
-| Installer latest route | GitHub `/releases/latest` can select either edition; select latest published release of the requested edition explicitly and test mixed ordering |
-| `tests/test-release-metadata.sh`, package/installer tests | Preserve Qt checks; add Rust identity, cross-edition rejection, compatibility launch, capture and coexistence checks |
-| `.github/workflows/ci.yml`, `release.yml` | Preserve Qt CI; add clean Rust packaging and `rust-v*` tag route; checksums/source hash and draft release from exact committed source |
-| Rust release/build/rollback docs | Separate source build and installer commands, feature limits and actual screenshots; no untested X11/aarch64 claims |
-
-The installer now selects package, executable, tag and asset patterns from a
-closed Qt/Rust allowlist; it rejects cross-edition names. Latest discovery filters
-published release tags by edition. Rust Quick Note uses its desktop action or
-the documented manual distinct-key route; automatic Qt setup is never invoked
-for Rust. See [Rust release instructions](rust-release.md).
-
-## Runtime and license discovery
-
-The existing local release binary reports `omarchy-notes-preview 0.1.0`, is
-285,223,488 bytes before stripping, and has SHA-256
-`295984b9066a78faf1ff84657f89324aabddd3fc06a971f9198f77eb36258ed0`.
-It is a discovery artifact, not a reproducible release candidate. `readelf -d`
-found no RPATH/RUNPATH and direct dependencies owned by Arch packages `glibc`,
-`libgcc`, `glib2`, `libxcb`, `libxkbcommon`, `libxkbcommon-x11`, `pango` and
-`cairo`; `ldd` resolved them on this developer machine. Wayland is loaded via
-`dlopen` in pinned GPUI, so `ldd` alone is insufficient. Include Wayland,
-Vulkan loader/driver, portal and attachment-launch requirements after testing
-the candidate in a clean environment. Building with X11 support does not mean
-X11 is advertised as tested.
-
-Toolchain discovery: rustc 1.99.0, x86_64; GPUI/platform pin
-`a84689073d296dfd39987bc7dd478e43ef76d83a`. The current workspace declares both
-Wayland and X11 features. Re-evaluate dependency declarations from the final
-binary rather than this preliminary list.
-
-`cargo metadata --locked --offline` found 769 packages across all targets and
-build/dev dependencies, with no missing Cargo license field. This is an
-inventory starting point, not a redistribution-license audit. Optional
-copyleft alternatives (`r-efi`, `self_cell`) also offer permissive choices;
-MPL-2.0 appears on `cbindgen`, `dwrote` and `option-ext`. Determine which are
-actually shipped, record selected licenses, gather required texts/notices, and
-audit generated/bundled native code. Existing `notes-ui/assets/NOTICE.md`,
-`GPUI-LICENSE` and Noto `fonts/OFL.txt` cover the bundled fonts/icon provenance
-and GPUI source guidance. A release package must install these, the repository
-MIT license and dependency notices. Runtime system libraries have their own
-system packages and licensing.
-
-R4 remains blocked on a clean source-to-package build, disposable install /
-preview transition / coexistence / upgrade / removal / rollback checks,
-candidate runtime and license audit, native installed-launch/portal tests and
-exact-source hosted CI evidence. R5 requires real participants and five actual
-working days; no automated result substitutes for those gates.
+| New note / folder | Ctrl+N / Ctrl+Alt+N |
+| Quick Note / handoff to main | Ctrl+Shift+N / Ctrl+Shift+O |
+| Library search / find in note | Ctrl+Shift+F or Ctrl+K / Ctrl+F |
+| Next find match | F3 / Enter |
+| Delete / duplicate note | Keyboard-accessible Note actions |
+| Bold / italic / underline | Ctrl+B / I / U |
+| Strikethrough / highlight / monospace | Ctrl+Shift+X / Y, Ctrl+E |
+| Title / heading / subheading / body | Ctrl+Shift+T / H / J / B; Ctrl+Alt+1 / 2 / 3 / 0 |
+| Checklist / tick | Ctrl+Shift+L / U; Ctrl+Shift+C checklist alias |
+| Bullet / numbered list | Ctrl+Shift+8 / 7 |
+| List indent / outdent | Tab / Shift+Tab; Ctrl+] / [ |
+| Basic table tools | Ctrl+Alt+T |
+| Attach file / link note | Ctrl+Shift+A / Ctrl+L |
+| Open attachment / object | Ctrl+Enter |
+| Settings / focus mode | Ctrl+, / Ctrl+Backslash |
+| Save / PDF export | Ctrl+S / Ctrl+Shift+P |
+
+Qt shortcuts are not a transparent migration contract: Ctrl+Shift+N is now Quick
+Note, Ctrl+D is not assigned to duplication, and Ctrl+Shift+S is not advertised
+for hiding folders. Native cross-app opening and link behavior still need the
+verification described in the acceptance record.
+
+## Legacy data boundary
+
+The retired Qt library was `$XDG_DATA_HOME/omarchy-notes`; its preferences were
+`$XDG_CONFIG_HOME/omarchy-notes/settings.ini`. Neither is automatically selected,
+renamed or upgraded. Close any legacy writer, migrate consistent copies with
+verified backups, and preserve the originals. Schema-3 quotation libraries require
+Rust. A rollback to a legacy reader uses the pre-upgrade backup and excludes later
+Rust edits. Portable exports can be lossy; keep exact backups.
+See [migration](migrating.md).
diff --git a/docs/rust-release-notes.md b/docs/rust-release-notes.md
index 280a189..0235db9 100644
--- a/docs/rust-release-notes.md
+++ b/docs/rust-release-notes.md
@@ -1,24 +1,26 @@
# Omarchy Notes Rust 1.0.0
-The first separate Rust edition provides an offline notes app with rich writing,
+Omarchy Notes is now Rust-only; Qt is retired and retained only as a legacy
+migration reference. The Rust 1.0 app provides offline notes with rich writing,
Quick Note and durable command-line capture, nested keyboard-accessible folders,
pinning, three sort modes, prefix search and snippets, duplication, Recently
Deleted, Undo and recovery. Settings provides reviewed Markdown/text import,
Markdown/HTML/PDF note export, library Markdown plus assets, exact backups,
inspection, safe restore into a new library and library opening.
-Install the x86_64 Arch/Omarchy edition explicitly:
+Install on x86_64 Arch/Omarchy. The current installer installs Rust by default;
+older edition-aware installers require `--edition rust`.
```sh
-bash install.sh --edition rust --version rust-v1.0.0 --no-quick-note
+bash install.sh --version rust-v1.0.0 --no-quick-note
```
The executable/package is `omarchy-notes-rust`, desktop identity is
`org.omarchy.Notes.Rust`, and the `omarchy-notes-preview` compatibility launcher
forwards to Rust. Existing Rust notes/preferences remain at `omarchy-notes-gpui`.
-Qt remains available and remains the default installer edition.
+Retirement changes neither Rust package identity nor its historical profile paths.
-Use copies and verified backups for Qt libraries. Quotation/schema-3 libraries
+Use copies and verified backups for retired Qt libraries; see [migration](migrating.md). Quotation/schema-3 libraries
require Rust; return to Qt using the pre-upgrade backup, which excludes later
Rust edits. Keep the newer library and export/backup before rollback. Folder
deletion Undo restores notes unfiled; it does not rebuild deleted folders.
@@ -27,7 +29,8 @@ Tags/Smart Folder interfaces, advanced table operations, gallery, drag filing,
bulk organization and browsable revision history remain deferred; existing
metadata and merged tables are preserved. X11 and other architectures are not
advertised. Use the desktop Quick Note action or a distinct manual compositor
-binding; the Rust installer does not alter the Qt shortcut.
+binding; automatic compositor setup is not implemented and legacy bindings are
+not altered.
The implemented build was released at the owner's direction on 13 October 2026.
Recorded checks include 171 Rust tests, six dependency tests, full Qt regression
diff --git a/docs/rust-release.md b/docs/rust-release.md
index 2bb83fc..62d7376 100644
--- a/docs/rust-release.md
+++ b/docs/rust-release.md
@@ -1,4 +1,4 @@
-# Building and installing the separate Rust edition
+# Building and installing Omarchy Notes (Rust)
The Rust workspace is **1.0.0**, released at the owner's direction on
13 October 2026. The evidence ledger distinguishes completed checks from
@@ -6,9 +6,21 @@ remaining follow-up; no unverified check is presented as passed. The five-person
first-use study and five-working-day trial also follow after release.
Rust uses `omarchy-notes-rust`, desktop identity `org.omarchy.Notes.Rust`, and
-the separate `rust-v1.0.0` tag. Qt remains the default installer route
-and its `omarchy-notes` package remains available. Rust has no `provides` or
-`conflicts` relationship with Qt.
+the `rust-v1.0.0` tag. Omarchy Notes is Rust-only; Qt is retired and relevant
+only for legacy migration. Binary/package/profile identity is unchanged. Rust
+has no `provides` or `conflicts` relationship with the retired Qt package.
+
+## Run from source
+
+Install the toolchain in `rust-toolchain.toml` through rustup and the native
+[development dependencies](gpui-preview.md#run-it). Do not run Cargo as root.
+
+```sh
+cargo run --release --locked -p omarchy-notes-preview --bin omarchy-notes-rust
+cargo test --workspace --locked
+```
+
+The Cargo package name is historical; it does not change the app identity.
## Candidate source and package
@@ -17,7 +29,7 @@ revision, excluding dirty and untracked files, and refuses an existing output
directory. Use a new directory per candidate:
```sh
-python3 packaging/prepare-release.py --edition rust --candidate \
+python3 packaging/prepare-release.py --candidate \
--ref COMMIT_SHA --output build-rust-candidate
cd build-rust-candidate/aur
makepkg --syncdeps --cleanbuild
@@ -55,15 +67,16 @@ this list does not claim that audit is complete.
## Published installer route
After a Rust release is actually published, download and inspect its installer
-before running it. Select Rust explicitly:
+before running it. The current installer installs Rust by default and needs no
+edition selector. Older edition-aware installers require `--edition rust`.
```sh
-bash install.sh --edition rust --version rust-vVERSION --dry-run
-bash install.sh --edition rust --version rust-vVERSION --no-quick-note
+bash install.sh --version rust-vVERSION --dry-run
+bash install.sh --version rust-vVERSION --no-quick-note
```
-Without `--edition rust`, the installer selects Qt. Its latest-release lookup
-filters published, non-draft, non-prerelease tags by the chosen edition; if no
+The installer selects Rust releases by default. Its latest-release lookup
+filters published, non-draft, non-prerelease Rust tags; if no
match occurs in the newest 100 releases, choose an explicit tag. Tags, assets,
package metadata and the package-owned executable must all match that edition.
The installer requires Python 3 for this JSON lookup, along with its existing
@@ -79,14 +92,14 @@ on `PATH` may take precedence; move that specific executable aside after
verifying the package-owned one. The installer reports such shadowing and does
not delete manual copies.
-## Quick Note and coexistence
+## Quick Note
Choose **Rust Quick Note** from the Rust desktop launcher's actions, run
-`omarchy-notes-rust --quick-note`, or use Ctrl+Shift+N inside Rust. Qt and Rust
-must use distinct global shortcut keys. For a compositor binding, choose an
-unused key such as Super+Alt+Shift+N and execute the absolute Rust command above;
-use `org.omarchy.Notes.Rust` when matching its windows. Keep the existing Qt
-binding intact. Follow the configuration format used by your installed Omarchy
+`omarchy-notes-rust --quick-note`, or use Ctrl+Shift+N inside Rust. For a
+compositor binding, choose an unused key such as Super+Alt+Shift+N and execute
+`/usr/bin/omarchy-notes-rust --quick-note`; use `org.omarchy.Notes.Rust` when
+matching its windows. Do not overwrite a legacy binding during migration.
+Follow the configuration format used by your installed Omarchy
version; Lua and native Hyprland configuration are not interchangeable.
Rust does not currently implement automatic `--setup-hyprland`. The installer's
@@ -96,7 +109,8 @@ floating-rule and shortcut behavior still require the supported-platform matrix.
## Recovery and release freeze
-Use copies and verified backups when bringing Qt libraries into Rust. Enabling
+Use copies and verified backups when migrating retired Qt libraries into Rust;
+see [migration](migrating.md). Enabling
quotations creates schema-3 data requiring Rust; returning to Qt uses the
pre-upgrade backup and excludes later Rust edits. Preserve the newer Rust library
and export/backup before rollback. Restore into a new verified directory rather
@@ -106,6 +120,7 @@ are useful copies, not lossless replacements for library backups.
At the final freeze, align workspace, man page, AppStream and release versions,
record every required gate on that exact revision, and use `rust-vVERSION`.
Stable artifact preparation requires that exact Rust tag and refuses Qt tags.
-The Rust release workflow creates a draft only; reviewing or publishing it and
-changing the default edition are separate decisions. Never replace an existing
-published archive or reuse Qt's tag.
+The Rust release workflow creates a draft only; reviewing and publishing it are
+separate decisions. The installer default is now Rust, not a reason to rename
+packages or profiles. Never replace an existing published archive or reuse a
+retired Qt tag.
diff --git a/install.sh b/install.sh
index 0886d09..5b71a4c 100755
--- a/install.sh
+++ b/install.sh
@@ -12,18 +12,17 @@ Omarchy Notes installer. A place for your thoughts.
Installs a verified release package on Omarchy or Arch Linux.
Run again to update. Your notes and running application are kept.
- --version TAG select a published release (for example v1.0.0)
- --edition qt|rust choose the edition (default: qt; Rust is separate)
- --source build the selected release with makepkg as your user
+ --version TAG select a published Rust release (for example rust-v1.0.0)
+ --source build the selected Rust release with makepkg as your user
--yes, -y accept package installation without confirmation
--dry-run inspect the release and show the plan without installing
- --quick-note opt in to the Quick Note key and floating window rule
+ --quick-note show manual Quick Note setup instructions
--no-quick-note skip Quick Note setup
--help, -h show this help
Without a terminal, installation requires --yes and noninteractive sudo access.
--yes alone never enables Quick Note. NO_COLOR disables color and animation.
-Other Linux systems: see the README for building with CMake into ~/.local.
+Other Linux systems: see the README for building with Cargo.
USAGE
}
@@ -197,18 +196,18 @@ build_source() {
}
finish() {
- local binary='' preview_alias='' package_name path count=0 alias_count=0 output shadow config data
+ local binary='' preview_alias='' package_name path count=0 alias_count=0 output shadow data
pacman -Ql "$PACKAGE_NAME" "$WORK/installed-files" 2>>"$LOG" || die 'Installed package file list is unavailable.'
while read -r package_name path; do
if [[ $package_name == "$PACKAGE_NAME" && $path == /*/bin/"$EXECUTABLE" ]]; then
binary=$path; count=$((count + 1))
fi
- if [[ $EDITION == rust && $package_name == "$PACKAGE_NAME" && $path == /*/bin/omarchy-notes-preview ]]; then
+ if [[ $package_name == "$PACKAGE_NAME" && $path == /*/bin/omarchy-notes-preview ]]; then
preview_alias=$path; alias_count=$((alias_count + 1))
fi
done <"$WORK/installed-files"
(( count == 1 )) && [[ -x $binary ]] || die 'The installed application executable is missing or ambiguous.'
- output=$(env -u QT_QPA_PLATFORMTHEME QT_QPA_PLATFORM=offscreen "$binary" --version >"$LOG") ||
+ output=$("$binary" --version >"$LOG") ||
die 'Package installed, but application verification failed. See the log before launching it.'
[[ $output == "$EXECUTABLE $VERSION" ]] || die "Installed application reports an unexpected version: $output."
ok "Application verified $BULLET $output"
@@ -217,40 +216,18 @@ finish() {
warn "An older or separate copy at $shadow takes precedence on PATH."
note "Use $binary for the package version; move the older copy aside when ready."
fi
- if [[ $EDITION == rust ]]; then
- (( alias_count == 1 )) && [[ -x $preview_alias ]] || die 'The package-owned preview compatibility launcher is missing or ambiguous.'
- output=$("$preview_alias" --version >"$LOG") || die 'The preview compatibility launcher could not execute Rust.'
- [[ $output == "$EXECUTABLE $VERSION" ]] || die "The preview compatibility launcher reports an unexpected version: $output."
- shadow=$(command -v omarchy-notes-preview || true)
- if [[ -n $shadow && $(readlink -f -- "$shadow") != "$(readlink -f -- "$preview_alias")" ]]; then
- warn "An older preview at $shadow takes precedence on PATH; move that specific copy aside when ready."
- fi
+ (( alias_count == 1 )) && [[ -x $preview_alias ]] || die 'The package-owned preview compatibility launcher is missing or ambiguous.'
+ output=$("$preview_alias" --version >"$LOG") || die 'The preview compatibility launcher could not execute Rust.'
+ [[ $output == "$EXECUTABLE $VERSION" ]] || die "The preview compatibility launcher reports an unexpected version: $output."
+ shadow=$(command -v omarchy-notes-preview || true)
+ if [[ -n $shadow && $(readlink -f -- "$shadow") != "$(readlink -f -- "$preview_alias")" ]]; then
+ warn "An older preview at $shadow takes precedence on PATH; move that specific copy aside when ready."
fi
- config=${XDG_CONFIG_HOME:-$HOME/.config}
- if [[ $EDITION == rust ]]; then
- if [[ $QUICK == yes ]]; then
- note 'Rust Quick Note is available in the desktop launcher or with omarchy-notes-rust --quick-note.'
- note 'Automatic Rust compositor setup is not implemented; use the distinct-key instructions in docs/rust-release.md. No bindings were changed.'
- fi
- elif (( IS_OMARCHY )) && [[ -f $config/hypr/bindings.lua && -f $config/hypr/hyprland.lua ]]; then
- if [[ $QUICK == ask ]] && (( HAVE_TTY && ! YES )); then
- if confirm 'Set up Quick Note with Super + Alt + N?' y/N; then QUICK=yes; fi
- fi
- if [[ $QUICK == yes ]]; then
- if env -u QT_QPA_PLATFORMTHEME QT_QPA_PLATFORM=offscreen "$binary" --setup-hyprland "$WORK/quick-note" 2>>"$LOG"; then
- ok 'Quick Note setup complete'
- else
- warn 'Notes is installed. Quick Note setup needs attention (the key may already be taken).'
- RETAIN_LOG=1
- note "Setup log: $LOG"
- fi
- tee -a "$LOG" <"$WORK/quick-note"
- fi
- elif [[ $QUICK == yes ]]; then
- warn 'Notes is installed. Quick Note setup requires compatible Omarchy Lua configuration.'
+ if [[ $QUICK == yes ]]; then
+ note 'Rust Quick Note is available in the desktop launcher or with omarchy-notes-rust --quick-note.'
+ note 'Automatic Rust compositor setup is not implemented; use the distinct-key instructions in docs/rust-release.md. No bindings were changed.'
fi
- if [[ $EDITION == rust ]]; then data=${XDG_DATA_HOME:-$HOME/.local/share}/omarchy-notes-gpui
- else data=${OMARCHY_NOTES_DATA_DIR:-${XDG_DATA_HOME:-$HOME/.local/share}/omarchy-notes}; fi
+ data=${XDG_DATA_HOME:-$HOME/.local/share}/omarchy-notes-gpui
[[ $data == /* ]] || data=$PWD/$data
printf '\n %sReady to write%s\n' "$BOLD" "$RESET"
if (( IS_OMARCHY )); then printf ' Super + Space, then type "%s"\n' "$DISPLAY_NAME"; fi
@@ -265,7 +242,7 @@ finish() {
main() {
presentation
- YES=0; DRY=0; SOURCE=0; QUICK=ask; TAG=''; EDITION=qt; WORK=''; LOG=''; ACTIVE_PID=''; RETAIN_LOG=0
+ YES=0; DRY=0; SOURCE=0; QUICK=no; TAG=''; WORK=''; LOG=''; ACTIVE_PID=''; RETAIN_LOG=0
local quick_option='' option
while (( $# )); do
option=$1
@@ -274,8 +251,6 @@ main() {
--yes|-y) YES=1 ;;
--dry-run) DRY=1 ;;
--source) SOURCE=1 ;;
- --edition) shift; (( $# )) || die '--edition requires qt or rust.'; EDITION=$1 ;;
- --edition=*) EDITION=${option#*=} ;;
--version) shift; (( $# )) && [[ -n $1 ]] || die '--version requires a release tag.'; TAG=$1 ;;
--version=*) TAG=${option#*=}; [[ -n $TAG ]] || die '--version requires a release tag.' ;;
--quick-note|--no-quick-note)
@@ -286,12 +261,8 @@ main() {
esac
shift
done
- case "$EDITION" in
- qt) PACKAGE_NAME=omarchy-notes; EXECUTABLE=omarchy-notes; TAG_PREFIX=v; DISPLAY_NAME='Omarchy Notes' ;;
- rust) PACKAGE_NAME=omarchy-notes-rust; EXECUTABLE=omarchy-notes-rust; TAG_PREFIX=rust-v; DISPLAY_NAME='Omarchy Notes (Rust)' ;;
- *) die '--edition must be qt or rust.' ;;
- esac
- [[ -z $TAG || $TAG =~ ^${TAG_PREFIX}[0-9]+\.[0-9]+\.[0-9]+$ ]] || die "--version must be a stable release tag for $EDITION such as ${TAG_PREFIX}1.0.0."
+ PACKAGE_NAME=omarchy-notes-rust; EXECUTABLE=omarchy-notes-rust; TAG_PREFIX=rust-v; DISPLAY_NAME='Omarchy Notes (Rust)'
+ [[ -z $TAG || $TAG =~ ^${TAG_PREFIX}[0-9]+\.[0-9]+\.[0-9]+$ ]] || die "--version must be a stable Rust release tag such as ${TAG_PREFIX}1.0.0."
HAVE_TTY=0
if ( : /dev/null; then HAVE_TTY=1; fi
if (( ! DRY )); then
@@ -301,10 +272,9 @@ main() {
[[ $(uname -s) == Linux ]] || die 'This installer supports Linux. See the README for build instructions.'
IS_OMARCHY=0
if [[ -d /usr/share/omarchy ]] || command -v omarchy >/dev/null 2>&1; then IS_OMARCHY=1; fi
- [[ -f /etc/arch-release ]] || die 'This installer supports Omarchy and Arch Linux. See the README for a CMake build.'
+ [[ -f /etc/arch-release ]] || die 'This installer supports Omarchy and Arch Linux. See the README for a Cargo build.'
ARCH=$(uname -m)
- [[ $ARCH == x86_64 || $ARCH == aarch64 ]] || die "Unsupported architecture: $ARCH. See the README for building with CMake."
- [[ $EDITION != rust || $ARCH == x86_64 ]] || die 'The Rust edition currently supports x86_64 only.'
+ [[ $ARCH == x86_64 ]] || die "Unsupported architecture: $ARCH. Rust currently supports x86_64 only."
local tool
for tool in curl sha256sum pacman setsid mktemp awk sed tail readlink python3; do
command -v "$tool" >/dev/null || die "Missing prerequisite: $tool. Install it and try again."
@@ -353,11 +323,8 @@ PY
die "Could not download checksums for $TAG. Check that the release exists and the network is available."
read_manifest
PACMAN_FLAGS=(); (( ! YES )) || PACMAN_FLAGS+=(--noconfirm)
- BUILD_DEPS=(base-devel cmake ninja pkgconf qt6-base qt6-declarative qt6-svg sqlite)
- if [[ $EDITION == rust ]]; then
- BUILD_DEPS=(base-devel rustup clang cmake pkgconf git vulkan-headers python glib2 cairo pango libxcb
- libxkbcommon libxkbcommon-x11 wayland vulkan-icd-loader hicolor-icon-theme noto-fonts-cjk noto-fonts-emoji xdg-desktop-portal xdg-utils)
- fi
+ BUILD_DEPS=(base-devel rustup clang cmake pkgconf git vulkan-headers python glib2 cairo pango libxcb
+ libxkbcommon libxkbcommon-x11 wayland vulkan-icd-loader hicolor-icon-theme noto-fonts-cjk noto-fonts-emoji xdg-desktop-portal xdg-utils)
local recipe='' recipe_hash='' source='' source_hash='' installed=''
if (( SOURCE )); then
select_asset "^${PACKAGE_NAME}-${version_pattern}-aur\\.tar\\.gz$" 'AUR recipe'
@@ -382,10 +349,8 @@ PY
note "Would download and verify $ASSET, and check its package identity."
fi
if (( SOURCE )) || [[ $installed != "$PACKAGE_NAME $PACKAGE_VERSION" ]]; then note 'Would run sudo pacman -U .'; fi
- note 'Would verify the package-owned executable with off-screen --version.'
- if [[ $QUICK == yes && $EDITION == rust ]]; then note 'Would show the Rust desktop Quick Note action and manual distinct-key setup instructions.'
- elif [[ $QUICK == yes ]]; then note 'Would set up Quick Note on compatible Omarchy configuration.'
- elif [[ $EDITION == qt && $QUICK == ask ]] && (( IS_OMARCHY && ! YES )); then note 'Would offer optional Quick Note setup in an interactive terminal.'; fi
+ note 'Would verify the package-owned executable with --version.'
+ if [[ $QUICK == yes ]]; then note 'Would show the Rust desktop Quick Note action and manual distinct-key setup instructions.'; fi
printf '\n'; return 0
fi
if (( SOURCE )) || [[ $installed != "$PACKAGE_NAME $PACKAGE_VERSION" ]]; then
diff --git a/packaging/arch/PKGBUILD-rust.in b/packaging/arch/PKGBUILD-rust.in
index a292e65..fa7997c 100644
--- a/packaging/arch/PKGBUILD-rust.in
+++ b/packaging/arch/PKGBUILD-rust.in
@@ -1,5 +1,5 @@
# Maintainer: Jason Alexander
-# Generated from an immutable revision. Rust remains separate from the Qt package.
+# Generated from an immutable revision. Preserve the Rust executable identity.
pkgname=omarchy-notes-rust
pkgver=@RUST_VERSION@
pkgrel=1
diff --git a/packaging/arch/PKGBUILD.in b/packaging/arch/PKGBUILD.in
deleted file mode 100644
index 418aede..0000000
--- a/packaging/arch/PKGBUILD.in
+++ /dev/null
@@ -1,34 +0,0 @@
-# Maintainer: Jason Alexander
-# Generated with packaging/prepare-release.py; submit the generated copy to AUR.
-pkgname=omarchy-notes
-pkgver=1.0.0
-pkgrel=1
-pkgdesc='Fast, native notes for Omarchy, inspired by Apple Notes'
-arch=('x86_64' 'aarch64')
-url='https://lastrefuge.ai/projects/omarchy-notes'
-license=('MIT')
-depends=('glibc' 'hicolor-icon-theme' 'libgcc' 'libstdc++' 'qt6-base' 'qt6-declarative' 'qt6-svg' 'sqlite')
-makedepends=('cmake' 'ninja' 'pkgconf')
-optdepends=('qt6-wayland: native Wayland support'
- 'qt6-imageformats: WebP, TIFF and other image formats in notes'
- 'xdg-utils: open attachments in their default applications')
-source=("https://github.com/last-refuge/omarchy-notes/releases/download/v${pkgver}/${pkgname}-${pkgver}.tar.gz")
-b2sums=('@SOURCE_B2SUM@')
-
-build() {
- cmake -S "$pkgname-$pkgver" -B build -G Ninja \
- -DCMAKE_BUILD_TYPE=None \
- -DCMAKE_INSTALL_PREFIX=/usr \
- -DCMAKE_INSTALL_LIBDIR=lib \
- -DBUILD_TESTING=OFF \
- -Wno-dev
- cmake --build build
-}
-
-check() {
- QT_QPA_PLATFORM=offscreen "$srcdir/build/src/app/omarchy-notes" --version
-}
-
-package() {
- DESTDIR="$pkgdir" cmake --install build
-}
diff --git a/packaging/desktop/org.omarchy.Notes.desktop.in b/packaging/desktop/org.omarchy.Notes.desktop.in
deleted file mode 100644
index 63a6fb3..0000000
--- a/packaging/desktop/org.omarchy.Notes.desktop.in
+++ /dev/null
@@ -1,21 +0,0 @@
-[Desktop Entry]
-Type=Application
-Name=Omarchy Notes
-GenericName=Notes
-Comment=Rich notes with checklists, tables and attachments
-Exec=@ONOTES_BIN@
-Icon=@ONOTES_APP_ID@
-Terminal=false
-Categories=Office;
-Keywords=notes;notebook;checklist;todo;omarchy;
-StartupNotify=true
-StartupWMClass=@ONOTES_APP_ID@
-Actions=new-note;quick-note;
-
-[Desktop Action new-note]
-Name=New Note
-Exec=@ONOTES_BIN@ --new
-
-[Desktop Action quick-note]
-Name=Quick Note
-Exec=@ONOTES_BIN@ --quick-note
diff --git a/packaging/icons/org.omarchy.Notes.svg b/packaging/icons/org.omarchy.Notes.svg
deleted file mode 100644
index fbf3b43..0000000
--- a/packaging/icons/org.omarchy.Notes.svg
+++ /dev/null
@@ -1,11 +0,0 @@
-
diff --git a/packaging/man/omarchy-notes-rust.1 b/packaging/man/omarchy-notes-rust.1
index ff6872f..79a06c0 100644
--- a/packaging/man/omarchy-notes-rust.1
+++ b/packaging/man/omarchy-notes-rust.1
@@ -1,12 +1,12 @@
.TH OMARCHY-NOTES-RUST 1 "October 2026" "omarchy-notes-rust 1.0.0" "User Commands"
.SH NAME
-omarchy-notes-rust \- private local notes, separate Rust edition
+omarchy-notes-rust \- private local notes
.SH SYNOPSIS
.B omarchy-notes-rust
.RI [ options ]
.SH DESCRIPTION
-The Rust edition is separately installable from the supported Qt edition.
-Version 1.0.0 is the first separate Rust release.
+Omarchy Notes is a Rust application for private local notes.
+Version 1.0.0 is the first Rust release.
Its library and preferences retain the preview locations. The installed
.B omarchy-notes-preview
compatibility launcher executes the Rust application with unchanged arguments.
@@ -52,7 +52,7 @@ Open disposable sample notes.
Exercise recovery with a scratch library; not an ordinary writing option.
.TP
.B \-\-help, \-\-version
-Show Rust edition help or version.
+Show application help or version.
.SH KEYBOARD
Ctrl+N creates a note, Ctrl+S saves, Ctrl+K searches, Ctrl+, opens Settings,
and Ctrl+Backslash toggles focus mode. Ctrl+Shift+N opens Quick Note;
@@ -80,6 +80,4 @@ The desktop launcher has a Rust Quick Note action. Optional compositor shortcuts
should use a distinct key and the org.omarchy.Notes.Rust application identity;
the installer does not claim to modify Rust compositor bindings automatically.
.SH SEE ALSO
-.BR omarchy-notes (1)
-.PP
https://github.com/last-refuge/omarchy-notes
diff --git a/packaging/man/omarchy-notes.1 b/packaging/man/omarchy-notes.1
deleted file mode 100644
index 76d8f9e..0000000
--- a/packaging/man/omarchy-notes.1
+++ /dev/null
@@ -1,58 +0,0 @@
-.TH OMARCHY-NOTES 1 "September 2026" "omarchy-notes 1.0.0" "User Commands"
-.SH NAME
-omarchy-notes \- fast, native notes for Omarchy
-.SH SYNOPSIS
-.B omarchy-notes
-[\fIOPTION\fR]...
-.SH DESCRIPTION
-Omarchy Notes is a local-first notes app with rich text, checklists, tables,
-attachments, folders, tags, Smart Folders and search. Only one instance runs per
-library: launching it again brings the open window forward and passes along
-any request, such as a Quick Note or captured text.
-.SH OPTIONS
-.TP
-.B \-\-new
-Start a new note.
-.TP
-.B \-\-quick\-note
-Open a small Quick Note window.
-.TP
-.BI \-\-capture " text"
-Save \fItext\fR as a new note without opening a window. Use \fB\-\fR to read
-the text from standard input.
-.TP
-.BI \-\-note " id"
-Open the note with the given id.
-.TP
-.BI \-\-data\-dir " dir"
-Use the library in \fIdir\fR instead of the default.
-.TP
-.B \-\-samples
-Fill an empty library with sample notes.
-.TP
-.B \-\-setup\-hyprland
-Add an optional Quick Note key binding (Super+Alt+N) and a floating window rule
-to the Hyprland configuration, if they don't conflict with existing settings.
-.TP
-.B \-\-version
-Show the version.
-.TP
-.B \-\-help
-Show all options.
-.SH FILES
-.TP
-.I $XDG_DATA_HOME/omarchy-notes/
-The notes library: an SQLite database and a folder of attachments.
-Uninstalling the app never removes it.
-.TP
-.I $XDG_CONFIG_HOME/omarchy-notes/settings.ini
-View preferences (sort order, last folder, gallery mode).
-.SH EXAMPLES
-.nf
-omarchy-notes --capture "Call the plumber on Tuesday"
-echo "idea" | omarchy-notes --capture -
-.fi
-.SH SEE ALSO
-Project page: https://lastrefuge.ai/projects/omarchy-notes
-.br
-Source and issues: https://github.com/last-refuge/omarchy-notes
diff --git a/packaging/metainfo/org.omarchy.Notes.Rust.metainfo.xml b/packaging/metainfo/org.omarchy.Notes.Rust.metainfo.xml
index a20af66..fd406fa 100644
--- a/packaging/metainfo/org.omarchy.Notes.Rust.metainfo.xml
+++ b/packaging/metainfo/org.omarchy.Notes.Rust.metainfo.xml
@@ -6,14 +6,14 @@
CC0-1.0MIT
-
The separate Rust edition of Omarchy Notes keeps rich notes in a local SQLite library, without an account.
+
Omarchy Notes keeps rich notes in a local SQLite library, without an account.
Nested folders, pinning, prefix search and recoverable deletion
Quick Note and durable command-line capture
Portable import/export and verified library backups
-
Rust uses its preview data directory and coexists with the Qt edition. Tags and Smart Folder interfaces are deferred; existing records remain preserved. Quotation libraries require Rust and returning to Qt uses a pre-upgrade backup.
+
The Rust application retains its preview data directory. Legacy Qt libraries can be migrated from verified backup copies. Tags and Smart Folder interfaces are deferred; existing records remain preserved. Quotation libraries require Rust and returning to Qt uses a pre-upgrade backup.