noneto-cli 1.1.1__py3-none-any.whl

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 (59) hide show
  1. noneto/__init__.py +1 -0
  2. noneto/__main__.py +3 -0
  3. noneto/app.py +113 -0
  4. noneto/assets/noneto.ico +0 -0
  5. noneto/audio/__init__.py +1 -0
  6. noneto/audio/controller.py +427 -0
  7. noneto/audio/inspector.py +21 -0
  8. noneto/audio/ipc_unix.py +29 -0
  9. noneto/audio/ipc_windows.py +94 -0
  10. noneto/audio/lifetime.py +68 -0
  11. noneto/audio/media_controls.py +107 -0
  12. noneto/audio/mpv_install.py +71 -0
  13. noneto/audio/player.py +222 -0
  14. noneto/audio/pulse_tap.py +120 -0
  15. noneto/audio/spectrum.py +44 -0
  16. noneto/audio/streams.py +101 -0
  17. noneto/audio/tap.py +208 -0
  18. noneto/audio/windows_identity.py +79 -0
  19. noneto/audio/windows_media.py +157 -0
  20. noneto/auth/__init__.py +1 -0
  21. noneto/auth/dpapi.py +28 -0
  22. noneto/auth/service.py +53 -0
  23. noneto/auth/storage.py +120 -0
  24. noneto/diagnostics.py +115 -0
  25. noneto/errors.py +12 -0
  26. noneto/i18n.py +199 -0
  27. noneto/platform/__init__.py +1 -0
  28. noneto/platform/paths.py +27 -0
  29. noneto/security.py +59 -0
  30. noneto/services/__init__.py +1 -0
  31. noneto/services/covers.py +88 -0
  32. noneto/services/executor.py +83 -0
  33. noneto/services/library.py +110 -0
  34. noneto/services/tidal.py +188 -0
  35. noneto/settings.py +48 -0
  36. noneto/state/__init__.py +1 -0
  37. noneto/state/queue.py +130 -0
  38. noneto/state/writer.py +38 -0
  39. noneto/ui/__init__.py +1 -0
  40. noneto/ui/common.py +36 -0
  41. noneto/ui/cover.py +88 -0
  42. noneto/ui/dialogs.py +107 -0
  43. noneto/ui/linux_login.py +57 -0
  44. noneto/ui/login_window.py +201 -0
  45. noneto/ui/lyrics.py +142 -0
  46. noneto/ui/player.py +172 -0
  47. noneto/ui/quality.py +75 -0
  48. noneto/ui/queue.py +34 -0
  49. noneto/ui/terminal.py +65 -0
  50. noneto/ui/themes.py +352 -0
  51. noneto/ui/top.py +39 -0
  52. noneto/ui/tracks.py +139 -0
  53. noneto/ui/tui.py +601 -0
  54. noneto/ui/visualizer.py +343 -0
  55. noneto_cli-1.1.1.dist-info/METADATA +222 -0
  56. noneto_cli-1.1.1.dist-info/RECORD +59 -0
  57. noneto_cli-1.1.1.dist-info/WHEEL +4 -0
  58. noneto_cli-1.1.1.dist-info/entry_points.txt +2 -0
  59. noneto_cli-1.1.1.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,343 @@
