YouTube Music

Electron wrapper de YouTube Music con las siguientes características:

Apariencia y sensación nativa, tiene como objetivo mantener la interfaz original
Framework para plugins personalizados: cambia YouTube Music según tus necesidades (estilo, contenido, funciones), habilita/deshabilita plugins con un solo clic

Imagen de demostración

Pantalla del reproductor (color del álbum como tema y luz ambiental)

Contenido

Características
Plugins disponibles
Traducción
Descarga
Temas
Dev
Crea tus propios plugins
- Creación de un plugin
- Casos de uso comunes
Compilar
Vista previa de producción
Tests
Licencia
Preguntas frecuentes

Características:

Confirmación automática al pausar (Siempre habilitado): desactiva el mensaje emergente "¿Continuar reproduciendo?" que pausa la música después de cierto tiempo
Y más ...

Plugins disponibles:

Bloqueador de Anuncios: Bloquea todos los anuncios y rastreadores de forma predeterminada
Acciones de Álbum: Agrega botones de deshacer No me gusta, No me gusta, Me gusta, y Deshacer me gusta a todas las canciones de una lista de reproducción o álbum
Tema de Color del Álbum: Aplica un tema dinámico y efectos visuales basados en la paleta de colores del álbum
Modo Ambiente: Aplica un efecto de iluminación proyectando colores suaves del video en el fondo de tu pantalla
Compresor de Audio: Aplica compresión al audio (reduce el volumen de las partes más fuertes de la señal y aumenta el volumen de las partes más suaves)
Barra de Navegación Difuminada: hace que la barra de navegación sea transparente y borrosa
Omitir Restricciones de Edades: omite la verificación de edad de YouTube
Selector de Subtítulos: Habilita los subtítulos
Barra Lateral Compacta: Siempre muestra la barra lateral en modo compacto
Crossfade: Transición suave entre canciones
Desactivar Reproducción Automática: Hace que cada canción comience en modo "pausado"
Discord Rich Presence: Muestra a tus amigos lo que estás escuchando con Rich Presence
Descargador: Descarga MP3 directamente desde la interfaz (youtube-dl)
Volumen Exponencial: Hace que el control de volumen sea exponencial para facilitar la selección de volúmenes más bajos
Menú en la Aplicación: da a las barras un aspecto elegante y oscuro

(consulta esta publicación si tienes problemas para acceder al menú después de habilitar este plugin y la opción hide-menu)
Scrobbler: Agrega soporte para scrobbling en Last.fm y ListenBrainz
Lumia Stream: Agrega soporte para Lumia Stream
Letras Genius: Agrega soporte de letras para la mayoría de las canciones
Music Together: Comparte una lista de reproducción con otros. Cuando el anfitrión reproduce una canción, todos los demás escucharán la misma canción
Navegación: Flechas de siguiente/anterior integradas directamente en la interfaz, como en tu navegador favorito
Sin Inicio de Sesión de Google: Elimina los botones y enlaces de inicio de sesión de Google de la interfaz
Notificaciones: Muestra una notificación cuando comienza una canción a reproducirse (notificaciones interactivas están disponibles en Windows)
Picture-in-picture: permite cambiar la aplicación al modo picture-in-picture
Velocidad de Reproducción: Escucha rápido, escucha lento! Agrega un deslizador que controla la velocidad de reproducción de las canciones
Volumen Preciso: Controla el volumen de forma precisa utilizando la rueda del mouse/atajos de teclado, con un HUD personalizado y pasos de volumen personalizables
Atajos (& MPRIS): Permite configurar atajos globales para la reproducción (reproducir/pausar/siguiente/anterior) + desactivar osd multimedia al anular las teclas multimedia + habilitar Ctrl/CMD + F para buscar + habilitar el soporte mpris de Linux para teclas multimedia + atajos personalizados para usuarios avanzados
Saltar Canción no Gustada: Salta las canciones que no te gustan
Saltar Silencios: Salta automáticamente las secciones de silencio
SponsorBlock: Salta automáticamente las partes que no son de música, como la introducción/final o partes de videos musicales donde no se reproduce la canción
Control Multimedia en la Barra de Tareas: Controla la reproducción desde la barra de tareas de Windows
TouchBar: Diseño personalizado de TouchBar para macOS
Tuna OBS: Integración con el complemento Tuna de OBS
Cambiador de Calidad de Video: Permite cambiar la calidad del video con un botón en la superposición de video
Alternar Video: Agrega un botón para alternar entre el modo de video/canción. también puede eliminar opcionalmente toda la pestaña de video
Visualizador: Diferentes visualizadores de música

