ultrasonics
1.1.0
Actualización 2022
Los ultrasonidos no están obsoletos, pero no tengo tanto tiempo como me gustaría trabajar en su desarrollo. Planeo volver a hacerlo en el futuro, ¡espero que puedas soportarme! Una próxima actualización importante se refiere a ultrasonics-api . Actualmente estoy alojando una versión pública en el nivel gratuito de Heroku, que se cerrará a finales de noviembre de 2022, como se anunció en agosto. Es necesario para cualquier servicio público de streaming (Spotify, Last.fm, etc.).
Todavía no tengo ninguna alternativa configurada, así que antes de que llegue ese momento le insto a que configure su propia instancia de ultrasonics-api junto con ultrasonics y claves para cualquier servicio en línea con el que desee sincronizar. ¡Todas las instrucciones están disponibles en ese repositorio!
Descripción general
Instalación
sistemad
Opción 1 (instalación manual)
Opción 2 (acoplador)
Applets
Entradas
Modificadores (opcionales)
Salidas
Desencadenantes
Complementos
Modo de listas de reproducción frente a modo de canciones
Contribuyendo
Escribiendo tu propio complemento
Mejora del código fuente de los ultrasonidos
¡Bienvenidos a los ultrasonidos !
Ultrasonics es una herramienta diseñada para ayudarte a tomar el control de tu biblioteca y listas de reproducción de música. Atrás quedaron los días en los que las listas de reproducción estaban repartidas en tres servicios diferentes o en que se limitaba a usar un solo servicio porque no se tenía tiempo para seleccionar manualmente varias copias de la misma lista de reproducción.
ultrasonics utiliza complementos para interactuar con sus servicios favoritos. Esto significa que se puede agregar funcionalidad simplemente instalando un nuevo complemento. Cada complemento puede proporcionar compatibilidad con un servicio, por ejemplo, el complemento oficial de Spotify enlaza con... bueno, Spotify, por supuesto. Otros complementos brindan funciones adicionales, como fusionar listas de reproducción de más de una fuente.
La descripción general de todos los complementos incluidos se puede encontrar en [documentación incompleta].
Para ejecutar ultrasonidos tienes dos opciones:
Descargue y ejecute ultrasonidos directamente.
Extraiga y ejecute la imagen oficial de Docker.
ultrasonidos fue desarrollado en Linux. Debería ser compatible con varias plataformas, pero no se ha probado, así que prepárate para errores o problemas en Windows/macOS.
Asegúrate de tener Python 3 instalado
# Si este comando no funciona, instale Python 3callum en uluru en ~↪ python3 --version Pitón 3.8.2
Clona el repositorio en un directorio de instalación, tal vez /opt/ultrasonics
# Muévete a tu directorio de instalación callum en uluru en ~↪ cd /opt# Clona este repocallum en uluru en /opt ↪ git clone https://github.com/XDGFX/ultrasonics# Asegúrese de tener la propiedad de la carpeta de ultrasonidos en uluru en /opt ↪ sudo chown -R callum:callum ultrasonics/
Cree un entorno virtual e instale las dependencias necesarias dentro de él.
# Ir al directorio de ultrasonidos callum en uluru en /opt ↪ cd ultrasonics# Crea un entorno virtual en la carpeta '.venv'callum en uluru en /o/ultrasonics ↪ python3 -m venv .venv# Activa el entorno.# Si estás usando un shell diferente, usa enable.<shell>#, por ejemplo, fuente .venv/bin/activate.fish para fish!callum en uluru en /o/ultrasonics ↪ fuente .venv/bin/activate# Asegúrese de que su venv esté activo (consulte el .venv al inicio de la línea)# Instale las dependencias de Python callum en uluru en /o/ultrasonics (.venv) ↪ instalación de pip3 -r requisitos.txt
Ejecutar app.py
# Con venv aún activo, ejecuta app.pycallum en uluru en /o/ultrasonics (.venv) ↪ aplicación python3.py
Si desea ejecutar esto como un proceso systemd, siga los pasos a continuación:
Copie el archivo de servicio de ejemplo en /etc/systemd/system/ultrasonics.service
sudo cp ultrasonics.service /etc/systemd/system/ultrasonics.service
Vuelva a cargar el demonio systemctl para recibir el nuevo servicio.
sudo systemctl daemon-reload
Habilitar e iniciar el servicio.
sudo systemctl enable --ahora ultrasonidos
Puede consultar el estado del proceso mediante:
ultrasonidos de estado systemctl
La imagen oficial de ultrasonidos se encuentra en xdgfx/ultrasonics. Puede extraerlo y ejecutarlo manualmente o pegarlo en su archivo docker-compose.yml .
versión: "3.7" servicios: ultrasonidos: imagen: xdgfx/ultrasonicscontainer_name: ultrasonidosrestart: a menos que se detengan puertos:
- 5000:5000 volúmenes:
- /path/to/config:/config - /path/to/plugins:/plugins # Se utiliza para entornos de complementos de terceros:
- PUID=${PUID} - PGID=${PGID}Si alguna vez ha utilizado IFTTT, ya comprende los fundamentos. Los ultrasonidos trabajan con el concepto de 'applets'. Cada subprograma que cree contiene complementos que encajan en una de cuatro categorías:
Estos complementos se conectan a un servicio para obtener una lista de canciones o listas de reproducción y pasar esa lista a los complementos Modificadores y Salida.
Estos complementos toman una lista de canciones o listas de reproducción de uno o más complementos de entrada y modifican la lista de alguna manera. Por ejemplo, pueden fusionar listas de reproducción duplicadas o reemplazar las canciones con canciones similares utilizando una API de descubrimiento de música.
Estos complementos toman la lista de listas de reproducción que se les pasa y las guardan en un servicio. Tal vez actualicen o creen sus listas de reproducción en Plex, o las guarden en un archivo .m3u en su servidor doméstico.
Estos complementos no forman parte del flujo de canciones/lista de reproducción, sino que determinan cuándo se ejecuta realmente el subprograma. El activador más simple se basa en el tiempo, por ejemplo, "Ejecutar una vez cada 6 horas".
Puede crear sus subprogramas personalizados utilizando los complementos instalados, guardarlos en la base de datos y luego se ejecutará automáticamente desde un complemento Trigger o ejecutando manualmente el subprograma desde la página de inicio.
ultrasonics viene con varios complementos oficiales. Para obtener más información, consulte [documentación incompleta].
Se pueden instalar nuevos complementos simplemente copiando la carpeta que contiene el complemento en el directorio plugins .
Cada subprograma necesita al menos un complemento de entrada y uno de salida. Para ejecutarse automáticamente, también necesita un complemento de activación.
La mayoría de los complementos tendrán configuraciones para configurar, que podrían ser configuraciones persistentes globales (comunes para todas las instancias del complemento, en todos sus subprogramas) o específicas para esta instancia del complemento.
Se le pedirá que ingrese las configuraciones requeridas cuando esté creando su subprograma.
¡La configuración siempre se puede dejar en blanco! En algunos casos, esto está bien o es lo esperado; sin embargo, en otros casos, esto puede provocar errores en el complemento que podrían requerir la reparación manual de la base de datos de ultrasonidos. ¡Asegúrate de completar todas las configuraciones necesarias!
Algunos complementos están diseñados para funcionar con listas de reproducción; por ejemplo, el complemento de Spotify interactúa con sus listas de reproducción de Spotify. Algunos complementos están diseñados para funcionar con canciones, por ejemplo, tus 100 canciones principales en Last.fm.
Si un complemento solo funciona en modo canciones, se mostrará una advertencia en la pantalla "seleccionar complemento".
Agregar un complemento de modo de canciones a una entrada funcionará efectivamente agregando una única lista de reproducción al flujo del subprograma. Esto debería funcionar sin problemas, siempre y cuando el complemento en cuestión proporcione un nombre para esta única lista de reproducción.
Intentar incluir varias listas de reproducción en un solo complemento de salida en modo de canciones probablemente causará problemas; no se recomienda.
¿Quieres ayudar a mejorar los ultrasonidos? Primero que nada, ¡gracias! Como alguien que no es ingeniero de software, este es uno de los proyectos más importantes en los que he trabajado. ¡Cualquier ayuda o sugerencia es muy apreciada!
¡Ampliar la funcionalidad de los ultrasonidos es fácil! Un complemento es una instalación de arrastrar y soltar, por lo que puede mejorar enormemente el proyecto con una complejidad mínima. La mejor manera de aprender es a través de la wiki. Puedes bifurcar este proyecto o crear tu propio repositorio específicamente para tu complemento. Puede mantenerse separado, o si cree que beneficiaría a la comunidad al crearlo como complemento predeterminado, ¡hágamelo saber a través de un problema de GitHub!
Pondré planes futuros, problemas conocidos o mejoras generales en los problemas. También eche un vistazo a los tableros de proyectos, que deberían mostrar los temas que son de alta prioridad.
O, si tienes una idea nueva, pruébala y házmelo saber con una solicitud de extracción o un problema. ?
