Scatto — Pixelfed iOS client, forked from Impressia
  • Swift 99.2%
  • Python 0.6%
  • Shell 0.2%
Find a file
vinz 3226a419d3 Keep an account's push when a launch's token has expired, 3.1.1 (151)
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>
2026-11-10 21:54:50 +01:00
.github Add sponsor information 2023-03-28 10:46:49 +02:00
Assets Replace app icon with Scatto cherry-glow design; strip 16 alternate icons 2026-07-28 21:48:43 +02:00
ClientKit Reactions in one-to-one messages, through the conversations API 2026-11-07 21:10:33 +01:00
CoreData Hide the gallery composer's description field unless switched on 2026-10-30 11:34:58 +01:00
docs Keep an account's push when a launch's token has expired, 3.1.1 (151) 2026-11-10 21:54:50 +01:00
EnvironmentKit Hide the gallery composer's description field unless switched on 2026-10-30 11:34:58 +01:00
Localization Followed hashtags on your profile, with swipe to unfollow 2026-11-08 08:26:31 +01:00
PixelfedKit Build Scatto for the Mac, with a desktop layout and UI smoke tests 2026-10-26 13:22:23 +01:00
Resources Add Spanish translation 2023-10-18 17:52:49 +02:00
Scatto Keep an account's push when a launch's token has expired, 3.1.1 (151) 2026-11-10 21:54:50 +01:00
Scatto.xcodeproj Keep an account's push when a launch's token has expired, 3.1.1 (151) 2026-11-10 21:54:50 +01:00
ScattoCore Keep an account's push when a launch's token has expired, 3.1.1 (151) 2026-11-10 21:54:50 +01:00
ScattoShare Fix what the review of the watermark found 2026-10-30 12:01:42 +01:00
ScattoUITests Badge new messages and refresh the open list, 3.1.1 (149) 2026-11-10 18:54:33 +01:00
ScattoWidget Build Scatto for the Mac, with a desktop layout and UI smoke tests 2026-10-26 13:22:23 +01:00
Scripts Take the NavigationView out of Settings' NavigationStack 2026-11-01 17:08:37 +01:00
ServicesKit Review and fix the es, eu, fr, it and pl translations 2026-10-23 15:25:22 +02:00
SharedAssets.xcassets Add a dark green accent 2026-08-05 22:20:29 +02:00
UploadKit Collections: choose them while composing 2026-09-03 14:37:41 +02:00
WidgetsKit Leave the timeline's photos alone when the keyboard comes up 2026-10-30 22:40:59 +01:00
.gitignore Ignore Python's bytecode cache 2026-10-30 08:52:46 +01:00
.swiftlint.yml Change version to 1.4.0 (113) 2023-04-15 08:24:13 +02:00
CLAUDE.md Keep a ledger of shipped bugs, and fail UI tests that only check for a crash 2026-11-01 13:05:26 +01:00
LICENSE Change license to Apache 2.0 2023-03-28 10:35:38 +02:00
NOTICE Complete Impressia → Scatto rename; add NOTICE, rewrite README 2026-07-28 21:37:22 +02:00
PRIVACY-NOTICE.md Sync conversation state across devices through iCloud 2026-09-25 19:22:32 +02:00
README.md Update README for push notifications and interaction sounds 2026-07-31 15:31:54 +02:00
RELEASE_NOTES.md Keep an account's push when a launch's token has expired, 3.1.1 (151) 2026-11-10 21:54:50 +01:00
sounds_license.md Credit BigSoundBank for the interaction sounds 2026-08-05 18:32:22 +02:00
Tips.storekit Match the local tip products to what's on the App Store 2026-08-07 09:10:35 +02:00

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.sound from 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 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

  • upstream remote: https://github.com/Impressia/Impressia
  • origin remote: 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.

License

Apache License 2.0 — see LICENSE and NOTICE.