Commit graph

244 commits

Author SHA1 Message Date
tgiachi
226ee72900 feat(web): mixes as tiles of colour with the name big
Each mix is a tile with its name and a note on where it comes from (my
listening or the genres of my files), in a colour that is always the same for
that mix. The tones of the missing covers are shared with the tiles.
2026-11-13 19:21:48 +01:00
squidd
d207787575 Merge pull request 'The Federation admin page like the mockup' (#153) from feat/ui-federation into main 2026-11-13 19:18:06 +01:00
tgiachi
69ec2abc1c feat(web): the Federation admin page like the mockup
Parts divided by lines instead of stacked blocks, the key of this server big
and in groups of four, the state of a friend as a pill in the friend colour,
two columns for the settings, the invites and the limits.
2026-11-13 19:17:04 +01:00
squidd
7a9aeab7d1 Merge pull request 'A bar of tabs at the bottom of the phone' (#151) from feat/ui-phone into main 2026-11-13 17:59:30 +01:00
tgiachi
35dabf48ef feat(web): a bar of tabs at the bottom of the phone
Home, Search, Library, Friends (only when there is a friend) and More,
under the player. The menu on the left stays on wide screens; on a phone
only the logo is left on top. New Library and More pages list the places
that do not fit in the bar.
2026-11-13 17:58:50 +01:00
squidd
cacb30d5ae Merge pull request 'Pages without boxes: rows, underlined tabs, one title style' (#149) from feat/ui-pages into main 2026-11-13 17:55:19 +01:00
tgiachi
1a03f70059 feat(web): pages without boxes: rows, underlined tabs, one title style
The fourth piece of the new look, first part.

- One component for the title of a page, larger than before; the greeting of
  Home is larger still.
- The cards of artists, albums, mixes, playlists and smart playlists are the
  picture and the words: no panel, no hover box, they still lift.
- The lists of the admin area (libraries, users, friends), of Discover (the
  suggestions and the wishlist) and of Friends are rows separated by a line.
  The providers, the jobs and the costs are sections divided by a line.
- The tabs of Discover, Admin and the music of a friend are underlined, in the
  colour of this server, or in the friend colour for a friend.
- The page of a friend has a band in the friend colour at its top edge.
- An artist with no picture is a quiet tile with its initial, not a loud one.
2026-11-13 17:54:25 +01:00
squidd
17a37b11f0 Merge pull request 'The seek bar shows the waveform of the track' (#147) from feat/ui-waveform into main 2026-11-13 17:36:10 +01:00
tgiachi
bfa3e6e458 feat: the seek bar shows the waveform of the track
The seek bar of the player is the shape of the track, with the part already
heard in colour, as in the approved mockups.

- GET /tracks/{id}/peaks gives 120 levels from 0 to 255 (the loudest part is
  255 whatever the volume). The server finds them by decoding the file, MP3 with
  go-mp3 and FLAC with eaburns/flac, both in pure Go. It takes a few seconds, so
  the first request starts the work in the background and answers 202 with
  Retry-After. It is done once for each file (migration 0025), worked out again
  if the size or the date of the file change, one track at a time so that a NAS
  is not kept busy, and a file that cannot be decoded is remembered as such. A
  track deleted while its file is being decoded is not an error.
- The seek bar of the player bar and of the full-screen player draws the shape
  and asks again every few seconds until it is there. Until then, and for a
  friend's track, which has none, the bar is flat. The heard part is teal, or
  the friend colour. It is still a native range input, 44 pixels high in the
  bar.
- OpenAPI path and schema, contract test, tests with real MP3 and FLAC files,
  and a real server checked: a 4-minute MP3 is ready in about a second and a
  half, a 12 MB FLAC in three, and asking again takes a millisecond.
2026-11-13 17:35:00 +01:00
squidd
f99d2bddcc Merge pull request 'New look of the web app, part 2: the player with a live spectrogram' (#145) from feat/ui-player into main 2026-11-13 17:19:29 +01:00
tgiachi
fdf1ebfabc feat(web): new look, part 2: the player with a live spectrogram
- A spectrogram drawn in the browser from the sound being played: the last
  seconds, time running to the right and ending now, low notes at the bottom,
  brighter where there is more energy. Small in the player bar, large in the
  full-screen player. It works the same for a friend's track, since its audio
  comes through this server.
- It is drawn only while something plays and the page is in view, and with
  reduced motion it is redrawn four times a second; where the browser has no
  Web Audio it stays empty and nothing else changes.
- The play button is round, in the colour of this server and in the friend
  colour for a friend's track.
- The bar and the full-screen player show the name of the friend whose server
  a track comes from, and nothing for this server's own music.
2026-11-13 17:17:57 +01:00
squidd
adc3aa2832 Merge pull request 'New look of the web app, part 1: palette, Figtree, menu, covers, controls' (#143) from feat/ui-foundation into main 2026-11-13 17:13:19 +01:00
tgiachi
945aaf1a05 feat(web): new look, part 1: palette, Figtree, menu, covers and controls
The first piece of the new look of the web app.

- The Sonda theme takes the new palette (a deep blue ground, a lighter tone
  for panels instead of shadows, teal for the action). Every theme gets a
  --friend colour for what comes from another Sonda server, checked for
  contrast on the page and on a panel and for a hue that is not the primary
  one.
- Figtree is the only font; Fraunces is gone, also from the full-screen
  player.
- The menu is words and a dot: the dot of the open page is the colour of this
  server, and the dot of Friends is always the colour of what comes from
  elsewhere. There is nothing to fold, so the fold button and its setting are
  removed.
- The shell is flat: the menu has a line on its right, the page has no panel
  around it, the player is a band under everything.
- A missing cover is the rings of Sonda on a colour taken from the album, the
  same one every time; a friend's album gets another colour than this
  server's album with the same id.
- The switch is a pill with a round knob and the outline button is a line.
2026-11-13 17:11:59 +01:00
squidd
9b81b6385a Merge pull request 'Federation: play a friend's music and show its covers through this server' (#141) from feat/federation-play into main 2026-11-13 16:13:18 +01:00
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
squidd
ae2ceb2190 Merge pull request 'Federation: browse and search a friend's catalogue' (#139) from feat/federation-browse into main 2026-11-13 16:00:48 +01:00
tgiachi
29bd46c3ba feat(federation): browse and search a friend's catalogue
A listener can now browse the music that a friend's server shares.

- GET /friends lists the friends both admins agreed to, by id and name; an
  address or a key is for the admin only. It is empty while federation is off.
- GET /friends/{friend}/artists, albums and tracks (q, limit, offset,
  artist_id, album_id) and the one-item routes: this server asks the friend
  with a request signed by its own key and passes the page on. The answer is
  read into this API's own types first, so what a friend adds is dropped and
  the shape is the one in the spec. Nothing is kept, and the ids are the
  friend's own.
- Only the three kinds of thing can be asked, and only the parameters their
  routes take: a listener cannot make this server ask a friend for anything
  else. The friend's address and what the connection said never reach a
  listener.
- A friend that cannot be reached, no longer takes this server for a friend,
  is busy or is not there is told in words, never as an error page.
- The client of friends gets a generic signed GET with a size limit.
- The web app has a Friends entry in the menu, shown only when there is a
  friend to browse, a list of friends and a page for each with artists,
  albums and songs, a search and links from an artist to its albums and from
  an album to its songs, in English and Italian.
- OpenAPI paths and schemas, contract test with a friend that is a whole
  server, and two real servers checked end to end.
2026-11-13 15:59:26 +01:00
squidd
8702ff9786 Merge pull request 'Federation: shared libraries and the signed read API for friends' (#137) from feat/federation-peer-api into main 2026-11-13 15:05:54 +01:00
tgiachi
89826fcd07 feat(federation): shared libraries and the signed read API for friends
A friend's server can now read what an admin chose to share.

- A library has a shared flag, off by default (migration 0024), set with
  PATCH /libraries/{id}. Changing it never waits for a scan.
- Requests between friends are signed with each server's Ed25519 key: the
  method, the path and query from /api/v1/peer on, a date, a nonce and the
  hash of the empty body. A date more than two minutes off, a nonce used
  before, an unknown or removed key and a bad signature all get the same
  401. A friend still waiting for approval gets 403, and while federation is
  off the routes are missing.
- Routes under /api/v1/peer: info, artists, albums, tracks, covers and
  streaming with Range. The catalogue, the counts and the format come from
  the shared libraries only, and the file served is the one in a shared
  library. No path, library id, listen, taste, user or provider data is part
  of an answer.
- A friend never makes this server build a cover, read an audio file or ask
  a provider: only covers already built from the audio files are served.
- Per-friend limits, set by the admin: parallel streams (default 3) and KiB
  a second (default 4096, 0 for none), shared by all the streams of a friend.
- A log of the last requests friends made (route, status, bytes; never the
  query), kept for 7 days, in GET /federation/requests.
- POST /federation/friends/{id}/check lets the side that pasted an invite
  find out that the other admin approved; a signed call from a friend this
  server is waiting for makes it active too.
- Admin: a Shared with friends switch on each library, which asks first, and
  limits, recent requests and a Check button in the Federation section, in
  English and Italian.
- OpenAPI paths and schemas, contract test, two real servers checked end to
  end with tagged audio files.
2026-11-13 15:04:07 +01:00
squidd
346466c621 Merge pull request 'Federation: keys, invites and pairing between Sonda servers' (#135) from feat/federation-pairing into main 2026-11-13 14:44:34 +01:00
tgiachi
695a012f6c feat(federation): keys, invites and pairing between Sonda servers
Two servers can become friends. Federation is off by default; turning it
on makes an Ed25519 key pair, kept in the database and never returned.

- Admin routes: GET and PUT /federation (on or off, name, public address),
  POST /federation/invites, POST /federation/friends (use an invite),
  POST /federation/friends/{id}/approve and DELETE /federation/friends/{id}.
- POST /api/v1/peer/pair, the one route without a login: the code of an
  invite is the proof. An invite works once and expires in 24 hours; only
  a hash of its code is stored. At most 10 attempts a minute.
- The server that uses an invite checks that the key it gets back is the
  one named in the invite. A friend is kept as incoming or outgoing until
  both admins have agreed.
- https only, except plain http on a network of one's own (private,
  loopback or link-local address, or a local name).
- A client of its own for friends, with no redirects, no proxy from the
  environment, a size limit and a time limit; the providers' client stays
  as it is.
- Migration 0023 for SQLite and PostgreSQL, OpenAPI paths and schemas,
  contract test with two real servers.
- Admin > Federation in the web app, in English and Italian, and a
  section in the README.
2026-11-13 14:43:48 +01:00
squidd
822f6094e5 Merge pull request 'feat(web): a Show photo button on the cards of Discover' (#133) from feat/discover-photos into main 2026-11-13 13:07:53 +01:00
tgiachi
3ade5e80d5 feat(web): a Show photo button on the cards of Discover
A suggested artist you do not have shows a letter, because a photo is a lookup at the providers. The card now has a button that asks for the photo of that one artist when it is pressed, says what it sends, and says so when there is no free photo.

Closes #132
2026-11-13 13:01:57 +01:00
squidd
cded6f063e Merge pull request 'Audit follow-ups: skip link, lighter player, lazy pages, small polish' (#131) from feat/audit-followups into main 2026-11-13 12:57:18 +01:00
tgiachi
f0135cc548 fix(web): tap targets of 44 px, a browser bar that follows the theme, shorter lines
- The switches and the seek bar of the player bar take a tap on 44 px (the switch is now one component).
- The colour of the browser bar follows the theme instead of staying dark blue.
- Paragraphs stop at 56 characters and no longer end on a lone word.

Closes #130
2026-11-13 12:56:26 +01:00
tgiachi
a423632632 perf(web): pages are fetched when first opened
Every page but Home is loaded on demand, so the first script goes from 728 kB to 345 kB (gzip 220 to 112 kB). The admin area and the smart playlist editor are no longer in the first download.
2026-11-13 12:46:56 +01:00
tgiachi
817b869af7 perf(web): the player parts follow only the state they show 2026-11-13 12:44:53 +01:00
tgiachi
a80ead7f2b feat(web): a skip link jumps over the sidebar to the page 2026-11-13 12:44:12 +01:00
squidd
3ac61faa88 Merge pull request 'fix(web): Gruvbox text and links reach 4.5:1 contrast' (#129) from fix/gruvbox-contrast into main 2026-11-13 12:39:50 +01:00
tgiachi
36dffc2ed1 fix(web): Gruvbox text and links reach 4.5:1 contrast
Muted text on the secondary surface was 4.05:1 in Gruvbox dark and 3.8:1 in Gruvbox light, and the link colour on cards was 4.46:1 in Gruvbox light. The tokens are adjusted and the contrast test now also checks muted text on secondary and the primary colour as text on background and card.

Closes #128
2026-11-13 12:39:15 +01:00
squidd
82f9ee39cc Merge pull request 'feat(web): the app can be installed and opens offline (PWA)' (#127) from feat/pwa into main 2026-11-13 12:24:58 +01:00
tgiachi
2217a12042 feat(web): the app can be installed and opens offline (PWA)
- A web app manifest with the name, the colours, the display mode and the icons (also a maskable one), so a browser offers to install it; Settings has an Install button where the browser lets the page ask.
- A service worker keeps the files of the app (the page, its scripts and styles, the manifest and the icons) so it opens at once, and shows its own page when the server cannot be reached. It never touches /api/: nothing from the API is kept, answered from a cache, or asked for by the worker. Files that failed, and anything that is not a file of the app, are not kept; the scripts it keeps are capped.
- A new version waits until the page says it may take over: a line says a new version is ready and its button reloads the page after the new worker took over.
- The server gives the manifest its type (application/manifest+json); the worker and the manifest are asked again every time, and the policy of the page needs no change.
2026-11-13 12:22:00 +01:00
squidd
f86b5a3d7b Merge pull request 'feat(web): the logo of Sonda, and a design pass' (#125) from feat/design-pass into main 2026-11-13 12:11:57 +01:00
tgiachi
7e46c38245 feat(web): the logo of Sonda, and a design pass
- The logo, sONDA with an O that is a sea wave, traced to vector paths: the s in the text colour and the rest in the accent colour of the theme, in the sidebar and on the sign-in page; folded, the sidebar shows the wave alone. The favicon, the touch icon and the 192 and 512 icons are the wave on the blue of the logo (the old favicon was left by the build tool).
- Touch targets: buttons, fields, icon buttons and small links are 44 pixels tall; the time of the player is 13 pixels; the seek bar has a taller hit area.
- A phone: the menu is one row that scrolls sideways and the player is two lines (what is playing and the controls, then the position), so the page keeps the screen.
- Cards that are links lift a little and their pictures grow inside the frame on hover, unless less motion is asked for.
- The provider cards have a ground of their own.
2026-11-13 12:10:54 +01:00
squidd
7e3e40a896 Merge pull request 'feat(smart): covers on the Smart playlists page' (#123) from feat/smart-covers into main 2026-11-13 11:42:13 +01:00
tgiachi
82b92eaf08 feat(smart): covers on the Smart playlists page
- GET /smart-playlists/{id}/covers and GET /smart-playlists/suggested/{key}/covers say which albums stand for a smart playlist: up to 4 albums that have a cover, in the order of the songs the rules give now (for the variant asked), each once. They are worked out apart from the songs, and the answer may be kept for a few minutes.
- The cards of the Smart playlists page are a grid with the collage. The list shows at once and each card asks for its own covers after that, showing the rings until they arrive or when they cannot be read.
- The pages of a smart playlist and of a suggested one use the same covers for the variant on screen, so only albums that have a cover are shown.
2026-11-13 11:41:23 +01:00
squidd
0d69ae48de Merge pull request 'feat: playlists with a cover, a collage of the covers of their albums' (#121) from feat/playlist-covers into main 2026-11-13 11:32:57 +01:00
tgiachi
a1e192066c feat: playlists with a cover, a collage of the covers of their albums
- A playlist says which albums stand for it (album_ids): up to 4 albums that have a cover, in the order they first appear in it, each once, read for a whole page of playlists in one query. An empty one has an empty list.
- The Playlists page is a grid of cards with the collage, and the page of a playlist shows it in its header. The pages of a smart playlist and of a suggested one show a collage of the albums of their first songs.
- Nothing is fetched for it: the covers are the ones the library already has.
2026-11-13 11:32:01 +01:00
squidd
75577e1fdb Merge pull request 'feat(naming): an admin section that shows what Claude costs' (#119) from feat/claude-costs into main 2026-11-13 11:15:43 +01:00
tgiachi
1b79a7370d feat(naming): an admin section that shows what Claude costs
- Every question asked of Claude is recorded: when, the kind of list, the model, the tokens read and written (also for an answer that was no name but was billed) and how it ended: a name made, a name taken from the kept ones, or a failure and why. Nothing of the facts that were sent is recorded. Records older than a year are removed (migration 0022).
- GET /providers/anthropic/usage (admin) gives the totals of the last days (1 to 365, 30 by default), a row for each day with calls and an estimate of the cost in dollars, worked out from the tokens and the price of the model. It says it is an estimate and flags calls to a model whose price is not known.
- A Costs section in the admin area shows the last 7, 30 or 90 days.
2026-11-13 11:14:45 +01:00
squidd
84b6937bbf Merge pull request 'feat(naming): playlists named by Claude by themselves when it is on' (#117) from feat/auto-names into main 2026-11-13 11:01:52 +01:00
tgiachi
0d8fadadf6 feat(naming): playlists named by Claude by themselves when it is on
- Keeping a mix, a smart playlist or a suggested smart playlist as a playlist with auto_name gives it the name and the line of description that Claude makes from its songs. The name sent stays the fallback when the provider is off, or Claude fails or declines, so a failure never stops a playlist from being made.
- A smart playlist can be made with no name when Claude is on: it names it from the songs the rules give. Without Claude a name is still needed.
- GET /naming says whether names are automatic, so the editor does not ask for a name that Claude will make.
- The web app always asks for an automatic name and sends the language of the page.
2026-11-13 11:00:23 +01:00
squidd
0dddfb741e Merge pull request 'feat(smart): the songs I play most, in rotation lately and over the year' (#115) from feat/on-rotation into main 2026-11-13 10:45:42 +01:00
tgiachi
bf5c108785 feat(smart): the songs I play most, in rotation lately and over the year
- A smart playlist rule, plays_within_days, that counts only the plays of the last N days where plays are counted: the minimum of plays and the most and least played orders. The other listening rules are not changed.
- Two more suggested smart playlists on it: on-rotation (the most played of the last 30 days, at least twice) and top-year (the same over 365 days). most-played stays as the plays of all time.
- The editor has the new rule and the page says it in words. Texts in English and Italian.
2026-11-13 10:44:55 +01:00
squidd
322b6e5530 Merge pull request 'feat(naming): names for playlists, with the Claude API as an option' (#113) from feat/naming into main 2026-11-13 10:34:49 +01:00
tgiachi
9e666d2b29 feat(web): a Suggest a name button
- Where a playlist is renamed, and where a smart playlist is edited, a button asks the server for a name in the language of the page. It fills the name, fills the description when it is empty, and says if the name came from Claude or from this server. A failed request says why and changes nothing.
- The Claude card in the providers page has a key, a test and the switch, but no contact and no data to take back.
2026-11-13 10:33:48 +01:00
tgiachi
23ae396430 feat(naming): names for playlists, with the Claude API as an option
- A pipeline over the facts about a list of songs (up to 5 genres, up to 8 artist names, how many songs, a few words about the rules of a smart playlist, the language). A local namer builds a name from the genres and the artists on this server and is always there; Claude is asked first only when an admin turned the new anthropic provider on with an API key. A failure or a refusal gives the local name. What Claude answers is kept under a hash of the facts, so the same question is not asked or paid twice.
- The anthropic provider: a write-only key (kept as typed, it is case-sensitive), a test that reads one model and sends no text, and a plain statement of what is sent. It uses the official Go SDK with nothing taken from the environment of the server (no key, profile, base URL or extra headers), no redirects, no system headers, and an answer that is cleaned and bounded.
- POST /playlists/{id}/suggest-name, POST /mixes/{id}/suggest-name and POST /smart-playlists/{id}/suggest-name answer with a name, a description and where it came from.
2026-11-13 10:33:48 +01:00
squidd
2b7635c936 Merge pull request 'feat(web): a sidebar that collapses' (#111) from feat/web-collapsible-sidebar into main 2026-11-13 10:11:21 +01:00
tgiachi
4810564aac feat(web): a sidebar that collapses
- A button in the sidebar folds it to a narrow bar with the icon of each page, and opens it again. The choice is remembered in the browser, which may refuse to keep it.
- Every link keeps its name for screen readers and gets a tooltip when only its icon shows.
- On a phone, where the sidebar is a row of links, nothing changes.
2026-11-13 10:10:25 +01:00
squidd
ca63fc4701 Merge pull request 'feat(smart): smart playlists made for everybody, without making them' (#109) from feat/suggested-smart into main 2026-11-13 10:07:45 +01:00