noneto-cli 1.1.1__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 (81) hide show
  1. noneto_cli-1.1.1/.gitattributes +8 -0
  2. noneto_cli-1.1.1/.gitignore +10 -0
  3. noneto_cli-1.1.1/LICENSE +21 -0
  4. noneto_cli-1.1.1/PKG-INFO +222 -0
  5. noneto_cli-1.1.1/README.md +191 -0
  6. noneto_cli-1.1.1/docs/assets/noneto-logo-black.png +0 -0
  7. noneto_cli-1.1.1/docs/assets/noneto-logo-white.png +0 -0
  8. noneto_cli-1.1.1/docs/assets/noneto-symbol-black.svg +1 -0
  9. noneto_cli-1.1.1/docs/assets/noneto-symbol-white.svg +1 -0
  10. noneto_cli-1.1.1/noneto/__init__.py +1 -0
  11. noneto_cli-1.1.1/noneto/__main__.py +3 -0
  12. noneto_cli-1.1.1/noneto/app.py +113 -0
  13. noneto_cli-1.1.1/noneto/assets/noneto.ico +0 -0
  14. noneto_cli-1.1.1/noneto/audio/__init__.py +1 -0
  15. noneto_cli-1.1.1/noneto/audio/controller.py +427 -0
  16. noneto_cli-1.1.1/noneto/audio/inspector.py +21 -0
  17. noneto_cli-1.1.1/noneto/audio/ipc_unix.py +29 -0
  18. noneto_cli-1.1.1/noneto/audio/ipc_windows.py +94 -0
  19. noneto_cli-1.1.1/noneto/audio/lifetime.py +68 -0
  20. noneto_cli-1.1.1/noneto/audio/media_controls.py +107 -0
  21. noneto_cli-1.1.1/noneto/audio/mpv_install.py +71 -0
  22. noneto_cli-1.1.1/noneto/audio/player.py +222 -0
  23. noneto_cli-1.1.1/noneto/audio/pulse_tap.py +120 -0
  24. noneto_cli-1.1.1/noneto/audio/spectrum.py +44 -0
  25. noneto_cli-1.1.1/noneto/audio/streams.py +101 -0
  26. noneto_cli-1.1.1/noneto/audio/tap.py +208 -0
  27. noneto_cli-1.1.1/noneto/audio/windows_identity.py +79 -0
  28. noneto_cli-1.1.1/noneto/audio/windows_media.py +157 -0
  29. noneto_cli-1.1.1/noneto/auth/__init__.py +1 -0
  30. noneto_cli-1.1.1/noneto/auth/dpapi.py +28 -0
  31. noneto_cli-1.1.1/noneto/auth/service.py +53 -0
  32. noneto_cli-1.1.1/noneto/auth/storage.py +120 -0
  33. noneto_cli-1.1.1/noneto/diagnostics.py +115 -0
  34. noneto_cli-1.1.1/noneto/errors.py +12 -0
  35. noneto_cli-1.1.1/noneto/i18n.py +199 -0
  36. noneto_cli-1.1.1/noneto/platform/__init__.py +1 -0
  37. noneto_cli-1.1.1/noneto/platform/paths.py +27 -0
  38. noneto_cli-1.1.1/noneto/security.py +59 -0
  39. noneto_cli-1.1.1/noneto/services/__init__.py +1 -0
  40. noneto_cli-1.1.1/noneto/services/covers.py +88 -0
  41. noneto_cli-1.1.1/noneto/services/executor.py +83 -0
  42. noneto_cli-1.1.1/noneto/services/library.py +110 -0
  43. noneto_cli-1.1.1/noneto/services/tidal.py +188 -0
  44. noneto_cli-1.1.1/noneto/settings.py +48 -0
  45. noneto_cli-1.1.1/noneto/state/__init__.py +1 -0
  46. noneto_cli-1.1.1/noneto/state/queue.py +130 -0
  47. noneto_cli-1.1.1/noneto/state/writer.py +38 -0
  48. noneto_cli-1.1.1/noneto/ui/__init__.py +1 -0
  49. noneto_cli-1.1.1/noneto/ui/common.py +36 -0
  50. noneto_cli-1.1.1/noneto/ui/cover.py +88 -0
  51. noneto_cli-1.1.1/noneto/ui/dialogs.py +107 -0
  52. noneto_cli-1.1.1/noneto/ui/linux_login.py +57 -0
  53. noneto_cli-1.1.1/noneto/ui/login_window.py +201 -0
  54. noneto_cli-1.1.1/noneto/ui/lyrics.py +142 -0
  55. noneto_cli-1.1.1/noneto/ui/player.py +172 -0
  56. noneto_cli-1.1.1/noneto/ui/quality.py +75 -0
  57. noneto_cli-1.1.1/noneto/ui/queue.py +34 -0
  58. noneto_cli-1.1.1/noneto/ui/terminal.py +65 -0
  59. noneto_cli-1.1.1/noneto/ui/themes.py +352 -0
  60. noneto_cli-1.1.1/noneto/ui/top.py +39 -0
  61. noneto_cli-1.1.1/noneto/ui/tracks.py +139 -0
  62. noneto_cli-1.1.1/noneto/ui/tui.py +601 -0
  63. noneto_cli-1.1.1/noneto/ui/visualizer.py +343 -0
  64. noneto_cli-1.1.1/pyproject.toml +50 -0
  65. noneto_cli-1.1.1/tests/test_core.py +109 -0
  66. noneto_cli-1.1.1/tests/test_diagnostics.py +102 -0
  67. noneto_cli-1.1.1/tests/test_first_run.py +66 -0
  68. noneto_cli-1.1.1/tests/test_i18n.py +91 -0
  69. noneto_cli-1.1.1/tests/test_library_controller.py +424 -0
  70. noneto_cli-1.1.1/tests/test_login_window.py +218 -0
  71. noneto_cli-1.1.1/tests/test_media_controls.py +161 -0
  72. noneto_cli-1.1.1/tests/test_packaging.py +44 -0
  73. noneto_cli-1.1.1/tests/test_performance.py +468 -0
  74. noneto_cli-1.1.1/tests/test_player_lifetime.py +156 -0
  75. noneto_cli-1.1.1/tests/test_queue_portability.py +260 -0
  76. noneto_cli-1.1.1/tests/test_release_platform.py +34 -0
  77. noneto_cli-1.1.1/tests/test_security.py +231 -0
  78. noneto_cli-1.1.1/tests/test_settings.py +46 -0
  79. noneto_cli-1.1.1/tests/test_stability.py +93 -0
  80. noneto_cli-1.1.1/tests/test_tui.py +605 -0
  81. noneto_cli-1.1.1/tests/test_visualizer.py +393 -0
