@involvex/youtube-music-cli 0.1.9 → 0.2.1
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.
- package/CHANGELOG.md +14 -0
- package/dist/source/cli.js +428 -297
- package/package.json +3 -3
- package/readme.md +19 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@involvex/youtube-music-cli",
|
|
3
|
-
"version": "0.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "- A Commandline music player for youtube-music",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -95,12 +95,12 @@
|
|
|
95
95
|
"@eslint/js": "^10.0.1",
|
|
96
96
|
"@sindresorhus/tsconfig": "^8.1.0",
|
|
97
97
|
"@tsconfig/bun": "^1.0.11",
|
|
98
|
-
"@types/bun": "^1.
|
|
98
|
+
"@types/bun": "^1.4.0",
|
|
99
99
|
"@types/node": "^26.2.0",
|
|
100
100
|
"@types/react": "^19.2.18",
|
|
101
101
|
"@types/ws": "^8.18.1",
|
|
102
102
|
"@vdemedes/prettier-config": "^2.0.1",
|
|
103
|
-
"bun-types": "^1.
|
|
103
|
+
"bun-types": "^1.4.0",
|
|
104
104
|
"chalk": "^6.0.0",
|
|
105
105
|
"conventional-changelog-cli": "^5.0.0",
|
|
106
106
|
"eslint": "^10.8.1",
|
package/readme.md
CHANGED
|
@@ -31,6 +31,7 @@ A powerful Terminal User Interface (TUI) music player for YouTube Music
|
|
|
31
31
|
- ⌨️ **Keyboard-Driven** - Efficient vim-style navigation
|
|
32
32
|
- 🖥️ **Immersive Mode** - Fullscreen Windows TUI with audio visualizer and disco effects
|
|
33
33
|
- 🌐 **Web Companion** - Browser UI with synced playback controls (`--web`); included in every production build
|
|
34
|
+
- 🔗 **Playlist Sync** - Sync YouTube Music playlists to local config with `ymc sync`; search and list saved playlists
|
|
34
35
|
- 💾 **Downloads** - Save tracks/playlists/artists with `Shift+D`
|
|
35
36
|
- 📊 **Listening Stats** - Press `o` for totals, top tracks/artists, streaks; share with `S` / `E` or `ymc stats --share`
|
|
36
37
|
- 🏷️ **Metadata Tagging** - Auto-tag title/artist/album with optional cover art
|
|
@@ -197,16 +198,31 @@ youtube-music-cli pause
|
|
|
197
198
|
youtube-music-cli resume
|
|
198
199
|
youtube-music-cli skip
|
|
199
200
|
youtube-music-cli back
|
|
201
|
+
|
|
202
|
+
# Sync a YouTube Music playlist to local config
|
|
203
|
+
ymc sync <playlist-id|ytm-url>
|
|
204
|
+
|
|
205
|
+
# Search your synced playlists
|
|
206
|
+
ymc sync search "query"
|
|
207
|
+
|
|
208
|
+
# List your synced playlists
|
|
209
|
+
ymc sync list
|
|
200
210
|
```
|
|
201
211
|
|
|
202
212
|
### Authentication
|
|
203
213
|
|
|
204
|
-
Authenticate with your YouTube Music account to access personalized features (library, playlists, and ad-free playback for Premium users) via the OAuth2 Device Flow:
|
|
214
|
+
Authenticate with your YouTube Music account to access personalized features (library, playlists, and ad-free playback for Premium users) via the OAuth2 Device Flow or cookie-based auth:
|
|
205
215
|
|
|
206
216
|
```bash
|
|
207
217
|
# Sign in (displays device code and verification URL)
|
|
208
218
|
ymc login
|
|
209
219
|
|
|
220
|
+
# Sign in with a cookies.txt file (useful if OAuth2 is blocked)
|
|
221
|
+
ymc login --cookies-file "/path/to/cookies.txt"
|
|
222
|
+
|
|
223
|
+
# Sign in by extracting cookies from a browser
|
|
224
|
+
ymc login --cookies-from-browser edge
|
|
225
|
+
|
|
210
226
|
# Check current account status
|
|
211
227
|
ymc whoami
|
|
212
228
|
|
|
@@ -214,6 +230,8 @@ ymc whoami
|
|
|
214
230
|
ymc logout
|
|
215
231
|
```
|
|
216
232
|
|
|
233
|
+
**Cookie-based auth** is a fallback for when OAuth2 Device Flow is blocked by YouTube. You can either pass a `cookies.txt` file exported from your browser, or let the CLI extract cookies automatically from Chrome, Edge, Brave, or Firefox. On Windows, browser cookie extraction uses a Python fallback because browsers lock the SQLite database; if you hit that limitation, use `--cookies-file` instead (export from `edge://settings/cookies` or a browser extension).
|
|
234
|
+
|
|
217
235
|
**Security & Credential Storage:**
|
|
218
236
|
|
|
219
237
|
- Credentials are stored securely in `~/.youtube-music-cli/credentials.json` with strict file permissions (`0600` on Unix-like systems) so only the owner can read/write them.
|