sonda/internal/api/http
Repository files (latest commit first)
Filename Latest commit message Latest commit date
tgiachi 7f38ae038e feat(federation): play a friend's music and show its covers through this server
A listener can now play the music of a friend from the web app.

- GET /friends/{friend}/tracks/{id}/stream and /friends/{friend}/albums/{id}/cover,
  in the group that accepts the access token in the query, like the local ones.
  This server asks the friend with a signed request and passes the bytes on,
  forwarding Range and the conditional headers, so a player can seek. The
  friend sees this server and never the listener.
- Only audio (for a stream) and a JPEG (for a cover) are passed on, with a
  fixed set of headers: Content-Type, Content-Length, Content-Range,
  Accept-Ranges, Last-Modified and ETag. Anything else a friend sends, or
  what a listener's request carries (cookies, authorization), is not passed
  either way, so a friend cannot make this server serve anything else.
- The client of friends can open a streaming answer: no limit on its whole
  length, one only on its beginning, no redirect followed, and it ends when
  the listener leaves.
- The player holds a friend's track next to the local ones. It streams
  through this server, shows the friend's cover, links to the music of the
  friend and not to a local page, is told apart from a local track with the
  same id, and is never reported as a listen: it does not feed taste.
- The songs of a friend have play buttons, the albums their covers.
- OpenAPI paths, contract test, and two real servers checked end to end: the
  bytes of the file arrive unchanged, with ranges, and a song plays in a
  browser from the friend's server through the other one.
