source: Klonkt/CHANGELOG.md@ 162c7a7

main
Last change on this file since 162c7a7 was 162c7a7, checked in by Robin <roboburr@…>, 7 weeks ago

Docs: FEDERATION.md per FEP-67ff

Documents Klonkt federation surface (AP S2S+C2S, WebFinger, HTTP Signatures, NodeInfo 2.1, OAuth+PKCE), activities/object types, Mastodon extension terms, supported FEPs (67ff, f1d5). Under-consideration section flags DRAFTs and the WITHDRAWN status of FEP-5624.

Co-Authored-By: Claude Opus 4.8 <noreply@…>

  • Property mode set to 100644
File size: 23.4 KB
Line 
1# Changelog — Klonkt
2
3All notable changes to Klonkt. Newest at the top.
4Versions follow [SemVer](https://semver.org/).
5
6## [Unreleased]
7
8### Added
9- **FEDERATION.md (FEP-67ff).** The repository root now documents what Klonkt
10 speaks on the wire: ActivityPub S2S and C2S, WebFinger, HTTP Signatures,
11 NodeInfo 2.1, OAuth (PKCE), the activities and object types it sends and
12 receives, the Mastodon-compatible extension terms, and the FEPs it supports or
13 tracks. Helps other implementations interoperate.
14- **Messages: your poll finished.** When one of your own polls closes, Messages
15 shows a "poll finished" item with the final result: a bar per option with its
16 percentage, and the number of voters. It lives under the Activity chip and is
17 searchable like the rest.
18- **Messages: sharper filters and a search box.** The filter chips are now
19 Messages (@mentions and private/DM replies), Conversations (public replies),
20 Activity (likes, boosts, follows), Moderation (reports) and Sent, next to All.
21 A search box filters the list by sender and message text, and combines with
22 the active chip. All client-side, instant.
23- **The reply editor got a visual clean-up.** Its toolbar now uses the same
24 icon set and 32px buttons as the post editor, with active formatting shown
25 filled in the accent colour, a framed editor box with a focus ring, and
26 tidier language, mention and attachment chips. One editor family across the
27 site.
28- **The reply editor shows who you are addressing (rich replies, phase 3).** A
29 "To:" bar above the editor lists the conversation partners (the author you
30 reply to plus the thread's earlier authors) as removable chips, instead of
31 cluttering your text with @mentions. Remove a chip and that person is no
32 longer mentioned, tagged or pinged; mentions you type yourself stay in the
33 text. Editing a sent reply keeps every co-mention intact.
34- **Editing a sent reply uses the rich editor too.** The edit forms on Messages
35 and the interact page open the same editor as new replies (formatting kept,
36 language adjustable, full-screen on phones). Attachments on the reply survive
37 an edit untouched.
38- **Media in replies (rich replies, phase 2).** Drop, paste or pick images,
39 audio and video straight into the reply editor (the paperclip works on
40 phones). Files upload to your own site, show as removable chips while you
41 write, travel as real attachments on the federated note, and render in your
42 thread. A media-only reply (no text) works too.
43- **Rich replies (phase 1).** Replying to fediverse comments (inline in the
44 thread and on the interact page) now uses a shared rich editor: bold, italic,
45 links, lists and quotes, plus a language picker for your reply (sent along as
46 the note's language map). On phones the editor opens as a full-screen compose
47 view, the pattern that actually works on mobile. Without JavaScript the plain
48 text box keeps working. Media in replies is the next phase.
49- **Revoke connected apps from your account page.** A "Connected apps" section
50 lists every app you authorized over OAuth (name, site, scope, last used) with
51 a Revoke button. Tokens you already granted show up too, since they were
52 always stored (hashed); the bearer itself is never kept, so revocation is keyed
53 on the token hash.
54- **The account owner can read their own followers and following over C2S.** The
55 `followers` and `following` collections stay count-only for the public
56 (privacy), but a request carrying a C2S bearer scoped to that site now returns
57 the real actor URIs, so an app (Shaer) can build a friends list. Anonymous
58 callers are unchanged.
59- **App access via OAuth 2.0 (ActivityPub Client-to-Server, phase 1).** Klonkt
60 now speaks the standard AP C2S auth handshake so native and web clients (the
61 Shaer apps first) can connect: dynamic client registration (RFC 7591), a
62 PKCE authorization-code flow with a consent screen that picks which of your
63 sites the app may post as, and bearer tokens (stored hashed, single-use
64 codes). The actor document advertises the OAuth and uploadMedia endpoints and
65 `/.well-known/oauth-authorization-server` (RFC 8414) exposes the metadata, so
66 clients discover everything instead of hardcoding paths. Public clients + PKCE
67 only, no client secrets.
68- **The outbox accepts posts from apps (C2S, phase 1 complete).** A
69 bearer-authenticated `POST` to `/ap/users/:slug/outbox` now drives your account
70 from a client: publish a note, reply, like, boost, follow, and undo any of
71 those. Activities are translated onto the same delivery machinery the web UI
72 uses; a bare Note is wrapped in a Create per the spec; content is sanitized;
73 the token is scoped to one site so it can't post as another. Note: this is
74 ActivityPub C2S, which the Shaer apps speak. Mastodon clients (Ivory etc.) use
75 Mastodon's own API and are not supported by this.
76
77### Fixed
78- **OAuth consent now hands off reliably to native apps.** After Allow/Deny, a
79 redirect to a native custom scheme (e.g. `com.klonkt.shaer:/oauth`) was a plain
80 302, which mobile browsers silently drop. The consent step now serves a tiny
81 interstitial for non-http redirect URIs that auto-forwards and offers an "Open
82 the app" tap link (a tap reliably launches the app on Android; iOS's web-auth
83 session intercepts either way). Web (http/https) clients still get a 302.
84- **Visitors can reply to the site owner's own comments.** The "reply via the
85 fediverse" button only appeared on comments from others; the site's own
86 comments in a thread offered visitors nothing, so you could not respond to
87 the author from your own instance.
88
89## [1.5.0] · 2026-07-18
90
91### Added
92- **Messages: your replies and notifications on one page.** A single Messages
93 tab replaces Replies and Notifications. One stream with filter chips (All,
94 Conversations, Activity, Sent): your own sent replies join the conversation
95 (with edit and delete), likes and boosts on the same post group into one line,
96 private replies carry a lock badge, and items new since your last visit get a
97 dot. The interact bookmarklet moved along. Old /fediverse and /notifications
98 links redirect to /messages.
99- **Connect: your following and followers on one page.** A single Connect tab
100 replaces the separate Following and Followers pages, showing each connection's
101 direction (following →, follower ←, mutual ↔) and, for accounts you deliver to,
102 when they were last reached. Accounts you can no longer reach move to a
103 collapsed "Unreachable" section for cleanup. Old /following and /followers
104 links redirect to /connect.
105- **Moderate incoming replies on your own posts.** As the site owner you can now
106 remove a reply from your thread (it stays removed: re-delivery and
107 thread-filling are blocked by a tombstone) and report it to its author's
108 server, straight from the thread. This also works for private replies, which
109 cannot be handled via the fediverse interact flow.
110
111### Fixed
112- **A boosted video post keeps its video in the Circle.** Boosting a video-only
113 post (Loops.video) stored it without its media, so the Circle showed a bare
114 text tile instead of a video thumbnail; re-boosting could even wipe the video
115 from an already-cached copy. Boosts now carry the full typed media, and a
116 refresh never erases cached media.
117- **The interact page title follows your language.** "Interacteer via de
118 fediverse" was hardcoded Dutch in the browser tab, even on an English site.
119- **The Apple Music icon looks like the Apple logo again.** The old icon was a
120 garbled shape.
121- **Statistics columns no longer jump around in the 30 and 90 day views.**
122 Columns without a date label collapsed slightly; every column now keeps its
123 label line.
124- **Private replies no longer show on the public post page.** A followers-only
125 or direct (DM) reply to your post was rendered in the public thread for
126 everyone. Incoming replies now record their fediverse addressing; the public
127 thread only shows public and unlisted replies. Private ones still reach you in
128 notifications, with the post they belong to.
129- **Bare video/audio embeds no longer overflow their column.** A `.webm` /
130 `.mp4` / `.mp3` player now fits the content width like the iframe embeds do;
131 the width rule previously covered only `iframe`.
132
133## [1.4.0] · 2026-07-14
134
135### Added
136- **Followers list with delivery health.** A new Fediverse tab shows who follows
137 you and when each account was last reached, so dead accounts stand out and you
138 can remove them after a check.
139- **Bare media links play inline.** A plain `.webm`, `.mp4` or `.mp3` link now
140 renders a native player instead of a dead link.
141- **Hashtags, links and mentions are clickable on your site too.** `#tags`, URLs
142 and `@mentions` in a post become links on the site itself, not only on the
143 federated copy. Mentions are resolved once when you save, so pages stay fast.
144
145### Fixed
146- **Replies, comment deletes and reply edits always arrive.** They used to be
147 dropped when a server was briefly unreachable; they now go through the retry
148 queue like posts do.
149- **Video thumbnails for more videos.** Covers from videos with their metadata at
150 the end of the file (Loops.video, phone exports) now get a thumbnail instead of
151 none.
152- **A video-only cover shows a poster on the post page.** It no longer renders
153 blank in the Solo view.
154- **The installed app no longer shows old data on a shaky start.** A cold launch
155 on a poor connection refreshes instead of showing a stale page.
156- **The Updates page follows your branch.** On the stable branch you no longer
157 see main's changes flagged as "latest".
158
159## [1.3.5] — 2026-07-04
160
161### Fixed
162- **Polls keep their cover art when boosted.** A poll with music or an embed was
163 federating without its cover, so a boosted poll showed a blank tile; the cover
164 now travels with it.
165- **The Android app's Updates page shows what's actually installable.** It read
166 the newest release branch, which could be ahead of the phone build for a short
167 while — pressing update then reinstalled the same version. It now reads the
168 version of the phone bundle itself.
169
170## [1.3.4] — 2026-07-04
171
172### Fixed
173- **Boosts that lost their cover get it back automatically.** Posts you boosted
174 before the cover fix were cached without their artwork; they are refreshed
175 once on the next restart. If a post's home server is briefly unreachable at
176 that moment, it is retried on the next restarts instead of being skipped for
177 good. Boosting a post again now also refreshes its cached copy (cover,
178 content) — from the feed as well as the interact page.
179
180## [1.3.3] — 2026-07-03
181
182### Fixed
183- **Boosted music posts keep their cover.** When you boosted a track from
184 someone you don't follow, the cover art went missing; it now shows, just like
185 for people you do follow.
186
187## [1.3.2] — 2026-07-02
188
189### Fixed
190- **The Updates page now works in the Android app.** It now shows the newest
191 available version, and the update button downloads and installs it right on
192 your phone (your posts and settings are kept).
193
194## [1.3.1] — 2026-07-02
195
196### Fixed
197- **Music keeps playing in the background on Android.** When a track ended while
198 your phone was locked or the app was in the background, the next track would
199 start and stop again after a second. The player now feeds the whole queue as
200 one continuous stream, so auto-advancing to the next track no longer counts
201 as "new" playback that the browser is allowed to pause.
202
203## [1.3.0] — 2026-07-02
204
205### Added
206- **Choose a light or dark share card.** The auto-generated share image follows your site theme;
207 under Admin → SEO you can now force it light or dark.
208- **A mention is now a notification.** When someone on the fediverse mentions you in a post —
209 even one that isn't a reply to you — it shows up in your fediverse notifications with a link
210 to the original.
211- **Cover art on openly shared audio.** A track shared openly on the fediverse now carries its
212 cover art (or the post cover), so audio players that support artwork show it instead of a blank tile.
213- **Report a post to the fediverse.** From a fediverse post you can now report it to the moderators
214 of its own home server, with an optional reason — and if someone reports your site, the report
215 shows up in your fediverse notifications.
216- **Set a post's language.** Choose the language you wrote a post in — on the fediverse it enables
217 timeline language filtering and the translate button.
218- **Alt text for images.** Give your cover image a description (and inline images keep their own
219 alt text) — it federates to the fediverse and lets screen readers describe the picture.
220- **Mention people in a post.** Typing `@user@server` in a post now links to their profile and
221 notifies them on the fediverse — even if they don't follow you — just like a mention in a reply.
222- **Short videos in the feed autoplay and loop.** An animated cover or a short (≤30s) clip in the
223 News feed now plays automatically and loops muted, like a GIF; longer videos keep their controls.
224- **Vote on fediverse polls.** A poll from an account you follow now shows in the News feed with its
225 options and current results, and you can cast your vote — it federates back like any Mastodon vote.
226- **Create your own polls.** A post can now carry a poll (single or multiple choice, with a set
227 duration). It federates as a real fediverse poll, so your Mastodon followers can vote from their own
228 app; the live results show on the post and the poll closes itself when the time is up.
229
230### Changed
231- **Sharing audio openly is now one-way.** Once a track is shared openly on the fediverse the file
232 has spread, so "closing" it again would be false security — the editor now locks the choice after
233 opening and warns you before you tick it.
234
235### Fixed
236- **Remote videos show a preview frame.** A video in the News feed or a Circle tile (e.g. from
237 Loops or PeerTube) used to appear as a black box until you pressed play; it now shows a real
238 poster frame. (Longer videos keep their player controls by design — only clips under 30 seconds
239 autoplay like a GIF.)
240- **Mentions, hashtags and links inside brackets now work.** A mention like `(@user@server)`, a
241 `(#hashtag)` or a bracketed URL federated as plain text — and the mentioned person was never
242 notified. They now link (and notify) like their unbracketed forms.
243- **Plain web addresses become links on the fediverse.** A bare URL typed in a post or reply now
244 federates as a clickable link instead of plain text.
245
246## [1.2.0] — 2026-07-01
247
248### Added
249- **PeerTube videos in the feed.** A PeerTube link in a post now shows an inline player in the News
250 feed, like YouTube, Spotify and SoundCloud already did.
251- **Light share images.** Sites whose default theme is Light now get a matching light Open Graph card
252 when a page is shared, instead of always a dark one.
253- **Leave your own visits out of the stats.** As the admin you can now exclude your own IP address
254 from your site statistics, for a truer picture of real visitors.
255- **Right-click "Save" is turned off on covers, images and videos** — a light bit of friction so the
256 artwork isn't one click from being saved (it's friction, not protection).
257
258### Fixed
259- **Animated video covers now render correctly everywhere.** In the Circle and the grid they could
260 show up as a broken image or a blank tile; they now display as a proper looping video that fills the
261 square, centred. Right-clicking a cover gives the normal link menu instead of the browser's video controls.
262- **Following someone no longer gets stuck.** A follow whose first delivery fails (the other server
263 briefly unreachable) is now retried automatically with backoff, instead of staying on "pending" forever.
264- **Boosted posts show their real text** in the Circle, instead of a "RE: <link>" prefix.
265- **Hardened fediverse handling** — stricter signature checks on incoming activity, blocks now also
266 cover a boost of a blocked author, and pinned-post syncing no longer races when you save several times quickly.
267
268## [1.1.0] — 2026-06-30
269
270### Added
271- **Animated covers play smoothly everywhere.** Upload an animated WebP as a cover and Klonkt also
272 makes a muted, looping video of it. iOS Safari — where animated WebP is janky — gets the smooth
273 video, every other browser keeps the crisp WebP, and on the fediverse the cover federates as a
274 video that plays in Mastodon and its apps. Shown on the post, the grid, the feed and related posts.
275- **Media library (Admin → Media).** See every uploaded image, where each one is used, copy its URL,
276 and clean up unused files in one click — including the leftover video/poster of an animated cover.
277 Images, Audio and Playlists now share one tab bar.
278- **Share button** at the bottom of every post (native share sheet, or copy link).
279- **Replace a track's audio file** without re-creating the track.
280- **Music on the fediverse (first step).** Audio posts now carry schema.org *MusicRecording* /
281 *MusicAlbum* data, and a per-post toggle can share a hosted track as a real fediverse audio
282 attachment that plays in followers' feeds.
283
284### Changed
285- **Cleaner embeds on Mastodon.** A post with a YouTube/Spotify/SoundCloud link now lets Mastodon
286 show its player card; link-only tracks share their streaming links. The cover still shows in other
287 Klonkt feeds. (On your own site nothing changes — the player and cover render as before.)
288- **Circles stay in sync the fediverse way** — edits and missed posts catch up automatically via
289 standard ActivityPub, so a Circle no longer drifts out of date.
290- **Everything Klonkt federates is now valid AS2 / JSON-LD**, guarded by a test, so stricter servers
291 accept it.
292- The track list is sorted **newest-first**.
293
294### Fixed
295- **Animated WebP covers are no longer frozen to a single frame** (the crop editor and the thumbnailer
296 left them static).
297- **Link-only tracks** (Spotify/YouTube, no uploaded file) can be inserted into a post again.
298- **Link previews** (og:image / Twitter card) now use absolute image URLs, so they show on Signal,
299 WhatsApp and other scrapers.
300- Several **fediverse delivery fixes**: covers/links no longer turn into a black tile on Mastodon,
301 raw audio files don't clutter a post that already has a player, and dead links from a renamed
302 remote post heal themselves.
303- The **mobile feed** loads full-resolution covers; long titles wrap instead of overflowing.
304- **Self-hosting updates** are more reliable: re-running the installer keeps your channel, and the
305 updater no longer restarts or claims an update when you're already up to date.
306
307## [1.0.0] — 2026-06-30
308
309### Added
310- **Klonkt is now on the fediverse (ActivityPub).** Your site is a real fediverse
311 account: people on Mastodon — or another Klonkt — can follow you, and your posts
312 reach their feeds. You can follow accounts and read their posts in a **News** feed,
313 get **notifications**, and **like, boost and reply** to posts. Incoming activity is
314 verified, so fake replies, likes and followers are rejected.
315- **Anyone can reply, like or boost your posts from the fediverse** — visitors interact
316 from their own account (they just enter their server); no account on your site needed.
317- **Circles**: follow other Klonkt sites and show each other's public posts in your
318 Circle — decentralised, with no central platform.
319- **Sensitive (NSFW) posts** with your own content-warning text: blurred with
320 click-to-reveal across the site, and shown as a content warning on the fediverse.
321- **Block** an account or an entire domain you'd rather not hear from.
322- Search now also finds **tracks** (by title, artist and album), playable straight from
323 the results with a link to the post they appear in — and post search matches as you type.
324- **Live theme preview** in Admin → site settings: accent, theme and palette update
325 instantly, before you save.
326- Uploaded images are automatically optimised to **WebP** for faster pages.
327- A roomier **mobile writing experience**: tap to open a distraction-free fullscreen
328 editor, with the formatting toolbar staying in view above the keyboard.
329- **Long posts collapse in the News feed** with a *read more* toggle, so a long post no
330 longer fills the whole screen — tap to expand or collapse it.
331- **See everyone in a Circle**: when a Circle has more than five sites, the member count
332 opens a popup that lists them all, so a big Circle no longer hides its members.
333
334### Changed
335- **Palettes revised to 8**: the neutral **Klonkt** (gold accent) is the new default,
336 plus seven full-colour themes — Forest, Ocean, Teal, Lilac, Sunset, Candy and Amber.
337- **Your profile federates more completely**: the links on your profile, the date you
338 joined and the accounts you follow now travel along to other servers, so your profile
339 looks complete when someone views it from Mastodon or elsewhere.
340- **Cover images and avatars are sharper** — resized on the server instead of being
341 squeezed by the browser.
342
343### Removed
344- **Hub mode** — Klonkt is now **solo or Circles**; you build a collective or label
345 through **Circles** (federated, standalone sites).
346- **Native comments and Google login** — replies, likes and boosts now run entirely
347 through the fediverse.
348- **Local favourites (♥)** — replaced by the ⭐ fediverse like.
349
350### Fixed
351- **Hashtags and mentions now work in every language and script** (e.g. Japanese, Cyrillic,
352 Arabic), both on your site and when federating — not just the Latin alphabet.
353- **Switching a site to solo (federation off) works again.** Turning the fediverse off could
354 make the whole site return “page not found” instead of just disabling federation; it now
355 cleanly switches federation off while the rest of the site keeps working. (Self-hosters:
356 update to pick up the fix.)
357- The Fediverse and Notifications items now disappear from the menu when federation is off,
358 instead of lingering.
359- The mini-player jumps and scrolls to the track that's playing — also from an album or
360 playlist — and keeps it highlighted.
361- Empty album/playlist covers now fall back to the first track's cover.
362- A profile photo that broke in the header after the WebP switch now repairs itself.
363- Many **mobile post-editor** fixes: reliable scrolling, a formatting toolbar that stays
364 put, no page jumps when you tap a button, and a Save bar that sits just above the keyboard.
365- **Boosts now reach the original poster** — their server registers the boost and notifies
366 them, just like a boost from Mastodon — and a boost is retried if a server is briefly
367 unreachable instead of being sent once and forgotten.
368- **Unfollowing an account now takes effect on the other server** (it could previously fail
369 to register, leaving you still following on their side).
370
371## [1.0.0-beta.2] — 2026-06-19
372
373First release where we actively track the version (shown in the footer — click it for
374this page).
375
376### Added
377- Release tracking: the version number in the footer links to this changelog page.
378- Eight premium features (Patreon-gated): newsletter/mailing list, download-for-email,
379 release scheduling + fan-only previews, EPK/press kit, pro statistics, link-in-bio +
380 click stats, embeddable player, and show agenda + notify-me.
381- Newsletter signup field in the footer (on/off in Admin → Settings).
382- SMTP settings configurable in Admin → Settings (no more config-file edit needed), with
383 a test-mail button.
384
385### Changed
386- Tidier settings forms (stacked labels, full-width inputs).
387- EPK/press kit shows the top 10 most-listened tracks.
388- Nicer 404 page (mobile-friendly) and clearer login error messages.
389
390### Fixed
391- The site-wide audio player wasn't loading any tracks.
392- Button text became unreadable on hover.
393- Date pickers now follow the theme.
394- Back/forward navigation no longer shows a doubled header.
Note: See TracBrowser for help on using the repository browser.