1
+ """Track aura: the cava-style spectrum under the lyrics, fed by the FFT of mpv's own output.
2
+
3
+ The playback side captures only mpv (process loopback) and returns raw band
4
+ amplitudes. Here they get cava's treatment: automatic sensitivity, a little
5
+ smoothing and gravity on the way down, plus a pluggable mode registry so people
6
+ and agents can register custom visualizer effects in one function.
7
+ """
8
+ import inspect
9
+ import time
10
+
11
+ from rich.segment import Segment
12
+ from rich.style import Style
13
+ from textual.message import Message
14
+ from textual.geometry import Region
15
+ from textual.strip import Strip
16
+ from textual.widget import Widget
17
+
18
+ from .themes import NAME_PATTERN, VISUALIZER_STOPS, gradient
19
+
20
+ BLOCKS = " ▁▂▃▄▅▆▇█"
21
+ FLAME = "░▒▓█" # tip to body
22
+ L_BITS = (0x01, 0x02, 0x04, 0x40)
23
+ R_BITS = (0x08, 0x10, 0x20, 0x80)
24
+ FPS = 30
25
+ SMOOTHING = 0.45 # share of the new frame; the rest is the previous one (cava's noise reduction)
26
+ GRAVITY = 4.0 # height units per second squared on the way down
27
+ PEAK_GRAVITY = 1.15 # slower gravity for floating peak-hold caps
28
+ SILENCE = 1e-12
29
+ MIRROR_CURVE = 0.7 # below 1 lifts quiet bands so the mirror spreads further
30
+ LYRICS_MIN_ROWS = 10 # the visualizer only takes rows the lyrics can spare
31
+ VISUALIZER_ROWS = (4, 10)
32
+ CSS = """
33
+ #visualizer { height: 6; padding: 0 1; color: $foreground; }
34
+ """
35
+
36
+
37
+ class CavaBars:
38
+ """Bar heights and floating peak-hold caps in [0, 1]."""
39
+
40
+ def __init__(self, count):
41
+ self.heights = [0.0] * count
42
+ self.peaks = [0.0] * count
43
+ self._memory = [0.0] * count
44
+ self._crests = [0.0] * count
45
+ self._falling = [0.0] * count
46
+ self._peak_crests = [0.0] * count
47
+ self._peak_falling = [0.0] * count
48
+ self.sensitivity = 1.0
49
+ self._settled = False
50
+
51
+ def resize(self, count):
52
+ if count != len(self.heights):
53
+ sensitivity, settled = self.sensitivity, self._settled
54
+ self.__init__(count)
55
+ self.sensitivity, self._settled = sensitivity, settled
56
+
57
+ def step(self, raw, dt):
58
+ count = len(self.heights)
59
+ if not isinstance(raw, (list, tuple)) or len(raw) != count:
60
+ raw = [0.0] * count
61
+ loud = max(raw, default=0.0) > SILENCE
62
+ values = []
63
+ for index, amplitude in enumerate(raw):
64
+ value = self._memory[index] * (1 - SMOOTHING) + amplitude * self.sensitivity * SMOOTHING
65
+ self._memory[index] = value
66
+ values.append(value)
67
+ # Automatic sensitivity: back off fast when bars clip, creep up while they don't.
68
+ if max(values, default=0.0) > 1:
69
+ self.sensitivity *= 0.97
70
+ self._settled = True
71
+ elif loud:
72
+ self.sensitivity *= 1.003 if self._settled else 1.1
73
+ self.sensitivity = max(1e-3, min(1e9, self.sensitivity))
74
+ for index, value in enumerate(values):
75
+ value = min(1.0, value)
76
+ if value >= self.heights[index]:
77
+ self.heights[index] = self._crests[index] = value
78
+ self._falling[index] = 0.0
79
+ else:
80
+ self._falling[index] += dt
81
+ drop = GRAVITY * self._falling[index] ** 2
82
+ self.heights[index] = max(value, self._crests[index] - drop)
83
+
84
+ height = self.heights[index]
85
+ if height >= self.peaks[index]:
86
+ self.peaks[index] = self._peak_crests[index] = height
87
+ self._peak_falling[index] = 0.0
88
+ else:
89
+ self._peak_falling[index] += dt
90
+ peak_drop = PEAK_GRAVITY * self._peak_falling[index] ** 2
91
+ self.peaks[index] = max(height, self._peak_crests[index] - peak_drop)
92
+ return self.heights
93
+
94
+
95
+ def render_bars(heights, width, rows, bar=1, gap=1):
96
+ """Draw classic bars bottom-up with eighth blocks; returns `rows` lines of `width` cells."""
97
+ levels = [round(height * rows * 8) for height in heights]
98
+ spacer = " " * gap
99
+ lines = []
100
+ for row in range(rows):
101
+ floor = (rows - 1 - row) * 8
102
+ line = "".join(BLOCKS[min(8, max(0, level - floor))] * bar + spacer for level in levels)
103
+ lines.append(line[:width].ljust(width))
104
+ return lines
105
+
106
+
107
+ def _braille(rows, row, left, right):
108
+ """One Braille cell of `row`: dots lit where `left`/`right` say so, counted from the bottom."""
109
+ mask = 0
110
+ for dot in range(4):
111
+ dot_from_bottom = (rows - 1 - row) * 4 + (3 - dot)
112
+ if left(dot_from_bottom):
113
+ mask |= L_BITS[dot]
114
+ if right(dot_from_bottom):
115
+ mask |= R_BITS[dot]
116
+ return chr(0x2800 + mask)
117
+
118
+
119
+ def _halves(heights):
120
+ """Each bar and the midpoint to its right neighbor: the two dot columns of a Braille cell."""
121
+ last = len(heights) - 1
122
+ return [(height, (height + heights[min(last, index + 1)]) * 0.5) for index, height in enumerate(heights)]
123
+
124
+
125
+ def render_braille(heights, peaks, width, rows):
126
+ """Draw a high-resolution 2×4 Braille dot spectrum interpolated across neighboring bands."""
127
+ total_dots = rows * 4
128
+ levels = [(round(left * total_dots), round(right * total_dots)) for left, right in _halves(heights)]
129
+ lines = []
130
+ for row in range(rows):
131
+ cells = [_braille(rows, row, lambda dot, top=left: dot < top, lambda dot, top=right: dot < top) + " "
132
+ for left, right in levels]
133
+ lines.append("".join(cells)[:width].ljust(width))
134
+ return lines
135
+
136
+
137
+ def render_mirror(heights, peaks, width, rows):
138
+ """Draw a symmetric Braille wave that grows up and down from the middle row."""
139
+ total_dots = rows * 4
140
+ middle = total_dots / 2
141
+ # A softer curve than the bars so quiet passages still reach well above and below the middle.
142
+ spans = [(round(left ** MIRROR_CURVE * middle), round(right ** MIRROR_CURVE * middle))
143
+ for left, right in _halves(heights)]
144
+ lines = []
145
+ for row in range(rows):
146
+ cells = [_braille(rows, row, lambda dot, span=left: abs(dot + 0.5 - middle) < span,
147
+ lambda dot, span=right: abs(dot + 0.5 - middle) < span) + " "
148
+ for left, right in spans]
149
+ lines.append("".join(cells)[:width].ljust(width))
150
+ return lines
151
+
152
+
153
+ def render_flame(heights, peaks, width, rows):
154
+ """Draw solid bars that thin into shade toward the top (`█▓▒░`), like a flame."""
155
+ lines = []
156
+ for row in range(rows):
157
+ base = rows - 1 - row
158
+ cells = []
159
+ for height in heights:
160
+ depth = height * rows - base # how far the bar's tip is above this cell's bottom
161
+ if height * rows < 0.15 or depth <= 0:
162
+ cells.append(" ")
163
+ else:
164
+ cells.append(FLAME[min(3, int(depth))] + " ")
165
+ lines.append("".join(cells)[:width].ljust(width))
166
+ return lines
167
+
168
+
169
+ def _adapt_renderer(fn):
170
+ """Allow custom mode functions with `(heights, width, rows)` or `(heights, peaks, width, rows)`."""
171
+ try:
172
+ sig = inspect.signature(fn)
173
+ required = sum(
174
+ 1 for p in sig.parameters.values()
175
+ if p.default is inspect.Parameter.empty
176
+ and p.kind in (inspect.Parameter.POSITIONAL_ONLY, inspect.Parameter.POSITIONAL_OR_KEYWORD)
177
+ )
178
+ except (TypeError, ValueError):
179
+ required = 4
180
+ if required == 3:
181
+ return lambda heights, _peaks, width, rows: fn(heights, width, rows)
182
+ return fn
183
+
184
+
185
+ VISUALIZER_MODES_REGISTRY = {
186
+ "classic": lambda heights, _peaks, width, rows: render_bars(heights, width, rows),
187
+ "braille": render_braille,
188
+ "mirror": render_mirror,
189
+ "flame": render_flame,
190
+ }
191
+
192
+ VISUALIZER_MODES = tuple(VISUALIZER_MODES_REGISTRY)
193
+ # Names shown to people (translated by the caller); custom modes show their own id.
194
+ MODE_LABELS = {"classic": "Classic", "braille": "Braille", "mirror": "Mirror", "flame": "Flame"}
195
+
196
+
197
+ def register_visualizer_mode(name, fn=None):
198
+ """Register a custom visualizer effect in Noneto CLI (usable as a function or `@decorator`).
199
+
200
+ The renderer receives `(heights, peaks, width, rows)` (or `(heights, width, rows)`) where
201
+ `heights` and `peaks` are lists of floats in `[0.0, 1.0]` of length `bar_count(width)`,
202
+ and must return a list of `rows` strings (each padded/clipped to `width` cells).
203
+ """
204
+ if not isinstance(name, str) or not NAME_PATTERN.match(name):
205
+ raise ValueError(f"Invalid visualizer mode name: {name!r}")
206
+
207
+ def _register(renderer):
208
+ global VISUALIZER_MODES
209
+ if not callable(renderer):
210
+ raise TypeError("Visualizer mode renderer must be callable")
211
+ VISUALIZER_MODES_REGISTRY[name] = _adapt_renderer(renderer)
212
+ if name not in VISUALIZER_MODES:
213
+ VISUALIZER_MODES = (*VISUALIZER_MODES, name)
214
+ return renderer
215
+
216
+ return _register(fn) if fn is not None else _register
217
+
218
+
219
+ def available_visualizer_modes() -> tuple[str, ...]:
220
+ """Return the registered visualizer mode names in cycle order."""
221
+ return VISUALIZER_MODES
222
+
223
+
224
+ def render_mode(mode, heights, peaks, width, rows):
225
+ """Render `mode` into `rows` lines of exact `width` cells."""
226
+ renderer = VISUALIZER_MODES_REGISTRY.get(mode) or VISUALIZER_MODES_REGISTRY["classic"]
227
+ raw_lines = renderer(heights, peaks, width, rows)
228
+ return [str(line)[:width].ljust(width) for line in list(raw_lines)[:rows]] + [" " * width] * max(0, rows - len(raw_lines))
229
+
230
+
231
+ def bar_count(width):
232
+ return max(1, (width + 1) // 2)
233
+
234
+
235
+ class Visualizer(Widget):
236
+ """Animates only while running; `source(count)` returns band amplitudes or None.
237
+
238
+ Uses the line API: each frame is plain strings, so Textual neither wraps text
239
+ nor re-lays out the screen. Measured headless at 120x38 with 10 rows: 31.7% of a
240
+ core with Static.update, 17.8% without layout, 15.1% with the line API.
241
+ """
242
+
243
+ class Clicked(Message):
244
+ """Posted when the user clicks the visualizer to cycle the effect mode."""
245
+
246
+ def __init__(self, source, mode="classic", **kwargs):
247
+ super().__init__(**kwargs)
248
+ self._source = source
249
+ self.mode = mode if mode in VISUALIZER_MODES_REGISTRY else "classic"
250
+ self._bars = CavaBars(0)
251
+ self._lines = []
252
+ self._timer = None
253
+ self._last = time.monotonic()
254
+ self._palette_key = None
255
+ self._styles = []
256
+ self._frame_key = None
257
+
258
+ def notify_style_update(self):
259
+ super().notify_style_update()
260
+ self._palette_key = None
261
+ self._frame_key = None
262
+
263
+ def _present(self, lines):
264
+ width, rows = self.content_size.width, self.content_size.height
265
+ key = (width, rows, self.mode, self.app.theme)
266
+ previous, self._lines = self._lines, lines
267
+ if key != self._frame_key:
268
+ self._frame_key = key
269
+ self.refresh()
270
+ else:
271
+ dirty = [Region(0, y, width, 1) for y, line in enumerate(lines)
272
+ if y >= len(previous) or line != previous[y]]
273
+ if dirty:
274
+ self.refresh(*dirty)
275
+
276
+ def set_mode(self, mode):
277
+ self.mode = mode if mode in VISUALIZER_MODES_REGISTRY else "classic"
278
+ width, rows = self.content_size.width, self.content_size.height
279
+ if width > 0 and rows > 0 and self._bars.heights:
280
+ self._present(render_mode(self.mode, self._bars.heights, self._bars.peaks, width, rows))
281
+
282
+ def on_click(self, event):
283
+ if event.button == 1:
284
+ self.post_message(self.Clicked())
285
+ event.stop()
286
+
287
+ @property
288
+ def running(self):
289
+ return self._timer is not None
290
+
291
+ def start(self):
292
+ if self._timer is None:
293
+ self._last = time.monotonic()
294
+ self._timer = self.set_interval(1 / FPS, self.tick)
295
+
296
+ def fit(self, area, wanted):
297
+ """Show only when wanted and the lyrics in `area` can spare the rows; returns whether it shows."""
298
+ rows = min(VISUALIZER_ROWS[1], area.height - LYRICS_MIN_ROWS)
299
+ show = wanted and rows >= VISUALIZER_ROWS[0] and area.width >= 40
300
+ self.display = show
301
+ if show:
302
+ self.styles.height = rows
303
+ self.start()
304
+ else:
305
+ self.stop()
306
+ return show
307
+
308
+ def stop(self):
309
+ if self._timer is not None:
310
+ self._timer.stop()
311
+ self._timer = None
312
+ self._lines = []
313
+ self._frame_key = None
314
+ self.refresh()
315
+
316
+ def bar_styles(self, count):
317
+ """One style per bar: the theme's gradient from left to right, recomputed on theme change."""
318
+ theme = self.app.theme
319
+ base = self.rich_style
320
+ if self._palette_key != (theme, count, base):
321
+ stops = VISUALIZER_STOPS.get(theme) or (self.app.current_theme.primary,)
322
+ self._styles = [base + Style(color=color) for color in gradient(stops, count)]
323
+ self._palette_key = (theme, count, base)
324
+ return self._styles
325
+
326
+ def render_line(self, y):
327
+ width = self.content_size.width
328
+ line = (self._lines[y] if y < len(self._lines) else "")[:width].ljust(width)
329
+ styles = self.bar_styles(bar_count(width))
330
+ # Each bar is one cell plus its gap, as drawn by render_mode.
331
+ segments = [Segment(line[index * 2:index * 2 + 2], style) for index, style in enumerate(styles)]
332
+ return Strip([segment for segment in segments if segment.text], width)
333
+
334
+ def tick(self):
335
+ now = time.monotonic()
336
+ dt, self._last = min(0.1, now - self._last), now
337
+ width, rows = self.content_size.width, self.content_size.height
338
+ if width <= 0 or rows <= 0:
339
+ return
340
+ count = bar_count(width)
341
+ self._bars.resize(count)
342
+ heights = self._bars.step(self._source(count), dt)
343
+ self._present(render_mode(self.mode, heights, self._bars.peaks, width, rows))
@@ -0,0 +1,222 @@
1
+ Metadata-Version: 2.4
2
+ Name: noneto-cli
3
+ Version: 1.1.1
4
+ Summary: Unofficial TIDAL client for the terminal.
5
+ Project-URL: Repository, https://github.com/VincentPelos/noneto-cli
6
+ Author: VincentPelos
7
+ License-Expression: MIT
8
+ License-File: LICENSE
9
+ Keywords: mpv,music,terminal,tidal,tui
10
+ Classifier: Operating System :: Microsoft :: Windows
11
+ Requires-Python: <3.13,>=3.12
12
+ Requires-Dist: certifi==2026.10.23
13
+ Requires-Dist: defusedxml==0.7.1
14
+ Requires-Dist: numpy==2.5.3
15
+ Requires-Dist: pillow==13.0.0
16
+ Requires-Dist: pywebview==6.2.1; sys_platform == 'win32'
17
+ Requires-Dist: requests==2.34.2
18
+ Requires-Dist: textual-image==0.14.1
19
+ Requires-Dist: textual==8.2.8
20
+ Requires-Dist: tidalapi==0.8.11
21
+ Requires-Dist: urllib3==2.8.0
22
+ Requires-Dist: winrt-runtime==3.2.1; sys_platform == 'win32'
23
+ Requires-Dist: winrt-windows-foundation==3.2.1; sys_platform == 'win32'
24
+ Requires-Dist: winrt-windows-media-interop==3.2.1; sys_platform == 'win32'
25
+ Requires-Dist: winrt-windows-media==3.2.1; sys_platform == 'win32'
26
+ Requires-Dist: winrt-windows-storage-streams==3.2.1; sys_platform == 'win32'
27
+ Provides-Extra: windows-test
28
+ Requires-Dist: winrt-windows-foundation-collections==3.2.1; (sys_platform == 'win32') and extra == 'windows-test'
29
+ Requires-Dist: winrt-windows-media-control==3.2.1; (sys_platform == 'win32') and extra == 'windows-test'
30
+ Description-Content-Type: text/markdown
31
+
32
+ <h1 align="center">
33
+ <picture>
34
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/noneto-logo-white.png">
35
+ <img alt="Noneto CLI" src="docs/assets/noneto-logo-black.png" width="440">
36
+ </picture>
37
+ </h1>
38
+
39
+ An unofficial TIDAL client for the terminal. This release supports Windows only. Linux support is still in development and is not enabled in this release. Search for songs, play your playlists,
40
+ create new ones, and follow lyrics with a cava-style track aura. Supports mouse and keyboard.
41
+ Built with Python 3.12, Textual, [`tidalapi`](https://github.com/EbbLabs/python-tidal), and mpv.
42
+ You need a TIDAL account with playback access.
43
+
44
+ > [!IMPORTANT]
45
+ > Noneto CLI is a free, personal, **unofficial** project. It is not affiliated with, associated
46
+ > with, or endorsed by TIDAL. TIDAL is a trademark of its respective owners.
47
+ >
48
+ > Noneto provides a terminal interface and connects your account to TIDAL through the unofficial
49
+ > `tidalapi` library. It does not operate TIDAL's service or develop or control its APIs.
50
+ > External changes may make features unavailable; future compatibility is not guaranteed.
51
+ > Noneto CLI streams music only: it does not download or save music, and it rejects encrypted
52
+ > streams rather than bypassing DRM.
53
+
54
+ ## Install
55
+
56
+ Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then:
57
+
58
+ ```powershell
59
+ uv tool install --python 3.12 noneto-cli
60
+ ```
61
+
62
+ Alternatively, install the same package directly from GitHub without Git:
63
+
64
+ ```powershell
65
+ uv tool install --python 3.12 https://github.com/VincentPelos/noneto-cli/releases/download/v1.1.1/noneto_cli-1.1.1-py3-none-any.whl
66
+ ```
67
+
68
+ Open a new terminal and run `noneto`. On the first launch, Noneto prepares mpv automatically
69
+ if it is missing, verifies the pinned SHA-256, and then continues to sign-in. A failed
70
+ download stops before sign-in; run `noneto` again to retry. Existing mpv installations are
71
+ reused. Installation does not ask for your TIDAL account. `noneto --install-mpv` remains
72
+ available for explicit preparation without signing in.
73
+
74
+ uv manages Python 3.12 and the isolated application environment. If `noneto` is not found,
75
+ run `uv tool update-shell` and open a new terminal. mpv remains in `%LOCALAPPDATA%\Noneto\mpv`.
76
+
77
+ ## Update and uninstall
78
+
79
+ ```powershell
80
+ uv tool upgrade noneto-cli
81
+ uv tool uninstall noneto-cli
82
+ Remove-Item -Recurse "$env:LOCALAPPDATA\Noneto" # optional: session, logs, and mpv
83
+ ```
84
+
85
+ ## Use
86
+
87
+ 1. On your first launch, a TIDAL sign-in window opens. Sign in and the window closes automatically.
88
+ Later launches restore your session.
89
+ 2. If the window cannot open because the renderer is unavailable, Noneto opens your browser.
90
+ TIDAL may finish on an "Oops" page; copy its address with Ctrl+L, Ctrl+C. Noneto detects it.
91
+ 3. Your first playlist opens.
92
+ 4. Click a song, or select it and press Enter. Playback continues through the remaining songs.
93
+
94
+ **Top bar:** **Library ▾** opens your own and favorite playlists, lets you create a playlist,
95
+ and refreshes the list. The search field and quality badge sit beside it.
96
+ During playback, the badge shows the audio mpv actually decodes, such as `◆ FLAC 24/96`.
97
+ Before playback, it shows the requested quality (`Requested: Hi-Res`). If TIDAL delivers less
98
+ than the track offers, the badge changes to `◇ … ↓` in a warning color. Hover over it to see
99
+ the requested quality, received quality, and available track tiers.
100
+
101
+ **Tabs:** **Songs** lists titles with artist and album below each one; `▷` marks the current song.
102
+ **Queue · N** lists upcoming songs. **Lyrics** shows cover art and lyrics, synchronized when
103
+ TIDAL provides timestamps. **Playlists** lists playlists found through search; click one or
104
+ press Enter to open its songs. **Library ▾** lets you switch to a playlist from your library.
105
+
106
+ **Cover art:** terminals with sixel graphics (Windows Terminal 1.22+, WezTerm, and others)
107
+ or the kitty graphics protocol show the actual image. Other terminals use colored half blocks.
108
+ Ctrl+O, or a click on the cover, switches the Lyrics tab between cover + lyrics and the cover
109
+ alone, large and centered; the choice is remembered. Songs without lyrics always show the large cover.
110
+
111
+ **Track aura:** spare rows in the Lyrics tab show a cava-style animation of the actual audio
112
+ played by Noneto, in four styles: classic bars, braille dots, a braille mirror that grows up and
113
+ down from the middle, and flame. Ctrl+G or a click changes it; the choice is remembered.
114
+ Capture is limited to mpv's process and runs only while the aura is
115
+ visible. Samples are never saved. Requires Windows 10 version 2004 or later.
116
+
117
+ **Selection and player:** **+ Queue** and **+ Playlist** add the selected song. The player shows
118
+ cover art, title, artist, album, shuffle, previous/play/pause/next controls, repeat modes
119
+ (off, queue, or one song), clickable volume, and a progress bar you can click to seek.
120
+ The queue persists between sessions, including duplicates, original/shuffled order, current song,
121
+ position, volume, and repeat mode. It restores paused until you press play. State is tied to the
122
+ account and excludes stream URLs. Position is saved every five seconds and on normal shutdown;
123
+ a forced exit may lose the last few seconds. Queue save failures are logged without stopping audio.
124
+
125
+ Shuffle keeps the current song and mixes only upcoming songs. Turning it off restores the
126
+ remaining songs to their original order. **+ Queue** always appends to the end. With repeat-all,
127
+ each new cycle is reshuffled and avoids starting with the same song that ended the previous
128
+ cycle when another song is available. Duplicate playlist entries are preserved.
129
+
130
+ Use a terminal with mouse support. The layout works at 80 × 24 and looks best at 100 × 28 or larger.
131
+
132
+ **Themes:** Ctrl+T cycles through nine palettes: noneto-dark, catppuccin-mocha, dracula,
133
+ tokyo-night, nord, rose-pine, flexoki, catppuccin-latte, and rose-pine-dawn. The track aura uses
134
+ the active theme's colors. Noneto remembers your last theme.
135
+
136
+ **Language:** English is the default on every Windows language setting. Use `--lang es` for
137
+ Spanish or `--lang en` for English. Playlist names, song metadata, and lyrics keep their original language.
138
+
139
+ **Windows media controls:** Noneto publishes the song, artist, album, cover art, and progress
140
+ to the system media session. It accepts play/pause, previous/next, and seek commands from the
141
+ system panel. Windows decides how that panel looks; audio remains in mpv.
142
+ Noneto creates a **Noneto CLI** Start menu shortcut to identify the application. After
143
+ uninstalling with uv, you can also delete that shortcut.
144
+
145
+ | Shortcut | Action |
146
+ | --- | --- |
147
+ | Ctrl+L | Open Library; choosing a playlist focuses its songs for arrow-key navigation |
148
+ | Ctrl+F | Focus search |
149
+ | Ctrl+N | Create a playlist |
150
+ | Enter in the song table | Play from the selected song |
151
+ | Space outside a text field | Play / pause |
152
+ | Ctrl+Right | Next song |
153
+ | Ctrl+T | Change theme |
154
+ | Ctrl+G | Change the track aura style |
155
+ | Ctrl+O | Lyrics tab: cover + lyrics or cover only |
156
+ | Ctrl+Q / Ctrl+C | Quit and stop audio |
157
+
158
+ ```powershell
159
+ noneto --playlist "https://tidal.com/browse/playlist/YOUR-PLAYLIST-UUID"
160
+ noneto # request Hi-Res FLAC, up to 24-bit / 192 kHz
161
+ noneto --quality LOSSLESS # cap the request at CD quality
162
+ noneto --quality HIGH # use less data (AAC 320 kbps)
163
+ noneto --lang es # use the Spanish interface
164
+ noneto --logout # delete the local session
165
+ ```
166
+
167
+ ## Privacy
168
+
169
+ - Noneto does not ask for or save your password. Tokens are encrypted with Windows DPAPI for
170
+ your user account and stored in `%LOCALAPPDATA%\Noneto\session.bin`. `--logout` deletes the
171
+ local session; it does not revoke the tokens at TIDAL.
172
+ - Music, lyrics, and cover art are not saved to disk.
173
+ - Logs in `%LOCALAPPDATA%\Noneto\logs\noneto.log` contain timestamps, track IDs, processing
174
+ stages, HTTP status codes, and timings. They exclude tokens, searches, signed URLs, and
175
+ audio, and remain on your computer.
176
+
177
+ ## Scope and limitations
178
+
179
+ Noneto CLI provides the client interface, controls, and local integration. The catalog,
180
+ audio availability, and account access depend on TIDAL and the interfaces used by `tidalapi`.
181
+ Noneto does not provide a music service or access independent of your TIDAL account.
182
+
183
+ If an API changes or an integration becomes unavailable, affected features may change,
184
+ be disabled, or be removed. Continuous availability and fixes for every third-party change
185
+ are not guaranteed. The software is provided as-is, subject to the warranty terms in
186
+ [LICENSE](LICENSE). This notice does not replace dependency licenses or TIDAL's service terms.
187
+
188
+ - This release supports Windows only. Linux is under development and is not enabled here. macOS is outside the project scope.
189
+ - No offline downloads. You can create playlists and add songs; renaming and deleting are not implemented.
190
+ - The next stream is prepared during the last 30 seconds and appended for mpv prefetch.
191
+ EOF continues without an intermediate stop. This does not guarantee gapless playback. Pause,
192
+ seeking, and queue changes invalidate preparation; failures preserve the current audio and
193
+ retry on advance. A new shuffled cycle still resolves its first song at EOF.
194
+
195
+ ## Tests
196
+
197
+ ```powershell
198
+ uv venv --python 3.12
199
+ uv pip install --python .venv/Scripts/python.exe -e ".[windows-test]"
200
+ .venv\Scripts\python.exe -m noneto --install-mpv
201
+ .venv\Scripts\python.exe -m unittest discover -s tests -v
202
+ ```
203
+
204
+ Tests do not require a TIDAL account. mpv tests use local audio and a null audio output.
205
+ The visualizer capture test uses the actual audio device at a very low volume.
206
+
207
+ ## License
208
+
209
+ The [MIT license](LICENSE) covers Noneto CLI's own code and documentation. Third-party
210
+ dependencies retain their own licenses; MIT does not replace them.
211
+
212
+ In particular, **`tidalapi`**, the Python library used to access TIDAL, is a separate,
213
+ unmodified dependency under
214
+ [LGPL-3.0-or-later](https://github.com/EbbLabs/python-tidal/blob/v0.8.11/LICENSE).
215
+ **`textual-image`**, which draws cover art in the terminal, is also a separate, unmodified
216
+ dependency under LGPL-3.0-or-later.
217
+ It is free software with different conditions from MIT. Noneto's license grants no rights
218
+ to TIDAL's service, APIs, music, lyrics, cover art, or trademarks.
219
+
220
+ Other main dependencies include Textual and Rich (MIT), Requests (Apache-2.0), NumPy (BSD),
221
+ and Pillow (MIT-CMU). mpv (GPL/LGPL) is downloaded separately from
222
+ [shinchiro/mpv-winbuild-cmake](https://github.com/shinchiro/mpv-winbuild-cmake) and runs as a separate process.
@@ -0,0 +1,59 @@
1
+ noneto/__init__.py,sha256=pC8jFJDDHeqsud20c4fXVEUKvxxs2SJadWUnr3FCQp8,110
2
+ noneto/__main__.py,sha256=pnwXIEYyOw78r-ksuDq8Jm1d1LyTHZMSzeG3vtUGQ9s,48
3
+ noneto/app.py,sha256=0iE737MX2ttu59PxAl_fuW-A6jPynQdIU-GjjRCXz50,5514
4
+ noneto/diagnostics.py,sha256=DrEV7X5kgURH4REoyedzOLbcAsBliWHXc-qHDJIJeeQ,4938
5
+ noneto/errors.py,sha256=j15E3LgW4AUL75ooH-X9tbl0-QF_hk4w1yf0_q3G6_g,342
6
+ noneto/i18n.py,sha256=7d8zsMhb3GotHJPwwZhEgKJ0FsslDd4n_yJlqlj5lQU,13683
7
+ noneto/security.py,sha256=Eu-nu0zZFCvt-sT2RZelGmeiCVT9E5NSJqsf9-zxZ3o,2643
8
+ noneto/settings.py,sha256=H-73rYOyB7fCmsLpXXsCLr5RFNxZGnLRQj_4asQe6IU,1741
9
+ noneto/assets/noneto.ico,sha256=wqNyS8W18Bdyg9dl-MRhJr36ANl90yMbykVPiPsguo0,17555
10
+ noneto/audio/__init__.py,sha256=FRkzMZu3Lmrhbrg_oQti-QZzWggLiBX0uazRaM8CATE,79
11
+ noneto/audio/controller.py,sha256=Qm_689Qn4Qrcnq0W0x-7JIqDEJ-4T-zMwelSouTD54k,20303
12
+ noneto/audio/inspector.py,sha256=c6oASgJo4e6zUZlaMHg6A4KHIBRIkyWhXA20p4jPprY,988
13
+ noneto/audio/ipc_unix.py,sha256=3kvYN4x_SJzfJmwMDZq_q5C6S_xO-vAQrju6SkL1jsY,829
14
+ noneto/audio/ipc_windows.py,sha256=3AbaBQ6Br8SzrR2Ub8Q5Cb1wJ953Pqp7OVzeIiKhMs4,3832
15
+ noneto/audio/lifetime.py,sha256=LGSKfO_lfhPSK21ptsBBVq6turDc7v6_q5sfiIcG8kc,3205
16
+ noneto/audio/media_controls.py,sha256=rsadHxNtpLd9fsNtKXJBH2bDxIf60NLHu1M-Lsl90Z8,4492
17
+ noneto/audio/mpv_install.py,sha256=wsVk1eMmLHXH-04R-voRuzA5Z_Q0hzs1J0BCKSYXAGY,3254
18
+ noneto/audio/player.py,sha256=hRo3OpBIEheJbxtDEJHTwNcBZbP5g4VZ0ttZQR-fd9U,8950
19
+ noneto/audio/pulse_tap.py,sha256=8lRTSQe7New7biZtuzj9djk8wPvn98HLdgX8uyNn6VU,4397
20
+ noneto/audio/spectrum.py,sha256=jNCatfDNi-3e6pOFhF8Le5o92FexouQTmJ09ALzw4sk,1973
21
+ noneto/audio/streams.py,sha256=Ehd1cogGxjR0ZHNsl95uzt3rnclnVy6JdKFbIjAaCX0,4634
22
+ noneto/audio/tap.py,sha256=98SD-CTUni3-t6JJjSfpbnUEST_J5hDyDV67Sd7wRF0,8631
23
+ noneto/audio/windows_identity.py,sha256=1tk5VfOcaOqUaEoVAlxxN79NxLSpt7AWeg6DKBixSaY,3780
24
+ noneto/audio/windows_media.py,sha256=MOIj35ihYh1aMK_PPcSyF0bXFn-nR15Wk8i8pZQ_UgI,7173
25
+ noneto/auth/__init__.py,sha256=v9zv4EZXPycXpEX20sNQFxTFmRDSFsqY9YFu7TorqSg,57
26
+ noneto/auth/dpapi.py,sha256=tKfBDDGb6x7-VXnOzamT0tK_qM7vXK-1fQ8C1J4xYjw,1218
27
+ noneto/auth/service.py,sha256=zjAQppOQN98_REiby6MgMOQV2jeIYoBBGgaea1ulm_k,2183
28
+ noneto/auth/storage.py,sha256=U-3VD5yKZB46S_2-5llnrYRQo4yUL3BaNA0C1ie3h2E,4487
29
+ noneto/platform/__init__.py,sha256=z9FFvfATrE0WwWPM3ZEg2M10zVbD5t54eZbFMdd6DlI,47
30
+ noneto/platform/paths.py,sha256=E2dDL4mFplUQ5sybL8ixi1gohl_0NFeXBt-u1OXR1AQ,715
31
+ noneto/services/__init__.py,sha256=HqDafmL7CUjrAAS6HxMBzDoVoq6U121nmmyWZbGqW1U,33
32
+ noneto/services/covers.py,sha256=kH-cEPtst6UTcCxg20Xor644xR1nJYu_nk-CVQ7lI7k,3558
33
+ noneto/services/executor.py,sha256=0gyjEe7wa98KD4Z9pyUl6doNIlnrLIPXkKUKt68V7qg,3207
34
+ noneto/services/library.py,sha256=fb_sEq-zcknZ2B9F3YAhUM9EpHOY4bgRUa6tGUH1bgI,4110
35
+ noneto/services/tidal.py,sha256=BI2W9pogSSUFjYr5jfnrtaH1W4eqCDm35GeVBHs_sCc,7608
36
+ noneto/state/__init__.py,sha256=Vfa_5m6-r_FgTckd8ZiJb4huktlauUUmlCucIYaJxjA,42
37
+ noneto/state/queue.py,sha256=SA7vtm1CrkbMOqFnlz0YNQbFVX1NWrVcU-0O4IR_0f8,5813
38
+ noneto/state/writer.py,sha256=NC_3jLbji4SDNykDY2OVQweUkKBJadhxdpfF5w_Fo-M,1421
39
+ noneto/ui/__init__.py,sha256=ivI6A09y9Kzqep8SNcXF6EOCQlX5kNotDmBDDoyw3Jo,89
40
+ noneto/ui/common.py,sha256=HVJfnt9NfP6Go0b3eLzkt2IaaZaoMymmKNH0f_eu7wU,1002
41
+ noneto/ui/cover.py,sha256=6rqgDpeDGsimqicKYmYeon5tk2bkc9JUjMrlVcamsB0,3323
42
+ noneto/ui/dialogs.py,sha256=9NsMrNiL0ARjv4HVov8M5YbQUDNa9mcUV73YBTwBO3Y,3948
43
+ noneto/ui/linux_login.py,sha256=EA07i49w4zpyW_NEyrh8eAyep3b0whlVW7odPNYFjEU,2213
44
+ noneto/ui/login_window.py,sha256=k6jrlzyTbb5fENQwFmz4_r_mIH2HXZZBzIsY_m-8lRM,7467
45
+ noneto/ui/lyrics.py,sha256=xhPClPYfLq14MCqVWQ-me3GoiD3hMtrNLNV_OwjgoOE,5348
46
+ noneto/ui/player.py,sha256=7bxxl4Yq6dOG_SxRH90LCxIO2q56MdYhDw1DkHFAPsc,7483
47
+ noneto/ui/quality.py,sha256=yXAdKyj6zUEVQxXDhwdcoehRZZikqn9yAYqsCxQn2GY,3190
48
+ noneto/ui/queue.py,sha256=-XmuBwJ0cVmzaD1A0zjEKseW_cC37pDgQiCH6haTAao,1186
49
+ noneto/ui/terminal.py,sha256=jkhQ7zCYYJwDxYp-4TVoHa9ujcGHqQYED_hNgT63r-4,2958
50
+ noneto/ui/themes.py,sha256=QlzS5i9SmK2KhdtmXuuon2NG_hhkIguq49Y9ztBJPbU,12178
51
+ noneto/ui/top.py,sha256=-97c31H0uyzowJx-2UwrjmokhhhtdnNJCRjur6RNXBg,1657
52
+ noneto/ui/tracks.py,sha256=E7B-lYINtsAIXOXK1DYQcj0XYw8AKzjGYEnURAiT2BE,5765
53
+ noneto/ui/tui.py,sha256=VMCKvIfwdizfw_gHEAQ737K6rpJzlH7_fKG73tQSDsc,26669
54
+ noneto/ui/visualizer.py,sha256=euAn1AE93dNk0lJf6HtFOXgF9dmR4LEGkn3SF8tef3s,13709
55
+ noneto_cli-1.1.1.dist-info/METADATA,sha256=xk0l2lVPWAqmVmbyLy17wG2csZTkdaFeaBhMv8cq6jA,11932
56
+ noneto_cli-1.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
57
+ noneto_cli-1.1.1.dist-info/entry_points.txt,sha256=IbYSy6JQAe6k5E88ODYB9N-SsNKN-kIFmZnEZ3BNthI,43
58
+ noneto_cli-1.1.1.dist-info/licenses/LICENSE,sha256=vxFFd_ow4RbQu3bUVvGCEUDX1Teqz0qM66kJABFbApQ,1069
59
+ noneto_cli-1.1.1.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.29.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ noneto = noneto.app:main
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 VincentPelos
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.