@involvex/youtube-music-cli 0.0.0

package/dist/source/types/youtube-music.types.d.ts

@@ -0,0 +1,35 @@
+export interface Artist {
+    artistId: string;
+    name: string;
+}
+export interface Album {
+    albumId: string;
+    name: string;
+    artists: Artist[];
+}
+export interface Track {
+    videoId: string;
+    title: string;
+    artists: Artist[];
+    album?: Album;
+    duration?: number;
+}
+export interface Playlist {
+    playlistId: string;
+    name: string;
+    tracks: Track[];
+}
+export interface SearchResult {
+    type: 'song' | 'album' | 'artist' | 'playlist';
+    data: Track | Album | Artist | Playlist;
+}
+export interface SearchResponse {
+    results: SearchResult[];
+    hasMore: boolean;
+    continuation?: string;
+}
+export interface SearchOptions {
+    type?: 'all' | 'songs' | 'albums' | 'artists' | 'playlists';
+    limit?: number;
+    continuation?: string;
+}

package/dist/source/types/youtube-music.types.js

@@ -0,0 +1 @@
+export {};

package/dist/source/types/youtubei.types.d.ts

@@ -0,0 +1,60 @@
+export interface VideoSearchResult {
+    id: string;
+    video_id?: string;
+    title: {
+        text: string;
+    } | string;
+    author?: {
+        name: string;
+    } | string;
+    channel_id?: string;
+    channel?: {
+        id: string;
+    };
+    duration?: {
+        seconds: number;
+    } | number;
+    type?: string;
+}
+export interface PlaylistSearchResult {
+    id: string;
+    title: {
+        text: string;
+    } | string;
+    author?: {
+        name: string;
+    } | string;
+}
+export interface ChannelSearchResult {
+    id: string;
+    channelId?: string;
+    author?: {
+        name: string;
+    } | string;
+    name?: string;
+}
+export interface SearchResponse {
+    videos?: VideoSearchResult[];
+    playlists?: PlaylistSearchResult[];
+    channels?: ChannelSearchResult[];
+    [key: string]: unknown;
+}
+export interface RelatedContent {
+    id: string;
+    title?: {
+        text: string;
+    } | string;
+    [key: string]: unknown;
+}
+export interface VideoInfo {
+    related?: {
+        contents: RelatedContent[];
+    };
+    chooseFormat?: (options: {
+        type: string;
+        quality: string;
+    }) => {
+        url: string;
+    } | null;
+    [key: string]: unknown;
+}

package/dist/source/types/youtubei.types.js

@@ -0,0 +1,3 @@
+// Type definitions for youtubei.js API responses
+// These interfaces provide proper typing for the dynamic responses from the YouTube API
+export {};

package/dist/source/utils/constants.d.ts

@@ -0,0 +1,65 @@
+export declare const APP_NAME = "@involvex/youtube-music-cli";
+export declare const APP_VERSION = "0.0.1";
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare const VIEW: {
+    readonly PLAYER: "player";
+    readonly SEARCH: "search";
+    readonly PLAYLISTS: "playlists";
+    readonly ARTIST: "artist";
+    readonly ALBUM: "album";
+    readonly HELP: "help";
+    readonly SUGGESTIONS: "suggestions";
+    readonly SETTINGS: "settings";
+    readonly CONFIG: "config";
+    readonly PLUGINS: "plugins";
+};
+export declare const SEARCH_TYPE: {
+    readonly ALL: "all";
+    readonly SONGS: "songs";
+    readonly ALBUMS: "albums";
+    readonly ARTISTS: "artists";
+    readonly PLAYLISTS: "playlists";
+};
+export declare const KEYBINDINGS: {
+    readonly QUIT: readonly ["q", "escape"];
+    readonly HELP: readonly ["?"];
+    readonly SEARCH: readonly ["/"];
+    readonly PLAYLISTS: readonly ["p"];
+    readonly SUGGESTIONS: readonly ["g"];
+    readonly SETTINGS: readonly [","];
+    readonly PLAY_PAUSE: readonly [" "];
+    readonly NEXT: readonly ["n", "right"];
+    readonly PREVIOUS: readonly ["b", "left"];
+    readonly VOLUME_UP: readonly ["="];
+    readonly VOLUME_DOWN: readonly ["-"];
+    readonly SHUFFLE: readonly ["s"];
+    readonly REPEAT: readonly ["r"];
+    readonly SEEK_FORWARD: readonly ["shift+right"];
+    readonly SEEK_BACKWARD: readonly ["shift+left"];
+    readonly UP: readonly ["up", "k"];
+    readonly DOWN: readonly ["down", "j"];
+    readonly SELECT: readonly ["enter", "return"];
+    readonly BACK: readonly ["escape"];
+    readonly CLEAR_SEARCH: readonly ["escape"];
+    readonly NEXT_RESULT: readonly ["tab"];
+    readonly PREV_RESULT: readonly ["shift+tab"];
+    readonly INCREASE_RESULTS: readonly ["]"];
+    readonly DECREASE_RESULTS: readonly ["["];
+    readonly ADD_TO_PLAYLIST: readonly ["a"];
+    readonly REMOVE_FROM_PLAYLIST: readonly ["d"];
+    readonly CREATE_PLAYLIST: readonly ["c"];
+    readonly DELETE_PLAYLIST: readonly ["D"];
+};
+export declare const DEFAULT_VOLUME = 70;
+export declare const MAX_QUEUE_SIZE = 1000;
+export declare const THEMES: {
+    readonly DARK: "dark";
+    readonly LIGHT: "light";
+    readonly MIDNIGHT: "midnight";
+    readonly MATRIX: "matrix";
+    readonly CUSTOM: "custom";
+};
+export declare const PROGRESS_UPDATE_INTERVAL = 100;
+export declare const STATUS_UPDATE_INTERVAL = 1000;
+export declare const DEFAULT_THEME: "dark";

