@involvex/youtube-music-cli 0.1.8 → 0.2.0

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@involvex/youtube-music-cli",
3
- "version": "0.1.8",
3
+ "version": "0.2.0",
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.3.14",
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.3.14",
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.