Documentación de ML-Player

Un reproductor multimedia accesible y potente, impulsado por VLC.

Este reproductor está impulsado por VLC media player, utilizando Python como lenguaje y la biblioteca python-vlc. La interfaz gráfica está diseñada con wxPython para garantizar una mayor accesibilidad.

Funciones Básicas

La aplicación cuenta con las funciones esenciales de cualquier reproductor de medios:

  • Pausar/reanudar
  • Detener
  • Control de volumen
  • Adelantar/retroceder
  • Medio anterior/siguiente
  • Silenciar/desilenciar

Otras Funciones

  • Control de velocidad de reproducción (aumentar, disminuir, normalizar).
  • Ir a un tiempo específico (formato hh:mm:ss).
  • Modo aleatorio y modo de repetición.
  • Soporte para listas de reproducción generadas al cargar una carpeta.
  • Descarga de videos desde YouTube.

Plugins: Ampliando las Capacidades

A partir de la versión 3.6, ML-Player cuenta con un sistema de plugins que permite a la comunidad de desarrolladores ampliar y añadir nuevas funcionalidades al reproductor. Puedes instalar características creadas por otros para personalizar tu experiencia.

¿Cómo se utiliza?

El reproductor se controla principalmente a través de su barra de menú, accesible con la tecla Alt. A continuación se detallan los menús disponibles.

Menú Archivo

Contiene acciones para cargar contenido:

  • Cargar archivo, carpeta o lista M3U/M3U8.
  • Cargar pista de subtítulos: Permite seleccionar un archivo de subtítulos (ej. .srt) desde tu computadora para un video en reproducción.
  • Reproducir desde una URL o un enlace de YouTube.
  • Salir de la aplicación.

Menú Reproducción

Opciones para controlar la reproducción actual:

  • Controles básicos (Reproducir/Pausar, Detener, Anterior, Siguiente).
  • Modos Aleatorio y Repetir.
  • Temporizador de apagado para programar el cierre de la aplicación.

Menú Audio

  • Seleccionar pista de audio (para archivos con múltiples idiomas).
  • Seleccionar dispositivo de salida de audio.
  • Ecualizador de audio de 5 bandas.
  • Seleccionar pista de subtítulos: Si el video que estás viendo ya incluye subtítulos integrados, esta opción te permite elegir cuál mostrar.

Diferencia clave: Cargar subtítulos es para añadir un archivo externo desde tu PC, mientras que Seleccionar subtítulos es para cambiar entre los que ya vienen dentro del propio video.

Menú Playlists

Gestiona tus listas de reproducción:

  • Seleccionar, mostrar, crear, renombrar o eliminar listas.
  • Añadir o eliminar archivos de una lista existente.

Menú Audiocinemateca

Accede al catálogo de Audiocinemateca:

  • Explorar Catálogo: Navega por series y películas, con opciones de búsqueda y filtrado.
  • Mis Favoritos: Gestiona y reproduce tus contenidos guardados de Audiocinemateca.
  • Cerrar Sesión: Desconecta tu cuenta de Audiocinemateca.

Menú LibriVox

Explora y gestiona audiolibros de dominio público:

  • Explorar Catálogo: Busca audiolibros por título o género.
  • Explorar por Género: Navega por los audiolibros organizados por categorías temáticas.
  • Últimos Lanzamientos: Descubre los audiolibros más recientes.

Menú Herramientas

  • Marcadores: Añade y gestiona marcadores en tus archivos de audio/video.
  • Historial: Revisa y reproduce elementos de tu historial.
  • Copias de seguridad: Importa o exporta la configuración de la aplicación.
  • Búsqueda de Contenido: Busca y reproduce videos directamente desde YouTube.
  • Preferencias: Configura el comportamiento del reproductor.

Menú Contenido para Adultos

Este menú agrupa las opciones de búsqueda de contenido para adultos (XNXX, Xvideos, Pornhub).

Nota Importante: Este menú está oculto por defecto. Para mostrarlo u ocultarlo, ve a Menú -> Herramientas -> Preferencias y en la pestaña General, marca o desmarca la opción Mostrar contenido para adultos (+18).

Menú Actualización

  • Permite buscar y actualizar la herramienta yt-dlp a su última versión.
  • Permite buscar actualizaciones para el reproductor.

