@involvex/youtube-music-cli 0.0.12 → 0.0.13

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.0.13](https://github.com/involvex/youtube-music-cli/compare/v0.0.12...v0.0.13) (2026-02-18)
+
+### Features
+
+- **download:** add cover art and improved file organization ([1d48f7d](https://github.com/involvex/youtube-music-cli/commit/1d48f7de3a4787e9341697b4c6f44a50a43e752c))
+
+### BREAKING CHANGES
+
+- **download:** The output file structure has changed from flat directory
+  to nested artist/album directories. Existing workflows expecting the old
+  structure will need to be updated.
+
 ## [0.0.12](https://github.com/involvex/youtube-music-cli/compare/v0.0.11...v0.0.12) (2026-02-18)
 
 ## [0.0.11](https://github.com/involvex/youtube-music-cli/compare/v0.0.10...v0.0.11) (2026-02-18)

package/dist/source/services/download/download.service.d.ts

@@ -30,8 +30,10 @@ declare class DownloadService {
     private fetchAudio;
     private ensureFfmpeg;
     private convertAudio;
+    private buildMetadataArgs;
     private runFfmpeg;
     private recordViaYtDlp;
+    private downloadCoverArt;
     private recordViaMpv;
 }
 export declare function getDownloadService(): DownloadService;

package/dist/source/services/download/download.service.js

@@ -76,11 +76,13 @@ class DownloadService {
             for (const track of tracks) {
                 const destination = this.getDestinationPath(track, directory, format);
                 const tempSource = `${destination}.source`;
+                const tempCover = `${destination}.cover.jpg`;
                 try {
                     logger.info('DownloadService', 'Starting track download', {
                         videoId: track.videoId,
                         title: track.title,
                     });
+                    mkdirSync(path.dirname(destination), { recursive: true });
                     if (existsSync(destination)) {
                         result.skipped++;
                         logger.debug('DownloadService', 'Skipping existing file', {
@@ -113,7 +115,8 @@ class DownloadService {
                             await this.recordViaMpv(track.videoId, tempSource);
                         }
                     }
-                    await this.convertAudio(tempSource, destination, format);
+                    const hasCover = await this.downloadCoverArt(track.videoId, tempCover);
+                    await this.convertAudio(tempSource, destination, format, track, hasCover ? tempCover : undefined);
                     result.downloaded++;
                     logger.info('DownloadService', 'Track download complete', {
                         videoId: track.videoId,
@@ -134,6 +137,9 @@ class DownloadService {
                     if (existsSync(tempSource)) {
                         unlinkSync(tempSource);
                     }
+                    if (existsSync(tempCover)) {
+                        unlinkSync(tempCover);
+                    }
                 }
             }
             return result;
@@ -155,8 +161,11 @@ class DownloadService {
     }
     getDestinationPath(track, directory, format) {
         const artist = track.artists[0]?.name ?? 'Unknown Artist';
-        const baseName = this.sanitizeFilename(`${artist} - ${track.title}`);
-        return path.join(directory, `${baseName}.${format}`);
+        const album = track.album?.name ?? 'Singles';
+        const artistDir = this.sanitizeFilename(artist) || 'Unknown Artist';
+        const albumDir = this.sanitizeFilename(album) || 'Singles';
+        const fileName = this.sanitizeFilename(track.title) || track.videoId;
+        return path.join(directory, artistDir, albumDir, `${fileName}.${format}`);
     }
     sanitizeFilename(value) {
         return value.replace(/[<>:"/\\|?*\u0000-\u001F]/g, '_').trim();
@@ -186,32 +195,52 @@ class DownloadService {
             throw new Error('ffmpeg is required for downloads. Install ffmpeg and ensure it is available in PATH.');
         }
     }
-    async convertAudio(sourcePath, destinationPath, format) {
+    async convertAudio(sourcePath, destinationPath, format, track, coverPath) {
+        const metadataArgs = this.buildMetadataArgs(track);
         if (format === 'mp3') {
-            await this.runFfmpeg([
-                '-y',
-                '-i',
-                sourcePath,
-                '-vn',
-                '-codec:a',
-                'libmp3lame',
-                '-q:a',
-                '2',
-                destinationPath,
-            ]);
+            const args = ['-y', '-i', sourcePath];
+            if (coverPath) {
+                args.push('-i', coverPath, '-map', '0:a:0', '-map', '1:v:0');
+            }
+            else {
+                args.push('-map', '0:a:0', '-vn');
+            }
+            args.push('-codec:a', 'libmp3lame', '-q:a', '2', ...metadataArgs);
+            if (coverPath) {
+                args.push('-codec:v', 'mjpeg', '-disposition:v:0', 'attached_pic', '-metadata:s:v', 'title=Album cover', '-metadata:s:v', 'comment=Cover (front)');
+            }
+            args.push(destinationPath);
+            await this.runFfmpeg(args);
             return;
         }
-        await this.runFfmpeg([
-            '-y',
-            '-i',
-            sourcePath,
-            '-vn',
-            '-codec:a',
-            'aac',
-            '-b:a',
-            '192k',
-            destinationPath,
-        ]);
+        const args = ['-y', '-i', sourcePath];
+        if (coverPath) {
+            args.push('-i', coverPath, '-map', '0:a:0', '-map', '1:v:0');
+        }
+        else {
+            args.push('-map', '0:a:0', '-vn');
+        }
+        args.push('-codec:a', 'aac', '-b:a', '192k', ...metadataArgs);
+        if (coverPath) {
+            args.push('-codec:v', 'mjpeg', '-disposition:v:0', 'attached_pic');
+        }
+        args.push(destinationPath);
+        await this.runFfmpeg(args);
+    }
+    buildMetadataArgs(track) {
+        const artist = track.artists
+            .map(row => row.name)
+            .filter(Boolean)
+            .join(', ') || 'Unknown Artist';
+        const album = track.album?.name || 'Singles';
+        return [
+            '-metadata',
+            `title=${track.title}`,
+            '-metadata',
+            `artist=${artist}`,
+            '-metadata',
+            `album=${album}`,
+        ];
     }
     async runFfmpeg(args) {
         await new Promise((resolve, reject) => {
@@ -264,6 +293,28 @@ class DownloadService {
             });
         });
     }
+    async downloadCoverArt(videoId, outputPath) {
+        const candidates = [
+            `https://i.ytimg.com/vi/${videoId}/maxresdefault.jpg`,
+            `https://i.ytimg.com/vi/${videoId}/hqdefault.jpg`,
+        ];
+        for (const url of candidates) {
+            try {
+                const response = await fetch(url);
+                if (!response.ok)
+                    continue;
+                const image = Buffer.from(await response.arrayBuffer());
+                if (image.length === 0)
+                    continue;
+                writeFileSync(outputPath, image);
+                return true;
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
     async recordViaMpv(videoId, outputPath) {
         const watchUrl = `https://www.youtube.com/watch?v=${videoId}`;
         await new Promise((resolve, reject) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.12",
+	"version": "0.0.13",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",