2026-11-13 16:11:59 +01:00
..
api_test.go feat(federation): shared libraries and the signed read API for friends 2026-11-13 15:04:07 +01:00
artist_image_test.go feat(images): free photos of artists from Wikimedia Commons 2026-11-11 22:03:32 +01:00
auth_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
catalog_test.go feat(catalog): add the read API for artists, albums and tracks 2026-11-11 13:43:38 +01:00
contract_test.go feat(federation): play a friend's music and show its covers through this server 2026-11-13 16:11:59 +01:00
covers_test.go fix(images): a refresh never wipes covers, the job sees outages and starts cleanly 2026-11-12 09:43:51 +01:00
description_test.go feat(images): free photos of artists from Wikimedia Commons 2026-11-11 22:03:32 +01:00
discover_busy_test.go feat(discover): one Discover at a time for each listener, three at once on the server 2026-11-12 11:52:20 +01:00
discover_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
docs.go fix(api): make the spec say what the code does, and make the tests prove it 2026-11-11 14:46:28 +01:00
docs_test.go fix(api): make the spec say what the code does, and make the tests prove it 2026-11-11 14:46:28 +01:00
duplicates_test.go feat(api): list the duplicate songs, check their files and delete the extra copies 2026-11-12 16:46:50 +01:00
errors.go feat: add sondad server with config, storage, auth and listening API 2026-11-11 12:06:15 +01:00
federation_test.go feat(federation): shared libraries and the signed read API for friends 2026-11-13 15:04:07 +01:00
feedback_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
friends_test.go feat(federation): play a friend's music and show its covers through this server 2026-11-13 16:11:59 +01:00
handlers_about.go feat(about): artist descriptions from Wikipedia 2026-11-11 21:36:27 +01:00
handlers_artist_image.go feat(images): free photos of artists from Wikimedia Commons 2026-11-11 22:03:32 +01:00
handlers_auth.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
handlers_catalog.go fix(catalog): keep albums apart, align album counts, reject bad search text 2026-11-11 13:47:31 +01:00
handlers_covers.go fix(images): a refresh never wipes covers, the job sees outages and starts cleanly 2026-11-12 09:43:51 +01:00
handlers_discover.go feat(discover): one Discover at a time for each listener, three at once on the server 2026-11-12 11:52:20 +01:00
handlers_duplicates.go feat(api): list the duplicate songs, check their files and delete the extra copies 2026-11-12 16:46:50 +01:00
handlers_federation.go feat(federation): play a friend's music and show its covers through this server 2026-11-13 16:11:59 +01:00
handlers_feedback.go feat(feedback): a wishlist and "not interested" 2026-11-11 20:11:18 +01:00
handlers_friends.go feat(federation): play a friend's music and show its covers through this server 2026-11-13 16:11:59 +01:00
handlers_jobs.go fix(jobs): a stop or a panic never wedges a job, a bad download never replaces a good picture 2026-11-12 10:09:46 +01:00
handlers_libraries.go feat(federation): shared libraries and the signed read API for friends 2026-11-13 15:04:07 +01:00
handlers_library.go fix(discovery): purge lock, cleanup chains and rescans that cannot read 2026-11-11 17:36:14 +01:00
handlers_lidarr.go fix(lidarr): protect Lidarr from many asks, refuse bad ids, give up when the request does 2026-11-12 11:35:28 +01:00
handlers_listen.go feat(listening): count a listen after a minimum play time and expose the history 2026-11-11 14:58:47 +01:00
handlers_mixes.go feat(naming): playlists named by Claude by themselves when it is on 2026-11-13 11:00:23 +01:00
handlers_naming.go feat(naming): an admin section that shows what Claude costs 2026-11-13 11:14:45 +01:00
handlers_peer.go feat(federation): shared libraries and the signed read API for friends 2026-11-13 15:04:07 +01:00
handlers_playlists.go feat: playlists with a cover, a collage of the covers of their albums 2026-11-13 11:32:01 +01:00
handlers_providers.go fix(lidarr): saved defaults, conflicts, no proxy, readable addresses 2026-11-12 11:11:35 +01:00
handlers_similar.go feat(discovery): artist tags from Last.fm and MusicBrainz, and ids from my files 2026-11-11 17:01:43 +01:00
handlers_smart.go feat(smart): covers on the Smart playlists page 2026-11-13 11:41:23 +01:00
handlers_stream.go feat(streaming): stream tracks with HTTP Range support 2026-11-11 12:56:20 +01:00
handlers_taste.go feat(taste): learn what I like from what I listen to 2026-11-11 18:46:58 +01:00
handlers_users.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
handlers_usersettings.go fix(settings): strict body, deleted-account race, doc wording 2026-11-11 19:20:42 +01:00
health_log_test.go fix(docker): keep the secret, quiet health checks, and tighter files 2026-11-12 12:29:38 +01:00
jobs_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
libraries_test.go feat(federation): shared libraries and the signed read API for friends 2026-11-13 15:04:07 +01:00
library_test.go fix(discovery): purge lock, cleanup chains and rescans that cannot read 2026-11-11 17:36:14 +01:00
lidarr_test.go feat(naming): names for playlists, with the Claude API as an option 2026-11-13 10:33:48 +01:00
listens_test.go feat(listening): count a listen after a minimum play time and expose the history 2026-11-11 14:58:47 +01:00
middleware.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
middleware_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
mixes_test.go feat(naming): names for playlists, with the Claude API as an option 2026-11-13 10:33:48 +01:00
naming_test.go feat(naming): an admin section that shows what Claude costs 2026-11-13 11:14:45 +01:00
peer_test.go feat(federation): play a friend's music and show its covers through this server 2026-11-13 16:11:59 +01:00
playlist_covers_test.go feat: playlists with a cover, a collage of the covers of their albums 2026-11-13 11:32:01 +01:00
playlists_test.go feat(playlists): a user keeps playlists of tracks 2026-11-12 16:55:25 +01:00
providers_test.go feat(naming): names for playlists, with the Claude API as an option 2026-11-13 10:33:48 +01:00
router.go feat(federation): play a friend's music and show its covers through this server 2026-11-13 16:11:59 +01:00
router_test.go feat(lidarr): send an artist to Lidarr and see whether it has it 2026-11-12 11:28:15 +01:00
similar_test.go feat(discovery): remove provider data, genres from my files, full rescans 2026-11-11 17:27:29 +01:00
smart_test.go feat(smart): covers on the Smart playlists page 2026-11-13 11:41:23 +01:00
stream_test.go feat(library): named media libraries managed through the API 2026-11-11 13:30:25 +01:00
tags_test.go feat(discovery): remove provider data, genres from my files, full rescans 2026-11-11 17:27:29 +01:00
taste_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
usersettings_test.go feat(auth): accounts are identified by an email address 2026-11-12 14:40:33 +01:00
web.go feat(web): the app can be installed and opens offline (PWA) 2026-11-13 12:22:00 +01:00
web_test.go feat(web): the app can be installed and opens offline (PWA) 2026-11-13 12:22:00 +01:00