diff --git a/common/anim.gd b/common/anim.gd
index ec68edb..cf75678 100644
--- a/common/anim.gd
+++ b/common/anim.gd
@@ -24,15 +24,20 @@ static func enabled() -> bool:
 ## one with the same key so they don't fight. Returns null when animations are off or the
 ## node is not in the tree.
 static func tween(node: Node, key: StringName = &"anim") -> Tween:
+	stop(node, key)
+	if !enabled() || !node.is_inside_tree():
+		return null
+	var new_tween: Tween = node.create_tween()
+	node.set_meta(StringName("_tween_" + key), new_tween)
+	return new_tween
+
+
+## Stops the animation called [param key] on [param node], if one is running.
+static func stop(node: Node, key: StringName = &"anim") -> void:
 	var meta: StringName = StringName("_tween_" + key)
 	var old: Variant = node.get_meta(meta) if node.has_meta(meta) else null
 	if old is Tween && (old as Tween).is_valid():
 		(old as Tween).kill()
-	if !enabled() || !node.is_inside_tree():
-		return null
-	var new_tween: Tween = node.create_tween()
-	node.set_meta(meta, new_tween)
-	return new_tween
 
 
 ## Makes [param control] grow from its middle.
diff --git a/common/animated_progress_bar.gd b/common/animated_progress_bar.gd
new file mode 100644
index 0000000..c1375ba
--- /dev/null
+++ b/common/animated_progress_bar.gd
@@ -0,0 +1,118 @@
+class_name AnimatedProgressBar
+extends ProgressBar
+## A progress bar with some life in it:
+## - [method wait] shows Godot's busy animation until there is any progress;
+## - [method move_to] glides to each new value instead of jumping;
+## - a soft highlight sweeps along the filled part, kept inside its rounded corners.
+##
+## The bar's style, e.g. [code]SyncProgressBar[/code], has a [code]shine[/code] colour for
+## the highlight, and two more styles go with it: [code]<style>Fill[/code], a Panel shaped
+## like the filled part that the highlight is kept inside, and [code]<style>Text[/code],
+## the Label with the percentage. With Reduce animations the bar only jumps to its values,
+## with no busy animation or highlight.
+
+## How wide the highlight is, in pixels.
+const SHINE_WIDTH: float = 260.0
+## How fast the highlight moves, in pixels per second.
+const SHINE_SPEED: float = 520.0
+## How far past the end the highlight goes before starting over, so sweeps have a pause.
+const SHINE_GAP: float = 600.0
+
+# The filled part's shape, which only its children are drawn inside
+var _mask: Panel
+var _shine: TextureRect
+# The percentage, drawn above the highlight rather than under it
+var _label: Label
+var _shine_x: float = -SHINE_WIDTH
+
+
+func _ready() -> void:
+	_mask = Panel.new()
+	_mask.mouse_filter = Control.MOUSE_FILTER_IGNORE
+	_mask.clip_children = CanvasItem.CLIP_CHILDREN_ONLY
+	add_child(_mask)
+	_shine = TextureRect.new()
+	_shine.mouse_filter = Control.MOUSE_FILTER_IGNORE
+	_shine.expand_mode = TextureRect.EXPAND_IGNORE_SIZE
+	_shine.stretch_mode = TextureRect.STRETCH_SCALE
+	_mask.add_child(_shine)
+	_label = Label.new()
+	_label.mouse_filter = Control.MOUSE_FILTER_IGNORE
+	_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
+	_label.vertical_alignment = VERTICAL_ALIGNMENT_CENTER
+	_label.set_anchors_and_offsets_preset(Control.PRESET_FULL_RECT)
+	_label.visible = show_percentage
+	add_child(_label)
+	show_percentage = false
+	_mask.theme_type_variation = StringName(String(theme_type_variation) + "Fill")
+	_label.theme_type_variation = StringName(String(theme_type_variation) + "Text")
+	theme_changed.connect(_update_style)
+	value_changed.connect(func(_value: float) -> void: _update_label())
+	_update_style()
+	_update_label()
+
+
+func _process(delta: float) -> void:
+	var fill_width: float = fill_width()
+	_mask.size = Vector2(fill_width, size.y)
+	_mask.visible = fill_width > 0.0 && !indeterminate && Anim.enabled()
+	if !_mask.visible:
+		return
+	_shine_x += SHINE_SPEED * delta
+	if _shine_x > fill_width + SHINE_GAP:
+		_shine_x = -SHINE_WIDTH
+	_shine.position = Vector2(_shine_x, 0.0)
+	_shine.size = Vector2(SHINE_WIDTH, size.y)
+
+
+## Shows the busy animation, with no value, until [method move_to] has some progress.
+func wait() -> void:
+	Anim.stop(self, &"progress")
+	value = min_value
+	indeterminate = Anim.enabled()
+	_update_label()
+
+
+## Glides to [param target]. Any progress ends the busy animation.
+func move_to(target: float) -> void:
+	if target > min_value:
+		indeterminate = false
+	var glide: Tween = Anim.tween(self, &"progress")
+	if glide == null:
+		value = target
+		return
+	glide.tween_property(self, "value", target, Anim.SLOW) \
+			.set_trans(Tween.TRANS_QUAD).set_ease(Tween.EASE_OUT)
+
+
+## How wide the filled part is, the way [ProgressBar] draws it.
+func fill_width() -> float:
+	var margins: float = get_theme_stylebox(&"fill").get_minimum_size().x
+	var filled: float = roundf(ratio_done() * (size.x - margins))
+	return filled + margins if filled > 0.0 else 0.0
+
+
+func _update_style() -> void:
+	var shine: Color = get_theme_color(&"shine")
+	var clear: Color = shine
+	clear.a = 0.0
+	var gradient: Gradient = Gradient.new()
+	gradient.offsets = PackedFloat32Array([0.0, 0.5, 1.0])
+	gradient.colors = PackedColorArray([clear, shine, clear])
+	var texture: GradientTexture2D = GradientTexture2D.new()
+	texture.gradient = gradient
+	texture.width = 256
+	texture.height = 1
+	_shine.texture = texture
+
+
+func _update_label() -> void:
+	if _label == null:
+		return
+	_label.text = "" if indeterminate else "%d%%" % roundi(ratio_done() * 100.0)
+
+
+## How much is done, from 0 to 1.
+func ratio_done() -> float:
+	var span: float = max_value - min_value
+	return clampf((value - min_value) / span, 0.0, 1.0) if span > 0.0 else 0.0
diff --git a/common/animated_progress_bar.gd.uid b/common/animated_progress_bar.gd.uid
new file mode 100644
index 0000000..40bea6f
--- /dev/null
+++ b/common/animated_progress_bar.gd.uid
@@ -0,0 +1 @@
+uid://bxjx3kacfqg6j
diff --git a/popups/SyncPopup.tscn b/popups/SyncPopup.tscn
index b7804d4..360c04a 100644
--- a/popups/SyncPopup.tscn
+++ b/popups/SyncPopup.tscn
@@ -1,6 +1,7 @@
 [gd_scene format=3 uid="uid://dpdem7pdxweb5"]
 
 [ext_resource type="Script" uid="uid://c3ejukwth512a" path="res://popups/sync_popup.gd" id="1_8ba47"]
+[ext_resource type="Script" path="res://common/animated_progress_bar.gd" id="progress_bar_script"]
 
 [node name="SyncPopup" type="Control" unique_id=1302914356 node_paths=PackedStringArray("panel")]
 layout_mode = 3
@@ -62,11 +63,11 @@ layout_mode = 2
 
 [node name="SyncProgressBar" type="ProgressBar" parent="SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer" unique_id=719135231]
 unique_name_in_owner = true
-custom_minimum_size = Vector2(1300, 0)
+custom_minimum_size = Vector2(1300, 32)
 layout_mode = 2
 size_flags_horizontal = 6
-step = 1.0
-rounded = true
+theme_type_variation = &"SyncProgressBar"
+script = ExtResource("progress_bar_script")
 
 [node name="SyncHBoxContainer" type="HBoxContainer" parent="SyncPanel/ScrollContainer/SyncVBoxContainer" unique_id=1156646398]
 unique_name_in_owner = true
diff --git a/popups/sync_popup.gd b/popups/sync_popup.gd
index 918625e..a9837df 100644
--- a/popups/sync_popup.gd
+++ b/popups/sync_popup.gd
@@ -17,7 +17,7 @@ var has_synced: bool = false
 @onready var no_changes_label: Label = %NoChangesLabel
 @onready var progress_hbox: HBoxContainer = %ProgressHBoxContainer
 @onready var sync_hbox: HBoxContainer = %SyncHBoxContainer
-@onready var sync_progress_bar: ProgressBar = %SyncProgressBar
+@onready var sync_progress_bar: AnimatedProgressBar = %SyncProgressBar
 @onready var soundtracks_added_vbox: VBoxContainer = %SoundtracksAddedVBox
 @onready var soundtracks_added_separator: VSeparator = %SoundtracksAddedSeparator
 @onready var soundtracks_readded_vbox: VBoxContainer = %SoundtracksReAddedVBox
@@ -77,13 +77,24 @@ func _on_sync_timeout() -> void:
 		GameLog.debug("data_received: ", data_received)
 		if data_received != null:
 			if data_received.has("progress"):
-				sync_progress_bar.value = int(data_received.progress)
+				sync_progress_bar.move_to(int(data_received.progress))
 				sync_time.text = data_received.time_spent if data_received.has("time_spent") else ""
 			else:
-				on_sync_finished(data_received)
+				_finish_progress(data_received)
 	MusicServerClient.fetch_sync_progress(get_progress)
 
 
+# Fills the bar and lets it pop before the result takes its place
+func _finish_progress(data_received: Dictionary) -> void:
+	sync_timer.stop()
+	if Anim.enabled() && progress_hbox.visible:
+		sync_progress_bar.move_to(sync_progress_bar.max_value)
+		await get_tree().create_timer(Anim.SLOW).timeout
+		Anim.pop(sync_progress_bar, 1.04, Anim.SLOW)
+		await get_tree().create_timer(Anim.SLOW).timeout
+	on_sync_finished(data_received)
+
+
 func on_sync_finished(data_received: Dictionary) -> void:
 	has_synced = true
 	reset_sync_result()
@@ -218,6 +229,7 @@ func show_sync_result() -> void:
 func show_sync_progress() -> void:
 	sync_title_label.text = "Sync in Progress"
 	progress_hbox.visible = true
+	sync_progress_bar.wait()
 	no_changes_label.visible = false
 	sync_hbox.visible = false
 	caught_errors_vbox.visible = false
diff --git a/server/generated/progress_response.gd b/server/generated/progress_response.gd
index 5be6746..f39f603 100644
--- a/server/generated/progress_response.gd
+++ b/server/generated/progress_response.gd
@@ -5,6 +5,7 @@ extends RefCounted
 ## The [code]ProgressResponse[/code] schema of the MusicServer API.
 
 var progress: String
+## How long the sync has been running, as minutes and seconds, e.g. "02:15"
 var time_spent: String
 
 
diff --git a/server/generated/sync_response.gd b/server/generated/sync_response.gd
index 0e3ba2b..7b7e64c 100644
--- a/server/generated/sync_response.gd
+++ b/server/generated/sync_response.gd
@@ -10,6 +10,7 @@ var soundtracks_changed_content: Array[String]
 var soundtracks_changed_title: Dictionary[String, String]
 var soundtracks_re_added: Array[String]
 var soundtracks_removed: Array[String]
+## How long the sync took, as minutes and seconds, e.g. "02:15"
 var total_time: String
 
 
