sorwave 0.0.3

Music Sorter based on Python

Sorwave

Sorwave es un potente clasificador de música basado en Python. Utiliza las bibliotecas mutagen y requests para gestionar metadatos y realizar otras operaciones relacionadas con archivos de música. Este proyecto está diseñado para ayudar a los usuarios a organizar y gestionar su colección de música de manera eficiente. https://pypi.org/project/sorwave/

Tabla de Contenidos

• Sorwave
  • Tabla de Contenidos
  • Descripción
  • Instalación
  • Funciones
    • get_metadata
      • Ejemplo de Uso
    • gen_log
      • Ejemplo de Uso
    • new_log
      • Ejemplo de Uso
    • filter_artist
      • Ejemplo de Uso
    • sort_songs
      • Ejemplo de Uso
  • Características
  • Contribuir
  • Roadmap
  • Preguntas Frecuentes
    • ¿Qué formatos de archivos de música son compatibles?
    • ¿Cómo puedo reportar un problema o solicitar una nueva característica?
  • Licencia
  • Contacto
  • Redes
  • Comunidad

Descripción

Sorwave permite a los usuarios organizar su biblioteca de música automáticamente mediante la gestión de metadatos y la clasificación de archivos. Esta herramienta es especialmente útil para quienes desean mantener sus colecciones de música ordenadas sin esfuerzo manual.

Instalación

Puedes instalar Sorwave desde PyPI usando pip:

pip install sorwave

Funciones

get_metadata

from sorwave import get_metadata

Esta función extrae metadatos de una canción cuando se le proporciona la ruta del archivo.

Ejemplo de Uso

metadata = get_metadata("ruta/a/tu/cancion.mp3")
print(metadata)

gen_log

from sorwave import gen_log

Esta función genera un log en el directorio principal de todas las canciones y canciones que hay en los subdirectorios. Guarda un archivo JSON con los metadatos de cada canción organizados por artista, álbumes y canciones en orden.

Ejemplo de Uso

gen_log("ruta/a/tu/carpeta/de/musica")

new_log

from sorwave import new_log

Esta función se puede utilizar para crear un nuevo log de actividades o eventos específicos en el sistema de gestión de música.

Ejemplo de Uso

new_log("Descripción del evento o actividad")

filter_artist

from sorwave import filter_artist

Esta función filtra los nombres de los artistas para que sean compatibles con las rutas de Windows sin que pierdan sentido los nombres.

Ejemplo de Uso

artista = "Nombre: del*Artista?"
artista_filtrado = filter_artist(artista)
print(artista_filtrado)  # Salida: Nombre_del_Artista

sort_songs

from sorwave import sort_songs

Esta función organiza la música en sus respectivas carpetas y subcarpetas (artistas, álbumes y canciones)

Ejemplo de Uso

sort_songs("ruta/a/tu/carpeta/de/musica")

Características

• Gestión de Metadatos: Usa mutagen para leer y escribir metadatos en archivos de música.
• Clasificación de Canciones: Clasifica canciones basadas en diferentes criterios.
• Registro de Actividades: Mantén un registro de las actividades relacionadas con la gestión de la música.
• Interfaz de Línea de Comandos: Ejecuta y gestiona tareas directamente desde la línea de comandos.

Contribuir

¡Las contribuciones son bienvenidas! Si deseas contribuir, por favor sigue estos pasos:

1. Haz un fork del repositorio.
2. Crea una nueva rama (git checkout -b feature/nueva-caracteristica).
3. Realiza tus cambios y haz commit (git commit -am 'Añadir nueva característica').
4. Haz push a la rama (git push origin feature/nueva-caracteristica).
5. Abre un Pull Request.

Roadmap

• Añadir soporte para más formatos de archivos de música.
• Mejorar la documentación con más ejemplos y tutoriales.
• Integración con servicios de música en línea para metadatos automáticos.

Preguntas Frecuentes

¿Qué formatos de archivos de música son compatibles?

Actualmente, Sorwave soporta archivos MP3 y FLAC. Estamos trabajando para añadir soporte para más formatos en futuras versiones.

¿Cómo puedo reportar un problema o solicitar una nueva característica?

Puedes abrir un issue en GitHub para reportar problemas o solicitar nuevas características.

Licencia

Este proyecto está bajo la Licencia Apache 2.0. Consulta el archivo LICENSE para más detalles.

Contacto

Autor: a-esh
Email: [e-mail]

Redes

Comunidad