Fix set_members with lock

Fix some edge cases with AirPlay DACP commands

Fix race condition with enqueue_next_media on SyncGroup

Fix for _cleanup_player_memberships

Fix playback speed handling on queue item and not on queue

Fix accessing player.state.synced_to

Auto ungroup when trying to form syncgroup with already synced player

Add note in docstring

Fix ungroup command

Fix issue with subprocess pips closing

Lock set_members to avoid concurrent actions

More gracefully handle DLNA errors

Speed-up core startup a bit

Fix bluesound volume jumping back after volume_set.

⬆️ Update music-assistant-frontend to 2.17.93 (#3214)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Properly cleanup stream buffers

Add a bunch of extra error handling and logging for flow streams

Add some additional guards to asyncprocess

Merge branch 'dev' of https://github.com/music-assistant/server into dev

Simplify can_group_with logic

Validate queue item ID in Sonos pause path (#3194)

Airplay2-configurable-latency (#3210)

Add API to handle playback speed (#3198)

Gracefully skip files/folders with emoji names on SMB mounts (#3183)

Snapcast: Fixes for hard switching of group leaders (#3209)

Fix Sonos S2 announcement 404 error on cloud queue context endpoint (#3208)

Small simplification for GroupPlayer

Some small code quality changes to DLNA Provider

Fix announcements typo

Handle HEAD requests on root route (#3204)

Fix group mute for protocol-synced players (#3205)

Fix HEOS source switching back to Local Music after starting stream (#3206)

Fix some more issues with syncgroups

Add comments to schema version constants

Revert MIN_SCHEMA_VERSION to maintain HA compatability.

Expand PIN based auth in airplay 2 (#3165)

* add LG details

* Make pin based auth work in other devices

* remove reference to apple tv and macos in check

* remove unused constant and adjust airplay2 filter

* also apply pairing check to raop

* add unit test

⬆️ Update music-assistant-frontend to 2.17.92 (#3203)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Fix use playerid for http profile

OpenSubsonic: Use server provided version tag if present (#3200)

Fix DSP not applying for AirPlay and Sendspin players (#3191)

Fixes for active source and current media with linked protocols

Feat/genres-v2-implementation (#3164)

* feat(genres): Core genre system

* feat(genres): add background scanner for metadata.genres

* refactor(genres): add genres to base

* test(genres): add test suite

* fix(genres): eixsting genres are not recreated at migration

* feat(genres): guard against infinite loops in scanner

* fix(genres): remove duplicate, improve tests

* fix(genres): limit genre tracks return

* refactor(genres): use logger rather than print

* refactor(genres): use asyncio.gather rather than sequential calls

* refactor(genres): various fixes after review comments

* refactor(genres): randomize selection, use asyncio gether

* refactor(genres): remove alias object

* fix(genres): fix n:n relationship, safeguard comparisons

* refactor(genres): address review comments

* fix(genres): fix issues after rebase

* test(genres): add missing param to library sync tests

abs: fix: do not add cover url if no cover present (#3202)

do not add cover url if path not present

⬆️ Update music-assistant-models to 1.1.99 (#3201)

Co-authored-by: MarvinSchenkel <17671719+MarvinSchenkel@users.noreply.github.com>

More fixes for protocol linking

Small fixes to grouped airplay playback and late joining

Fix: remove rate limiting from single item streams

Merge branch 'dev' of https://github.com/music-assistant/server into dev

Add debug logs to streamscontroller to debug smart fades sometimes skipping.

Fix RAOP password handling (#3197)

Added AriaCast Receiver plugin for Music Assistant (#3061)

* Add AriaCast Receiver plugin for Music Assistant

- Implemented AriaCast Receiver plugin to stream audio from Android devices to Music Assistant players.
- Added README.md with features, installation, configuration, and usage instructions.
- Created configuration classes for audio and server settings.
- Developed metadata handling for AriaCast streams.
- Implemented UDP discovery and WebSocket server for audio and metadata streaming.
- Added helper functions for local IP retrieval and artwork downloading.
- Included SVG icon for the plugin.
- Updated manifest.json with documentation link and requirements.

* Update README to simplify installation instructions

Removed installation instructions and updated configuration step for clarity.

* fixed mypy and pre-commit problems for my provider

* Delete music_assistant/providers/ariacast_receiver/README.md

* fixed pre-commit problems x2

* fixed icon

* Merge remote-tracking branch 'origin/dev' into dev

* Fixed Metadata and media controls after refactoring

* copilot notes addressing

* Addressing more copilot notes

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Addressing last notes

* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* fix: address code review feedback for ariacast_receiver

* fix(ariacast): add playback ready event for audio/player sync

- Add _playback_ready event to coordinate audio handler and player stream
- Audio handler waits up to 2s for player to become ready after starting playback
- get_audio_stream signals ready when it starts consuming frames
- Clear ready state on cleanup in _clear_active_player and stream end

This reduces audio frame loss during player setup by synchronizing
the audio receiver with the player's readiness to consume frames.

* Add multi-platform AriaCast receiver binaries (darwin/linux amd64/arm64/arm)

* renamed receiver name

* no redownload if same artwork

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/manifest.json

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* fix: use shared http_session for ariacast websocket connection

* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* fix in previous copilot commit messing up the way pipe was read (no loop)

* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* fixel last comments

* Change multi_instance setting to false

* Addressed latest comments after review

- Switched from pipe to stdout
- Dropped linux arm
- Moved _get_binary_path() to helpers.py

* Implemented stderr logging, robust WebSocket connection retries, improved artwork handling, and player switching control.

Updated Manifest

* Fix after PlayerController renamed all to all_players and players.get to get_player()

* Update music_assistant/providers/ariacast_receiver/__init__.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update music_assistant/providers/ariacast_receiver/__init__.py

Added suggested track change comments

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update documentation URL in manifest.json

* Added README for the binary of AriaCast Receiver

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

fix: gpodder: pass verify_ssl to web requests (#3195)

* pass verify_ssl in gpodder

* default is True

⬆️ Update music-assistant-frontend to 2.17.91 (#3199)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Fixes for sendspin web player

Fix grouping for for players whos native protocol is a protocol of other players (#3192)

Small tweak to merged players concept

Simplify hidden_by_default

Update protocol linking test

Add a extensions.json file to .vscode (#3068)

* Add a extensions.json file to .vscode

* Update .vscode/extensions.json

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Add another extension to the VS Code recommended set

* Remove Python env extension from recommended extensions

* Adjust whitespacing

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Fix universal player availability

Fix for protocol matching with locally administered mac

Reduce FFmpeg cover-art storms (#3109)

* fix(images): add in-memory cache and concurrency limit for image data

Add a TTL-based LRU memory cache (256 entries, 15min TTL) to
get_image_data() to avoid redundant fetches of the same image.
Deduplicate concurrent in-flight requests via task_id and limit
embedded image extractions to 2 concurrent ffmpeg processes
using a semaphore.

Includes unit tests for cache hits, TTL expiry, eviction, and
request deduplication.

* Revert "fix(images): add in-memory cache and concurrency limit for image data"

This reverts commit a676a2484d24df1de4d2631118f1f0315c503fc8.

* feat(images): add on-disk thumbnail cache to avoid repeated ffmpeg extractions

Implement a two-tier caching system for image thumbnails:

- On-disk cache: thumbnails stored as {sha256(provider/path)}_{size}.{ext}
  in a "thumbnails" subfolder of the cache directory, surviving restarts.
- In-memory FIFO cache: last 50 thumbnails for instant access on hot paths.
- In-flight deduplication: concurrent requests for the same thumbnail share
  a single generation task via create_task, preventing ffmpeg bursts.

This eliminates repeated ffmpeg spawns for embedded cover art extraction,
which caused high CPU usage and playback interruptions especially on
lower-powered hardware and network-mounted music libraries (e.g. SMB).

Add APEv2 tag parsing for WavPack/Musepack/Monkey's Audio (#3185)

⬆️ Update music-assistant-frontend to 2.17.90 (#3190)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Add eager start to create_task helper

Fix library items not being deletes after providers have removed them (#3154)

Switch to MA MusicBrainz mirror (#3186)

* Use MA Musicbrainz mirror and relax throttler.

* Use MA Musicbrainz mirror and relax throttler.

Fix: Don't merge player protocols for multiple software players on same host

⬆️ Update music-assistant-frontend to 2.17.89 (#3181)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Fix: ignore invalid mac and ip addresses in protocol linking

Update Sendspin provider to version 4.0 with many improvements (#3158)

Fix webplayer hide from UI by default

Use PlayerType player for sendspin web player

Fix player config entries

Fix: bind sendspin proxy to correct IP

Fix: Add PlayerFeature.PLAY_MEDIA to HEOS provider

Update readme of AirPlay provider about late joining

Improve AirPlay late joiner support

Some small tweaks to the AirPlay provider

Cap Apple Music artwork resolution to 1000x1000 (#3177)

Apple Music API returns artwork URLs with the maximum available resolution
(e.g. 6605x6605, 3000x3000) which causes excessive bandwidth usage, slower
page loads, and unnecessary memory consumption. Since Apple Music artwork
URLs support dynamic sizing via {w}x{h} placeholders, cap the requested
dimensions to 1000x1000 which is sufficient for all UI contexts. The
existing image proxy can further downscale for thumbnails as needed.

https://claude.ai/code/session_01AxXvTSeiZyCmnNqYLtfhLH

Co-authored-by: Claude <noreply@anthropic.com>

feat(kion_music): add configurable My Mix settings and improvements (#3145)

* feat(kion_music): add configurable My Mix settings and improvements

Add comprehensive configuration options for My Mix (radio) feature and
various provider improvements synchronized from Yandex Music provider.

## New Features

### My Mix Configuration
- `my_mix_max_tracks`: Maximum tracks for My Mix playlist (default: 150)
- `my_mix_batch_size`: API batch count for Browse/Discover (default: 3)
- `track_batch_size`: Track details batch size (default: 50)
- `discovery_initial_tracks`: Initial tracks in Discover section (default: 5)
- `browse_initial_tracks`: Initial tracks when browsing My Mix (default: 15)

### Feature Toggles (Advanced, disabled by default)
- `enable_recommendations`: Show My Mix in Discover/Recommendations
- `enable_my_mix_browse`: Show My Mix folder in Browse section
- `enable_my_mix_playlist`: Show My Mix as virtual playlist
- `enable_my_mix_radio`: Enable radio feedback (like/dislike)

### Base URL Configuration (Advanced)
- `base_url`: Configurable API endpoint (default: https://music.mts.ru/ya_proxy_api)
- Fixes connection issue from endpoint change (/ya_api → /ya_proxy_api)

## Provider Improvements

### API Client
- Add batching for liked albums/tracks fetching
- Add retry logic for network errors
- Add My Mix tracks fetching with batch_id support
- Add radio station feedback support
- Accept optional base_url parameter
- Use DEFAULT_BASE_URL constant

### Provider Features
- Add SIMILAR_TRACKS and RECOMMENDATIONS features
- Add My Mix as virtual playlist (playlist_id: "my_mix")
- Add radio feedback for track started/finished/like/dislike
- Add duplicate track filtering in My Mix
- Add locale-based browse folder names (Russian/English)
- Conditional feature enabling based on config

### Streaming
- Add quality selection logic for FLAC/AAC/MP3
- Add content type detection for audio formats
- Support for flac-mp4 and aac-mp4 formats

### Parsers
- Add radio track ID parsing (track_id@station_id format)
- Improve external URL generation for artists/albums/tracks/playlists
- Use music.mts.ru domain

## Testing
- Add test_streaming.py (7 tests for quality selection)
- Add test_my_mix.py (2 tests for radio ID parsing)
- Update test_api_client.py (8 tests for batching/retry/My Mix)
- Update test_parsers.py (16 tests with snapshots)
- All 44 tests pass ✅

## Constants
- Add My Mix configuration keys
- Add DEFAULT_BASE_URL constant
- Add ROTOR_STATION_MY_MIX constant
- Add MY_MIX_PLAYLIST_ID constant
- Add RADIO_TRACK_ID_SEP constant
- Add browse folder name dictionaries

This brings KION Music provider feature parity with Yandex Music provider
while maintaining MTS-specific branding and API endpoints.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(kion_music): use DEFAULT_BASE_URL when base_url not provided

Set self._base_url to DEFAULT_BASE_URL if base_url parameter is None
in KionMusicClient.__init__(). This ensures tests pass and the client
always has a valid base URL.

Fixes test_connect_sets_base_url failure in CI.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Address PR #3145 review comments

- Remove all tuning/toggle config entries; use hardcoded constants with
  sane defaults (all features always enabled)
- Fix documentation URL (beta.music-assistant.io → music-assistant.io)
- Extract magic string to ROTOR_FEEDBACK_FROM constant with comment
- Switch from private client._request to public client.request
- Update docstrings: Yandex → KION / generic wording
- Fix test import path (yandex_music → kion_music)
- Refactor duplicated My Mix code into shared _fetch_my_mix_tracks()
  helper; browse(), _get_my_mix_playlist_tracks(), recommendations()
  are now thin wrappers

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Increase Discovery initial tracks to 20 and cache to 10 minutes

Show more tracks in Discovery on Home and reduce API load by caching
recommendations for 10 minutes instead of 1 minute.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: address Copilot review comments and improve robustness

- Use == instead of is for dict comparison (BROWSE_NAMES_RU)
- Remove dead _get_content_type stub in parsers.py, inline ContentType.UNKNOWN
- Add AAC variants (aac-mp4, he-aac, he-aac-mp4) to streaming content type mapping
- Fix cache key collision: normalize composite track IDs before caching
- Add retry with reconnect to get_track_file_info_lossless

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: trudenboy0 <trudenboy0@gmail.com>

feat(deezer): Genre and mood flows (#3171)

* Add basic mood and genre flow support for Deezer

* Fetch Deezer flows and their images dynamically

* Address PR review comments

- Narrow exception handling from `Exception` to `DeezerErrorResponse`
  for recommended albums/artists endpoints
- Parse GW track data directly via `_parse_gw_track()` instead of
  making individual REST API calls per track
- Add early return check in `get_user_radio` when data key is missing
- Remove unnecessary `:param: None` docstring in `get_home_flows`
- Add defensive `.get()` check for "sections" key in `get_home_flows`
  to prevent KeyError

* Shrink function documentation of _parse_gw_track

* Revert to previous approach of fetching gw tracks seperately

---------

Co-authored-by: jdaberkow <13017916+jdaberkow@users.noreply.github.com>

Chore(deps): Bump aioslimproto from 3.1.4 to 3.1.5 (#3176)

* Chore(deps): Bump aioslimproto from 3.1.4 to 3.1.5

Bumps aioslimproto from 3.1.4 to 3.1.5.

---
updated-dependencies:
- dependency-name: aioslimproto
  dependency-version: 3.1.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
* Also bump version in provider manifest

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Marvin Schenkel <marvinschenkel@gmail.com>

Fix RuntimeError from dict/set mutation during iteration (#3159)

* Fix RuntimeError from dict/set mutation during iteration

Several collections are iterated while concurrent callbacks can
modify them, causing "Set/dictionary changed size during iteration"
RuntimeErrors:

- mass.py: _subscribers set iterated in signal_event() while
  subscribe/unsubscribe callbacks modify it
- mass.py: _providers dict iterated in get_provider() and
  _on_mdns_service_state_change() while providers load/unload
- player_controller.py: _players dict iterated in get_players(),
  get_player_by_name(), and update_player_control() while players
  register/unregister
- music.py: in_progress_syncs list iterated while done-callbacks
  call .remove() on it

Snapshot via list() before iterating in all affected locations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Fix additional dict mutation during iteration in mass.py

Snapshot via list() in three more locations where self._providers
or self._tracked_tasks are iterated while concurrent callbacks can
modify them: get_providers(), get_providers_by_domain(), and stop().

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Fix dict mutation during iteration in webserver dynamic routes

Snapshot self._dynamic_routes.items() via list() in _handle_catch_all()
to prevent RuntimeError when routes are registered or unregistered by
providers while a request is being matched against prefix routes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------

Co-authored-by: David Bishop <git@gnuconsulting.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

⬆️ Update music-assistant-frontend to 2.17.88 (#3178)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

fix: adapt playlog for all users if no user present (#3169)

adapt playlog for all users

fix: add name back to abs/itunes recommendation folders (#3170)

add name back to recommendation folders

abs: report correct time_listened in sessions (#3163)

* abs sessions statistics

* small progress sync fix

Auto cleanup cache db when it grows >= 2GB (#3174)

Auto cleanup cachedb when it grows >= 2GB

Fix: restart playback when switching to other output protocol

Some small follow-up fixes for protocols linking

Fix index_in_buffer or current_index treating index 0 as unset (#3160)

index_in_buffer and current_index are int | None where 0 is a valid
value (first track in queue). Two locations use chained `or` to
select between them:

- set_shuffle: `queue.index_in_buffer or queue.current_index`
- play_media_from_queue: `queue.index_in_buffer or queue.current_index or 0`

When index_in_buffer is 0 (first track buffered), Python's `or`
treats it as falsy and falls through to current_index. This causes
shuffle reshuffling and queue insertion to use the wrong position.

Replace with explicit `is not None` checks in both locations.

Co-authored-by: David Bishop <git@gnuconsulting.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Fix AttributeError when provider is temporarily unavailable (#3157)

get_provider() can return None when a provider is temporarily
unavailable (e.g., during reload or network issues). Both
remove_item_from_library() and add_item_to_library() call
.library_edit_supported() on the result without a None check,
causing an AttributeError that surfaces as a 500 error.

Co-authored-by: David Bishop <git@gnuconsulting.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

⬆️ Update music-assistant-frontend to 2.17.87 (#3172)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Fix HTTP proxy URL parsing for wss:// WebSocket URLs (#3168)

* Fix HTTP proxy URL parsing for wss:// WebSocket URLs

The HTTP proxy handler constructed the local HTTP URL by stripping
"ws://" from local_ws_url with a simple string replace. When the
server uses SSL, local_ws_url is "wss://..." which didn't match the
replace, producing a broken URL like "http://wss:/imageproxy?..." and
causing all proxy requests to fail with DNS resolution errors.

Use urllib.parse.urlparse instead, which correctly handles both ws://
and wss:// schemes.

* Move urlparse import to top-level to fix PLC0415 lint error

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Merge players with multiple protocols together (#3150)

* Base implementation of merging players through protocol linking

* Restore after merge conflict

* follow-up

* Fix config handling for players

* some tweaks

* Handle more (edge) cases

* bunch of fixes

* More fixes

* Some more tweaks

* Fix group_members calc

* A bunch of tweaks and refactoring

* more tweaks

* more follow-up

* Update controller.py

* refactoring groups

* more fixes for syncgroup

* fix readme nitpick

* revert frozen in uv run

* Add default providers conf

* fix tests

* more tweaks

* fixes for syncgroups

* More small tweaks

* more sync player tweaks

Fix typo in Sonos provider

⬆️ Update music-assistant-frontend to 2.17.86 (#3162)

Co-authored-by: marcelveldt <6389780+marcelveldt@users.noreply.github.com>

Fix typo in Airplay provider on setting new ip

Fix NO_CONTENT error on Sonos playback