diff --git a/server/openapi.json b/server/openapi.json
index 26528b9..52d289a 100644
--- a/server/openapi.json
+++ b/server/openapi.json
@@ -1 +1,4940 @@
-{"components":{"schemas":{"APIError":{"additionalProperties":false,"properties":{"error":{"description":"What went wrong","examples":["Not Found"],"type":"string"}},"required":["error"],"type":"object"},"AlternativeNames":{"additionalProperties":false,"properties":{"names":{"description":"The new list of alternative names. Replaces the old list; send [] to remove them all.","items":{"type":"string"},"maxItems":50,"type":"array"}},"required":["names"],"type":"object"},"CharacterDetails":{"additionalProperties":false,"properties":{"modified":{"description":"When the image was last changed, in Unix seconds","format":"int64","type":"integer"},"name":{"description":"File name of the character image","type":"string"}},"required":["name","modified"],"type":"object"},"CoverSource":{"additionalProperties":false,"properties":{"id":{"description":"The game's ID on SteamGridDB, or the anime's ID on AniList","maxLength":50,"minLength":1,"type":"string"},"source":{"description":"Where the cover comes from","enum":["steamgriddb","anilist"],"type":"string"}},"required":["source","id"],"type":"object"},"ProgressResponse":{"additionalProperties":false,"properties":{"progress":{"type":"string"},"time_spent":{"type":"string"}},"required":["progress","time_spent"],"type":"object"},"Song":{"additionalProperties":false,"properties":{"file_name":{"type":"string"},"name":{"type":"string"},"soundtrack_name":{"type":"string"},"soundtrack_uuid":{"type":"string"},"times_played":{"format":"int32","type":"integer"},"uuid":{"type":"string"}},"required":["uuid","name","times_played","soundtrack_uuid","soundtrack_name"],"type":"object"},"SongInfo":{"additionalProperties":false,"properties":{"CurrentlyPlaying":{"type":"boolean"},"Song":{"type":"string"},"SongNo":{"format":"int64","type":"integer"},"SongPlayed":{"format":"int32","type":"integer"},"SongUuid":{"type":"string"},"Soundtrack":{"type":"string"},"SoundtrackPlayed":{"format":"int32","type":"integer"},"SoundtrackUuid":{"type":"string"}},"required":["SoundtrackUuid","Soundtrack","SoundtrackPlayed","SongUuid","Song","SongPlayed","CurrentlyPlaying","SongNo"],"type":"object"},"SongInfoForStats":{"additionalProperties":false,"properties":{"file_name":{"type":"string"},"path":{"type":"string"},"song_name":{"type":"string"},"song_uuid":{"type":"string"},"soundtrack_id":{"format":"int32","type":"integer"},"soundtrack_name":{"type":"string"},"soundtrack_uuid":{"type":"string"},"times_played":{"format":"int32","type":"integer"}},"required":["soundtrack_id","soundtrack_uuid","song_uuid","soundtrack_name","song_name","path","times_played"],"type":"object"},"Soundtrack":{"additionalProperties":false,"properties":{"added":{"format":"date-time","type":"string"},"alternative_names":{"description":"Other names the soundtrack is known by","items":{"type":"string"},"type":"array"},"cover_modified":{"description":"When the cover last changed, in Unix seconds. Missing when there is no cover.","format":"int64","type":"integer"},"last_played":{"format":"date-time","type":"string"},"name":{"type":"string"},"times_played":{"format":"int32","type":"integer"},"uuid":{"type":"string"}},"required":["uuid","name","alternative_names","times_played","added"],"type":"object"},"SoundtrackWithSongList":{"additionalProperties":false,"properties":{"added":{"format":"date-time","type":"string"},"alternative_names":{"description":"Other names the soundtrack is known by","items":{"type":"string"},"type":"array"},"cover_modified":{"description":"When the cover last changed, in Unix seconds. Missing when there is no cover.","format":"int64","type":"integer"},"last_played":{"format":"date-time","type":"string"},"name":{"type":"string"},"songs":{"items":{"$ref":"#/components/schemas/Song"},"type":"array"},"times_played":{"format":"int32","type":"integer"},"uuid":{"type":"string"}},"required":["songs","uuid","name","alternative_names","times_played","added"],"type":"object"},"SoundtrackWithSongs":{"additionalProperties":false,"properties":{"alternative_names":{"description":"Other names the soundtrack is known by","items":{"type":"string"},"type":"array"},"cover_modified":{"description":"When the cover last changed, in Unix seconds. Missing when there is no cover.","format":"int64","type":"integer"},"songs":{"items":{"$ref":"#/components/schemas/SongInfoForStats"},"type":"array"},"soundtrack_id":{"format":"int32","type":"integer"},"soundtrack_last_played":{"format":"date-time","type":"string"},"soundtrack_name":{"type":"string"},"soundtrack_played":{"format":"int32","type":"integer"},"soundtrack_uuid":{"type":"string"}},"required":["soundtrack_id","soundtrack_uuid","soundtrack_name","alternative_names","soundtrack_played","songs"],"type":"object"},"StatisticsSummary":{"additionalProperties":false,"properties":{"avg_soundtrack_plays":{"format":"double","type":"number"},"max_soundtrack_plays":{"format":"int64","type":"integer"},"min_soundtrack_plays":{"format":"int64","type":"integer"},"never_played_soundtracks":{"format":"int64","type":"integer"},"played_soundtracks":{"format":"int64","type":"integer"},"total_soundtrack_plays":{"format":"int64","type":"integer"},"total_soundtracks":{"format":"int64","type":"integer"}},"required":["total_soundtracks","played_soundtracks","never_played_soundtracks","total_soundtrack_plays","avg_soundtrack_plays","max_soundtrack_plays","min_soundtrack_plays"],"type":"object"},"StatusMessage":{"additionalProperties":false,"properties":{"status":{"type":"string"}},"required":["status"],"type":"object"},"SyncResponse":{"additionalProperties":false,"properties":{"catched_errors":{"items":{"type":"string"},"type":"array"},"soundtracks_added":{"items":{"type":"string"},"type":"array"},"soundtracks_changed_content":{"items":{"type":"string"},"type":"array"},"soundtracks_changed_title":{"additionalProperties":{"type":"string"},"type":"object"},"soundtracks_re_added":{"items":{"type":"string"},"type":"array"},"soundtracks_removed":{"items":{"type":"string"},"type":"array"},"total_time":{"type":"string"}},"required":["soundtracks_added","soundtracks_re_added","soundtracks_changed_title","soundtracks_changed_content","soundtracks_removed","catched_errors","total_time"],"type":"object"},"TokenRequest":{"additionalProperties":false,"properties":{"client_type":{"default":"web","description":"Kind of client, for example web, godot or api","type":"string"},"password":{"description":"API password, required when the server has one configured","type":"string"}},"type":"object"},"TokenResponse":{"additionalProperties":false,"properties":{"client_type":{"type":"string"},"expires_at":{"format":"date-time","type":"string"},"token":{"description":"Send as Authorization: Bearer \u003ctoken\u003e","type":"string"}},"required":["token","expires_at","client_type"],"type":"object"},"Upload":{"additionalProperties":false,"properties":{"files":{"description":"The songs received so far, sorted by name","items":{"$ref":"#/components/schemas/UploadFile"},"type":"array"},"id":{"type":"string"},"name":{"description":"Name of the new soundtrack, also its folder name","type":"string"},"started":{"format":"date-time","type":"string"},"total_size":{"description":"Size of all songs received so far, in bytes","format":"int64","type":"integer"}},"required":["id","name","started","files","total_size"],"type":"object"},"UploadFile":{"additionalProperties":false,"properties":{"name":{"type":"string"},"size":{"format":"int64","type":"integer"}},"required":["name","size"],"type":"object"},"UploadRequest":{"additionalProperties":false,"properties":{"name":{"description":"Name of the new soundtrack, also its folder name in the music folder","maxLength":200,"minLength":1,"type":"string"}},"required":["name"],"type":"object"},"VersionData":{"additionalProperties":false,"properties":{"changelog":{"examples":[["Initial release","Bug fixes"]],"items":{"type":"string"},"type":"array"},"version":{"examples":["1.0.0"],"type":"string"}},"required":["version","changelog"],"type":"object"}},"securitySchemes":{"bearer":{"description":"Token from POST /api/v1/token","scheme":"bearer","type":"http"}}},"info":{"description":"API for the MusicServer application.\n\nGet a token with `POST /api/v1/token` and send it as `Authorization: Bearer \u003ctoken\u003e`.\n\nEvery client has its own play queue. The music endpoints return its ID in the `X-Queue-Id` header; send it back in the same header to keep using that queue. Without it, or when the queue has ended (after a reset or a sync), a new queue is started.","title":"MusicServer API","version":"5.0.0"},"openapi":"3.1.0","paths":{"/api/v1/character":{"get":{"description":"Returns a character image.","operationId":"get-character","parameters":[{"description":"File name of the character image, from the character list","explode":false,"in":"query","name":"name","required":true,"schema":{"description":"File name of the character image, from the character list","type":"string"}}],"responses":{"200":{"content":{"image/jpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}},"image/png":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The image"},"206":{"content":{"image/jpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}},"image/png":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Character image","tags":["characters"]}},"/api/v1/character/details":{"get":{"description":"Returns every character image with the time it was last changed, so clients can cache images and download only the changed ones.","operationId":"list-character-details","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CharacterDetails"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"List characters with change times","tags":["characters"]}},"/api/v1/character/list":{"get":{"description":"Returns the file names of all character images.","operationId":"list-characters","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"List characters","tags":["characters"]}},"/api/v1/download":{"get":{"description":"Returns the name of the latest MusicPlayer release.","operationId":"get-latest-client-version","responses":{"200":{"content":{"application/json":{"schema":{"type":"string"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Gateway"}},"security":[{"bearer":[]}],"summary":"Latest client version","tags":["download"]}},"/api/v1/download/linux":{"get":{"description":"Redirects to the download URL of the latest MusicPlayer release for Linux.","operationId":"download-client-linux","responses":{"302":{"description":"Found","headers":{"Location":{"schema":{"description":"Download URL of the asset","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Gateway"}},"security":[{"bearer":[]}],"summary":"Download the latest client for Linux","tags":["download"]}},"/api/v1/download/linux-package":{"get":{"description":"Redirects to the download URL of the latest MusicPlayer release for Linux (package with installer).","operationId":"download-client-linux-package","responses":{"302":{"description":"Found","headers":{"Location":{"schema":{"description":"Download URL of the asset","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Gateway"}},"security":[{"bearer":[]}],"summary":"Download the latest client for Linux (package with installer)","tags":["download"]}},"/api/v1/download/list":{"get":{"description":"Returns the file names of the latest MusicPlayer release.","operationId":"list-client-assets","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Gateway"}},"security":[{"bearer":[]}],"summary":"Latest client assets","tags":["download"]}},"/api/v1/download/windows":{"get":{"description":"Redirects to the download URL of the latest MusicPlayer release for Windows.","operationId":"download-client-windows","responses":{"302":{"description":"Found","headers":{"Location":{"schema":{"description":"Download URL of the asset","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Gateway"}},"security":[{"bearer":[]}],"summary":"Download the latest client for Windows","tags":["download"]}},"/api/v1/health":{"get":{"description":"Returns {\"status\": \"up\"} when the server and database work, otherwise status \"down\" and an error.","operationId":"get-health","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object"}}},"description":"OK"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Error"}},"summary":"Health check","tags":["server"]}},"/api/v1/music":{"get":{"description":"Jumps to the song at the given queue position (clamped to the queue) and returns it.","operationId":"get-queue-song","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}},{"description":"Position of the song in the queue (SongNo)","explode":false,"in":"query","name":"song","required":true,"schema":{"description":"Position of the song in the queue (SongNo)","format":"int64","type":"integer"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Play a song from the queue","tags":["music"]}},"/api/v1/music/addPlayed":{"get":{"description":"Increments the play counters of the current song and its soundtrack.","operationId":"mark-current-played","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Mark the current song as played","tags":["music"]}},"/api/v1/music/addQue":{"get":{"description":"Adds the song returned by the last random song request to the end of the queue.","operationId":"add-latest-to-queue","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Add the last random song to the queue","tags":["music"]}},"/api/v1/music/all":{"get":{"description":"Returns the names of all soundtracks in random order.","operationId":"get-soundtrack-names-random","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Soundtrack names, random order","tags":["music"]}},"/api/v1/music/all/order":{"get":{"description":"Returns the names of all soundtracks in alphabetical order.","operationId":"get-soundtrack-names","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Soundtrack names, sorted","tags":["music"]}},"/api/v1/music/all/random":{"get":{"description":"Same as /music/all.","operationId":"get-soundtrack-names-random-alias","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Soundtrack names, random order","tags":["music"]}},"/api/v1/music/info":{"get":{"description":"Returns the current song in the queue.","operationId":"get-song-info","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SongInfo"}}},"description":"OK","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Current song","tags":["music"]}},"/api/v1/music/list":{"get":{"description":"Returns all songs in the queue.","operationId":"get-played-songs","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SongInfo"},"type":"array"}}},"description":"OK","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Queue","tags":["music"]}},"/api/v1/music/next":{"get":{"description":"Moves to the next song in the queue and returns it. Stays on the last song at the end.","operationId":"get-next-song","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Next song in the queue","tags":["music"]}},"/api/v1/music/played":{"put":{"description":"Increments the play counters of the song at the given queue position. Positions outside the queue are ignored.","operationId":"mark-song-played","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}},{"description":"Position of the song in the queue (SongNo)","explode":false,"in":"query","name":"song","required":true,"schema":{"description":"Position of the song in the queue (SongNo)","format":"int64","type":"integer"}}],"responses":{"200":{"description":"OK","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Mark a queued song as played","tags":["music"]}},"/api/v1/music/previous":{"get":{"description":"Moves to the previous song in the queue and returns it. Stays on the first song at the start.","operationId":"get-previous-song","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Previous song in the queue","tags":["music"]}},"/api/v1/music/rand":{"get":{"description":"Picks a random song from a random soundtrack. Add it to the queue with /music/addQue.","operationId":"get-random-song","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Random song","tags":["music"]}},"/api/v1/music/rand/classic":{"get":{"description":"Picks a random song where every song has the same chance, regardless of soundtrack.","operationId":"get-random-song-classic","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Random song, every song equal","tags":["music"]}},"/api/v1/music/rand/low":{"get":{"description":"Picks a random song, favouring soundtracks that have been played less than average.","operationId":"get-random-song-low-chance","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request","headers":{"X-Queue-Id":{"description":"ID of the client's play queue. Send it with the following requests.","schema":{"format":"uuid","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Random song, favouring rarely played","tags":["music"]}},"/api/v1/music/reset":{"get":{"description":"Ends the queue, starts a new one and reloads the soundtrack list. The new queue's ID is returned in the X-Queue-Id header; send it with the following requests.","operationId":"reset-queue","parameters":[{"description":"ID of the client's play queue, from an earlier response. Omit it to start a new queue.","in":"header","name":"X-Queue-Id","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Queue-Id":{"schema":{"description":"ID of the new queue","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Reset the queue","tags":["music"]}},"/api/v1/music/soundTest":{"get":{"description":"Returns a random song for checking the volume.","operationId":"get-sound-test-song","responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)"},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Sound check song","tags":["music"]}},"/api/v1/songs/{uuid}":{"get":{"description":"Returns information about a song.","operationId":"get-song","parameters":[{"description":"UUID of the soundtrack or song","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack or song","format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Song"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Get song","tags":["library"]}},"/api/v1/songs/{uuid}/file":{"get":{"description":"Returns the audio file of a song.","operationId":"get-song-file","parameters":[{"description":"UUID of the soundtrack or song","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack or song","format":"uuid","type":"string"}}],"responses":{"200":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The song (MP3)"},"206":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Stream song","tags":["library"]}},"/api/v1/soundtracks":{"get":{"description":"Returns all soundtracks, sorted by name.","operationId":"list-soundtracks","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Soundtrack"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"List soundtracks","tags":["library"]}},"/api/v1/soundtracks/uploads":{"post":{"description":"Starts adding a new soundtrack. Send its songs with PUT /soundtracks/uploads/{id}/files/{file}, then POST /soundtracks/uploads/{id}/finish. The name must be usable as a folder name, and no soundtrack, folder or other upload may have it, ignoring case. Unfinished uploads are removed after a day.","operationId":"start-upload","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Upload"}}},"description":"Created"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Service Unavailable"}},"security":[{"bearer":[]}],"summary":"Start uploading a soundtrack","tags":["uploads"]}},"/api/v1/soundtracks/uploads/{id}":{"delete":{"description":"Deletes an unfinished upload and its songs.","operationId":"cancel-upload","parameters":[{"description":"ID of the upload, from POST /soundtracks/uploads","in":"path","name":"id","required":true,"schema":{"description":"ID of the upload, from POST /soundtracks/uploads","format":"uuid","type":"string"}}],"responses":{"204":{"description":"No Content"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Cancel an upload","tags":["uploads"]},"get":{"description":"Returns an unfinished upload with the songs received so far, for example to resume it.","operationId":"get-upload","parameters":[{"description":"ID of the upload, from POST /soundtracks/uploads","in":"path","name":"id","required":true,"schema":{"description":"ID of the upload, from POST /soundtracks/uploads","format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Upload"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Get an upload","tags":["uploads"]}},"/api/v1/soundtracks/uploads/{id}/files/{file}":{"put":{"description":"Stores one song of the upload, replacing a song of the same name, so a failed song can be sent again. Only MP3 files are accepted. The size limits are set on the server with UPLOAD_MAX_FILE_MB and UPLOAD_MAX_TOTAL_MB.","operationId":"upload-song","parameters":[{"description":"ID of the upload, from POST /soundtracks/uploads","in":"path","name":"id","required":true,"schema":{"description":"ID of the upload, from POST /soundtracks/uploads","format":"uuid","type":"string"}},{"description":"File name of the song, e.g. \"01 Title.mp3\". Plain names only: put songs from disc folders in one folder, e.g. \"1-01 Title.mp3\".","in":"path","name":"file","required":true,"schema":{"description":"File name of the song, e.g. \"01 Title.mp3\". Plain names only: put songs from disc folders in one folder, e.g. \"1-01 Title.mp3\".","type":"string"}}],"requestBody":{"content":{"audio/mpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadFile"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Upload a song","tags":["uploads"]}},"/api/v1/soundtracks/uploads/{id}/finish":{"post":{"description":"Moves the songs into a new folder in the music folder, adds the soundtrack to the library and returns it. Refused when a soundtrack with the same songs exists.","operationId":"finish-upload","parameters":[{"description":"ID of the upload, from POST /soundtracks/uploads","in":"path","name":"id","required":true,"schema":{"description":"ID of the upload, from POST /soundtracks/uploads","format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoundtrackWithSongList"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Finish an upload","tags":["uploads"]}},"/api/v1/soundtracks/{uuid}":{"get":{"description":"Returns a soundtrack with its songs, sorted by name.","operationId":"get-soundtrack","parameters":[{"description":"UUID of the soundtrack or song","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack or song","format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoundtrackWithSongList"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Get soundtrack","tags":["library"]}},"/api/v1/soundtracks/{uuid}/alternative-names":{"put":{"description":"Replaces the soundtrack's alternative names, which search and the cover search also use. Names are trimmed, and empty names, duplicates and the soundtrack's own name (ignoring case) are dropped.","operationId":"set-alternative-names","parameters":[{"description":"UUID of the soundtrack","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack","format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlternativeNames"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Soundtrack"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Set alternative names","tags":["library"]}},"/api/v1/soundtracks/{uuid}/cover":{"delete":{"description":"Deletes the soundtrack's cover, including one set by hand, so the automatic search looks for a new one.","operationId":"delete-soundtrack-cover","parameters":[{"description":"UUID of the soundtrack or song","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack or song","format":"uuid","type":"string"}}],"responses":{"204":{"description":"No Content"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Service Unavailable"}},"security":[{"bearer":[]}],"summary":"Remove the cover","tags":["covers"]},"get":{"description":"Returns the soundtrack's cover image. cover_modified in the soundtrack responses tells when it last changed.","operationId":"get-soundtrack-cover","parameters":[{"description":"UUID of the soundtrack or song","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack or song","format":"uuid","type":"string"}}],"responses":{"200":{"content":{"image/jpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}},"image/png":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}},"image/webp":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"The cover image"},"206":{"content":{"image/jpeg":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}},"image/png":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}},"image/webp":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"description":"Part of the file, for a Range request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Soundtrack cover","tags":["covers"]},"put":{"description":"Stores the image as the soundtrack's cover. The automatic search never replaces it; delete it to go back to automatic.","operationId":"upload-soundtrack-cover","parameters":[{"description":"UUID of the soundtrack","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack","format":"uuid","type":"string"}}],"requestBody":{"content":{"image/*":{"schema":{"contentMediaType":"application/octet-stream","format":"binary","type":"string"}}},"required":true},"responses":{"204":{"description":"No Content"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Service Unavailable"}},"security":[{"bearer":[]}],"summary":"Upload a cover","tags":["covers"]}},"/api/v1/soundtracks/{uuid}/cover/source":{"put":{"description":"Downloads the cover of the given SteamGridDB game or AniList anime and stores it as the soundtrack's cover. The automatic search never replaces it. SteamGridDB needs STEAMGRIDDB_API_KEY on the server.","operationId":"set-soundtrack-cover-source","parameters":[{"description":"UUID of the soundtrack","in":"path","name":"uuid","required":true,"schema":{"description":"UUID of the soundtrack","format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverSource"}}},"required":true},"responses":{"204":{"description":"No Content"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Bad Gateway"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Service Unavailable"}},"security":[{"bearer":[]}],"summary":"Pick a cover","tags":["covers"]}},"/api/v1/statistics/songs/least-played":{"get":{"description":"Returns the least played songs with their soundtrack.","operationId":"get-least-played-songs","parameters":[{"description":"Number of results. Values above 100 are capped to 100.","explode":false,"in":"query","name":"limit","schema":{"default":10,"description":"Number of results. Values above 100 are capped to 100.","format":"int64","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SongInfoForStats"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Least played songs","tags":["statistics"]}},"/api/v1/statistics/songs/most-played":{"get":{"description":"Returns the most played songs with their soundtrack.","operationId":"get-most-played-songs","parameters":[{"description":"Number of results. Values above 100 are capped to 100.","explode":false,"in":"query","name":"limit","schema":{"default":10,"description":"Number of results. Values above 100 are capped to 100.","format":"int64","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SongInfoForStats"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Most played songs","tags":["statistics"]}},"/api/v1/statistics/soundtracks":{"get":{"description":"Returns every soundtrack with its songs and play counts, sorted by name.","operationId":"get-all-soundtrack-statistics","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SoundtrackWithSongs"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"All soundtracks with statistics","tags":["statistics"]}},"/api/v1/statistics/soundtracks/last-played":{"get":{"description":"Returns the most recently played soundtracks with their songs.","operationId":"get-last-played-soundtracks","parameters":[{"description":"Number of results. Values above 100 are capped to 100.","explode":false,"in":"query","name":"limit","schema":{"default":10,"description":"Number of results. Values above 100 are capped to 100.","format":"int64","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SoundtrackWithSongs"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Recently played soundtracks","tags":["statistics"]}},"/api/v1/statistics/soundtracks/least-played":{"get":{"description":"Returns the least played soundtracks with their songs.","operationId":"get-least-played-soundtracks","parameters":[{"description":"Number of results. Values above 100 are capped to 100.","explode":false,"in":"query","name":"limit","schema":{"default":10,"description":"Number of results. Values above 100 are capped to 100.","format":"int64","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SoundtrackWithSongs"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Least played soundtracks","tags":["statistics"]}},"/api/v1/statistics/soundtracks/most-played":{"get":{"description":"Returns the most played soundtracks with their songs.","operationId":"get-most-played-soundtracks","parameters":[{"description":"Number of results. Values above 100 are capped to 100.","explode":false,"in":"query","name":"limit","schema":{"default":10,"description":"Number of results. Values above 100 are capped to 100.","format":"int64","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SoundtrackWithSongs"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Most played soundtracks","tags":["statistics"]}},"/api/v1/statistics/soundtracks/never-played":{"get":{"description":"Returns all soundtracks that have never been played, with their songs.","operationId":"get-never-played-soundtracks","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SoundtrackWithSongs"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Never played soundtracks","tags":["statistics"]}},"/api/v1/statistics/soundtracks/oldest-played":{"get":{"description":"Returns the soundtracks played longest ago (played at least once) with their songs.","operationId":"get-oldest-played-soundtracks","parameters":[{"description":"Number of results. Values above 100 are capped to 100.","explode":false,"in":"query","name":"limit","schema":{"default":10,"description":"Number of results. Values above 100 are capped to 100.","format":"int64","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SoundtrackWithSongs"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Least recently played soundtracks","tags":["statistics"]}},"/api/v1/statistics/summary":{"get":{"description":"Returns overall play statistics.","operationId":"get-statistics-summary","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatisticsSummary"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Statistics summary","tags":["statistics"]}},"/api/v1/sync":{"post":{"description":"Starts syncing the music folder in the background, skipping soundtracks that have not changed. Poll /sync/progress for the result.","operationId":"start-sync","responses":{"200":{"content":{"application/json":{"schema":{"type":"string"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Sync changed soundtracks","tags":["sync"]}},"/api/v1/sync/full":{"post":{"description":"Starts a full sync in the background that re-reads every soundtrack and removes songs whose files are gone. Poll /sync/progress for the result.","operationId":"start-full-sync","responses":{"200":{"content":{"application/json":{"schema":{"type":"string"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"423":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Locked"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Sync all soundtracks","tags":["sync"]}},"/api/v1/sync/progress":{"get":{"description":"While a sync is running, returns its progress. Otherwise returns the result of the last sync.","operationId":"get-sync-progress","responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ProgressResponse"},{"$ref":"#/components/schemas/SyncResponse"}]}}},"description":"Progress of the running sync, or the result of the last sync"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Sync progress or result","tags":["sync"]}},"/api/v1/token":{"delete":{"description":"Deletes the token used for this request.","operationId":"delete-token","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusMessage"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Invalidate session token","tags":["auth"]},"post":{"description":"Returns a token for the other /api/v1 endpoints, valid for 24 hours. Requires the API password when the server has one. Limited to 10 requests per minute per client.","operationId":"create-token","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"summary":"Create session token","tags":["auth"]}},"/api/v1/token/cleanup":{"post":{"description":"Deletes all expired session tokens.","operationId":"cleanup-tokens","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusMessage"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Remove expired tokens","tags":["auth"]}},"/api/v1/version":{"get":{"description":"Returns the server version and its changelog.","operationId":"get-version","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionData"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Latest server version","tags":["server"]}},"/api/v1/version/history":{"get":{"description":"Returns all server versions with their changelogs, newest first.","operationId":"get-version-history","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/VersionData"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}},"description":"Internal Server Error"}},"security":[{"bearer":[]}],"summary":"Version history","tags":["server"]}}}}
\ No newline at end of file
+{
+  "components": {
+    "schemas": {
+      "APIError": {
+        "additionalProperties": false,
+        "properties": {
+          "error": {
+            "description": "What went wrong",
+            "examples": [
+              "Not Found"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "error"
+        ],
+        "type": "object"
+      },
+      "AlternativeNames": {
+        "additionalProperties": false,
+        "properties": {
+          "names": {
+            "description": "The new list of alternative names. Replaces the old list; send [] to remove them all.",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 50,
+            "type": "array"
+          }
+        },
+        "required": [
+          "names"
+        ],
+        "type": "object"
+      },
+      "CharacterDetails": {
+        "additionalProperties": false,
+        "properties": {
+          "modified": {
+            "description": "When the image was last changed, in Unix seconds",
+            "format": "int64",
+            "type": "integer"
+          },
+          "name": {
+            "description": "File name of the character image",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "modified"
+        ],
+        "type": "object"
+      },
+      "CoverSource": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "description": "The game's ID on SteamGridDB, or the anime's ID on AniList",
+            "maxLength": 50,
+            "minLength": 1,
+            "type": "string"
+          },
+          "source": {
+            "description": "Where the cover comes from",
+            "enum": [
+              "steamgriddb",
+              "anilist"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "source",
+          "id"
+        ],
+        "type": "object"
+      },
+      "ProgressResponse": {
+        "additionalProperties": false,
+        "properties": {
+          "progress": {
+            "type": "string"
+          },
+          "time_spent": {
+            "description": "How long the sync has been running, as minutes and seconds, e.g. \"02:15\"",
+            "type": "string"
+          }
+        },
+        "required": [
+          "progress",
+          "time_spent"
+        ],
+        "type": "object"
+      },
+      "Song": {
+        "additionalProperties": false,
+        "properties": {
+          "file_name": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "soundtrack_name": {
+            "type": "string"
+          },
+          "soundtrack_uuid": {
+            "type": "string"
+          },
+          "times_played": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "uuid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "uuid",
+          "name",
+          "times_played",
+          "soundtrack_uuid",
+          "soundtrack_name"
+        ],
+        "type": "object"
+      },
+      "SongInfo": {
+        "additionalProperties": false,
+        "properties": {
+          "CurrentlyPlaying": {
+            "type": "boolean"
+          },
+          "Song": {
+            "type": "string"
+          },
+          "SongNo": {
+            "format": "int64",
+            "type": "integer"
+          },
+          "SongPlayed": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "SongUuid": {
+            "type": "string"
+          },
+          "Soundtrack": {
+            "type": "string"
+          },
+          "SoundtrackPlayed": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "SoundtrackUuid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "SoundtrackUuid",
+          "Soundtrack",
+          "SoundtrackPlayed",
+          "SongUuid",
+          "Song",
+          "SongPlayed",
+          "CurrentlyPlaying",
+          "SongNo"
+        ],
+        "type": "object"
+      },
+      "SongInfoForStats": {
+        "additionalProperties": false,
+        "properties": {
+          "file_name": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "song_name": {
+            "type": "string"
+          },
+          "song_uuid": {
+            "type": "string"
+          },
+          "soundtrack_id": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "soundtrack_name": {
+            "type": "string"
+          },
+          "soundtrack_uuid": {
+            "type": "string"
+          },
+          "times_played": {
+            "format": "int32",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "soundtrack_id",
+          "soundtrack_uuid",
+          "song_uuid",
+          "soundtrack_name",
+          "song_name",
+          "path",
+          "times_played"
+        ],
+        "type": "object"
+      },
+      "Soundtrack": {
+        "additionalProperties": false,
+        "properties": {
+          "added": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "alternative_names": {
+            "description": "Other names the soundtrack is known by",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "cover_modified": {
+            "description": "When the cover last changed, in Unix seconds. Missing when there is no cover.",
+            "format": "int64",
+            "type": "integer"
+          },
+          "last_played": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "times_played": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "uuid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "uuid",
+          "name",
+          "alternative_names",
+          "times_played",
+          "added"
+        ],
+        "type": "object"
+      },
+      "SoundtrackWithSongList": {
+        "additionalProperties": false,
+        "properties": {
+          "added": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "alternative_names": {
+            "description": "Other names the soundtrack is known by",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "cover_modified": {
+            "description": "When the cover last changed, in Unix seconds. Missing when there is no cover.",
+            "format": "int64",
+            "type": "integer"
+          },
+          "last_played": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "songs": {
+            "items": {
+              "$ref": "#/components/schemas/Song"
+            },
+            "type": "array"
+          },
+          "times_played": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "uuid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "songs",
+          "uuid",
+          "name",
+          "alternative_names",
+          "times_played",
+          "added"
+        ],
+        "type": "object"
+      },
+      "SoundtrackWithSongs": {
+        "additionalProperties": false,
+        "properties": {
+          "alternative_names": {
+            "description": "Other names the soundtrack is known by",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "cover_modified": {
+            "description": "When the cover last changed, in Unix seconds. Missing when there is no cover.",
+            "format": "int64",
+            "type": "integer"
+          },
+          "songs": {
+            "items": {
+              "$ref": "#/components/schemas/SongInfoForStats"
+            },
+            "type": "array"
+          },
+          "soundtrack_id": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "soundtrack_last_played": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "soundtrack_name": {
+            "type": "string"
+          },
+          "soundtrack_played": {
+            "format": "int32",
+            "type": "integer"
+          },
+          "soundtrack_uuid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "soundtrack_id",
+          "soundtrack_uuid",
+          "soundtrack_name",
+          "alternative_names",
+          "soundtrack_played",
+          "songs"
+        ],
+        "type": "object"
+      },
+      "StatisticsSummary": {
+        "additionalProperties": false,
+        "properties": {
+          "avg_soundtrack_plays": {
+            "format": "double",
+            "type": "number"
+          },
+          "max_soundtrack_plays": {
+            "format": "int64",
+            "type": "integer"
+          },
+          "min_soundtrack_plays": {
+            "format": "int64",
+            "type": "integer"
+          },
+          "never_played_soundtracks": {
+            "format": "int64",
+            "type": "integer"
+          },
+          "played_soundtracks": {
+            "format": "int64",
+            "type": "integer"
+          },
+          "total_soundtrack_plays": {
+            "format": "int64",
+            "type": "integer"
+          },
+          "total_soundtracks": {
+            "format": "int64",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "total_soundtracks",
+          "played_soundtracks",
+          "never_played_soundtracks",
+          "total_soundtrack_plays",
+          "avg_soundtrack_plays",
+          "max_soundtrack_plays",
+          "min_soundtrack_plays"
+        ],
+        "type": "object"
+      },
+      "StatusMessage": {
+        "additionalProperties": false,
+        "properties": {
+          "status": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "status"
+        ],
+        "type": "object"
+      },
+      "SyncResponse": {
+        "additionalProperties": false,
+        "properties": {
+          "catched_errors": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "soundtracks_added": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "soundtracks_changed_content": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "soundtracks_changed_title": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "soundtracks_re_added": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "soundtracks_removed": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "total_time": {
+            "description": "How long the sync took, as minutes and seconds, e.g. \"02:15\"",
+            "type": "string"
+          }
+        },
+        "required": [
+          "soundtracks_added",
+          "soundtracks_re_added",
+          "soundtracks_changed_title",
+          "soundtracks_changed_content",
+          "soundtracks_removed",
+          "catched_errors",
+          "total_time"
+        ],
+        "type": "object"
+      },
+      "TokenRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "client_type": {
+            "default": "web",
+            "description": "Kind of client, for example web, godot or api",
+            "type": "string"
+          },
+          "password": {
+            "description": "API password, required when the server has one configured",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "TokenResponse": {
+        "additionalProperties": false,
+        "properties": {
+          "client_type": {
+            "type": "string"
+          },
+          "expires_at": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "token": {
+            "description": "Send as Authorization: Bearer <token>",
+            "type": "string"
+          }
+        },
+        "required": [
+          "token",
+          "expires_at",
+          "client_type"
+        ],
+        "type": "object"
+      },
+      "Upload": {
+        "additionalProperties": false,
+        "properties": {
+          "files": {
+            "description": "The songs received so far, sorted by name",
+            "items": {
+              "$ref": "#/components/schemas/UploadFile"
+            },
+            "type": "array"
+          },
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "description": "Name of the new soundtrack, also its folder name",
+            "type": "string"
+          },
+          "started": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "total_size": {
+            "description": "Size of all songs received so far, in bytes",
+            "format": "int64",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "started",
+          "files",
+          "total_size"
+        ],
+        "type": "object"
+      },
+      "UploadFile": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "size": {
+            "format": "int64",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "name",
+          "size"
+        ],
+        "type": "object"
+      },
+      "UploadRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "description": "Name of the new soundtrack, also its folder name in the music folder",
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "type": "object"
+      },
+      "VersionData": {
+        "additionalProperties": false,
+        "properties": {
+          "changelog": {
+            "examples": [
+              [
+                "Initial release",
+                "Bug fixes"
+              ]
+            ],
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "version": {
+            "examples": [
+              "1.0.0"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "version",
+          "changelog"
+        ],
+        "type": "object"
+      }
+    },
+    "securitySchemes": {
+      "bearer": {
+        "description": "Token from POST /api/v1/token",
+        "scheme": "bearer",
+        "type": "http"
+      }
+    }
+  },
+  "info": {
+    "description": "API for the MusicServer application.\n\nGet a token with `POST /api/v1/token` and send it as `Authorization: Bearer <token>`.\n\nEvery client has its own play queue. The music endpoints return its ID in the `X-Queue-Id` header; send it back in the same header to keep using that queue. Without it, or when the queue has ended (after a reset or a sync), a new queue is started.",
+    "title": "MusicServer API",
+    "version": "5.0.0"
+  },
+  "openapi": "3.1.0",
+  "paths": {
+    "/api/v1/character": {
+      "get": {
+        "description": "Returns a character image.",
+        "operationId": "get-character",
+        "parameters": [
+          {
+            "description": "File name of the character image, from the character list",
+            "explode": false,
+            "in": "query",
+            "name": "name",
+            "required": true,
+            "schema": {
+              "description": "File name of the character image, from the character list",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "image/jpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/png": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The image"
+          },
+          "206": {
+            "content": {
+              "image/jpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/png": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Character image",
+        "tags": [
+          "characters"
+        ]
+      }
+    },
+    "/api/v1/character/details": {
+      "get": {
+        "description": "Returns every character image with the time it was last changed, so clients can cache images and download only the changed ones.",
+        "operationId": "list-character-details",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/CharacterDetails"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "List characters with change times",
+        "tags": [
+          "characters"
+        ]
+      }
+    },
+    "/api/v1/character/list": {
+      "get": {
+        "description": "Returns the file names of all character images.",
+        "operationId": "list-characters",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "List characters",
+        "tags": [
+          "characters"
+        ]
+      }
+    },
+    "/api/v1/download": {
+      "get": {
+        "description": "Returns the name of the latest MusicPlayer release.",
+        "operationId": "get-latest-client-version",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "502": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Gateway"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Latest client version",
+        "tags": [
+          "download"
+        ]
+      }
+    },
+    "/api/v1/download/linux": {
+      "get": {
+        "description": "Redirects to the download URL of the latest MusicPlayer release for Linux.",
+        "operationId": "download-client-linux",
+        "responses": {
+          "302": {
+            "description": "Found",
+            "headers": {
+              "Location": {
+                "schema": {
+                  "description": "Download URL of the asset",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "502": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Gateway"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Download the latest client for Linux",
+        "tags": [
+          "download"
+        ]
+      }
+    },
+    "/api/v1/download/linux-package": {
+      "get": {
+        "description": "Redirects to the download URL of the latest MusicPlayer release for Linux (package with installer).",
+        "operationId": "download-client-linux-package",
+        "responses": {
+          "302": {
+            "description": "Found",
+            "headers": {
+              "Location": {
+                "schema": {
+                  "description": "Download URL of the asset",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "502": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Gateway"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Download the latest client for Linux (package with installer)",
+        "tags": [
+          "download"
+        ]
+      }
+    },
+    "/api/v1/download/list": {
+      "get": {
+        "description": "Returns the file names of the latest MusicPlayer release.",
+        "operationId": "list-client-assets",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "502": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Gateway"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Latest client assets",
+        "tags": [
+          "download"
+        ]
+      }
+    },
+    "/api/v1/download/windows": {
+      "get": {
+        "description": "Redirects to the download URL of the latest MusicPlayer release for Windows.",
+        "operationId": "download-client-windows",
+        "responses": {
+          "302": {
+            "description": "Found",
+            "headers": {
+              "Location": {
+                "schema": {
+                  "description": "Download URL of the asset",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "502": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Gateway"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Download the latest client for Windows",
+        "tags": [
+          "download"
+        ]
+      }
+    },
+    "/api/v1/health": {
+      "get": {
+        "description": "Returns {\"status\": \"up\"} when the server and database work, otherwise status \"down\" and an error.",
+        "operationId": "get-health",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "default": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Error"
+          }
+        },
+        "summary": "Health check",
+        "tags": [
+          "server"
+        ]
+      }
+    },
+    "/api/v1/music": {
+      "get": {
+        "description": "Jumps to the song at the given queue position (clamped to the queue) and returns it.",
+        "operationId": "get-queue-song",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Position of the song in the queue (SongNo)",
+            "explode": false,
+            "in": "query",
+            "name": "song",
+            "required": true,
+            "schema": {
+              "description": "Position of the song in the queue (SongNo)",
+              "format": "int64",
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Play a song from the queue",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/addPlayed": {
+      "get": {
+        "description": "Increments the play counters of the current song and its soundtrack.",
+        "operationId": "mark-current-played",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Mark the current song as played",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/addQue": {
+      "get": {
+        "description": "Adds the song returned by the last random song request to the end of the queue.",
+        "operationId": "add-latest-to-queue",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Add the last random song to the queue",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/all": {
+      "get": {
+        "description": "Returns the names of all soundtracks in random order.",
+        "operationId": "get-soundtrack-names-random",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Soundtrack names, random order",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/all/order": {
+      "get": {
+        "description": "Returns the names of all soundtracks in alphabetical order.",
+        "operationId": "get-soundtrack-names",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Soundtrack names, sorted",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/all/random": {
+      "get": {
+        "description": "Same as /music/all.",
+        "operationId": "get-soundtrack-names-random-alias",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Soundtrack names, random order",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/info": {
+      "get": {
+        "description": "Returns the current song in the queue.",
+        "operationId": "get-song-info",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SongInfo"
+                }
+              }
+            },
+            "description": "OK",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Current song",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/list": {
+      "get": {
+        "description": "Returns all songs in the queue.",
+        "operationId": "get-played-songs",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SongInfo"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Queue",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/next": {
+      "get": {
+        "description": "Moves to the next song in the queue and returns it. Stays on the last song at the end.",
+        "operationId": "get-next-song",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Next song in the queue",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/played": {
+      "put": {
+        "description": "Increments the play counters of the song at the given queue position. Positions outside the queue are ignored.",
+        "operationId": "mark-song-played",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Position of the song in the queue (SongNo)",
+            "explode": false,
+            "in": "query",
+            "name": "song",
+            "required": true,
+            "schema": {
+              "description": "Position of the song in the queue (SongNo)",
+              "format": "int64",
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Mark a queued song as played",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/previous": {
+      "get": {
+        "description": "Moves to the previous song in the queue and returns it. Stays on the first song at the start.",
+        "operationId": "get-previous-song",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Previous song in the queue",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/rand": {
+      "get": {
+        "description": "Picks a random song from a random soundtrack. Add it to the queue with /music/addQue.",
+        "operationId": "get-random-song",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Random song",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/rand/classic": {
+      "get": {
+        "description": "Picks a random song where every song has the same chance, regardless of soundtrack.",
+        "operationId": "get-random-song-classic",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Random song, every song equal",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/rand/low": {
+      "get": {
+        "description": "Picks a random song, favouring soundtracks that have been played less than average.",
+        "operationId": "get-random-song-low-chance",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request",
+            "headers": {
+              "X-Queue-Id": {
+                "description": "ID of the client's play queue. Send it with the following requests.",
+                "schema": {
+                  "format": "uuid",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Random song, favouring rarely played",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/reset": {
+      "get": {
+        "description": "Ends the queue, starts a new one and reloads the soundtrack list. The new queue's ID is returned in the X-Queue-Id header; send it with the following requests.",
+        "operationId": "reset-queue",
+        "parameters": [
+          {
+            "description": "ID of the client's play queue, from an earlier response. Omit it to start a new queue.",
+            "in": "header",
+            "name": "X-Queue-Id",
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "headers": {
+              "X-Queue-Id": {
+                "schema": {
+                  "description": "ID of the new queue",
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Reset the queue",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/music/soundTest": {
+      "get": {
+        "description": "Returns a random song for checking the volume.",
+        "operationId": "get-sound-test-song",
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)"
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Sound check song",
+        "tags": [
+          "music"
+        ]
+      }
+    },
+    "/api/v1/songs/{uuid}": {
+      "get": {
+        "description": "Returns information about a song.",
+        "operationId": "get-song",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack or song",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack or song",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Song"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Get song",
+        "tags": [
+          "library"
+        ]
+      }
+    },
+    "/api/v1/songs/{uuid}/file": {
+      "get": {
+        "description": "Returns the audio file of a song.",
+        "operationId": "get-song-file",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack or song",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack or song",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The song (MP3)"
+          },
+          "206": {
+            "content": {
+              "audio/mpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Stream song",
+        "tags": [
+          "library"
+        ]
+      }
+    },
+    "/api/v1/soundtracks": {
+      "get": {
+        "description": "Returns all soundtracks, sorted by name.",
+        "operationId": "list-soundtracks",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/Soundtrack"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "List soundtracks",
+        "tags": [
+          "library"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/uploads": {
+      "post": {
+        "description": "Starts adding a new soundtrack. Send its songs with PUT /soundtracks/uploads/{id}/files/{file}, then POST /soundtracks/uploads/{id}/finish. The name must be usable as a folder name, and no soundtrack, folder or other upload may have it, ignoring case. Unfinished uploads are removed after a day.",
+        "operationId": "start-upload",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UploadRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Upload"
+                }
+              }
+            },
+            "description": "Created"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Conflict"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Service Unavailable"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Start uploading a soundtrack",
+        "tags": [
+          "uploads"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/uploads/{id}": {
+      "delete": {
+        "description": "Deletes an unfinished upload and its songs.",
+        "operationId": "cancel-upload",
+        "parameters": [
+          {
+            "description": "ID of the upload, from POST /soundtracks/uploads",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "ID of the upload, from POST /soundtracks/uploads",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Cancel an upload",
+        "tags": [
+          "uploads"
+        ]
+      },
+      "get": {
+        "description": "Returns an unfinished upload with the songs received so far, for example to resume it.",
+        "operationId": "get-upload",
+        "parameters": [
+          {
+            "description": "ID of the upload, from POST /soundtracks/uploads",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "ID of the upload, from POST /soundtracks/uploads",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Upload"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Get an upload",
+        "tags": [
+          "uploads"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/uploads/{id}/files/{file}": {
+      "put": {
+        "description": "Stores one song of the upload, replacing a song of the same name, so a failed song can be sent again. Only MP3 files are accepted. The size limits are set on the server with UPLOAD_MAX_FILE_MB and UPLOAD_MAX_TOTAL_MB.",
+        "operationId": "upload-song",
+        "parameters": [
+          {
+            "description": "ID of the upload, from POST /soundtracks/uploads",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "ID of the upload, from POST /soundtracks/uploads",
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "File name of the song, e.g. \"01 Title.mp3\". Plain names only: put songs from disc folders in one folder, e.g. \"1-01 Title.mp3\".",
+            "in": "path",
+            "name": "file",
+            "required": true,
+            "schema": {
+              "description": "File name of the song, e.g. \"01 Title.mp3\". Plain names only: put songs from disc folders in one folder, e.g. \"1-01 Title.mp3\".",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "audio/mpeg": {
+              "schema": {
+                "contentMediaType": "application/octet-stream",
+                "format": "binary",
+                "type": "string"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UploadFile"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Request Entity Too Large"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Upload a song",
+        "tags": [
+          "uploads"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/uploads/{id}/finish": {
+      "post": {
+        "description": "Moves the songs into a new folder in the music folder, adds the soundtrack to the library and returns it. Refused when a soundtrack with the same songs exists.",
+        "operationId": "finish-upload",
+        "parameters": [
+          {
+            "description": "ID of the upload, from POST /soundtracks/uploads",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "ID of the upload, from POST /soundtracks/uploads",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SoundtrackWithSongList"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Conflict"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Finish an upload",
+        "tags": [
+          "uploads"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/{uuid}": {
+      "get": {
+        "description": "Returns a soundtrack with its songs, sorted by name.",
+        "operationId": "get-soundtrack",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack or song",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack or song",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SoundtrackWithSongList"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Get soundtrack",
+        "tags": [
+          "library"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/{uuid}/alternative-names": {
+      "put": {
+        "description": "Replaces the soundtrack's alternative names, which search and the cover search also use. Names are trimmed, and empty names, duplicates and the soundtrack's own name (ignoring case) are dropped.",
+        "operationId": "set-alternative-names",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AlternativeNames"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Soundtrack"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Set alternative names",
+        "tags": [
+          "library"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/{uuid}/cover": {
+      "delete": {
+        "description": "Deletes the soundtrack's cover, including one set by hand, so the automatic search looks for a new one.",
+        "operationId": "delete-soundtrack-cover",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack or song",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack or song",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Service Unavailable"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Remove the cover",
+        "tags": [
+          "covers"
+        ]
+      },
+      "get": {
+        "description": "Returns the soundtrack's cover image. cover_modified in the soundtrack responses tells when it last changed.",
+        "operationId": "get-soundtrack-cover",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack or song",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack or song",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "image/jpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/png": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/webp": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "The cover image"
+          },
+          "206": {
+            "content": {
+              "image/jpeg": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/png": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/webp": {
+                "schema": {
+                  "contentMediaType": "application/octet-stream",
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Part of the file, for a Range request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Soundtrack cover",
+        "tags": [
+          "covers"
+        ]
+      },
+      "put": {
+        "description": "Stores the image as the soundtrack's cover. The automatic search never replaces it; delete it to go back to automatic.",
+        "operationId": "upload-soundtrack-cover",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "image/*": {
+              "schema": {
+                "contentMediaType": "application/octet-stream",
+                "format": "binary",
+                "type": "string"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Service Unavailable"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Upload a cover",
+        "tags": [
+          "covers"
+        ]
+      }
+    },
+    "/api/v1/soundtracks/{uuid}/cover/source": {
+      "put": {
+        "description": "Downloads the cover of the given SteamGridDB game or AniList anime and stores it as the soundtrack's cover. The automatic search never replaces it. SteamGridDB needs STEAMGRIDDB_API_KEY on the server.",
+        "operationId": "set-soundtrack-cover-source",
+        "parameters": [
+          {
+            "description": "UUID of the soundtrack",
+            "in": "path",
+            "name": "uuid",
+            "required": true,
+            "schema": {
+              "description": "UUID of the soundtrack",
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CoverSource"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Request"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Not Found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "502": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Bad Gateway"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Service Unavailable"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Pick a cover",
+        "tags": [
+          "covers"
+        ]
+      }
+    },
+    "/api/v1/statistics/songs/least-played": {
+      "get": {
+        "description": "Returns the least played songs with their soundtrack.",
+        "operationId": "get-least-played-songs",
+        "parameters": [
+          {
+            "description": "Number of results. Values above 100 are capped to 100.",
+            "explode": false,
+            "in": "query",
+            "name": "limit",
+            "schema": {
+              "default": 10,
+              "description": "Number of results. Values above 100 are capped to 100.",
+              "format": "int64",
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SongInfoForStats"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Least played songs",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/songs/most-played": {
+      "get": {
+        "description": "Returns the most played songs with their soundtrack.",
+        "operationId": "get-most-played-songs",
+        "parameters": [
+          {
+            "description": "Number of results. Values above 100 are capped to 100.",
+            "explode": false,
+            "in": "query",
+            "name": "limit",
+            "schema": {
+              "default": 10,
+              "description": "Number of results. Values above 100 are capped to 100.",
+              "format": "int64",
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SongInfoForStats"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Most played songs",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/soundtracks": {
+      "get": {
+        "description": "Returns every soundtrack with its songs and play counts, sorted by name.",
+        "operationId": "get-all-soundtrack-statistics",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SoundtrackWithSongs"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "All soundtracks with statistics",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/soundtracks/last-played": {
+      "get": {
+        "description": "Returns the most recently played soundtracks with their songs.",
+        "operationId": "get-last-played-soundtracks",
+        "parameters": [
+          {
+            "description": "Number of results. Values above 100 are capped to 100.",
+            "explode": false,
+            "in": "query",
+            "name": "limit",
+            "schema": {
+              "default": 10,
+              "description": "Number of results. Values above 100 are capped to 100.",
+              "format": "int64",
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SoundtrackWithSongs"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Recently played soundtracks",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/soundtracks/least-played": {
+      "get": {
+        "description": "Returns the least played soundtracks with their songs.",
+        "operationId": "get-least-played-soundtracks",
+        "parameters": [
+          {
+            "description": "Number of results. Values above 100 are capped to 100.",
+            "explode": false,
+            "in": "query",
+            "name": "limit",
+            "schema": {
+              "default": 10,
+              "description": "Number of results. Values above 100 are capped to 100.",
+              "format": "int64",
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SoundtrackWithSongs"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Least played soundtracks",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/soundtracks/most-played": {
+      "get": {
+        "description": "Returns the most played soundtracks with their songs.",
+        "operationId": "get-most-played-soundtracks",
+        "parameters": [
+          {
+            "description": "Number of results. Values above 100 are capped to 100.",
+            "explode": false,
+            "in": "query",
+            "name": "limit",
+            "schema": {
+              "default": 10,
+              "description": "Number of results. Values above 100 are capped to 100.",
+              "format": "int64",
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SoundtrackWithSongs"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Most played soundtracks",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/soundtracks/never-played": {
+      "get": {
+        "description": "Returns all soundtracks that have never been played, with their songs.",
+        "operationId": "get-never-played-soundtracks",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SoundtrackWithSongs"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Never played soundtracks",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/soundtracks/oldest-played": {
+      "get": {
+        "description": "Returns the soundtracks played longest ago (played at least once) with their songs.",
+        "operationId": "get-oldest-played-soundtracks",
+        "parameters": [
+          {
+            "description": "Number of results. Values above 100 are capped to 100.",
+            "explode": false,
+            "in": "query",
+            "name": "limit",
+            "schema": {
+              "default": 10,
+              "description": "Number of results. Values above 100 are capped to 100.",
+              "format": "int64",
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SoundtrackWithSongs"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Least recently played soundtracks",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/statistics/summary": {
+      "get": {
+        "description": "Returns overall play statistics.",
+        "operationId": "get-statistics-summary",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StatisticsSummary"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Statistics summary",
+        "tags": [
+          "statistics"
+        ]
+      }
+    },
+    "/api/v1/sync": {
+      "post": {
+        "description": "Starts syncing the music folder in the background, skipping soundtracks that have not changed. Poll /sync/progress for the result.",
+        "operationId": "start-sync",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Sync changed soundtracks",
+        "tags": [
+          "sync"
+        ]
+      }
+    },
+    "/api/v1/sync/full": {
+      "post": {
+        "description": "Starts a full sync in the background that re-reads every soundtrack and removes songs whose files are gone. Poll /sync/progress for the result.",
+        "operationId": "start-full-sync",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "423": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Locked"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Sync all soundtracks",
+        "tags": [
+          "sync"
+        ]
+      }
+    },
+    "/api/v1/sync/progress": {
+      "get": {
+        "description": "While a sync is running, returns its progress. Otherwise returns the result of the last sync.",
+        "operationId": "get-sync-progress",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/ProgressResponse"
+                    },
+                    {
+                      "$ref": "#/components/schemas/SyncResponse"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Progress of the running sync, or the result of the last sync"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Sync progress or result",
+        "tags": [
+          "sync"
+        ]
+      }
+    },
+    "/api/v1/token": {
+      "delete": {
+        "description": "Deletes the token used for this request.",
+        "operationId": "delete-token",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StatusMessage"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Invalidate session token",
+        "tags": [
+          "auth"
+        ]
+      },
+      "post": {
+        "description": "Returns a token for the other /api/v1 endpoints, valid for 24 hours. Requires the API password when the server has one. Limited to 10 requests per minute per client.",
+        "operationId": "create-token",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TokenRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TokenResponse"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unprocessable Entity"
+          },
+          "429": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Too Many Requests"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "summary": "Create session token",
+        "tags": [
+          "auth"
+        ]
+      }
+    },
+    "/api/v1/token/cleanup": {
+      "post": {
+        "description": "Deletes all expired session tokens.",
+        "operationId": "cleanup-tokens",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StatusMessage"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Remove expired tokens",
+        "tags": [
+          "auth"
+        ]
+      }
+    },
+    "/api/v1/version": {
+      "get": {
+        "description": "Returns the server version and its changelog.",
+        "operationId": "get-version",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VersionData"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Latest server version",
+        "tags": [
+          "server"
+        ]
+      }
+    },
+    "/api/v1/version/history": {
+      "get": {
+        "description": "Returns all server versions with their changelogs, newest first.",
+        "operationId": "get-version-history",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/VersionData"
+                  },
+                  "type": "array"
+                }
+              }
+            },
+            "description": "OK"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/APIError"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Version history",
+        "tags": [
+          "server"
+        ]
+      }
+    }
+  }
+}
diff --git a/tests/data/layout_baseline.json b/tests/data/layout_baseline.json
index e9cfd61..92330b1 100644
--- a/tests/data/layout_baseline.json
+++ b/tests/data/layout_baseline.json
@@ -3965,7 +3965,7 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -3974,7 +3974,34 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    230.0,
+    228.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -11977,7 +12004,7 @@
     230.0,
     310.0,
     1460.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -11986,7 +12013,34 @@
     310.0,
     310.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    310.0,
+    310.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -16983,7 +17037,7 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -16992,7 +17046,34 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    230.0,
+    228.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -21854,7 +21935,7 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -21863,7 +21944,34 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    230.0,
+    228.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -27246,7 +27354,7 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -27255,7 +27363,34 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    230.0,
+    228.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -33456,7 +33591,7 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -33465,7 +33600,34 @@
     230.0,
     228.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    230.0,
+    228.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    230.0,
+    228.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -50019,7 +50181,7 @@
     230.0,
     228.0,
     1460.0,
-    109.0
+    114.0
    ],
    "visible": false
   },
@@ -50055,7 +50217,7 @@
     230.0,
     310.0,
     1460.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -50064,7 +50226,34 @@
     310.0,
     310.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    522.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    310.0,
+    310.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -50696,7 +50885,7 @@
     230.0,
     228.0,
     1460.0,
-    109.0
+    114.0
    ],
    "visible": true
   },
@@ -50732,7 +50921,7 @@
     230.0,
     310.0,
     1460.0,
-    27.0
+    32.0
    ],
    "visible": true
   },
@@ -50741,7 +50930,34 @@
     310.0,
     310.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": true
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    522.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    310.0,
+    310.0,
+    1300.0,
+    32.0
    ],
    "visible": true
   },
@@ -50986,7 +51202,7 @@
     230.0,
     310.0,
     1460.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -50995,7 +51211,34 @@
     310.0,
     310.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    310.0,
+    310.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
@@ -55524,7 +55767,7 @@
     230.0,
     310.0,
     1460.0,
-    27.0
+    32.0
    ],
    "visible": false
   },
@@ -55533,7 +55776,34 @@
     310.0,
     310.0,
     1300.0,
-    27.0
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    32.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#0/#0": {
+   "rect": [
+    310.0,
+    310.0,
+    0.0,
+    0.0
+   ],
+   "visible": false
+  },
+  "SyncPopup/SyncPanel/ScrollContainer/SyncVBoxContainer/ProgressHBoxContainer/SyncProgressBar/#1": {
+   "rect": [
+    310.0,
+    310.0,
+    1300.0,
+    32.0
    ],
    "visible": false
   },
diff --git a/tests/fakes/ui_tour.gd b/tests/fakes/ui_tour.gd
index b042ea3..f75b098 100644
--- a/tests/fakes/ui_tour.gd
+++ b/tests/fakes/ui_tour.gd
@@ -18,7 +18,7 @@ const SONG_INFO: Dictionary = {
 	"SongNo": 0, "Soundtrack": "Chrono Trigger", "SoundtrackUuid": "soundtrack-0",
 	"Song": "Corridors of Time",
 }
-const SYNC_PROGRESS: Dictionary = {"progress": 40, "time_spent": "00:00:02"}
+const SYNC_PROGRESS: Dictionary = {"progress": 40, "time_spent": "00:02"}
 const SYNC_RESULT: Dictionary = {
 	"soundtracks_added": ["Terranigma", "Lufia II"],
 	"soundtracks_re_added": [],
@@ -26,7 +26,7 @@ const SYNC_RESULT: Dictionary = {
 	"soundtracks_changed_content": ["Chrono Trigger"],
 	"soundtracks_removed": ["Old Soundtrack"],
 	"catched_errors": [],
-	"total_time": "00:00:03",
+	"total_time": "00:03",
 }
 
 ## The server's version history, newest first.
diff --git a/tests/integration/test_scene_split.gd b/tests/integration/test_scene_split.gd
index 9a6c2f4..0c9758c 100644
--- a/tests/integration/test_scene_split.gd
+++ b/tests/integration/test_scene_split.gd
@@ -226,7 +226,7 @@ func test_click_on_top_bar_while_quiz_popup_is_open_only_closes_it() -> void:
 
 func test_sync_disables_quiz_buttons_until_finished() -> void:
 	_server.respond_bytes("/sync", PackedByteArray())
-	_server.respond_json("/sync/progress", {"progress": 10, "time_spent": "00:00:01"})
+	_server.respond_json("/sync/progress", {"progress": 10, "time_spent": "00:01"})
 	var sync_popup: BasePopup = _window.get_node("SyncPopup")
 
 	_top_bar_button("SyncButton").pressed.emit()
diff --git a/tests/integration/test_sync_popup.gd b/tests/integration/test_sync_popup.gd
index ba8bb25..47d4b16 100644
--- a/tests/integration/test_sync_popup.gd
+++ b/tests/integration/test_sync_popup.gd
@@ -10,6 +10,8 @@ var _window: Control
 func before_test() -> void:
 	_snapshot = AutoloadSnapshot.take([Settings])
 	Settings.currently_syncing = false
+	# The bar jumps to its values and the result shows at once
+	Settings.reduce_animations = true
 	_server = FakeHttpTransport.new().install()
 	_server.respond_bytes("/sync", PackedByteArray())
 	_runner = scene_runner("res://popups/SyncPopup.tscn")
@@ -38,7 +40,7 @@ func _empty_result() -> Dictionary:
 		"soundtracks_changed_content": [],
 		"soundtracks_removed": [],
 		"catched_errors": [],
-		"total_time": "00:00:03",
+		"total_time": "00:03",
 	}
 
 
@@ -64,12 +66,29 @@ func test_start_sync_does_nothing_while_already_syncing() -> void:
 
 func test_progress_updates_progress_bar() -> void:
 	_runner.invoke("start_sync")
-	_server.respond_json("/sync/progress", {"progress": "42", "time_spent": "00:00:12"})
+	_server.respond_json("/sync/progress", {"progress": "42", "time_spent": "00:12"})
 
 	_runner.invoke("_on_sync_timeout")
 
 	assert_float(_node("SyncProgressBar").value).is_equal(42.0)
-	assert_str(_node("SyncTime").text).is_equal("00:00:12")
+	assert_str(_node("SyncTime").text).is_equal("00:12")
+
+
+func test_finished_sync_fills_the_bar_before_the_result() -> void:
+	Settings.reduce_animations = false
+	_runner.invoke("start_sync")
+	var bar: AnimatedProgressBar = _node("SyncProgressBar")
+	assert_bool(bar.indeterminate).is_true()
+
+	_finish_sync(_empty_result())
+
+	assert_bool(_node("ProgressHBoxContainer").visible).is_true()
+	await await_millis(int(Anim.SLOW * 1000) + 100)
+	assert_float(bar.value).is_equal(100.0)
+	assert_bool(_node("ProgressHBoxContainer").visible).is_true()
+	await await_millis(int(Anim.SLOW * 1000) + 100)
+	assert_bool(_node("ProgressHBoxContainer").visible).is_false()
+	assert_str(_node("SyncTitleLabel").text).is_equal("Sync Result")
 
 
 func test_finished_sync_shows_only_sections_with_changes() -> void:
@@ -88,7 +107,7 @@ func test_finished_sync_shows_only_sections_with_changes() -> void:
 	assert_bool(_node("NoChangesLabel").visible).is_false()
 	# Header plus one label per soundtrack
 	assert_int(_node("SoundtracksAddedVBox").get_child_count()).is_equal(3)
-	assert_str(_node("SyncTime").text).is_equal("Total time: 00:00:03")
+	assert_str(_node("SyncTime").text).is_equal("Total time: 00:03")
 	assert_bool(Settings.currently_syncing).is_false()
 	await assert_signal(_window).is_emitted("sync_finished")
 
diff --git a/tests/integration/test_theme.gd b/tests/integration/test_theme.gd
index ba96892..bce3a18 100644
--- a/tests/integration/test_theme.gd
+++ b/tests/integration/test_theme.gd
@@ -48,6 +48,9 @@ const STYLES: Dictionary = {
 	"PlayerTime": "Label",
 	"PlayerIcon": "Button",
 	"UpdateButton": "Button",
+	"SyncProgressBar": "ProgressBar",
+	"SyncProgressBarFill": "Panel",
+	"SyncProgressBarText": "Label",
 	"ProgressSlider": "HSlider",
 	"VolumeBar": "HSlider",
 	"StatisticsCard": "PanelContainer",
@@ -67,6 +70,7 @@ const STYLES: Dictionary = {
 ## Theme types that only scripts read from, so they are not styles a node can pick.
 const CODE_ONLY_TYPES: Dictionary = {
 	"Palette": ["backdrop", "first_point", "match_point", "flash"],
+	"SyncProgressBar": ["shine"],
 	"ScoreGraph": [
 		"player_1", "player_2", "player_3", "player_4", "player_5", "player_6", "player_7",
 		"grid", "axis_text", "winning_line",
diff --git a/tests/unit/test_animated_progress_bar.gd b/tests/unit/test_animated_progress_bar.gd
new file mode 100644
index 0000000..6bc33f5
--- /dev/null
+++ b/tests/unit/test_animated_progress_bar.gd
@@ -0,0 +1,88 @@
+extends GdUnitTestSuite
+## The sync popup's progress bar: busy until there is progress, gliding to new values,
+## a highlight on the filled part, and plain jumps with Reduce animations.
+
+var _runner: GdUnitSceneRunner
+var _bar: AnimatedProgressBar
+var _reduce_before: bool
+
+
+func before_test() -> void:
+	_reduce_before = Settings.reduce_animations
+	Settings.reduce_animations = false
+	var holder: Control = auto_free(Control.new())
+	holder.size = Vector2(1000, 100)
+	_bar = AnimatedProgressBar.new()
+	_bar.theme_type_variation = &"SyncProgressBar"
+	_bar.size = Vector2(1000, 32)
+	holder.add_child(_bar)
+	_runner = scene_runner(holder)
+	await _runner.simulate_frames(1)
+
+
+func after_test() -> void:
+	Settings.reduce_animations = _reduce_before
+
+
+func _label() -> Label:
+	return _bar.get_child(1) as Label
+
+
+func test_waits_with_the_busy_animation() -> void:
+	_bar.wait()
+
+	assert_bool(_bar.indeterminate).is_true()
+	assert_str(_label().text).is_empty()
+
+
+func test_progress_ends_the_wait_and_glides() -> void:
+	_bar.wait()
+
+	_bar.move_to(40)
+
+	assert_bool(_bar.indeterminate).is_false()
+	assert_float(_bar.value).is_less(40.0)
+	await await_millis(int(Anim.SLOW * 1000) + 150)
+	assert_float(_bar.value).is_equal(40.0)
+	assert_str(_label().text).is_equal("40%")
+
+
+func test_reduce_animations_jumps_and_never_waits() -> void:
+	Settings.reduce_animations = true
+
+	_bar.wait()
+	assert_bool(_bar.indeterminate).is_false()
+	_bar.move_to(75)
+
+	assert_float(_bar.value).is_equal(75.0)
+	assert_str(_label().text).is_equal("75%")
+
+
+func test_highlight_stays_on_the_filled_part() -> void:
+	Settings.reduce_animations = true
+	_bar.move_to(50)
+	Settings.reduce_animations = false
+	await _runner.simulate_frames(3)
+
+	var mask: Control = _bar.get_child(0)
+	assert_bool(mask.visible).is_true()
+	assert_float(mask.size.x).is_equal(_bar.fill_width())
+	assert_float(_bar.fill_width()).is_between(490.0, 510.0)
+
+
+func test_no_highlight_without_progress_or_animations() -> void:
+	await _runner.simulate_frames(2)
+	assert_bool((_bar.get_child(0) as Control).visible).is_false()
+
+	Settings.reduce_animations = true
+	_bar.move_to(50)
+	await _runner.simulate_frames(2)
+	assert_bool((_bar.get_child(0) as Control).visible).is_false()
+
+
+func test_highlight_takes_the_themes_colour() -> void:
+	var shine: TextureRect = _bar.get_child(0).get_child(0)
+	var gradient: Gradient = (shine.texture as GradientTexture2D).gradient
+
+	assert_object(gradient.get_color(1)).is_equal(_bar.get_theme_color(&"shine"))
+	assert_float(gradient.get_color(0).a).is_equal(0.0)
diff --git a/tests/unit/test_animated_progress_bar.gd.uid b/tests/unit/test_animated_progress_bar.gd.uid
new file mode 100644
index 0000000..062a204
--- /dev/null
+++ b/tests/unit/test_animated_progress_bar.gd.uid
@@ -0,0 +1 @@
+uid://bgb6no4urwpc7
diff --git a/tests/unit/test_api_types.gd b/tests/unit/test_api_types.gd
index 12027fc..d29b33c 100644
--- a/tests/unit/test_api_types.gd
+++ b/tests/unit/test_api_types.gd
@@ -118,7 +118,7 @@ func test_sync_response() -> void:
 		"soundtracks_added": ["Terranigma"], "soundtracks_re_added": [],
 		"soundtracks_changed_title": {"FF6": "Final Fantasy VI"},
 		"soundtracks_changed_content": ["Chrono Trigger"], "soundtracks_removed": ["Old"],
-		"catched_errors": ["Could not read x.mp3"], "total_time": "00:00:03"}"""))
+		"catched_errors": ["Could not read x.mp3"], "total_time": "00:03"}"""))
 
 	assert_array(result.soundtracks_added).contains_exactly(["Terranigma"])
 	assert_array(result.soundtracks_re_added).is_empty()
@@ -126,15 +126,15 @@ func test_sync_response() -> void:
 	assert_array(result.soundtracks_changed_content).contains_exactly(["Chrono Trigger"])
 	assert_array(result.soundtracks_removed).contains_exactly(["Old"])
 	assert_array(result.catched_errors).contains_exactly(["Could not read x.mp3"])
-	assert_str(result.total_time).is_equal("00:00:03")
+	assert_str(result.total_time).is_equal("00:03")
 
 
 func test_progress_response() -> void:
 	var progress: ProgressResponse = ProgressResponse.from_dict(_parse("""{
-		"progress": "40", "time_spent": "00:00:02"}"""))
+		"progress": "40", "time_spent": "00:02"}"""))
 
 	assert_str(progress.progress).is_equal("40")
-	assert_str(progress.time_spent).is_equal("00:00:02")
+	assert_str(progress.time_spent).is_equal("00:02")
 
 
 func test_version_data() -> void:
diff --git a/themes/christmas_theme.tres b/themes/christmas_theme.tres
index 27c644c..c5636ee 100644
--- a/themes/christmas_theme.tres
+++ b/themes/christmas_theme.tres
@@ -1248,6 +1248,30 @@ corner_radius_bottom_right = 8
 corner_radius_bottom_left = 8
 corner_detail = 8
 
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_track"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(0.478, 0.082, 0.125, 0.7)
+corner_radius_top_left = 10
+corner_radius_top_right = 10
+corner_radius_bottom_right = 10
+corner_radius_bottom_left = 10
+corner_detail = 8
+
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_fill"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(0.204, 0.553, 0.290, 1.0)
+corner_radius_top_left = 10
+corner_radius_top_right = 10
+corner_radius_bottom_right = 10
+corner_radius_bottom_left = 10
+corner_detail = 8
+
 [resource]
 default_font = ExtResource("1_default_font")
 Button/colors/font_color = Color(0.478, 0.082, 0.125, 1.0)
@@ -1456,6 +1480,21 @@ ProgressBar/constants/outline_size = 0
 ProgressBar/font_sizes/font_size = 16
 ProgressBar/styles/background = SubResource("StyleBoxFlat_07kyi")
 ProgressBar/styles/fill = SubResource("StyleBoxFlat_ouuwv")
+SyncProgressBar/base_type = &"ProgressBar"
+SyncProgressBar/colors/font_color = Color(1, 1, 1, 1)
+SyncProgressBar/colors/font_outline_color = Color(0, 0, 0, 0.45)
+SyncProgressBar/colors/shine = Color(0.949, 0.843, 0.478, 0.9)
+SyncProgressBar/constants/outline_size = 4
+SyncProgressBar/font_sizes/font_size = 18
+SyncProgressBar/styles/background = SubResource("StyleBoxFlat_sync_track")
+SyncProgressBar/styles/fill = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarFill/base_type = &"Panel"
+SyncProgressBarFill/styles/panel = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarText/base_type = &"Label"
+SyncProgressBarText/colors/font_color = Color(1, 1, 1, 1)
+SyncProgressBarText/colors/font_outline_color = Color(0, 0, 0, 0.45)
+SyncProgressBarText/constants/outline_size = 4
+SyncProgressBarText/font_sizes/font_size = 18
 ScoreGraph/colors/axis_text = Color(0.965, 0.925, 0.878, 1.0)
 ScoreGraph/colors/grid = Color(0.992, 0.980, 0.953, 0.1)
 ScoreGraph/colors/player_1 = Color(0.992, 0.980, 0.953, 1.0)
diff --git a/themes/main_theme.tres b/themes/main_theme.tres
index 979497f..cb328e5 100644
--- a/themes/main_theme.tres
+++ b/themes/main_theme.tres
@@ -1056,6 +1056,30 @@ corner_radius_bottom_right = 8
 corner_radius_bottom_left = 8
 corner_detail = 8
 
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_track"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(0.1, 0.1, 0.1, 0.55)
+corner_radius_top_left = 6
+corner_radius_top_right = 6
+corner_radius_bottom_right = 6
+corner_radius_bottom_left = 6
+corner_detail = 8
+
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_fill"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(1, 0.5, 0, 1)
+corner_radius_top_left = 6
+corner_radius_top_right = 6
+corner_radius_bottom_right = 6
+corner_radius_bottom_left = 6
+corner_detail = 8
+
 [resource]
 default_font = ExtResource("1_default_font")
 Button/colors/font_color = Color(0.875, 0.875, 0.875, 1)
@@ -1264,6 +1288,21 @@ ProgressBar/constants/outline_size = 0
 ProgressBar/font_sizes/font_size = 16
 ProgressBar/styles/background = SubResource("StyleBoxFlat_07kyi")
 ProgressBar/styles/fill = SubResource("StyleBoxFlat_ouuwv")
+SyncProgressBar/base_type = &"ProgressBar"
+SyncProgressBar/colors/font_color = Color(1, 1, 1, 1)
+SyncProgressBar/colors/font_outline_color = Color(0, 0, 0, 0.55)
+SyncProgressBar/colors/shine = Color(1, 0.86, 0.6, 0.8)
+SyncProgressBar/constants/outline_size = 4
+SyncProgressBar/font_sizes/font_size = 18
+SyncProgressBar/styles/background = SubResource("StyleBoxFlat_sync_track")
+SyncProgressBar/styles/fill = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarFill/base_type = &"Panel"
+SyncProgressBarFill/styles/panel = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarText/base_type = &"Label"
+SyncProgressBarText/colors/font_color = Color(1, 1, 1, 1)
+SyncProgressBarText/colors/font_outline_color = Color(0, 0, 0, 0.55)
+SyncProgressBarText/constants/outline_size = 4
+SyncProgressBarText/font_sizes/font_size = 18
 ScoreGraph/colors/axis_text = Color(0.75, 0.75, 0.75, 1)
 ScoreGraph/colors/grid = Color(1, 1, 1, 0.1)
 ScoreGraph/colors/player_1 = Color(0.25, 0.56, 0.95, 1)
diff --git a/themes/nord_theme.tres b/themes/nord_theme.tres
index 0ce23c1..ba5459e 100644
--- a/themes/nord_theme.tres
+++ b/themes/nord_theme.tres
@@ -1231,6 +1231,30 @@ corner_radius_bottom_right = 8
 corner_radius_bottom_left = 8
 corner_detail = 8
 
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_track"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(0.118, 0.290, 0.412, 0.7)
+corner_radius_top_left = 10
+corner_radius_top_right = 10
+corner_radius_bottom_right = 10
+corner_radius_bottom_left = 10
+corner_detail = 8
+
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_fill"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(0.533, 0.753, 0.816, 1.0)
+corner_radius_top_left = 10
+corner_radius_top_right = 10
+corner_radius_bottom_right = 10
+corner_radius_bottom_left = 10
+corner_detail = 8
+
 [resource]
 default_font = ExtResource("1_default_font")
 Button/colors/font_color = Color(0.925, 0.937, 0.957, 1.0)
@@ -1439,6 +1463,21 @@ ProgressBar/constants/outline_size = 0
 ProgressBar/font_sizes/font_size = 16
 ProgressBar/styles/background = SubResource("StyleBoxFlat_07kyi")
 ProgressBar/styles/fill = SubResource("StyleBoxFlat_ouuwv")
+SyncProgressBar/base_type = &"ProgressBar"
+SyncProgressBar/colors/font_color = Color(0.925, 0.937, 0.957, 1.0)
+SyncProgressBar/colors/font_outline_color = Color(0.180, 0.204, 0.251, 0.8)
+SyncProgressBar/colors/shine = Color(0.925, 0.937, 0.957, 0.85)
+SyncProgressBar/constants/outline_size = 4
+SyncProgressBar/font_sizes/font_size = 18
+SyncProgressBar/styles/background = SubResource("StyleBoxFlat_sync_track")
+SyncProgressBar/styles/fill = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarFill/base_type = &"Panel"
+SyncProgressBarFill/styles/panel = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarText/base_type = &"Label"
+SyncProgressBarText/colors/font_color = Color(0.925, 0.937, 0.957, 1.0)
+SyncProgressBarText/colors/font_outline_color = Color(0.180, 0.204, 0.251, 0.8)
+SyncProgressBarText/constants/outline_size = 4
+SyncProgressBarText/font_sizes/font_size = 18
 ScoreGraph/colors/axis_text = Color(0.847, 0.871, 0.914, 1.0)
 ScoreGraph/colors/grid = Color(0.925, 0.937, 0.957, 0.1)
 ScoreGraph/colors/player_1 = Color(0.533, 0.753, 0.816, 1.0)
diff --git a/themes/original_web_theme.tres b/themes/original_web_theme.tres
index 3b88699..0cfa708 100644
--- a/themes/original_web_theme.tres
+++ b/themes/original_web_theme.tres
@@ -1157,6 +1157,30 @@ corner_radius_bottom_right = 8
 corner_radius_bottom_left = 8
 corner_detail = 8
 
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_track"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(0.86, 0.86, 0.86, 1)
+corner_radius_top_left = 6
+corner_radius_top_right = 6
+corner_radius_bottom_right = 6
+corner_radius_bottom_left = 6
+corner_detail = 8
+
+[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_sync_fill"]
+content_margin_left = 2.0
+content_margin_top = 2.0
+content_margin_right = 2.0
+content_margin_bottom = 2.0
+bg_color = Color(1, 0.612, 0, 1)
+corner_radius_top_left = 6
+corner_radius_top_right = 6
+corner_radius_bottom_right = 6
+corner_radius_bottom_left = 6
+corner_detail = 8
+
 [resource]
 default_font = ExtResource("1_default_font")
 Button/colors/font_color = Color(1, 0.612, 0, 1)
@@ -1365,6 +1389,21 @@ ProgressBar/constants/outline_size = 0
 ProgressBar/font_sizes/font_size = 16
 ProgressBar/styles/background = SubResource("StyleBoxFlat_07kyi")
 ProgressBar/styles/fill = SubResource("StyleBoxFlat_ouuwv")
+SyncProgressBar/base_type = &"ProgressBar"
+SyncProgressBar/colors/font_color = Color(1, 1, 1, 1)
+SyncProgressBar/colors/font_outline_color = Color(0, 0, 0, 0.45)
+SyncProgressBar/colors/shine = Color(1, 1, 1, 0.7)
+SyncProgressBar/constants/outline_size = 4
+SyncProgressBar/font_sizes/font_size = 18
+SyncProgressBar/styles/background = SubResource("StyleBoxFlat_sync_track")
+SyncProgressBar/styles/fill = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarFill/base_type = &"Panel"
+SyncProgressBarFill/styles/panel = SubResource("StyleBoxFlat_sync_fill")
+SyncProgressBarText/base_type = &"Label"
+SyncProgressBarText/colors/font_color = Color(1, 1, 1, 1)
+SyncProgressBarText/colors/font_outline_color = Color(0, 0, 0, 0.45)
+SyncProgressBarText/constants/outline_size = 4
+SyncProgressBarText/font_sizes/font_size = 18
 ScoreGraph/colors/axis_text = Color(0.75, 0.75, 0.75, 1)
 ScoreGraph/colors/grid = Color(1, 1, 1, 0.1)
 ScoreGraph/colors/player_1 = Color(0.25, 0.56, 0.95, 1)