Menú Plugins

Gestiona tus plugins:

  • Ver, habilitar o deshabilitar plugins instalados.
  • Instalar un nuevo plugin desde un archivo .ml-plugin.
  • Eliminar plugins que ya no necesites.

Menú Ayuda

  • Acceso a esta documentación.
  • Información "Acerca de" la aplicación.

Reproduciendo desde URL

Al intentar reproducir desde una URL, el programa te preguntará si requiere autenticación. Si respondes "Sí", te pedirá la URL, el usuario y la contraseña. Si respondes "No", solo solicitará el enlace al archivo multimedia.

Atajos de teclado

Nota Importante: A partir de la versión 3.6, la mayoría de estos atajos son personalizables en Menú -> Herramientas -> Preferencias -> Atajos de teclado. Además, puedes activar la "Ayuda de entrada" con Ctrl+Shift+M para que el reproductor anuncie la acción de cada atajo en lugar de ejecutarla.

1. Controles básicos de reproducción

AtajoAcción
EspacioPausa / Reanuda
SDetiene la reproducción
PPista anterior
NPista siguiente
RModo repetir
Ctrl+RModo aleatorio

2. Control de tiempo y navegación

AtajoAcción
Flecha DerechaAdelanta
Flecha IzquierdaRetrocede
GIr a un tiempo específico

3. Control de audio

AtajoAcción
Flecha ArribaSube volumen
Flecha AbajoBaja volumen
MSilenciar
ZNormaliza la velocidad
XDisminuye la velocidad
CAumenta la velocidad

4. Información y verbalizaciones

AtajoAcción
VVerbaliza volumen
Shift+VVerbaliza velocidad
TVerbaliza tiempo
Ctrl+TVerbaliza título
LMuestra lista de reproducción

Formatos soportados

ML-Player es compatible con una amplia variedad de formatos de audio y video, incluyendo:

  • MP3
  • MP4
  • M4A
  • WAV
  • MKV
  • Opus
  • OGG
  • FLAC
  • AVI

Una nota sobre el futuro de ML-Player

Con el lanzamiento de la versión 3.6, el ciclo de desarrollo activo y las actualizaciones frecuentes de ML-Player entrarán en una pausa. Esto no significa que sea la versión final, pero el desarrollo de nuevas funcionalidades se ralentizará durante un tiempo. Agradecemos a todos los usuarios por su apoyo y sus sugerencias.

Cambios recientes

Versión 4.4.0: Integración Completa con LibriVox

Nuevas Características

  • Integración Completa con LibriVox: Ahora puedes explorar, buscar y reproducir audiolibros de dominio público directamente desde ML-Player.
    • Explorador de Audiolibros: Un nuevo explorador te permite buscar audiolibros por título o género.
    • Exploración por Género: Descubre audiolibros organizados por categorías temáticas.
    • Últimos Lanzamientos: Mantente al día con los audiolibros más recientes añadidos a LibriVox.
    • Descarga de Audiolibros: Descarga audiolibros completos o capítulos seleccionados para escucharlos sin conexión. Un indicador de progreso te mantendrá informado.
    • Menú Dedicado: Todas las funciones de LibriVox están convenientemente agrupadas en un nuevo menú principal.

Mejoras de Experiencia de Usuario

  • Búsqueda Inteligente: La búsqueda de audiolibros ahora es más precisa, mostrando resultados que coinciden con el inicio del título.
  • Retroalimentación por Voz: Recibirás alertas de audio claras sobre el número de resultados de búsqueda y al seleccionar o deseleccionar capítulos, mejorando la accesibilidad.
  • Guía en Pantalla: Se han añadido instrucciones útiles en los diálogos para facilitar la selección de capítulos.

Correcciones de Errores

  • Se ha corregido un problema que impedía buscar audiolibros por género, haciendo la función de búsqueda más flexible.
Versión 4.3.0: Mejoras en Audiocinemateca y Correcciones

Nuevas Características

  • Audiocinemateca - Gestión Mejorada de Favoritos:
    • Organización por Tipo: Tus favoritos de Audiocinemateca ahora se organizan en categorías como "Películas" y "Episodios", facilitando su gestión.
    • Nombres Claros para Episodios: Al guardar un episodio, su nombre incluirá automáticamente el título de la serie para una mejor identificación.
  • Diálogo "Ir a Tiempo" Mejorado: Al usar la función "Ir a tiempo", el diálogo ahora mostrará el tiempo actual de reproducción como referencia.

