Skip to content
kōan
Contents

Start

Server

Library

Playback

Automation

Reference

Protocol

Changelog

Unreleased

Changed

Fixed

0.72.3

Fixed

0.72.2

Changed

0.72.1

Changed

Fixed

Internal

0.72.0

Security

Changed

Fixed

Internal

0.71.4

Fixed

0.71.3

Changed

Fixed

0.71.2

Changed

Fixed

Internal

0.71.1

Changed

Internal

0.71.0

Added

Changed

Fixed

Internal

0.70.5

Added

Changed

Fixed

Internal

0.70.4

Added

0.70.3

Changed

Fixed

Internal

0.70.2

Changed

Fixed

0.70.1

Fixed

0.70.0

Added

Changed

Fixed

Internal

0.69.6

Added

Changed

Fixed

Internal

0.69.5

Fixed

Internal

0.69.4

Added

Changed

Fixed

Internal

0.69.3

Added

Changed

Fixed

Internal

0.69.2

Added

Fixed

0.69.1

Changed

Fixed

0.69.0

Added

Fixed

0.68.0

Security

Changed

Fixed

Internal

0.67.8

Fixed

0.67.7

Security

Changed

Fixed

0.67.6

Changed

Fixed

0.67.5

Security

Changed

Fixed

Internal

0.67.4

Changed

Fixed

0.67.3

Security

Changed

Fixed

Internal

0.67.2

Added

Changed

Removed

Internal

0.67.1

Added

0.67.0

Added

Changed

0.66.7

Added

Changed

0.66.6

Added

Security

Internal

0.66.5

Security

0.66.4

Added

Internal

0.66.3

Security

Changed

Fixed

Internal

0.66.2

Fixed

Internal

0.66.1

Added

Changed

Fixed

Internal

0.66.0

Added

Security

Changed

Removed

Fixed

Internal

0.65.1

Added

Changed

Fixed

0.65.0

Added

Changed

Removed

Internal

0.64.1

Added

Fixed

Internal

0.64.0

Added

Changed

Fixed

0.63.0

Added

Changed

0.62.1

Added

Changed

Fixed

0.62.0

Added

Security

Changed

Fixed

0.61.13

Added

Fixed

0.61.12

Changed

Fixed

0.61.11

Fixed

0.61.10

Added

Changed

Fixed

0.61.9

Fixed

0.61.8

Changed

0.61.7

Changed

Fixed

0.61.6

Fixed

0.61.5

Added

Changed

Fixed

0.61.4

Changed

0.61.3

Removed

Fixed

0.61.2

Added

Changed

Fixed

0.61.1

Changed

Fixed

0.61.0

This release manages app passwords from the Mac and iPhone, gives the kōan theme its own icons, and stops EQs kept on every device from being deleted without anyone deleting them; a kōan server now keeps a deleted EQ for thirty days. The schema stays at 23: the server's dsp_profiles table gains two columns, deleted_doc and deleted_at, added in place, so 0.60.12 still opens the database. Snapshot a server's database before upgrading all the same.

Added

Changed

Fixed

0.60.12

This release fixes a library folder configured in another case than the disk's, such as ~/music on a Mac whose folder is ~/Music: 0.60.11 indexed every file in it a second time. The first scan after upgrading folds each duplicate back into its original track. The database schema is unchanged from 0.60.11.

Security

Fixed

0.60.11