Traducción

Puedes ayudar con la traducción en Hosted Weblate.

Descarga

Puedes consultar la última versión para encontrar rápidamente la versión más reciente.

Arch Linux

Instala el paquete youtube-music-bin desde AUR. Para obtener instrucciones de instalación de AUR, consulta esta página del wiki.

macOS

Puedes instalar la aplicación usando Homebrew (consulta la definición de cask):

brew install th-ch/youtube-music/youtube-music

Si instalas la aplicación manualmente y obtienes un error "está dañado y no se puede abrir" al iniciar la aplicación, ejecuta lo siguiente en la Terminal:

/usr/bin/xattr -cr /Applications/YouTube\ Music.app

Windows

Puedes usar el administrador de paquetes Scoop para instalar el paquete youtube-music desde el extras bucket.

scoop bucket add extras
scoop install extras/youtube-music

Alternativamente, puedes usar Winget, el administrador de paquetes CLI oficial de Windows 11 para instalar el paquete th-ch.YouTubeMusic.

Nota: Microsoft Defender SmartScreen podría bloquear la instalación ya que proviene de un "editor desconocido". Esto también esválido para la instalación manual al intentar ejecutar el ejecutable (.exe) después de una descarga manual aquí en GitHub (mismo archivo).

winget install th-ch.YouTubeMusic

Cómo instalar sin conexión a Internet? (en Windows)

Descarga el archivo *.nsis.7z para la arquitectura de tu dispositivo en la página de lanzamientos.
- x64 para Windows de 64 bits
- ia32 para Windows de 32 bits
- arm64 para Windows ARM64
Descarga el instalador en la página de lanzamientos. (*-Setup.exe)
Colócalos en el mismo directorio.
Ejecuta el instalador.

Temas

Puedes cargar archivos CSS para cambiar la apariencia de la aplicación (Opciones > Ajustes visuales > Tema).

Algunos temas predefinidos están disponibles en https://github.com/kerichdev/themes-for-ytmdesktop-player.

Dev

git clone https://github.com/th-ch/youtube-music
cd youtube-music
pnpm install --frozen-lockfile
pnpm dev

Crea tus propios plugins

Usando plugins, puedes:

manipular la aplicación - se pasa el BrowserWindow de electron al controlador del plugin
cambiar la interfaz manipulando el HTML/CSS

Creación de un plugin

Crea una carpeta en src/plugins/NOMBRE-DEL-PLUGIN:

index.ts: el archivo principal del plugin

import style from './style.css?inline'; // importar estilo como inline

import { createPlugin } from '@/utils';

export default createPlugin({
  name: "Plugin Label",
  restartNeeded: true, // si el valor es true, ytmusic muestra el diálogo de reinicio
  config: {
    enabled: false,
  }, // tu configuración personalizada
  stylesheets: [style], // tu estilo personalizado,
  menu: async ({ getConfig, setConfig }) => {
    // Todos los métodos *Config están envueltos en Promise<T>
    const config = await getConfig();
    return [
      {
        label: "menu",
        submenu: [1, 2, 3].map((value) => ({
          label: `value ${value}`,
          type: "radio",
          checked: config.value === value,
          click() {
            setConfig({ value });
          },
        })),
      },
    ];
  },
  backend: {
    start({ window, ipc }) {
      window.maximize();

      // puedes comunicarte con el plugin de renderizado
      ipc.handle("some-event", () => {
        return "hello";
      });
    },
    // se activa cuando cambia la configuración
    onConfigChange(newConfig) { /* ... */ },
    // se activa cuando se desactiva el plugin
    stop(context) { /* ... */ },
  },
  renderer: {
    async start(context) {
      console.log(await context.ipc.invoke("some-event"));
    },
    // Solo disponible en el plugin de renderizado
    onPlayerApiReady(api: YoutubePlayer, context: RendererContext) {
      // establecer la configuración del plugin fácilmente
      context.setConfig({ myConfig: api.getVolume() });
    },
    onConfigChange(newConfig) { /* ... */ },
    stop(_context) { /* ... */ },
  },
  preload: {
    async start({ getConfig }) {
      const config = await getConfig();
    },
    onConfigChange(newConfig) {},
    stop(_context) {},
  },
});

