Skip to content

Commit b744ffc

Browse files
committed
Update the README and site now the download just opens
Drops the Gatekeeper workaround and the ask for a sponsor to fund the Apple Developer Program membership, both of which are now obsolete, and adds a short install section. The sponsor link stays as general support for the project.
1 parent 80b075f commit b744ffc

2 files changed

Lines changed: 22 additions & 21 deletions

File tree

README.md

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -14,22 +14,17 @@ desktop app and no native quick-access of its own.
1414

1515
> Not affiliated with or endorsed by Proton AG.
1616
17-
## 💛 Looking for a sponsor
17+
## 💛 Support the project
1818

1919
[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-db61a2?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/bsramin)
2020

21-
This is a free, open-source side project, and it will stay that way. I'm looking
22-
for a **sponsor to cover the Apple Developer Program membership** (99 USD/year).
21+
This is a free, open-source side project, and it will stay that way.
2322

24-
With it, I can ship the app **notarized and signed**, so it installs without
25-
Gatekeeper warnings, and add **automatic updates** so everyone stays on the
26-
latest version effortlessly. The app would remain **completely free and fully
27-
open source** for everyone, forever. The sponsorship pays only for the Apple
28-
membership that makes safe, frictionless distribution possible.
29-
30-
If you or your company would like to help, you can sponsor through
31-
**[GitHub Sponsors](https://github.com/sponsors/bsramin)**. Your support would be
32-
credited here with thanks.
23+
If the app is useful to you and you'd like to help with the running costs, the
24+
Apple Developer Program membership among them, you can sponsor through
25+
**[GitHub Sponsors](https://github.com/sponsors/bsramin)**. It's entirely
26+
optional and changes nothing about the app, which is and remains completely free
27+
and fully open source.
3328

3429
Prefer not to sponsor? You can also sign up for Proton with my
3530
**[referral link](https://pr.tn/ref/H6KQSW71)**. You get 2 weeks of a paid plan,
@@ -177,12 +172,21 @@ The workflow is the same one you already know:
177172
- An optional Touch ID lock guards casual access to an unlocked Mac. It is not a
178173
defense against local code execution.
179174

175+
## Install
176+
177+
Download `PassQuickAccess.zip` from the
178+
[latest release](https://github.com/bsramin/pass-quick-access/releases/latest),
179+
unzip it, and move the app to `/Applications`. From then on it tells you when a
180+
new version is out and installs it only when you pick "Update Now".
181+
182+
You'll also need `pass-cli` installed and logged in (see Requirements).
183+
180184
## Requirements
181185

182186
- macOS 14 or later
183187
- [`pass-cli`](https://github.com/protonpass/pass-cli) installed and logged in
184188
(`pass-cli login`). The CLI requires a paid Proton Pass plan.
185-
- [XcodeGen](https://github.com/yonaskolb/XcodeGen) to generate the project
189+
- [XcodeGen](https://github.com/yonaskolb/XcodeGen), to build from source
186190

187191
## Build and run
188192

@@ -199,9 +203,10 @@ xcodebuild -scheme PassQuickAccess -destination 'platform=macOS' test
199203
```
200204

201205
`PassQuickAccess.xcodeproj` is generated from `project.yml` and is not checked
202-
in. By default the project builds ad-hoc signed; to sign with your own Apple
203-
Developer identity, copy `Config/Local.xcconfig.example` to
204-
`Config/Local.xcconfig` and fill in your team.
206+
in. By default the project builds ad-hoc signed, which is enough to run it
207+
locally; to sign with your own Apple Developer identity, copy
208+
`Config/Local.xcconfig.example` to `Config/Local.xcconfig` and fill in your team.
209+
Producing a release artifact is [documented separately](RELEASING.md).
205210

206211
## Limitations
207212

@@ -210,10 +215,6 @@ Developer identity, copy `Config/Local.xcconfig.example` to
210215
- Ordering uses the item's modification time. The official app also factors in
211216
last-use time, which `pass-cli` does not expose. If you'd like it to, vote for
212217
[this Proton feature request](https://protonmail.uservoice.com/forums/953584-proton-pass-authenticator/suggestions/51396523-cli-expose-and-update-last-used-time-for-items).
213-
- Distribution is currently build-from-source. A notarized release needs an
214-
Apple Developer ID certificate (a paid Apple Developer Program membership);
215-
[sponsoring the project](https://github.com/sponsors/bsramin) would help cover
216-
it, so builds could open without a Gatekeeper prompt.
217218

218219
## Contributing
219220

docs/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -504,7 +504,7 @@ <h2>Get it running.</h2>
504504
<a class="btn btn-primary" href="https://github.com/bsramin/pass-quick-access/releases/latest" target="_blank" rel="noopener">Download for macOS
505505
<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><path d="M12 4v12m0 0l-5-5m5 5l5-5M5 20h14"/></svg>
506506
</a>
507-
<p class="note">The download isn't notarized yet (a notarized release needs an Apple Developer ID certificate). The first time, right-click the app and choose <b>Open</b> to get past Gatekeeper, or run <span class="mono">xattr -dr com.apple.quarantine PassQuickAccess.app</span>. <a style="color:var(--accent)" href="https://github.com/sponsors/bsramin" target="_blank" rel="noopener">Sponsoring</a> helps cover notarization. You can also sign up for Proton with my <a style="color:var(--accent)" href="https://pr.tn/ref/H6KQSW71" target="_blank" rel="noopener">referral link</a>: you get 2 weeks of a paid plan, and I get a small reward if you subscribe.</p>
507+
<p class="note">Unzip it, drag it to Applications, open it. From then on the app tells you when there's a new version, and installs it only when you say so. If you'd like to support the project you can <a style="color:var(--accent)" href="https://github.com/sponsors/bsramin" target="_blank" rel="noopener">sponsor</a> it, or sign up for Proton with my <a style="color:var(--accent)" href="https://pr.tn/ref/H6KQSW71" target="_blank" rel="noopener">referral link</a>: you get 2 weeks of a paid plan, and I get a small reward if you subscribe.</p>
508508
</div>
509509
<div class="install reveal">
510510
<div class="ihead">

0 commit comments

Comments
 (0)