Troubleshooting

Troubleshooting

macOS blocks the app on first launch

PullPing is signed with a self-made certificate, not notarized. Open System Settings → Privacy & Security, scroll down and click Open Anyway next to PullPing, or run xattr -dr com.apple.quarantine /Applications/PullPing.app once. See Installation.

The menu-bar icon is missing

• Open PullPing again from /Applications: it brings up its window even without the icon.
• Check System Settings → Menu Bar: PullPing may be switched off there, or hidden by a menu-bar manager or the notch. With many menu-bar items, macOS hides the ones that do not fit.
• Settings → General → Show in the Menu Bar must be on.

No pull requests show up

1. Settings → Accounts: is the account Connected? Is its Enabled switch on? See the status table in Accounts and tokens.
2. Token scopes. A classic token needs repo (or public_repo) and read:org. A fine-grained token needs the permissions listed in Accounts and tokens, and its resource owner must be the user or organization that owns the repositories.
3. Organizations with SSO: authorize the token for each organization (Configure SSO on the token).
4. Which pull requests count: open ones you opened, are assigned to, were asked to review, commented on, reviewed or were mentioned in. Merged and closed ones disappear after the retention time (Settings → General). Issues show only while Settings → General → Track Issues is on. See Usage.
5. Filters: check the filter and the account switch at the top of the panel; a pull request you muted is under Muted, one you hid under Hidden. Settings → General → Reset Ignored Pull Requests brings back ones you chose to stop tracking.
6. Refresh now (⌘R) and wait a few seconds.

A pull request is still invisible

A fine-grained token only sees the repositories you selected, and an organization may need to approve it first. Try a classic token with repo and read:org. If you use a restricted OAuth setup, use a personal access token instead.

"Token rejected", "Missing repo scope", "Needs SSO", "Rate limited"

See Accounts and tokens → Account status. A rate limit clears by itself when GitHub resets it; PullPing resumes on its own.

"Token rejected" every day on a Sign in with GitHub account: fixed in 0.5.0. GitHub sign-in tokens expire after 8 hours; PullPing now keeps the refresh token GitHub sends with them (in your login keychain) and renews the token by itself. Accounts signed in with an earlier version have no refresh token yet: sign in with GitHub once more (Add Account…, then remove the old entry). Personal access tokens are not affected.

CI status is missing or wrong

CI status may be incomplete with fine-grained tokens because of a gap in GitHub's Checks API. Use a classic token when CI matters.

Notifications are late or missing

• PullPing polls GitHub (every 3 minutes by default, 1 to 15 in Settings → General). Press ⌘R for an immediate check, at most once every 10 seconds.
• Your first sync of an account is silent by design. So is the first sync of issues after you update to 0.4.0 or turn Track Issues back on: only later activity notifies.
• Labels changed is off for others' pull requests and issues by default; turn it on in Settings → Notifications.
• Settings → Notifications: is Show Notifications on, and is the style for that kind of event Off? Is the pull request muted or snoozed, or did you pause notifications from the menu-bar icon's menu?
• Your own actions never notify you.
• Hidden pull requests still notify; muted and snoozed ones do not.
• After your Mac wakes, PullPing checks again, so events arrive a moment after wake.

Panels appear during Focus

By design: macOS offers no way to detect Focus. See FAQ.

Nothing arrives on my phone

• Settings → Phone: a topic must be set, and at least one kind of event ticked (nothing is sent by default).
• Click Send Test Notification. If it fails, check the server address (include https://) and, for a protected server, the access token.
• You must subscribe to the same topic in the ntfy app on your phone.
• Phone sends follow the same rules as panels: Show Notifications must be on, and muted, snoozed and paused pull requests are skipped.

Open at Login does nothing

PullPing has to be in /Applications. If macOS asks for approval, click Allow in Login Items… or check System Settings → General → Login Items & Extensions.

Still stuck

Open a bug report. Please do not paste tokens, and use generic names for private repositories.