{"id":49193330,"url":"https://github.com/dbetm/spotify-wrapy","last_synced_at":"2026-04-23T08:04:42.596Z","repository":{"id":112483292,"uuid":"577129809","full_name":"dbetm/spotify-wrapy","owner":"dbetm","description":"Generate some visualizations, stats, and a video and stats. Inspired by Spotify Wrapped.","archived":false,"fork":false,"pushed_at":"2025-11-27T05:53:53.000Z","size":4188,"stargazers_count":9,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-29T21:23:25.169Z","etag":null,"topics":["music","python-visualization","spotify","spotify-wrapped"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dbetm.png","metadata":{"files":{"readme":"README.es.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-12-12T02:58:17.000Z","updated_at":"2025-11-27T05:53:20.000Z","dependencies_parsed_at":"2024-11-10T22:19:53.916Z","dependency_job_id":"e0c4aa9e-f415-4eb4-b556-1e0bd3bef73f","html_url":"https://github.com/dbetm/spotify-wrapy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dbetm/spotify-wrapy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbetm%2Fspotify-wrapy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbetm%2Fspotify-wrapy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbetm%2Fspotify-wrapy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbetm%2Fspotify-wrapy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dbetm","download_url":"https://codeload.github.com/dbetm/spotify-wrapy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbetm%2Fspotify-wrapy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32171228,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T02:19:40.750Z","status":"ssl_error","status_checked_at":"2026-04-23T02:17:55.737Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["music","python-visualization","spotify","spotify-wrapped"],"created_at":"2026-04-23T08:04:14.994Z","updated_at":"2026-04-23T08:04:42.559Z","avatar_url":"https://github.com/dbetm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spotify WraPy\n\n[English](README.md) / [Español](README.es.md)\n\nDisfruta de tu experiencia en Spotify generando un video personalizado que muestra tus estadísticas de reproducción. Este video incluye varios gráficos informativos:\n\n- Reproducciones por hora, mes y día de la semana: Visualiza tus hábitos de escucha a lo largo del día y tus patrones semanales y mensuales.\n- Canciones y artistas principales y horas pico de escucha: Descubre tus pistas favoritas y los momentos en que las escuchas con mayor frecuencia.\n\nAdemás, el video proporciona estadísticas detalladas, como:\n\n- Tiempo total de reproducción: Mostrado en días, horas y minutos.\n- Reproducciones totales: El número total de canciones que has escuchado.\n- Canciones omitidas: Pistas que has saltado durante la reproducción.\n- Artistas y canciones únicas: La diversidad de tus elecciones musicales.\n\n![](assets/plays_per_hour.png)\n\n[Video de ejemplo](https://youtube.com/shorts/oalWYvvdk-M?feature=share)\n\n\n## Descargar tus datos de Spotify\n_Actualizado: 10 noviembre 2024_\n\n- En la app de escritorio en el menú desplegable donde está tu foto de perfil selecciona la opción **Cuenta**.\n- Elegir **Privacidad de la cuenta**.\n- En la sección de **Descargar tus datos** seleccionada la opción de **Datos de cuenta**.\n- Dar click en **Solicitar datos**.\n- En 5-10 días te envíarán los datos a tu correo (el asociado a tu cuenta de Spotify) algo como esto:\n\n![](assets/ejemplo_correo_descargar_datos.png) \n\n- Da click en el botón de \"Descargar\". Se descargará una archivo `.zip`.\n- Descomprime el archivo y tendrás una carpeta **my_spotify_data** con tus datos.\n\n---------------\n\n## Instalar el proyecto\n\n**Requerimientos a instalar**\n\n- Git\n- Python 3.8 o una versión mayor.\n\n**Descargar el repositorio**\n```bash\ngit clone https://github.com/dbetm/spotify-wrapy.git\n```\n\n**Moverse al repo**\n\n```bash\ncd spotify-wrapy\n```\n\n\n**Instalar bibliotecas necesarias de Python**\n\n```bash\nmake install\n```\n\nNota: El comando anterior va a crear un entorno virtual de Python.\n\n------------------------\n\n## Generar video de Spotify WraPy\n\n1) Dentro de la carpeta con tus datos busca los archivos llamados algo como `StreamingHistory_music.json`. Podría ser solo uno, llamado: `StreamingHistory_music_0.json`.\n2) Copia ese o esos archivos y pegalos en la carpeta `spotify_data/` que está dentro del repositorio.\n3) Activa el entorno virtual, si no lo has hecho.\n```bash\nsource .venv/bin/activate\n```\n4) En la línea de comandos ejecuta:\n```bash\npython3 app.py --lang spanish\n```\nTambién soporta idioma inglés: `python3 app.py --lang english` si no se pasa este argumento, por defecto estará en inglés.\n\nAlternativamente puedes pasar la fecha de inicio y final para delimitar los datos a usar, ejemplo:\n```bash\npython3 app.py --lang spanish --start-date 2022-01-13 --end-date 2023-01-01\n```\nY si no deseas generar el video:\n```bash\npython3 app.py --lang spanish --no-video\n```\n5) Los resultados se guardarán dentro de una carpeta (con nombre según la fecha y hora de ejecución) que estará dentro de la carpeta [output](output/).\n\n\n**Nota importante**: El timestamp dado por Spotify usa tiempo UTC. En este proyecto por defecto se calcula la zona horaria de la computadora donde se ejecuta; puedes usar otra zona horaria ejecutando:\n\n```bash\npython3 app.py --tz America/New_York\n```\n\nLa lista de timezones la puedes encontrar en [Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).\n\n------------------\n\n\n## Contribuye\n\nEste es un proyecto sin fines de lucro, hecho solo por diversión :) no está asociado a Spotify de alguna forma oficial.\n\nTiene algunas mejoras, incluyendo el generar más gráficas o con otros estilos personalizables. Siéntete libre de contribuir:\n- Haz un fork del repositorio.\n- Deriva una rama nueva desde la rama `main`.\n- Sube tu rama y abre un Pull Request apuntando a este repositorio.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbetm%2Fspotify-wrapy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdbetm%2Fspotify-wrapy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbetm%2Fspotify-wrapy/lists"}