qobit 0.9.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. qobit-0.9.0/.gitignore +43 -0
  2. qobit-0.9.0/CHANGELOG.md +377 -0
  3. qobit-0.9.0/LICENSE +675 -0
  4. qobit-0.9.0/PKG-INFO +226 -0
  5. qobit-0.9.0/README.md +190 -0
  6. qobit-0.9.0/contrib/pipewire/10-allowed-rates.conf +29 -0
  7. qobit-0.9.0/contrib/pipewire/README.md +70 -0
  8. qobit-0.9.0/docs/assets/README.md +14 -0
  9. qobit-0.9.0/docs/assets/favicon.svg +1 -0
  10. qobit-0.9.0/docs/assets/png/qobit-glyph-512.png +0 -0
  11. qobit-0.9.0/docs/assets/png/qobit-mark-1024.png +0 -0
  12. qobit-0.9.0/docs/assets/png/qobit-mark-16.png +0 -0
  13. qobit-0.9.0/docs/assets/png/qobit-mark-180.png +0 -0
  14. qobit-0.9.0/docs/assets/png/qobit-mark-32.png +0 -0
  15. qobit-0.9.0/docs/assets/png/qobit-mark-512.png +0 -0
  16. qobit-0.9.0/docs/assets/qobit-glyph.svg +1 -0
  17. qobit-0.9.0/docs/assets/qobit-mark.svg +1 -0
  18. qobit-0.9.0/docs/assets/qobit-wordmark-dark.svg +1 -0
  19. qobit-0.9.0/docs/assets/qobit-wordmark-light.svg +1 -0
  20. qobit-0.9.0/docs/audio.md +97 -0
  21. qobit-0.9.0/docs/qobuz-connect-design.md +261 -0
  22. qobit-0.9.0/docs/qobuz-connect.md +317 -0
  23. qobit-0.9.0/docs/usage.md +203 -0
  24. qobit-0.9.0/pyproject.toml +98 -0
  25. qobit-0.9.0/src/qobit/__init__.py +10 -0
  26. qobit-0.9.0/src/qobit/__main__.py +423 -0
  27. qobit-0.9.0/src/qobit/_fs.py +38 -0
  28. qobit-0.9.0/src/qobit/account_data.py +102 -0
  29. qobit-0.9.0/src/qobit/audio/__init__.py +0 -0
  30. qobit-0.9.0/src/qobit/audio/device.py +85 -0
  31. qobit-0.9.0/src/qobit/audio/media_keys.py +442 -0
  32. qobit-0.9.0/src/qobit/audio/player.py +234 -0
  33. qobit-0.9.0/src/qobit/audio/verify.py +144 -0
  34. qobit-0.9.0/src/qobit/config.py +201 -0
  35. qobit-0.9.0/src/qobit/connect/__init__.py +52 -0
  36. qobit-0.9.0/src/qobit/connect/proto/__init__.py +8 -0
  37. qobit-0.9.0/src/qobit/connect/proto/qcloud.proto +60 -0
  38. qobit-0.9.0/src/qobit/connect/proto/qcloud_pb2.py +50 -0
  39. qobit-0.9.0/src/qobit/connect/proto/qconnect.proto +723 -0
  40. qobit-0.9.0/src/qobit/connect/proto/qconnect_pb2.py +210 -0
  41. qobit-0.9.0/src/qobit/connect/queue.py +108 -0
  42. qobit-0.9.0/src/qobit/connect/renderer.py +519 -0
  43. qobit-0.9.0/src/qobit/connect/session.py +155 -0
  44. qobit-0.9.0/src/qobit/connect/wire.py +99 -0
  45. qobit-0.9.0/src/qobit/qobuz/__init__.py +0 -0
  46. qobit-0.9.0/src/qobit/qobuz/client.py +544 -0
  47. qobit-0.9.0/src/qobit/qobuz/models.py +285 -0
  48. qobit-0.9.0/src/qobit/qobuz/oauth.py +167 -0
  49. qobit-0.9.0/src/qobit/qobuz/sanitize.py +32 -0
  50. qobit-0.9.0/src/qobit/secret.py +22 -0
  51. qobit-0.9.0/src/qobit/store.py +32 -0
  52. qobit-0.9.0/src/qobit/token_store.py +106 -0
  53. qobit-0.9.0/src/qobit/ui/__init__.py +0 -0
  54. qobit-0.9.0/src/qobit/ui/_images.py +225 -0
  55. qobit-0.9.0/src/qobit/ui/_now_playing.py +248 -0
  56. qobit-0.9.0/src/qobit/ui/_utils.py +68 -0
  57. qobit-0.9.0/src/qobit/ui/app.py +1860 -0
  58. qobit-0.9.0/src/qobit/ui/nav.py +186 -0
  59. qobit-0.9.0/src/qobit/ui/play_context.py +376 -0
  60. qobit-0.9.0/src/qobit/ui/screens/__init__.py +0 -0
  61. qobit-0.9.0/src/qobit/ui/screens/album_detail.py +353 -0
  62. qobit-0.9.0/src/qobit/ui/screens/albums.py +341 -0
  63. qobit-0.9.0/src/qobit/ui/screens/artist_detail.py +1293 -0
  64. qobit-0.9.0/src/qobit/ui/screens/artists.py +389 -0
  65. qobit-0.9.0/src/qobit/ui/screens/context_menu.py +192 -0
  66. qobit-0.9.0/src/qobit/ui/screens/login.py +212 -0
  67. qobit-0.9.0/src/qobit/ui/screens/mixes.py +348 -0
  68. qobit-0.9.0/src/qobit/ui/screens/playlist_detail.py +219 -0
  69. qobit-0.9.0/src/qobit/ui/screens/playlists.py +401 -0
  70. qobit-0.9.0/src/qobit/ui/screens/queue.py +670 -0
  71. qobit-0.9.0/src/qobit/ui/screens/search.py +268 -0
  72. qobit-0.9.0/src/qobit/ui/screens/tracks.py +308 -0
  73. qobit-0.9.0/src/qobit/ui/themes.py +248 -0
  74. qobit-0.9.0/src/qobit/ui/widgets/__init__.py +0 -0
  75. qobit-0.9.0/src/qobit/ui/widgets/art.py +79 -0
  76. qobit-0.9.0/src/qobit/ui/widgets/lists.py +131 -0
  77. qobit-0.9.0/src/qobit/ui/widgets/transport.py +350 -0
  78. qobit-0.9.0/tests/conftest.py +153 -0
  79. qobit-0.9.0/tests/test_account_data.py +84 -0
  80. qobit-0.9.0/tests/test_app_timeline.py +445 -0
  81. qobit-0.9.0/tests/test_cards.py +68 -0
  82. qobit-0.9.0/tests/test_client.py +253 -0
  83. qobit-0.9.0/tests/test_config.py +157 -0
  84. qobit-0.9.0/tests/test_connect.py +649 -0
  85. qobit-0.9.0/tests/test_connect_context.py +137 -0
  86. qobit-0.9.0/tests/test_context_menu.py +133 -0
  87. qobit-0.9.0/tests/test_images_cache.py +140 -0
  88. qobit-0.9.0/tests/test_lists.py +65 -0
  89. qobit-0.9.0/tests/test_login_ui.py +226 -0
  90. qobit-0.9.0/tests/test_models.py +414 -0
  91. qobit-0.9.0/tests/test_navigation.py +52 -0
  92. qobit-0.9.0/tests/test_oauth.py +326 -0
  93. qobit-0.9.0/tests/test_player.py +108 -0
  94. qobit-0.9.0/tests/test_queue_reconcile.py +172 -0
  95. qobit-0.9.0/tests/test_rows.py +50 -0
  96. qobit-0.9.0/tests/test_sanitize.py +43 -0
  97. qobit-0.9.0/tests/test_secret.py +50 -0
  98. qobit-0.9.0/tests/test_store.py +58 -0
  99. qobit-0.9.0/tests/test_themes.py +89 -0
  100. qobit-0.9.0/tests/test_token_store.py +103 -0
  101. qobit-0.9.0/tests/test_utils.py +30 -0
  102. qobit-0.9.0/tests/test_verify.py +92 -0