Casos de uso comunes

inyectar CSS personalizado: crea un archivo style.css en la misma carpeta y luego:

// index.ts
import style from './style.css?inline'; // importar estilo como inline

import { createPlugin } from '@/utils';

export default createPlugin({
    name: 'Plugin Label',
    restartNeeded: true, // si el valor es true, ytmusic mostrará el diálogo de reinicio
    config: {
        enabled: false,
    }, // tu configuración personalizada
    stylesheets: [style], // tu estilo personalizado
    renderer() {} // define el hook del renderizador
});

Si quieres cambiar el HTML:

import { createPlugin } from '@/utils';

export default createPlugin({
    name: 'Plugin Label',
    restartNeeded: true, // si el valor es true, ytmusic mostrará el diálogo de reinicio
    config: {
        enabled: false,
    }, // tu configuración personalizada
    renderer() {
        // Elimina el botón de inicio de sesión
        document.querySelector(".sign-in-link.ytmusic-nav-bar").remove();
    } // define el hook del renderizador
});

comunicación entre el front y el back: se puede hacer utilizando el módulo ipcMain de electron. Ver archivo index.ts y ejemplo en el plugin sponsorblock.

Compilar

Clonar el repositorio
Seguir esta guía para instalar pnpm
Ejecutar pnpm install --frozen-lockfile para instalar las dependencias
Ejecutar pnpm build:OS

pnpm dist:win - Windows
pnpm dist:linux - Linux (amd64)
pnpm dist:linux:deb-arm64 - Linux (arm64 para Debian)
pnpm dist:linux:rpm-arm64 - Linux (arm64 para Fedora)
pnpm dist:mac - macOS (amd64)
pnpm dist:mac:arm64 - macOS (arm64)

Construye la aplicación para macOS, Linux y Windows, utilizando electron-builder.

Vista previa de producción

pnpm start

Tests

pnpm test

Utiliza Playwright para probar la aplicación.

Licencia

MIT © th-ch

Preguntas frecuentes

¿Por qué no se muestra el menú de aplicaciones?

Si la opción Ocultar menú está activada - puedes mostrar el menú con la tecla alt (o ` [acento grave] si estás utilizando el plugin in-app-menu)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README-es.md

README-es.md

YouTube Music

Imagen de demostración

Contenido

Características:

Plugins disponibles:

Traducción

Descarga

Arch Linux

macOS

Windows

Cómo instalar sin conexión a Internet? (en Windows)

Temas

Dev

Crea tus propios plugins

Creación de un plugin

Casos de uso comunes

Compilar

Vista previa de producción

Tests

Licencia

Preguntas frecuentes

¿Por qué no se muestra el menú de aplicaciones?

Files

README-es.md

Latest commit

History

README-es.md

File metadata and controls

YouTube Music

Imagen de demostración

Contenido

Características:

Plugins disponibles:

Traducción

Descarga

Arch Linux

macOS

Windows

Cómo instalar sin conexión a Internet? (en Windows)

Temas

Dev

Crea tus propios plugins

Creación de un plugin

Casos de uso comunes

Compilar

Vista previa de producción

Tests

Licencia

Preguntas frecuentes

¿Por qué no se muestra el menú de aplicaciones?