maCopy/docs/LAUNCH-AT-LOGIN.md
ilia e9461ed4f3
All checks were successful
CI / skip-ci-check (pull_request) Successful in 4s
CI / secret-scan (pull_request) Successful in 3s
CI / node-ci (pull_request) Successful in 17s
Add copy-only, color swatches, DB speed pragmas, and living docs
- Copy only (right-click -> Copy): write to clipboard without
  auto-pasting or hiding the window
- Color swatches: hex/rgb/hsl entries show a preview chip
- SQLite WAL + synchronous=NORMAL so the UI can read while the
  clipboard poller writes
- Memoize list rows (React.memo) so selection/focus changes don't
  re-render every row's preview
- Add docs/GUIDE.md (living install + usage doc), docs/SHARING.md,
  docs/TESTING.md, docs/LAUNCH-AT-LOGIN.md, docs/PRODUCT.md,
  CHANGELOG.md, ROADMAP.md
- Add homelab Gitea Actions CI (.gitea/workflows/ci.yml) + gitleaks
  allowlist
- Bump version to 0.2.0
2026-07-14 21:58:31 -04:00

1.5 KiB
Raw Permalink Blame History

Launch at login (start when Mac loads)

maCopy can register itself as a macOS Login Item so it starts when you log in.

In the app (preferred)

  1. Build and install a real app bundle (dev mode often cannot register Login Items reliably):

    npm run tauri build
    open src-tauri/target/release/bundle/macos/maCopy.app
    
  2. Menu bar tray → Settings… → turn on Launch at login.

  3. Confirm in System Settings → GeneralLogin Items & Extensions → maCopy is listed.

Turning the toggle off removes the Login Item.

How it works

  • Settings UI calls @tauri-apps/plugin-autostart (enable / disable / isEnabled).
  • Preference is also stored in SQLite (launch_at_login) for display consistency.
  • Backend plugin is initialized with MacosLauncher::LaunchAgent.

Manual fallback

If the toggle fails:

  1. System Settings → General → Login Items → + → choose maCopy.app
  2. Or: right-click maCopy in the Dock (while open) → Options → Open at Login

Requirements for it to stick

Need Why
Installed .app under /Applications (or a stable path) Login Items point at a path; rebuilds under target/ get orphaned
Quit tauri dev when testing login Dont mix debug binary paths with the release app
Accessibility still granted after update Auto-paste needs Privacy → Accessibility → maCopy

Verify after reboot

  1. Restart Mac / log out and in
  2. Copy some text
  3. Press Ctrl+` — picker should appear without launching manually