package/dist/source/utils/constants.js

@@ -0,0 +1,82 @@
+// Application constants
+export const APP_NAME = '@involvex/youtube-music-cli';
+export const APP_VERSION = '0.0.1';
+// Config directory
+export const CONFIG_DIR = process.platform === 'win32'
+    ? `${process.env['USERPROFILE']}\\.youtube-music-cli`
+    : `${process.env['HOME']}/.youtube-music-cli`;
+export const CONFIG_FILE = `${CONFIG_DIR}/config.json`;
+// View types
+export const VIEW = {
+    PLAYER: 'player',
+    SEARCH: 'search',
+    PLAYLISTS: 'playlists',
+    ARTIST: 'artist',
+    ALBUM: 'album',
+    HELP: 'help',
+    SUGGESTIONS: 'suggestions',
+    SETTINGS: 'settings',
+    CONFIG: 'config',
+    PLUGINS: 'plugins',
+};
+// Search types
+export const SEARCH_TYPE = {
+    ALL: 'all',
+    SONGS: 'songs',
+    ALBUMS: 'albums',
+    ARTISTS: 'artists',
+    PLAYLISTS: 'playlists',
+};
+// Keybindings
+export const KEYBINDINGS = {
+    // Global
+    QUIT: ['q', 'escape'],
+    HELP: ['?'],
+    SEARCH: ['/'],
+    PLAYLISTS: ['p'],
+    SUGGESTIONS: ['g'],
+    SETTINGS: [','],
+    // Player
+    PLAY_PAUSE: [' '],
+    NEXT: ['n', 'right'],
+    PREVIOUS: ['b', 'left'],
+    VOLUME_UP: ['='], // Only '=' without shift, since '+' requires shift and causes issues
+    VOLUME_DOWN: ['-'], // Only '-' without shift
+    SHUFFLE: ['s'],
+    REPEAT: ['r'],
+    SEEK_FORWARD: ['shift+right'],
+    SEEK_BACKWARD: ['shift+left'],
+    // Navigation
+    UP: ['up', 'k'],
+    DOWN: ['down', 'j'],
+    SELECT: ['enter', 'return'],
+    BACK: ['escape'],
+    // Search
+    CLEAR_SEARCH: ['escape'],
+    NEXT_RESULT: ['tab'],
+    PREV_RESULT: ['shift+tab'],
+    INCREASE_RESULTS: [']'],
+    DECREASE_RESULTS: ['['],
+    // Playlist
+    ADD_TO_PLAYLIST: ['a'],
+    REMOVE_FROM_PLAYLIST: ['d'],
+    CREATE_PLAYLIST: ['c'],
+    DELETE_PLAYLIST: ['D'],
+};
+// Default volume
+export const DEFAULT_VOLUME = 70;
+// Queue limits
+export const MAX_QUEUE_SIZE = 1000;
+// Themes
+export const THEMES = {
+    DARK: 'dark',
+    LIGHT: 'light',
+    MIDNIGHT: 'midnight',
+    MATRIX: 'matrix',
+    CUSTOM: 'custom',
+};
+// Update intervals
+export const PROGRESS_UPDATE_INTERVAL = 100; // ms
+export const STATUS_UPDATE_INTERVAL = 1000; // ms
+// Default theme
+export const DEFAULT_THEME = 'dark';

package/dist/source/utils/format.d.ts

@@ -0,0 +1,3 @@
+export declare function formatTime(seconds: number): string;
+export declare function formatNumber(num: number): string;
+export declare function truncate(text: string, maxLength: number): string;