qobit-0.9.0/.gitignore ADDED
@@ -0,0 +1,43 @@
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *.pyo
5
+ *.pyd
6
+ *.so
7
+ *.egg
8
+ *.egg-info/
9
+ dist/
10
+ build/
11
+ .eggs/
12
+ .venv/
13
+ venv/
14
+ env/
15
+
16
+ # uv
17
+ .uv/
18
+
19
+ # Secrets / config (never commit these)
20
+ .env
21
+ .env.*
22
+ !.env.example
23
+
24
+ # Scratch debug scripts (local, one-off API/bundle exploration)
25
+ debug_*.py
26
+
27
+ # IDE / OS
28
+ .idea/
29
+ .vscode/
30
+ *.swp
31
+ *.swo
32
+ .DS_Store
33
+ Thumbs.db
34
+
35
+ # Textual / Rich snapshots
36
+ *.svg
37
+ # ...but not the project's own artwork (README logo)
38
+ !docs/assets/*.svg
39
+
40
+ # Test / coverage
41
+ .coverage
42
+ .pytest_cache/
43
+ htmlcov/
@@ -0,0 +1,377 @@
1
+ # Changelog
2
+
3
+ All notable changes to qobit. Versions follow [semver](https://semver.org/);
4
+ while in 0.x, a minor bump means new features and a patch bump means fixes.
5
+
6
+ Releasing: bump `version` in `pyproject.toml` (the only place it lives), add
7
+ an entry here, `uv lock`, commit, then push the tag `vX.Y.Z`: the release
8
+ workflow publishes to PyPI and creates the GitHub release from this entry.
9
+
10
+ ## [0.9.0] - 2026-11-16
11
+
12
+ ### Added
13
+
14
+ - qobit is published on PyPI: `uv tool install qobit` (or `pipx install
15
+ qobit`). The README has macOS install steps.
16
+ - CI runs the tests on Python 3.11 and 3.13, on Linux and macOS.
17
+
18
+ ## [0.8.0] - 2026-11-16
19
+
20
+ ### Security
21
+
22
+ - **Email/password login removed.** It saved the password in plaintext in
23
+ `config.json`, sent it in a request URL, and couldn't stream anyway. qobit
24
+ logs in through the browser only (`qobit auth`); a password an older qobit
25
+ saved is deleted at startup, with a notice. `QOBUZ_EMAIL` /
26
+ `QOBUZ_PASSWORD` are no longer read.
27
+ - **Text from Qobuz can no longer drive the terminal.** Titles, names and
28
+ playlist descriptions (public playlists are written by other users) passed
29
+ escape sequences straight through: one could rewrite the clipboard (OSC
30
+ 52) or redraw the screen. Control characters are now stripped from every
31
+ API response, error message and saved state file.
32
+ - The session token travels in a request header, never in the URL (URLs end
33
+ up in logs).
34
+ - The stream URL (signed, naming the account) no longer appears in mpv's
35
+ command line, which any local user can read: mpv reads it from a private
36
+ playlist file, deleted when playback stops.
37
+ - A crash screen no longer shows the session token: Textual prints local
38
+ variables there, and credentials are now masked in them.
39
+ - The cover-art cache (a record of what was played) is readable only by
40
+ you.
41
+ - **The session token lives in the system keyring**: the macOS Keychain, or
42
+ the Secret Service on Linux (GNOME Keyring, KWallet). `config.json` keeps
43
+ only a marker. Without a keyring (headless Linux, SSH) the token stays in
44
+ `config.json`; `QOBIT_KEYRING=0` forces that. A token already in the file
45
+ moves to the keyring at the next start. `qobit auth status` says where it
46
+ is.
47
+ - `config.json` (the session token) and the files in `~/.local/share/qobit`
48
+ are written 0600 from the first byte, in 0700 directories. Before, the
49
+ token was briefly world-readable on every settings change (and stayed so
50
+ if the chmod failed), and the mpv control socket's folder relied on the
51
+ umask. Existing files and folders are tightened at startup.
52
+ - The browser login's local server listens on loopback only, on a port
53
+ picked as it binds, and takes one code. Each login's return address has a
54
+ random path, and a code is taken only there, so another web page or
55
+ program can't log qobit into a different account.
56
+
57
+ ### Added
58
+
59
+ - **Log in inside qobit.** Without a session, or when it expires, qobit opens
60
+ a login dialog instead of failing in every tab: the link (copy with `c`,
61
+ open with `o`, or click it), a field for the address the browser ends on,
62
+ and your queue kept. `^p` → *Log in to Qobuz* / *Log out of Qobuz*.
63
+ - `qobit auth status` (who is logged in, and whether the session still
64
+ works).
65
+ - **Logging out erases the account from this machine** (`qobit logout`, or
66
+ `^p` → *Log out of Qobuz*): the session, queue and history, last track,
67
+ mixes and cached covers, and in a running qobit the library and queue on
68
+ screen. Settings stay; `qobit logout --all` removes them too. A different
69
+ account logging in after an expiry gets a clean slate as well.
70
+ - Log in from a machine without a browser (SSH, a headless box): open the
71
+ link anywhere, then paste the address the browser ends on into
72
+ `qobit auth`. The login now waits 5 minutes instead of 2.
73
+
74
+ ### Changed
75
+
76
+ - `qobit auth` always prints the login link, so it can be opened by hand
77
+ when the browser doesn't come up. Without a display (SSH, a console) qobit
78
+ no longer tries to open a browser, which could start a text browser in the
79
+ terminal.
80
+ - A login code Qobuz rejects (expired, already used) gets a plain message.
81
+
82
+ ## [0.7.0] - 2026-11-16
83
+
84
+ ### Added
85
+
86
+ - A **bit-perfect lamp** on the transport bar and the Now Playing panel: a
87
+ couple of seconds into each track qobit checks mpv's output and, on Linux,
88
+ the rate and format the DAC actually runs at (catching a sound server that
89
+ resamples behind mpv). `◉ BIT-PERFECT`, or what differs:
90
+ `◌ RESAMPLED 96 → 48 kHz`, `◌ REDUCED 24 → 16-BIT`, `◌ SOFTWARE VOLUME 80%`.
91
+ - `HI-RES` tag for streams and albums above CD quality, in its own theme
92
+ colour (magenta in cyberdeck, blue in Ayu), on the transport bar, the Now
93
+ Playing panel, album cards and the album page.
94
+ - The playing track's `▶` becomes a small animated bar meter while it plays.
95
+ - Covers show a tile with the artist's or album's initials while they load,
96
+ or when there's no image.
97
+ - A `◢◤ qobit` wordmark at the right of the tab bar (from 102 columns).
98
+
99
+ ### Changed
100
+
101
+ - Pages (an album, artist or playlist opened from Search, `g`, `i` or Similar)
102
+ keep the tab bar, with the tab they came from lit, and show the whole trail
103
+ (`Search › Mogwai › Mr. Beast`) instead of one `← back` label. Click any
104
+ part to go back there; Escape goes up one level. The Albums and Artists
105
+ tabs' inline details use the same trail.
106
+ - The progress bar moves smoothly (an eighth of a cell at a time); in
107
+ cyberdeck it's a cyan-to-magenta gradient.
108
+ - Panel titles are uppercase readouts (`FAVOURITE ALBUMS`), like the queue's
109
+ section dividers.
110
+ - Library grids fit more tiles: 3 columns at 120 terminal columns (was 2).
111
+ - The cyberdeck theme has three colour roles: cyan chrome, neon pink for
112
+ signal (HI-RES, hearts) and amber LED readouts (the transport's status and
113
+ time, the footer keys). Muted text is tinted cyan and easier to read
114
+ (10.7:1), the selection tint is lighter so pink and muted text stay
115
+ readable on it, and the violet secondary is brighter.
116
+ - The Now Playing panel's genre/label line, the playing row's album line, the
117
+ playlist card date and the mix track count are easier to read in every theme.
118
+ - Track rows line up: the title and the album line start in the same column
119
+ in every list, and the playing row's ▶/⏸ takes the place of its number or
120
+ `♪` instead of pushing the row to the right.
121
+ - Long album names end in `…` instead of wrapping onto the next row.
122
+ - The footer shows only the keys that apply: `esc Back` when there's somewhere
123
+ to go back to, no Sort/Filter while an album or artist is open, and `-`/`=`
124
+ only once software volume is turned on.
125
+ - When a track ends, a list's cursor follows playback only if it was on the
126
+ playing track, so browsing a list (or Up Next) no longer loses your place.
127
+ - The Now Playing panel shows the stream's resolution, and its lines no longer
128
+ wrap.
129
+ - Resolution is written the same way everywhere (`24-BIT · 96 kHz`), and
130
+ separators are ` · ` throughout.
131
+ - Album and playlist panels are titled "Album" / "Playlist" instead of repeating
132
+ the name shown right below.
133
+ - The Playback list updates in place when a track ends or the queue changes,
134
+ instead of being cleared and rebuilt: no flicker, and the scroll position
135
+ stays.
136
+ - Empty, loading and error states look the same in every tab; tabs show
137
+ "loading…" while they fetch.
138
+
139
+ ### Fixed
140
+
141
+ - With the theme background off, the cursor on the playing track lost its
142
+ highlight and its text turned the selection's text colour on the bare
143
+ terminal (black on black in `ansi-dark`). The playing row now highlights
144
+ like any other.
145
+ - Readability across all 25 themes (checked automatically in both background
146
+ modes): unfocused panel titles, inactive tabs, secondary text, the album
147
+ page's details, the transport's album line, the bit-perfect lamp and the
148
+ footer were too faint in many themes (down to 1.0:1: Solarized Light's
149
+ footer, and light themes' muted text with the background off). Secondary
150
+ text now uses a colour qobit checks per theme, and everything reads at
151
+ 4.5:1 or better except a few of the themes' own colours.
152
+ - On the Mixes tab, Space opened the focused mix instead of pausing (and
153
+ `space Pause` was missing from the footer there). `Enter` opens a mix.
154
+ - On short terminals the Now Playing panel's cover pushed the resolution and
155
+ the bit-perfect lamp out of view: the cover now shrinks to fit, and hides
156
+ when there's no room for it.
157
+ - After switching theme, the bit-perfect lamp and the transport readout kept
158
+ the previous theme's colours until the next track.
159
+ - A selected row, card or menu option is readable in every theme. Its text
160
+ was the accent on an accent tint, unreadable in most of Textual's themes
161
+ and every light one, and in ANSI themes (`ansi-dark`) the same colour as
162
+ its background. qobit now picks the selection's text colour per theme by
163
+ measuring contrast (ANSI themes use their own cursor colours), and
164
+ everything on a selection, hearts and HI-RES included, takes it. The
165
+ playing row, hearts and HI-RES also stay readable on light themes.
166
+ - Backgrounds are consistent: no page section paints one (the album and
167
+ artist headers, the footer, the search box, scrollbar tracks and cover
168
+ placeholders did, some only with the theme background on, some even with
169
+ it off). Panels are set apart by their borders; the only fills left are the
170
+ selection, the now-playing row and the `i`/`g` menu, the same in both modes.
171
+ - `1`–`7` on an album, artist or playlist page switched the hidden tab under
172
+ it, so Escape then landed somewhere unexpected. They now close the page and
173
+ switch tab.
174
+ - The playlist page's panel sat one column inside the transport bar.
175
+ - Album names, artist names and titles containing `[…]` lost that part (it was
176
+ read as markup) in list rows, breadcrumbs and the Now Playing panel.
177
+
178
+ ## [0.6.0] - 2026-11-15
179
+
180
+ ### Added
181
+
182
+ - The artist page shows **Your favourites**: your favourite tracks by that
183
+ artist, next to Top Tracks. Side by side on wide terminals; on narrower ones
184
+ they share a panel; `t` or a click on the panel title switches. Hidden when
185
+ you have none.
186
+ - Similar artists on the artist page: in the Albums & EPs panel (`t` or a
187
+ click on the panel title switches), and as a short list beside the bio from
188
+ 128 columns. `♥` marks artists you follow.
189
+ - The `i` and `g` menus wrap around: up on the first option goes to the last.
190
+
191
+ ### Changed
192
+
193
+ - Panels with two views name both in the title, the shown one underlined;
194
+ click a name, or press `t`, to switch.
195
+
196
+ ### Fixed
197
+
198
+ - Opening the `i` or `g` menu (or the command palette) shifted the whole
199
+ screen behind it one column to the right, and hid every image behind it.
200
+ The page behind a menu is no longer dimmed.
201
+ - Artists Qobuz has no photo for (about 1 in 10, e.g. Besso0) showed an empty
202
+ tile. They now show the cover of their newest release, in the Artists tab
203
+ and on the artist page.
204
+ - An album or artist sent with a missing (null) field could fail to load.
205
+
206
+ ## [0.5.0] - 2026-11-15
207
+
208
+ ### Added
209
+
210
+ - The `i` menu works on whatever is highlighted, not just track rows:
211
+ - tracks: add to / remove from favourites;
212
+ - albums (Albums tab, an artist's albums, Search, an open album page): add
213
+ to / remove from favourites;
214
+ - artists (Artists tab, Search, an open artist page): follow / unfollow.
215
+ - Ayu themes: Ayu Dark, Ayu Mirage and Ayu Light.
216
+ - Mixes: the DailyQ and WeeklyQ cards can be reached from the keyboard (`Tab`,
217
+ `←` `→`, `Enter` to open, `↓` to the tracks).
218
+ - A logo, and a short CONTRIBUTING guide.
219
+
220
+ ### Changed
221
+
222
+ - Visual pass: every border and divider is rounded, one accent colour
223
+ throughout, one selection style for lists and grids. Lists no longer show a
224
+ lighter box behind them when the background isn't transparent.
225
+ - The breadcrumb on a page opened with `g` or `i` names the page you came
226
+ from (the album or artist you were on, or the tab).
227
+ - Tab subtitles show how many items there are (`↓ Date Added · 700`).
228
+ - Plainer documentation, a Terminal section in the README (images need the
229
+ Kitty graphics protocol), a clearer disclaimer, and new screenshots.
230
+ - `LICENSE` now holds the full GPL-3.0 text.
231
+ - Minimum dependencies match what qobit needs: Textual 8.2, textual-image 0.12.
232
+
233
+ ### Fixed
234
+
235
+ - Tracks, Artists, Albums and Playlists stopped at 200 items, so the oldest
236
+ favourites couldn't be reached. Long lists now load more as you scroll, and
237
+ `End` goes to the real last item.
238
+ - Artist pages showed at most 100 releases and playlists at most 500 tracks.
239
+ - qobit closed itself on a network error, e.g. a search while offline.
240
+ - "Go to album" did nothing for tracks started from an album page.
241
+ - Album and artist pages opened with `g` or `i` sometimes had no artist info
242
+ or albums.
243
+ - Cover art was missing for the paused track restored after a restart.
244
+ - Picking two tracks quickly could play the first while the queue showed the
245
+ second.
246
+ - Quickly opening one artist after another could mix their top tracks, and a
247
+ previous track's cover could stay on screen.
248
+ - One failed favourites load at startup hid every favourite heart until
249
+ restart.
250
+ - After `End` on a long Tracks list, the next tab could stay empty.
251
+
252
+ ## [0.4.0] - 2026-11-14
253
+
254
+ ### Added
255
+
256
+ - `g` opens a small popup to go to the artist or album of the track that's
257
+ playing. It also works on the paused track restored after a restart.
258
+
259
+ ### Changed
260
+
261
+ - Documentation rewritten: a shorter README, with the detail moved to
262
+ `docs/usage.md` (every key, each tab) and `docs/audio.md` (bit-perfect setup,
263
+ quality, verification). New logo.
264
+
265
+ ### Fixed
266
+
267
+ - CI installs the system headers that PyGObject and pycairo build against
268
+ (required for Linux media keys since 0.1.x), so lint and tests run again.
269
+
270
+ ## [0.3.0] - 2026-11-14
271
+
272
+ ### Added
273
+
274
+ - Qobuz Connect phase 2: while qobit is the active Connect device, you can
275
+ also edit the queue in qobit (play from the library, play next, add to queue,
276
+ remove, clear, song radio with `R`). Changes go through Qobuz, so qobit and
277
+ the app show the same queue.
278
+ - The Queue tab is now called Playback. It's the first tab and qobit opens on
279
+ it. Tabs show their key: `[1] Playback`, `[2] Tracks` … `[7] Search`
280
+ (`1 Playback` below 90 columns).
281
+ - The queue is saved: history, current track and Up Next are restored on
282
+ launch, paused where you left off.
283
+
284
+ ### Fixed
285
+
286
+ - Albums, Artists and Playlists tiles are the same, slightly smaller size, and
287
+ playlist covers are sharp (qobit used 50 px thumbnails).
288
+ - One selection style for all three grids. With a transparent background, the
289
+ selection tint was hidden behind the card's text. This was probably the
290
+ cause of the long-standing "selection looks wrong" issue.
291
+ - Qobuz Connect: a second qobit on the same computer no longer removes the
292
+ first from the apps' device list. Only one can have Connect on, and qobit
293
+ rejoins by itself if its registration is dropped.
294
+
295
+ ## [0.2.2] - 2026-11-14
296
+
297
+ ### Fixed
298
+
299
+ - Qobuz Connect: the Qobuz apps showed "unknown quality" while qobit played.
300
+ qobit now reports the real stream format (sample rate, bit depth, CD/Hi-Res
301
+ level) on every track; file and device format are the same, since output
302
+ is bit-perfect.
303
+
304
+ ## [0.2.1] - 2026-11-14
305
+
306
+ ### Fixed
307
+
308
+ - A track could be skipped right after a stop-and-restart (e.g. changing
309
+ track): stopping mpv could be mistaken for the track ending naturally.
310
+ - Qobuz Connect: when a remote control moved playback to qobit and started
311
+ music in one go, the track could restart and then pause.
312
+
313
+ ## [0.2.0] - 2026-11-14
314
+
315
+ ### Added
316
+
317
+ - Qobuz Connect (phase 1, opt-in). qobit appears in the Qobuz apps' device
318
+ picker; pick it there to control qobit from the app, while qobit plays
319
+ bit-perfect through mpv. Enable from the command palette (saved)
320
+ or for one run with `qobit --connect-on`. The transport bar shows
321
+ `[ ⇄ CONNECT ]` / `[ ⇄ CONNECT · ACTIVE ]`.
322
+ - Play, pause, seek, skip and picking songs/albums/playlists from the app;
323
+ the Queue tab mirrors the app's queue, including edits made in the app.
324
+ - Local control keeps working while active (space, seek, previous/next,
325
+ media keys, selecting a Queue row) and is reflected in the app.
326
+ - Editing the queue in qobit while it's active isn't supported yet
327
+ (phase 2); qobit shows a message instead.
328
+ - The app's volume control is ignored on purpose (bit-perfect).
329
+ - When another device takes over, qobit keeps the queue as its own, paused.
330
+ - Unofficial: speaks the community-documented protocol
331
+ (`docs/qobuz-connect.md`).
332
+
333
+ ### Changed
334
+
335
+ - Queue/timeline writes go through a play-context layer
336
+ (`ui/play_context.py`); local behaviour is unchanged.
337
+ - New dependencies: `protobuf`, `websockets`.
338
+
339
+ ## [0.1.1] - 2026-11-14
340
+
341
+ ### Fixed
342
+
343
+ - Tracks the account can't stream are no longer played as 30-second MP3
344
+ previews. Qobuz returns the preview at every quality, so the fallback chain
345
+ used to accept it silently, breaking the bit-perfect FLAC guarantee. The TUI
346
+ now shows "Not streamable (preview only)" and skips to the next track;
347
+ `qobit play` exits with an error.
348
+
349
+ ## [0.1.0] - 2026-11-14
350
+
351
+ Baseline release, tagged retroactively: everything built before qobit had
352
+ releases (development phases 1–9).
353
+
354
+ - Bit-perfect playback through mpv: exclusive `hw:` ALSA / PipeWire
355
+ rate-following on Linux, CoreAudio exclusive mode on macOS, post-play
356
+ rate/format verification. Opt-in software volume, off by default.
357
+ - Textual TUI: Tracks (sortable, filterable), Artists and Albums grids with
358
+ inline detail, Playlists, Search, Queue with Now Playing hero.
359
+ - Timeline + cursor queue: skip back and forth without dropping tracks, play
360
+ next / add to queue / remove, per-track context menu (`i`).
361
+ - Qobuz song radio and endless radio; DailyQ / WeeklyQ mixes.
362
+ - Favourites with heart glyphs across all track lists.
363
+ - OS media controls: macOS Now Playing, Linux MPRIS2, with artwork.
364
+ - Kitty-protocol cover art with on-disk cache; themes incl. the qobit theme,
365
+ transparent background.
366
+ - Session restore (last track + position).
367
+ - CLI: `play`, `auth`, `devices`, `set-device`, `clear-cache`.
368
+
369
+ [0.6.0]: https://github.com/pierdom/qobit/releases/tag/v0.6.0
370
+ [0.5.0]: https://github.com/pierdom/qobit/releases/tag/v0.5.0
371
+ [0.4.0]: https://github.com/pierdom/qobit/releases/tag/v0.4.0
372
+ [0.3.0]: https://github.com/pierdom/qobit/releases/tag/v0.3.0
373
+ [0.2.2]: https://github.com/pierdom/qobit/releases/tag/v0.2.2
374
+ [0.2.1]: https://github.com/pierdom/qobit/releases/tag/v0.2.1
375
+ [0.2.0]: https://github.com/pierdom/qobit/releases/tag/v0.2.0
376
+ [0.1.1]: https://github.com/pierdom/qobit/releases/tag/v0.1.1
377
+ [0.1.0]: https://github.com/pierdom/qobit/releases/tag/v0.1.0