Correcciones de Errores

  • Reproducción Estable de YouTube: Se ha solucionado un error crítico que causaba que los videos de YouTube se recargaran infinitamente, asegurando una reproducción fluida.
  • Visualización Correcta de Series en Audiocinemateca: Se han corregido problemas que impedían la correcta visualización y reproducción de series desde el explorador principal y desde tus favoritos.
Versión 4.2.0: Control Parental y Estadísticas Detalladas

Nuevas Características

  • Control Parental Avanzado:
    • Menú de Contenido +18: Se ha añadido un nuevo menú "Contenido +18" que agrupa las opciones de búsqueda de contenido para adultos (Pornhub, XNXX, Xvideos).
    • Configuración Flexible: Puedes ocultar o mostrar este menú fácilmente desde las preferencias de la aplicación, ofreciendo un mayor control sobre el contenido.
  • Estadísticas de Reproducción Detalladas:
    • Desglose por Categoría: Consulta tus hábitos de escucha y visualización con estadísticas que clasifican tu contenido como "Música", "Video" u "Otro".
    • Actividad Horaria: Descubre a qué horas del día utilizas más el reproductor con un desglose de actividad por cada hora.

Mejoras de Experiencia de Usuario

  • Búsqueda de Tiempo Precisa: Se ha implementado un sistema de búsqueda de tiempo más avanzado y configurable mediante atajos de teclado.
  • Estadísticas Más Fiables y Accesibles: Las estadísticas de reproducción ahora son más precisas, especialmente el porcentaje de finalización de medios. Además, se ha mejorado la accesibilidad del diálogo de estadísticas para usuarios de lectores de pantalla.
  • Internacionalización Ampliada: Los diálogos "Ir a Tiempo" y "Novedades" ahora están disponibles en varios idiomas.

Correcciones de Errores

  • Cálculo Correcto de Estadísticas: Se ha corregido un error en el cálculo de la actividad de reproducción diaria para asegurar que los datos sean precisos.
  • Reproducción Continua en Listas: Se ha solucionado un problema que causaba que el reproductor no se detuviera completamente al final de una lista de reproducción, lo que afectaba el tiempo total registrado.
Versión 4.1.0: Estadísticas, XNXX y Favoritos de Audiocinemateca

Nuevas Características

  • Estadísticas de Reproducción:
    • Top 10 Más Reproducidos: Descubre cuáles son tus medios favoritos con un nuevo diálogo que muestra los 10 elementos más reproducidos.
  • Funcionalidades Extendidas para XNXX:
    • Descarga de Videos: Ahora puedes descargar videos de XNXX.
    • Búsqueda Avanzada: Se han añadido filtros de búsqueda y mejoras en la interfaz para una mejor experiencia.
  • Audiocinemateca - Favoritos:
    • Guarda tu Contenido Preferido: Añade, elimina y visualiza tus películas, series y documentales favoritos de Audiocinemateca.
    • Acceso Rápido: Una nueva opción en el menú te permite acceder directamente a tu lista de favoritos.
  • Múltiples Instancias: Ahora puedes abrir varias ventanas de ML-Player al mismo tiempo.

Mejoras de Experiencia de Usuario

  • Descargas de XNXX Optimizadas: Se ha mejorado la experiencia de usuario al descargar contenido de XNXX.

Correcciones de Errores

  • Contador de Reproducciones Fiable: Se ha corregido un error que impedía que el contador de reproducciones se actualizara correctamente, especialmente al usar el modo de repetición.
  • Restablecimiento de Tiempo en el Deslizador: Se ha solucionado un problema relacionado con el restablecimiento del tiempo en el deslizador de reproducción.

Otros Cambios

  • Se ha centralizado la lógica para detener el reproductor, mejorando la estabilidad.
  • Se han realizado ajustes en la documentación y el instalador para reflejar la versión 4.0.0.
Versión 4.0: La Gran Reestructuración