package/dist/source/utils/format.js

@@ -0,0 +1,24 @@
+// Format utilities
+export function formatTime(seconds) {
+    if (!seconds || seconds < 0) {
+        return '0:00';
+    }
+    const mins = Math.floor(seconds / 60);
+    const secs = Math.floor(seconds % 60);
+    return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+export function formatNumber(num) {
+    if (num >= 1_000_000) {
+        return `${(num / 1_000_000).toFixed(1)}M`;
+    }
+    if (num >= 1_000) {
+        return `${(num / 1_000).toFixed(1)}K`;
+    }
+    return num.toString();
+}
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.slice(0, maxLength - 3) + '...';
+}

package/dist/test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink-testing-library';
+import App from './source/app.js';
+import chalk from 'chalk';
+import test from 'ava';
+test('greet unknown user', t => {
+    const { lastFrame } = render(_jsx(App, { flags: { help: true } }));
+    t.is(lastFrame(), `Hello, ${chalk.green('Stranger')}`);
+});
+test('greet user with a name', t => {
+    const { lastFrame } = render(_jsx(App, { flags: { version: true } }));
+    t.is(lastFrame(), `Hello, ${chalk.green('Jane')}`);
+});

package/package.json

@@ -0,0 +1,100 @@
+{
+	"name": "@involvex/youtube-music-cli",
+	"version": "0.0.0",
+	"description": "- A Commandline music player for youtube-music",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/involvex/youtube-music-cli"
+	},
+	"funding": "https://github.com/sponsors/involvex",
+	"license": "MIT",
+	"author": "involvex",
+	"type": "module",
+	"bin": {
+		"youtube-music-cli": "dist/source/cli.js",
+		"ymc": "dist/source/cli.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"prebuild": "bun run format && bun run lint:fix && bun run typecheck",
+		"build": "tsc",
+		"bun:build": "bun build source/cli.tsx --outfile dist/index.js --target node",
+		"compile": "bun build --compile source/cli.tsx --outfile dist/youtube-music-cli.exe",
+		"dev": "bun run --bun source/cli.tsx",
+		"dev:watch": "bun run --bun --watch source/cli.tsx",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"lint": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-pattern dist",
+		"lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix --ignore-pattern dist",
+		"start": "bun run dist/source/cli.js",
+		"test": "prettier --check . && xo && ava",
+		"typecheck": "tsc --noEmit",
+		"changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
+		"clean": "rimraf dist"
+	},
+	"xo": {
+		"extends": "xo-react",
+		"prettier": true,
+		"rules": {
+			"react/prop-types": "off"
+		}
+	},
+	"prettier": "@vdemedes/prettier-config",
+	"ava": {
+		"extensions": {
+			"ts": "module",
+			"tsx": "module"
+		},
+		"nodeArguments": [
+			"--loader=ts-node/esm"
+		]
+	},
+	"dependencies": {
+		"@distube/ytdl-core": "^4.16.12",
+		"ansi-escapes": "^7.3.0",
+		"ink": "^6.7.0",
+		"ink-table": "^3.1.0",
+		"ink-text-input": "^6.0.0",
+		"jiti": "^2.6.1",
+		"meow": "^14.0.0",
+		"node-youtube-music": "^0.10.3",
+		"play-sound": "^1.1.6",
+		"react": "^19.2.4",
+		"youtube-ext": "^1.1.25",
+		"youtubei.js": "^16.0.1"
+	},
+	"devDependencies": {
+		"@eslint/js": "^10.0.1",
+		"@sindresorhus/tsconfig": "^8.1.0",
+		"@types/react": "^19.2.14",
+		"@vdemedes/prettier-config": "^2.0.1",
+		"ava": "^6.4.1",
+		"chalk": "^5.6.2",
+		"conventional-changelog-cli": "^5.0.0",
+		"eslint": "^10.0.0",
+		"eslint-config-xo-react": "^0.29.0",
+		"eslint-plugin-react": "^7.37.5",
+		"eslint-plugin-react-hooks": "^7.0.1",
+		"globals": "^17.3.0",
+		"ink-testing-library": "^4.0.0",
+		"prettier": "^3.8.1",
+		"prettier-plugin-organize-imports": "^4.3.0",
+		"prettier-plugin-packagejson": "^3.0.0",
+		"prettier-plugin-sort-imports": "^1.8.11",
+		"react-devtools-core": "^7.0.1",
+		"rimraf": "^6.1.3",
+		"ts-node": "^10.9.2",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.56.0",
+		"xo": "^1.2.3"
+	},
+	"engines": {
+		"node": ">=16"
+	},
+	"sponsors": "https://github.com/sponsors/involvex",
+	"trustedDependencies": [
+		"unrs-resolver"
+	]
+}