@@ -0,0 +1,8 @@
1
+ * text=auto
2
+ *.py text eol=lf
3
+ *.md text eol=lf
4
+ *.json text eol=lf
5
+ *.html text eol=lf
6
+ *.svg text eol=lf
7
+ *.toml text eol=lf
8
+ *.png binary
@@ -0,0 +1,10 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.pyc
4
+ dist/
5
+ build/
6
+ *.log
7
+ *.log.*
8
+ session.bin
9
+ .env
10
+ .env.*
@@ -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.
@@ -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,191 @@
1
+ <h1 align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/noneto-logo-white.png">
4
+ <img alt="Noneto CLI" src="docs/assets/noneto-logo-black.png" width="440">
5
+ </picture>
6
+ </h1>
7
+
8
+ 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,
9
+ create new ones, and follow lyrics with a cava-style track aura. Supports mouse and keyboard.
10
+ Built with Python 3.12, Textual, [`tidalapi`](https://github.com/EbbLabs/python-tidal), and mpv.
11
+ You need a TIDAL account with playback access.
12
+
13
+ > [!IMPORTANT]
14
+ > Noneto CLI is a free, personal, **unofficial** project. It is not affiliated with, associated
15
+ > with, or endorsed by TIDAL. TIDAL is a trademark of its respective owners.
16
+ >
17
+ > Noneto provides a terminal interface and connects your account to TIDAL through the unofficial
18
+ > `tidalapi` library. It does not operate TIDAL's service or develop or control its APIs.
19
+ > External changes may make features unavailable; future compatibility is not guaranteed.
20
+ > Noneto CLI streams music only: it does not download or save music, and it rejects encrypted
21
+ > streams rather than bypassing DRM.
22
+
23
+ ## Install
24
+
25
+ Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then:
26
+
27
+ ```powershell
28
+ uv tool install --python 3.12 noneto-cli
29
+ ```
30
+
31
+ Alternatively, install the same package directly from GitHub without Git:
32
+
33
+ ```powershell
34
+ 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
35
+ ```
36
+
37
+ Open a new terminal and run `noneto`. On the first launch, Noneto prepares mpv automatically
38
+ if it is missing, verifies the pinned SHA-256, and then continues to sign-in. A failed
39
+ download stops before sign-in; run `noneto` again to retry. Existing mpv installations are
40
+ reused. Installation does not ask for your TIDAL account. `noneto --install-mpv` remains
41
+ available for explicit preparation without signing in.
42
+
43
+ uv manages Python 3.12 and the isolated application environment. If `noneto` is not found,
44
+ run `uv tool update-shell` and open a new terminal. mpv remains in `%LOCALAPPDATA%\Noneto\mpv`.
45
+
46
+ ## Update and uninstall
47
+
48
+ ```powershell
49
+ uv tool upgrade noneto-cli
50
+ uv tool uninstall noneto-cli
51
+ Remove-Item -Recurse "$env:LOCALAPPDATA\Noneto" # optional: session, logs, and mpv
52
+ ```
53
+
54
+ ## Use
55
+
56
+ 1. On your first launch, a TIDAL sign-in window opens. Sign in and the window closes automatically.
57
+ Later launches restore your session.
58
+ 2. If the window cannot open because the renderer is unavailable, Noneto opens your browser.
59
+ TIDAL may finish on an "Oops" page; copy its address with Ctrl+L, Ctrl+C. Noneto detects it.
60
+ 3. Your first playlist opens.
61
+ 4. Click a song, or select it and press Enter. Playback continues through the remaining songs.
62
+
63
+ **Top bar:** **Library ▾** opens your own and favorite playlists, lets you create a playlist,
64
+ and refreshes the list. The search field and quality badge sit beside it.
65
+ During playback, the badge shows the audio mpv actually decodes, such as `◆ FLAC 24/96`.
66
+ Before playback, it shows the requested quality (`Requested: Hi-Res`). If TIDAL delivers less
67
+ than the track offers, the badge changes to `◇ … ↓` in a warning color. Hover over it to see
68
+ the requested quality, received quality, and available track tiers.
69
+
70
+ **Tabs:** **Songs** lists titles with artist and album below each one; `▷` marks the current song.
71
+ **Queue · N** lists upcoming songs. **Lyrics** shows cover art and lyrics, synchronized when
72
+ TIDAL provides timestamps. **Playlists** lists playlists found through search; click one or
73
+ press Enter to open its songs. **Library ▾** lets you switch to a playlist from your library.
74
+
75
+ **Cover art:** terminals with sixel graphics (Windows Terminal 1.22+, WezTerm, and others)
76
+ or the kitty graphics protocol show the actual image. Other terminals use colored half blocks.
77
+ Ctrl+O, or a click on the cover, switches the Lyrics tab between cover + lyrics and the cover
78
+ alone, large and centered; the choice is remembered. Songs without lyrics always show the large cover.
79
+
80
+ **Track aura:** spare rows in the Lyrics tab show a cava-style animation of the actual audio
81
+ played by Noneto, in four styles: classic bars, braille dots, a braille mirror that grows up and
82
+ down from the middle, and flame. Ctrl+G or a click changes it; the choice is remembered.
83
+ Capture is limited to mpv's process and runs only while the aura is
84
+ visible. Samples are never saved. Requires Windows 10 version 2004 or later.
85
+
86
+ **Selection and player:** **+ Queue** and **+ Playlist** add the selected song. The player shows
87
+ cover art, title, artist, album, shuffle, previous/play/pause/next controls, repeat modes
88
+ (off, queue, or one song), clickable volume, and a progress bar you can click to seek.
89
+ The queue persists between sessions, including duplicates, original/shuffled order, current song,
90
+ position, volume, and repeat mode. It restores paused until you press play. State is tied to the
91
+ account and excludes stream URLs. Position is saved every five seconds and on normal shutdown;
92
+ a forced exit may lose the last few seconds. Queue save failures are logged without stopping audio.
93
+
94
+ Shuffle keeps the current song and mixes only upcoming songs. Turning it off restores the
95
+ remaining songs to their original order. **+ Queue** always appends to the end. With repeat-all,
96
+ each new cycle is reshuffled and avoids starting with the same song that ended the previous
97
+ cycle when another song is available. Duplicate playlist entries are preserved.
98
+
99
+ Use a terminal with mouse support. The layout works at 80 × 24 and looks best at 100 × 28 or larger.
100
+
101
+ **Themes:** Ctrl+T cycles through nine palettes: noneto-dark, catppuccin-mocha, dracula,
102
+ tokyo-night, nord, rose-pine, flexoki, catppuccin-latte, and rose-pine-dawn. The track aura uses
103
+ the active theme's colors. Noneto remembers your last theme.
104
+
105
+ **Language:** English is the default on every Windows language setting. Use `--lang es` for
106
+ Spanish or `--lang en` for English. Playlist names, song metadata, and lyrics keep their original language.
107
+
108
+ **Windows media controls:** Noneto publishes the song, artist, album, cover art, and progress
109
+ to the system media session. It accepts play/pause, previous/next, and seek commands from the
110
+ system panel. Windows decides how that panel looks; audio remains in mpv.
111
+ Noneto creates a **Noneto CLI** Start menu shortcut to identify the application. After
112
+ uninstalling with uv, you can also delete that shortcut.
113
+
114
+ | Shortcut | Action |
115
+ | --- | --- |
116
+ | Ctrl+L | Open Library; choosing a playlist focuses its songs for arrow-key navigation |
117
+ | Ctrl+F | Focus search |
118
+ | Ctrl+N | Create a playlist |
119
+ | Enter in the song table | Play from the selected song |
120
+ | Space outside a text field | Play / pause |
121
+ | Ctrl+Right | Next song |
122
+ | Ctrl+T | Change theme |
123
+ | Ctrl+G | Change the track aura style |
124
+ | Ctrl+O | Lyrics tab: cover + lyrics or cover only |
125
+ | Ctrl+Q / Ctrl+C | Quit and stop audio |
126
+
127
+ ```powershell
128
+ noneto --playlist "https://tidal.com/browse/playlist/YOUR-PLAYLIST-UUID"
129
+ noneto # request Hi-Res FLAC, up to 24-bit / 192 kHz
130
+ noneto --quality LOSSLESS # cap the request at CD quality
131
+ noneto --quality HIGH # use less data (AAC 320 kbps)
132
+ noneto --lang es # use the Spanish interface
133
+ noneto --logout # delete the local session
134
+ ```
135
+
136
+ ## Privacy
137
+
138
+ - Noneto does not ask for or save your password. Tokens are encrypted with Windows DPAPI for
139
+ your user account and stored in `%LOCALAPPDATA%\Noneto\session.bin`. `--logout` deletes the
140
+ local session; it does not revoke the tokens at TIDAL.
141
+ - Music, lyrics, and cover art are not saved to disk.
142
+ - Logs in `%LOCALAPPDATA%\Noneto\logs\noneto.log` contain timestamps, track IDs, processing
143
+ stages, HTTP status codes, and timings. They exclude tokens, searches, signed URLs, and
144
+ audio, and remain on your computer.
145
+
146
+ ## Scope and limitations
147
+
148
+ Noneto CLI provides the client interface, controls, and local integration. The catalog,
149
+ audio availability, and account access depend on TIDAL and the interfaces used by `tidalapi`.
150
+ Noneto does not provide a music service or access independent of your TIDAL account.
151
+
152
+ If an API changes or an integration becomes unavailable, affected features may change,
153
+ be disabled, or be removed. Continuous availability and fixes for every third-party change
154
+ are not guaranteed. The software is provided as-is, subject to the warranty terms in
155
+ [LICENSE](LICENSE). This notice does not replace dependency licenses or TIDAL's service terms.
156
+
157
+ - This release supports Windows only. Linux is under development and is not enabled here. macOS is outside the project scope.
158
+ - No offline downloads. You can create playlists and add songs; renaming and deleting are not implemented.
159
+ - The next stream is prepared during the last 30 seconds and appended for mpv prefetch.
160
+ EOF continues without an intermediate stop. This does not guarantee gapless playback. Pause,
161
+ seeking, and queue changes invalidate preparation; failures preserve the current audio and
162
+ retry on advance. A new shuffled cycle still resolves its first song at EOF.
163
+
164
+ ## Tests
165
+
166
+ ```powershell
167
+ uv venv --python 3.12
168
+ uv pip install --python .venv/Scripts/python.exe -e ".[windows-test]"
169
+ .venv\Scripts\python.exe -m noneto --install-mpv
170
+ .venv\Scripts\python.exe -m unittest discover -s tests -v
171
+ ```
172
+
173
+ Tests do not require a TIDAL account. mpv tests use local audio and a null audio output.
174
+ The visualizer capture test uses the actual audio device at a very low volume.
175
+
176
+ ## License
177
+
178
+ The [MIT license](LICENSE) covers Noneto CLI's own code and documentation. Third-party
179
+ dependencies retain their own licenses; MIT does not replace them.
180
+
181
+ In particular, **`tidalapi`**, the Python library used to access TIDAL, is a separate,
182
+ unmodified dependency under
183
+ [LGPL-3.0-or-later](https://github.com/EbbLabs/python-tidal/blob/v0.8.11/LICENSE).
184
+ **`textual-image`**, which draws cover art in the terminal, is also a separate, unmodified
185
+ dependency under LGPL-3.0-or-later.
186
+ It is free software with different conditions from MIT. Noneto's license grants no rights
187
+ to TIDAL's service, APIs, music, lyrics, cover art, or trademarks.
188
+
189
+ Other main dependencies include Textual and Rich (MIT), Requests (Apache-2.0), NumPy (BSD),
190
+ and Pillow (MIT-CMU). mpv (GPL/LGPL) is downloaded separately from
191
+ [shinchiro/mpv-winbuild-cmake](https://github.com/shinchiro/mpv-winbuild-cmake) and runs as a separate process.
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 185 186" role="img" aria-label="Noneto"><title>Noneto</title><polygon points="0,0 39,0 86,52 86,83 120,83 120,106 147,131 147,0 185,0 185,186 147,186 97,131 97,107 64,107 64,83 39,53 39,186 0,186" fill="#111111"/></svg>
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 185 186" role="img" aria-label="Noneto"><title>Noneto</title><polygon points="0,0 39,0 86,52 86,83 120,83 120,106 147,131 147,0 185,0 185,186 147,186 97,131 97,107 64,107 64,83 39,53 39,186 0,186" fill="#ffffff"/></svg>
@@ -0,0 +1 @@
1
+ """Noneto CLI: unofficial Windows terminal client for TIDAL. UI, authentication and audio are independent."""
@@ -0,0 +1,3 @@
1
+ from .app import main
2
+
3
+ raise SystemExit(main())
@@ -0,0 +1,113 @@
1
+ """Composition root: connects UI, auth, catalog and audio."""
2
+ import argparse
3
+ import os
4
+ import sys
5
+ import tempfile
6
+
7
+ from .auth.service import login, logout
8
+ from .auth.storage import SessionPersistence
9
+ from .audio.controller import PlaybackController
10
+ from .audio.mpv_install import install_mpv, mpv_dir
11
+ from .audio.player import Player, find_mpv
12
+ from .audio.streams import stream_target
13
+ from .services.library import Library
14
+ from .services.tidal import Catalog, create_session
15
+ from .ui.terminal import Terminal
16
+ from .ui.themes import available_themes, load_user_themes
17
+ from .ui.visualizer import available_visualizer_modes
18
+ from .diagnostics import configure, emit, failure
19
+ from .i18n import LANGUAGES, _, set_language, DEFAULT_LANGUAGE
20
+ from .settings import load_settings, save_settings
21
+ from .state.queue import QueueStore
22
+
23
+
24
+ def main(argv=None):
25
+ # The language must be set before help texts are built and before the TUI module is imported.
26
+ early = argparse.ArgumentParser(add_help=False)
27
+ early.add_argument("--lang", choices=LANGUAGES)
28
+ set_language(early.parse_known_args(argv)[0].lang or DEFAULT_LANGUAGE)
29
+ parser = argparse.ArgumentParser(prog="noneto", description=_("Noneto CLI: unofficial TIDAL client for the terminal."))
30
+ parser.add_argument("--playlist", help=_("Link or UUID of the playlist to open at startup"))
31
+ parser.add_argument("--quality", choices=["HIGH", "LOSSLESS", "HI_RES_LOSSLESS"], default="HI_RES_LOSSLESS",
32
+ help=_("Highest quality requested from TIDAL; by default, the best available"))
33
+ parser.add_argument("--lang", choices=LANGUAGES, help=_("Interface language (default: English)"))
34
+ parser.add_argument("--logout", action="store_true", help=_("Delete the local session and exit"))
35
+ parser.add_argument("--install-mpv", action="store_true",
36
+ help=_("Download mpv (pinned version, SHA-256 verified) and exit"))
37
+ args = parser.parse_args(argv)
38
+ if sys.platform != "win32":
39
+ print(_("This release supports Windows only. Linux support is still in development."), file=sys.stderr)
40
+ return 1
41
+ from .ui.cover import terminal_artwork
42
+ from .ui.lyrics import LAYOUTS
43
+ from .ui.tui import NonetoApp
44
+ session = None
45
+ ui = Terminal()
46
+ try:
47
+ if args.logout:
48
+ logout()
49
+ ui.notify("logout")
50
+ return 0
51
+ if args.install_mpv:
52
+ ui.notify("mpv-installing")
53
+ ui.notify("mpv-ready", path=install_mpv())
54
+ return 0
55
+ try:
56
+ log_path = configure()
57
+ except OSError:
58
+ ui.notify("logs-unavailable")
59
+ else:
60
+ ui.notify("logs-ready", path=log_path)
61
+ emit("app.started", quality=args.quality)
62
+ if os.name == "nt" and not (mpv_dir() / "mpv.exe").is_file():
63
+ ui.notify("mpv-installing")
64
+ ui.notify("mpv-ready", path=install_mpv())
65
+ find_mpv()
66
+ ui.notify("welcome")
67
+ session = create_session(args.quality)
68
+ login(session, ui.notify, ui.ask)
69
+ catalog = Catalog(session)
70
+ with tempfile.TemporaryDirectory(prefix="noneto-") as directory:
71
+ library = Library(catalog, persist=SessionPersistence(session))
72
+ controls = None
73
+ playback = PlaybackController(lambda track: library.resolve(stream_target, track, directory),
74
+ player_factory=lambda: Player(media_controls=not (controls and controls.available)),
75
+ queue_store=QueueStore(session.user.id))
76
+ try:
77
+ if os.name == "nt":
78
+ from .audio.media_controls import MediaControls
79
+ controls = MediaControls(playback, lambda track: library.submit("media_cover", track))
80
+ load_user_themes()
81
+ settings = load_settings(available_themes(), allowed_visualizer_modes=available_visualizer_modes(),
82
+ allowed_lyrics_layouts=LAYOUTS)
83
+
84
+ def update_setting(key, value):
85
+ settings[key] = value
86
+ save_settings(settings)
87
+
88
+ artwork = terminal_artwork() # probes the terminal before Textual takes stdin
89
+ interface = NonetoApp(library, playback, args.quality, args.playlist,
90
+ getattr(session.user, "first_name", None), theme=settings.get("theme"),
91
+ on_theme=lambda name: update_setting("theme", name),
92
+ visualizer_mode=settings.get("visualizer_mode"),
93
+ on_visualizer_mode=lambda mode: update_setting("visualizer_mode", mode),
94
+ artwork=artwork, lyrics_layout=settings.get("lyrics_layout"),
95
+ on_lyrics_layout=lambda layout: update_setting("lyrics_layout", layout))
96
+ interface.run()
97
+ finally:
98
+ if controls is not None:
99
+ controls.close()
100
+ playback.close()
101
+ library.close()
102
+ return interface.return_code
103
+ except (KeyboardInterrupt, EOFError):
104
+ ui.notify("bye")
105
+ return 0
106
+ except Exception as error:
107
+ failure("app.failed", error)
108
+ ui.notify("error", error=error)
109
+ return 1
110
+ finally:
111
+ if session is not None:
112
+ session.request_session.close()
113
+ emit("app.stopped")
@@ -0,0 +1 @@
1
+ """Stream validation, playback queue, mpv transport and visualizer capture."""