Esta versión representa una de las actualizaciones más grandes en la historia de ML-Player. Se ha reescrito el sistema de actualizaciones, se ha implementado un framework completo de internacionalización, se ha modularizado la funcionalidad de plugins y se han añadido nuevas integraciones de contenido.

Novedades Principales

  • Integración con Audiocinemateca: Se ha añadido una integración completa con el servicio Audiocinemateca, accesible desde su propio menú en la barra principal.
    • Navegación Completa: Explora el catálogo por categorías, busca, y ordena los resultados. La interfaz carga los resultados en lotes de 200 para mayor fluidez y te notifica con una alerta de audio cuando se cargan más.
    • Detalles y Reproducción: Visualiza los detalles de las series, incluyendo el número de temporadas y el idioma. Al reproducir un capítulo, la temporada completa se carga automáticamente en la lista de reproducción.
    • Gestión de Cuentas (Crear cuenta): Inicia y cierra sesión de forma segura. Las credenciales se pueden guardar de forma segura en el gestor de credenciales del sistema operativo (keyring), y la contraseña se puede mostrar u ocultar en el diálogo.
  • Internacionalización (i18n): La aplicación ahora es multi-idioma (inglés y español para empezar).
    • Se ha traducido una parte de la interfaz, incluyendo diálogos, menús y alertas de audio.
    • Se ha implementado soporte para traducción contextual (pgettext), lo que permite desambiguar términos como "Eliminar" (quitar de una lista vs. borrar un archivo).
  • Sistema de Actualizaciones Totalmente Nuevo: Se ha rediseñado desde cero el sistema de actualizaciones para ser más robusto y flexible. Un agradecimiento especial a rayo-alcantar por su ayuda en el diseño e implementación de este nuevo sistema.
    • Auto-actualización del Actualizador: La aplicación ahora puede actualizar el propio updater.exe, asegurando que la lógica de actualización siempre esté al día.
    • Instalación Robusta: El proceso de actualización ya no borra archivos, sino que fusiona los cambios, evitando la pérdida de datos o plugins.
  • Búsqueda en Pornhub: Se ha integrado un nuevo módulo para buscar videos en Pornhub, accesible con el atajo Ctrl+Alt+P. Incluye filtros por etiquetas y orden.
  • Actualización de Títulos de Radio: El reproductor ahora monitorea las transmisiones de radio y actualiza automáticamente el título de la ventana cuando la canción cambia.

Mejoras de Rendimiento y Experiencia de Usuario

  • Arranque más Rápido: La carga de plugins ahora es asíncrona, lo que evita que la interfaz se bloquee al inicio mientras se extraen o actualizan los plugins.
  • Búsqueda Fluida: Se ha añadido un retardo (debounce) a la búsqueda de Audiocinemateca para evitar que la aplicación se congele al escribir rápidamente.
  • Caché de Catálogo: El catálogo de Audiocinemateca se guarda en memoria después de la primera carga, haciendo que las aperturas posteriores del explorador sean casi instantáneas.
  • Mejoras de Accesibilidad:
    • Se ha rediseñado el diálogo de Audiocinemateca para una navegación más lógica y accesible con lectores de pantalla.
    • Se ha corregido un problema que hacía que el foco se perdiera después de filtrar o actualizar listas.
  • Notificaciones Menos Intrusivas: Se han reemplazado muchos diálogos de notificación por alertas de audio que no interrumpen el flujo de trabajo.

Correcciones de Errores

  • Autenticación: Solucionado un bug crítico que guardaba credenciales incorrectas y no manejaba bien los errores de conexión en Audiocinemateca.
  • Atajos de Teclado: Corregido un error que impedía el funcionamiento de atajos que usan la tecla Alt.
  • Portapapeles: Solucionado un error en Windows que podía ocurrir al intentar leer el portapapeles varias veces.
  • Plugins: Corregida la ruta de carga de plugins cuando la aplicación está instalada, solucionando problemas de detección.
  • Streams de Radio: Corregido un error que impedía obtener correctamente la información de duración en streams de radio en vivo.

Cambios para Desarrolladores

  • API de Plugins Mejorada: El AppContext ahora incluye un método speak() para que los plugins puedan dar feedback de audio al usuario.
Versión 3.8

Esta versión se centra en importantes mejoras en la calidad, la gestión de la reproducción y la integración de un nuevo motor de voz.

