{"id":23802858,"url":"https://github.com/gkeep/spotify-stats","last_synced_at":"2025-07-19T10:34:01.015Z","repository":{"id":113970770,"uuid":"417234438","full_name":"gkeep/spotify-stats","owner":"gkeep","description":"Top 10 played tracks from Spotify, built with PyQt5 and spotipy","archived":false,"fork":false,"pushed_at":"2024-02-04T14:02:32.000Z","size":255,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-21T16:59:28.968Z","etag":null,"topics":["pyqt5","python","spotify","spotipy"],"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/gkeep.png","metadata":{"files":{"readme":"README.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}},"created_at":"2021-10-14T18:05:15.000Z","updated_at":"2023-10-29T22:58:58.000Z","dependencies_parsed_at":"2025-01-01T22:28:07.019Z","dependency_job_id":"f9f164b0-6ecb-4573-9010-7ac97a5e0a1a","html_url":"https://github.com/gkeep/spotify-stats","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gkeep/spotify-stats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkeep%2Fspotify-stats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkeep%2Fspotify-stats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkeep%2Fspotify-stats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkeep%2Fspotify-stats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gkeep","download_url":"https://codeload.github.com/gkeep/spotify-stats/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkeep%2Fspotify-stats/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265916990,"owners_count":23848839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["pyqt5","python","spotify","spotipy"],"created_at":"2025-01-01T22:28:02.642Z","updated_at":"2025-07-19T10:34:00.985Z","avatar_url":"https://github.com/gkeep.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# spotify-stats\n\nSpotify-stats is a small program made to display your top 10 tracks and artists from last 4 weeks (*short term*), last 6 months (*medium term*) and all time (*long term*).\n\n![Top 10 tracks screenshot](image/top-tracks-screenshot.png)\n\n**Libraries used**:\n\n1. PyQt5\n2. [Spotipy](https://spotipy.readthedocs.io/) - Python library for the Spotify Web API\n\n## Data locations\n\n- Config location: `$HOME/.config/spotify-stats/config`\n- Cache location: `$HOME/.cache/spotify-stats`\n- Logs location: `$HOME/.cache/spotify-stats/log/spotify-stats.log`\n\n## For developers\n\n### Pre-requirements\n\nGenerate Client ID and Client Secret for your account:\n\n1. Open [Spotify for Developers Dashboard](https://developer.spotify.com/dashboard)\n2. Create a new app\n3. Set callback URIs: default config uses `http://localhost:9090/callback`\n4. Set Client ID and Client Secret (and callback URI, if you changed that) from the Developer Dashboard page to config file (`config.sample` or `$HOME/.config/spotify-stats/config`)\n\nIt is recommended to set up [pyenv](https://github.com/pyenv/pyenv) and virtualenv.\n\n1. Install Python \u003e= 3.6 using *pyenv*: `pyenv install 3.7.0`\n2. Select installed version of Python in the repository folder: `pyenv local 3.7.0`\n\n### Development\n\n1. Install virtualenv and create new venv for the repository: `$(pyenv which python) -m pip install virtualenv`, `$(pyenv which python) -m virtualenv venv`\n2. Activate virtualenv and install dependencies: `. venv/bin/activate`, `pip install -r requirements.txt`\n\n- Install default config with `make install-cfg`\n- Run the app with `python src/main.py config.sample`\n- Build the app with `make build`\n- Run the built binary with `make run`\n\n## LICENSE\n\nMIT license. See [LICENSE](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgkeep%2Fspotify-stats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgkeep%2Fspotify-stats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgkeep%2Fspotify-stats/lists"}