- Swift 99.2%
- Python 0.6%
- Shell 0.2%
On launch the scene asks for the device token while onApplicationStart is still refreshing the access tokens. When the token differed from the stored one, register re-subscribed every account with its stored token; registerAccount tore the old subscription down first and the new one then failed with 401 on a token that had expired overnight. The account was left with no push until it was switched off and on (seen on the Mac for vinz, 401s in the 149 launch log). register now holds a device token until accessTokensRefreshed, called after refreshAccessTokens (LaunchGate in ScattoCore, with tests), and a 401 on removing the old subscription stops the registration and keeps it. iPhone, iPad and Mac. ScattoCore 470 tests, ScattoTests, ClientKitTests and iPhone SmokeTests pass; Release builds for iOS and Mac Catalyst succeed. The failure itself was not reproduced. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .github | ||
| Assets | ||
| ClientKit | ||
| CoreData | ||
| docs | ||
| EnvironmentKit | ||
| Localization | ||
| PixelfedKit | ||
| Resources | ||
| Scatto | ||
| Scatto.xcodeproj | ||
| ScattoCore | ||
| ScattoShare | ||
| ScattoUITests | ||
| ScattoWidget | ||
| Scripts | ||
| ServicesKit | ||
| SharedAssets.xcassets | ||
| UploadKit | ||
| WidgetsKit | ||
| .gitignore | ||
| .swiftlint.yml | ||
| CLAUDE.md | ||
| LICENSE | ||
| NOTICE | ||
| PRIVACY-NOTICE.md | ||
| README.md | ||
| RELEASE_NOTES.md | ||
| sounds_license.md | ||
| Tips.storekit | ||
Scatto
Scatto is a personal fork of Impressia, the SwiftUI iOS client for Pixelfed. It keeps Impressia's photo-first experience and adds three things Impressia doesn't have: first-class video support, real push notifications, and interaction sound effects.
Scatto runs against the maintainer's own Pixelfed instances (pix.hever.de, scatto.social) and is being prepared for an App Store release. There is no plan to open a public issue tracker on this repo.
What Scatto adds over Impressia
Push notifications
Pixelfed speaks Web Push, which iOS apps can't receive directly — so Scatto pairs with a companion relay, scatto-push-relay, that bridges Pixelfed's Web Push to Apple Push Notification service (APNs).
- Real push for likes, comments, follows, and boosts, delivered even when the app is closed.
- Multi-account and multi-instance: each signed-in account gets its own subscription on its own instance, and enabling push registers them all. Signing into a second account no longer silences the first.
- Deep-linking: tapping a notification opens the post or profile it refers to.
- Device-wide badge: the app-icon badge shows the total unread across all accounts, not just whichever was pushed to last.
- Per-subscription control of the icon badge and interaction sounds, so the in-app toggles are honoured even for pushes that land while the app is closed (iOS applies
aps.badge/aps.soundfrom the payload before any app code runs, so the relay has to be told).
Interaction sounds
Scatto plays a short sound for social interactions — a heartbeat when you like (or are liked), a whoosh when you boost (or are boosted), and a typewriter for comments (yours and received). A single Interaction sounds toggle in Settings gates them (default on). Foreground pushes play through the app; backgrounded pushes carry the sound name in the APNs payload.
Video
First-class video support in an app that upstream keeps deliberately photos-only — the original reason for the fork.
Credits
Scatto exists because Impressia exists. All the hard work is upstream:
- Impressia by Marcin Czachurski and contributors — https://github.com/Impressia/Impressia
- Previously released as Vernissage — https://github.com/VernissageApp/Vernissage
Impressia is licensed under the Apache License 2.0. Scatto keeps the same license (see LICENSE) and preserves upstream attribution in NOTICE and in the per-file copyright headers.
Why fork instead of contribute?
Impressia is intentionally photos-only, and its push-free design fits a pure Pixelfed client. Adding video changes the app's positioning, and push notifications pull in a whole companion service — neither is a good fit for upstreaming. Forking lets us keep pulling in upstream fixes (git fetch upstream && git merge upstream/develop) while diverging on our own feature set (video, push, interaction sounds).
Relationship to upstream
upstreamremote: https://github.com/Impressia/Impressiaoriginremote: this repository- Bundle IDs, target names, and directories have been renamed from
Impressia→Scatto— merges from upstream on those files will conflict and need manual resolution.
Build
Requirements: Xcode 16+, iOS 17 SDK, and either a free Apple ID (7-day sideload) or the Apple Developer Program ($99/yr) for stable installs.
git clone git@git.hever.de:vinz/scatto.git
cd scatto
open Scatto.xcodeproj
Set the signing team to your Apple ID for the three targets: Scatto, ScattoShareExtension, ScattoWidgetExtension. Bundle IDs are namespaced under de.hever.scatto.
Push notifications are optional. They require the companion scatto-push-relay running on your own host (with an APNs auth key) and its base URL + subscribe token wired into AppSecrets. Without it, everything else — timelines, uploads, video, interaction sounds when the app is open — works normally.