Nuevas Características

  • Nuevo motor de voz SAPI: Se ha integrado Microsoft SAPI como una alternativa a NVDA, permitiendo el uso del reproductor sin un lector de pantalla activo.
  • Personalización de SAPI: Ahora es posible seleccionar la voz y ajustar la velocidad del motor SAPI desde el diálogo de preferencias.
  • Restauración de Posición Mejorada: La última posición de reproducción ahora se guarda y restaura de forma fiable en más lugares:
    • Al cambiar de pista en una playlist (local y URLs).
    • Al cargar el primer archivo de una carpeta o lista M3U.
    • Al reproducir un medio desde el historial, incluyendo URLs.
  • Marcadores para URLs: Ahora es posible crear y reproducir marcadores para streams y vídeos de internet.
  • Actualizaciones Periódicas: Se ha añadido una opción en las preferencias para buscar actualizaciones de la aplicación periódicamente.
  • Visor de Novedades: Integrada una nueva opción en el menú de ayuda para ver qué hay de nuevo en la versión actual.
  • Más Atajos Personalizables: Se han añadido más comandos a la lista de atajos de teclado que se pueden personalizar.

Correcciones y Mejoras

  • Corregido un error que impedía la correcta carga de medios desde el portapapeles.
  • Ajustada la verbalización del cambio de velocidad para que sea menos frecuente.
  • Optimizada la eliminación de marcadores para que sea instantánea, incluso con muchos elementos.
  • Mejoras internas en la gestión de la base de datos y la lógica de guardado de posición para mayor fiabilidad.
Versión 3.7
  1. Mejoras en el Panel de Video: Se ha mejorado significativamente la experiencia de visualización de videos.
    • Modo de Pantalla Completa: Ahora se puede entrar y salir del modo de pantalla completa haciendo doble clic sobre el video o presionando la tecla F11.
    • Controles Ocultables: En el modo de pantalla completa, los controles de reproducción se ocultan automáticamente después de 3 segundos de inactividad.
    • Retroalimentación por Voz: El reproductor ahora anuncia verbalmente cuando se activa o desactiva el modo de pantalla completa.
  2. Verbalización de Subtítulos Externos: Se ha añadido la capacidad de cargar y verbalizar archivos de subtítulos externos (.srt).
  3. Corrección de Congelamiento al Cerrar: Se ha resuelto un problema que causaba que la aplicación se congelara al cerrarla.
  4. Menú Contextual en Playlists: Acceso más rápido a acciones comunes.
  5. Gestor de Fila de Reproducción: Se ha añadido un nuevo diálogo para gestionar la fila de reproducción (Ctrl+Q).
Versión 3.6
  1. Atajos de Teclado Personalizables: ¡Ahora puedes cambiar la mayoría de los atajos de teclado!
  2. Modo de Ayuda de Entrada: Se ha añadido una nueva función para aprender los atajos (Ctrl+Shift+M).
  3. Mejora en la Carga de URLs: La aplicación ya no se congelará mientras procesa una URL.
Versión 3.5

Corregido un problema al verificar actualizaciones al iniciar el reproductor.

Versión 3.4

Se ha modificado el diálogo de búsqueda de YouTube, añadiendo nuevos comandos y un botón para copiar la URL del video. También se añadieron nuevas opciones de configuración para el historial y la visualización de extensiones de archivo. Finalmente, se añadió la capacidad de reproducir contenido desde el portapapeles con Ctrl+V.

Versión 3.3
  1. Corregidos problemas con el actualizador.
  2. Añadido soporte para listas M3U.
Versión 3.0, 3.1 y 3.2

Se integró un ecualizador de audio, se mejoró la gestión de marcadores y se añadió la posibilidad de usar teclas multimedia. Además, se actualizó yt-dlp y se eliminó la necesidad de tener VLC instalado por separado.

Versiones anteriores (2.3 a 2.8)

Se realizaron múltiples mejoras, incluyendo la eliminación del requisito de una clave API para búsquedas en YouTube, la introducción de listas de reproducción, la adición de marcadores, la capacidad de descargar videos de YouTube y se modificó el sistema de actualizaciones. También se corrigieron varios errores para mejorar la estabilidad.

Donaciones

Si deseas apoyar la mejora constante de este y otros proyectos, te invito a considerar una donación.