0.60.10 was never published: its macOS and tvOS release builds failed in the Swift compiler, so its GitHub release, server image and TestFlight builds did not go out. 0.60.11 is the first release to carry its changes, below under 0.60.10. This release moves the database from schema 22 to 23, rebuilding the scan and lyrics caches (#1059), and builds older than 0.60.11 refuse a database that has been migrated. Snapshot the server's database before deploying.

Added

Security

Changed

Fixed

0.60.10

Added

Changed

Fixed

0.60.9

Added

Changed

Fixed

0.60.8

Fixed

0.60.7

Added

Changed

Fixed

0.60.6

Added

Changed

Fixed

0.60.5

Fixed

0.60.4

Fixed

0.60.3

Changed

Removed

Fixed

0.60.2

Added

Security

Changed

Fixed

0.60.1

Added

Changed

Fixed

0.60.0

0.59.0 was never published: its macOS notarisation timed out on Apple's side, so its GitHub release and server image did not go out. 0.60.0 is the first release to carry its changes, below under 0.59.0, including the move from schema 20 to 21. Upgrading from 0.58.0 or earlier runs that migration; snapshot the database first.

Added

Changed

Fixed

0.59.0

The library database moves from schema 20 to 21. The upgrade only adds tables: the EQ profiles a server keeps for its accounts, and a device's record of what it synced. Every existing row is kept as it was, and the upgrade runs in one transaction. Builds older than this one refuse a schema-21 database, so going back means restoring a copy taken before upgrading.

Added

Changed

Fixed

0.58.0

The library database moves from schema 19 to 20 (new tables for Subsonic saved play queues; every existing row is kept). Upgrades now run in one transaction and roll back whole if any step fails, and a server finding the database newer than it knows drains and exits. Builds older than 0.58.0 refuse a schema-20 database, so going back means restoring a copy taken before upgrading.

Added

Changed

Fixed

0.57.0

Added

Security

Changed

Fixed

0.56.0

Added

Security

Changed

Fixed

0.55.0

Added

Changed

Fixed

0.54.2

Changed

Fixed

0.54.1

Added

Changed

Fixed

0.54.0

The library database moves from schema 16 to 19 (new tables for ratings, bookmarks, scrobbling and smart playlists, and the play history table rebuilt for sharing between devices; every existing row is kept as it was). Builds older than 0.54.0 refuse a schema-19 database, so going back means restoring a copy taken before upgrading.

Added

Fixed

0.53.0

Added

Fixed

0.52.9

Changed

0.52.8

Fixed

0.52.7

Fixed

0.52.6

Added

Changed

Fixed

0.52.5

Changed

0.52.4

Added

Fixed

0.52.3

Added

Fixed

0.52.2

Changed

Fixed

0.52.1

Added

Changed

Fixed

0.52.0

Added

0.51.0

Added

Changed

Fixed

Removed

0.50.3

Added

Changed

Removed

Fixed

0.50.2

Changed

Fixed

0.50.1

Fixed

0.50.0

Added

Removed

0.49.2

Removed

0.49.1

Changed

Fixed

0.49.0

Changed

Removed

Fixed

0.48.2

Fixed

0.48.1

Fixed

0.48.0

Changed

Fixed

0.47.2

Fixed

0.47.1

Fixed

0.47.0

Changed

Fixed

0.46.3

Fixed

0.46.2

Fixed

0.46.1

Changed

Fixed

0.46.0

Changed

Fixed

0.45.1

Fixed

0.45.0

Added

Changed

Fixed

0.44.1

Added

Changed

Fixed

0.44.0

Added

Changed

Fixed

0.43.0

Added

Changed

Fixed

0.42.1

Changed

Fixed

0.42.0

Added

Changed

Fixed

0.41.0

Added

Changed

Fixed

0.40.0

Added

Changed

Fixed

0.39.4

Fixed

0.39.3

Fixed

0.39.2

Added

0.39.1

Fixed

0.39.0

Added

Changed

0.38.6

Fixed

0.38.5

Fixed

0.38.4

Added

Fixed

0.38.3

Fixed

0.38.2

Fixed

0.38.1

Fixed

0.38.0

Added

Changed

Fixed

0.37.0

Added

0.36.10

Fixed

0.36.9

Changed

Fixed

0.36.8

Fixed

0.36.7

Fixed

0.36.6

Fixed

0.36.5

Fixed

0.36.4

Added

Fixed

0.36.3

Changed

Fixed

0.36.2

Added

Changed

Fixed

Internal

0.36.1

Added

Changed

0.36.0

Added

Changed

Fixed

0.35.5

Fixed

0.35.4

Fixed

0.35.3

Changed

Fixed

0.35.2

Fixed

0.35.1

Fixed

0.35.0

Added

Fixed

0.34.3

Added

0.34.2

Fixed

0.34.1

Changed

Fixed

0.34.0

Security

Added

Fixed

0.33.2

Changed

Fixed

0.33.1

Added

Changed

Fixed

0.33.0

Changed

Fixed

0.32.0

Added

Changed

Removed

Fixed

0.31.2

Added

Changed

Removed

Fixed

0.31.1

Changed

0.31.0

Added

Changed

Removed

Unknown keys are ignored rather than rejected, so a stale config still loads. Two renames change behaviour silently and are worth grepping your config for: [graphql] subsonic_port (now [subsonic] port) and [discovery] analysis_on_scan (now [library] analyze_on_scan). The others were inert.

Fixed

0.30.2

Added

Changed

Fixed

0.30.1

Changed

Fixed

0.30.0

Added

Changed

Fixed

0.29.1

Changed

0.29.0

Added

Changed

Fixed

0.28.0

Added

Changed

Fixed

0.27.0

Added

Changed

Fixed

0.26.0

Added

Changed

Fixed

0.25.2

Changed

Fixed

0.25.1

Fixed

0.25.0

Added

Changed

Fixed

0.24.0

Breaking

Security

Added

Seven ways koan organize could destroy music files, every one of which was reported as a successful move.

Also hardened, same blast radius:

Changed

Removed

Fixed

Known issues

Closes the browser-facing attack surface on koan serve. The threat model that drove this: koan on a LAN, reachable from other machines on the network and from any web page the owner's browser happens to load.

Internal

0.23.3

Fixed

0.23.2

Second attempt at getting the split crates on crates.io. v0.23.1 published koan-core but then failed because the publish order had koan-tui before koan-server — and koan-tui depends on koan-server. Flipped the order; no code delta.

Fixed

0.23.1

Re-release of v0.23.0 to publish the split crates to crates.io. No code changes from v0.23.0.

Fixed

0.23.0

Groundwork for the upcoming browser SPA: full GraphQL schema for web clients, real-time subscriptions, cookie auth, and configurable CORS. Subsonic streaming now rides the GraphQL port by default, so the remote TUI (koan play --server) finally works end-to-end.

Added

Fixed

Known issues

Internal

0.22.0

Security

Added

0.21.0

Added

Changed

Fixed

0.20.4

Fixed

0.20.3

Added

Changed

Fixed

0.20.2

Changed

0.20.1

Added

Fixed

0.20.0

Added

Changed

0.19.5

Added

0.19.4

Fixed

0.19.3

Fixed

0.19.2

Fixed

0.19.1

Added

0.19.0

Added

0.18.7

Changed

0.18.6

Fixed

0.18.5

Fixed

0.18.4

Changed

Fixed

0.18.3

Changed

Fixed

0.18.2

Changed

Fixed

0.18.1

Added

Changed

Fixed

0.18.0

Added

0.17.1

Added

Fixed

0.17.0

Changed

Removed

Fixed

Remote

Audio

Player

TUI

Database

Misc

0.16.0

Changed

0.15.0

Added

Changed

Fixed

0.14.0

Added

0.13.1

Changed

Fixed

0.13.0

Added

Changed

0.12.5

Fixed

0.12.4

Fixed

0.12.3

Added

0.12.2

Added

0.12.1

Changed

0.12.0

Added

Fixed

0.11.1

Fixed

Tests

0.11.0

Added

0.10.0

Added

0.9.2

Fixed

0.9.1

Added

Fixed

0.9.0

Added

0.8.2

Added

0.8.1

Added

0.8.0

Added

Fixed

0.7.2

Fixed

0.7.1

Fixed

0.7.0

Added

0.6.3

Added

Fixed

0.6.2

Added

0.6.1

Added

Fixed

Tests

0.6.0

Full codebase audit of v0.5.2 covering security, performance, architecture, dependencies, and test coverage. Every change was reviewed individually and as a combined integration.

Changed

Removed

Fixed

Tests

0.5.2

Fixed

0.5.1

Added

Fixed

0.5.0

Added

0.4.0

Added

Changed

Removed

Fixed

0.3.0

Added

Changed

Fixed

0.2.3

Added

Removed

Fixed

0.2.0

First public release. Full TUI rewrite, undo/redo, file organization, CI/CD pipeline.

Added

Changed

Removed

Fixed

0.1.0

Initial release.