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.
- noneto_cli-1.1.1/.gitattributes +8 -0
- noneto_cli-1.1.1/.gitignore +10 -0
- noneto_cli-1.1.1/LICENSE +21 -0
- noneto_cli-1.1.1/PKG-INFO +222 -0
- noneto_cli-1.1.1/README.md +191 -0
- noneto_cli-1.1.1/docs/assets/noneto-logo-black.png +0 -0
- noneto_cli-1.1.1/docs/assets/noneto-logo-white.png +0 -0
- noneto_cli-1.1.1/docs/assets/noneto-symbol-black.svg +1 -0
- noneto_cli-1.1.1/docs/assets/noneto-symbol-white.svg +1 -0
- noneto_cli-1.1.1/noneto/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/__main__.py +3 -0
- noneto_cli-1.1.1/noneto/app.py +113 -0
- noneto_cli-1.1.1/noneto/assets/noneto.ico +0 -0
- noneto_cli-1.1.1/noneto/audio/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/audio/controller.py +427 -0
- noneto_cli-1.1.1/noneto/audio/inspector.py +21 -0
- noneto_cli-1.1.1/noneto/audio/ipc_unix.py +29 -0
- noneto_cli-1.1.1/noneto/audio/ipc_windows.py +94 -0
- noneto_cli-1.1.1/noneto/audio/lifetime.py +68 -0
- noneto_cli-1.1.1/noneto/audio/media_controls.py +107 -0
- noneto_cli-1.1.1/noneto/audio/mpv_install.py +71 -0
- noneto_cli-1.1.1/noneto/audio/player.py +222 -0
- noneto_cli-1.1.1/noneto/audio/pulse_tap.py +120 -0
- noneto_cli-1.1.1/noneto/audio/spectrum.py +44 -0
- noneto_cli-1.1.1/noneto/audio/streams.py +101 -0
- noneto_cli-1.1.1/noneto/audio/tap.py +208 -0
- noneto_cli-1.1.1/noneto/audio/windows_identity.py +79 -0
- noneto_cli-1.1.1/noneto/audio/windows_media.py +157 -0
- noneto_cli-1.1.1/noneto/auth/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/auth/dpapi.py +28 -0
- noneto_cli-1.1.1/noneto/auth/service.py +53 -0
- noneto_cli-1.1.1/noneto/auth/storage.py +120 -0
- noneto_cli-1.1.1/noneto/diagnostics.py +115 -0
- noneto_cli-1.1.1/noneto/errors.py +12 -0
- noneto_cli-1.1.1/noneto/i18n.py +199 -0
- noneto_cli-1.1.1/noneto/platform/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/platform/paths.py +27 -0
- noneto_cli-1.1.1/noneto/security.py +59 -0
- noneto_cli-1.1.1/noneto/services/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/services/covers.py +88 -0
- noneto_cli-1.1.1/noneto/services/executor.py +83 -0
- noneto_cli-1.1.1/noneto/services/library.py +110 -0
- noneto_cli-1.1.1/noneto/services/tidal.py +188 -0
- noneto_cli-1.1.1/noneto/settings.py +48 -0
- noneto_cli-1.1.1/noneto/state/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/state/queue.py +130 -0
- noneto_cli-1.1.1/noneto/state/writer.py +38 -0
- noneto_cli-1.1.1/noneto/ui/__init__.py +1 -0
- noneto_cli-1.1.1/noneto/ui/common.py +36 -0
- noneto_cli-1.1.1/noneto/ui/cover.py +88 -0
- noneto_cli-1.1.1/noneto/ui/dialogs.py +107 -0
- noneto_cli-1.1.1/noneto/ui/linux_login.py +57 -0
- noneto_cli-1.1.1/noneto/ui/login_window.py +201 -0
- noneto_cli-1.1.1/noneto/ui/lyrics.py +142 -0
- noneto_cli-1.1.1/noneto/ui/player.py +172 -0
- noneto_cli-1.1.1/noneto/ui/quality.py +75 -0
- noneto_cli-1.1.1/noneto/ui/queue.py +34 -0
- noneto_cli-1.1.1/noneto/ui/terminal.py +65 -0
- noneto_cli-1.1.1/noneto/ui/themes.py +352 -0
- noneto_cli-1.1.1/noneto/ui/top.py +39 -0
- noneto_cli-1.1.1/noneto/ui/tracks.py +139 -0
- noneto_cli-1.1.1/noneto/ui/tui.py +601 -0
- noneto_cli-1.1.1/noneto/ui/visualizer.py +343 -0
- noneto_cli-1.1.1/pyproject.toml +50 -0
- noneto_cli-1.1.1/tests/test_core.py +109 -0
- noneto_cli-1.1.1/tests/test_diagnostics.py +102 -0
- noneto_cli-1.1.1/tests/test_first_run.py +66 -0
- noneto_cli-1.1.1/tests/test_i18n.py +91 -0
- noneto_cli-1.1.1/tests/test_library_controller.py +424 -0
- noneto_cli-1.1.1/tests/test_login_window.py +218 -0
- noneto_cli-1.1.1/tests/test_media_controls.py +161 -0
- noneto_cli-1.1.1/tests/test_packaging.py +44 -0
- noneto_cli-1.1.1/tests/test_performance.py +468 -0
- noneto_cli-1.1.1/tests/test_player_lifetime.py +156 -0
- noneto_cli-1.1.1/tests/test_queue_portability.py +260 -0
- noneto_cli-1.1.1/tests/test_release_platform.py +34 -0
- noneto_cli-1.1.1/tests/test_security.py +231 -0
- noneto_cli-1.1.1/tests/test_settings.py +46 -0
- noneto_cli-1.1.1/tests/test_stability.py +93 -0
- noneto_cli-1.1.1/tests/test_tui.py +605 -0
- noneto_cli-1.1.1/tests/test_visualizer.py +393 -0
noneto_cli-1.1.1/LICENSE
ADDED
|
@@ -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.
|
|
Binary file
|
|
Binary file
|
|
@@ -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,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")
|
|
Binary file
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Stream validation, playback queue, mpv transport and visualizer capture."""
|