{"id":21271423,"url":"https://github.com/heismauri/rolling-friend-chart","last_synced_at":"2025-03-15T12:16:50.418Z","repository":{"id":112502838,"uuid":"322866245","full_name":"heismauri/rolling-friend-chart","owner":"heismauri","description":"A Python3 script to make a chart based on your LastFM scrobbles ","archived":false,"fork":false,"pushed_at":"2023-12-13T02:08:27.000Z","size":13,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T02:41:28.414Z","etag":null,"topics":["billboard","chart","lastfm","lastfm-api","python3"],"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/heismauri.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":"2020-12-19T14:30:15.000Z","updated_at":"2023-12-13T22:08:41.000Z","dependencies_parsed_at":"2023-12-13T03:54:28.880Z","dependency_job_id":"8b308b4f-fba5-4dfb-8f03-52fcb8e2440c","html_url":"https://github.com/heismauri/rolling-friend-chart","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heismauri%2Frolling-friend-chart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heismauri%2Frolling-friend-chart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heismauri%2Frolling-friend-chart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heismauri%2Frolling-friend-chart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heismauri","download_url":"https://codeload.github.com/heismauri/rolling-friend-chart/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243725635,"owners_count":20337670,"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":["billboard","chart","lastfm","lastfm-api","python3"],"created_at":"2024-11-21T08:26:29.177Z","updated_at":"2025-03-15T12:16:50.392Z","avatar_url":"https://github.com/heismauri.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"**Rolling Friend Chart** is a Python script that creates a chart based on your friends' recent scrobbles from LastFM. It can create charts for artists, albums and tracks. It uses the [LastFM API](https://www.last.fm/api) to collect the data. You can customize the chart by changing the length of the chart and by showing the detail of it, which is how much each item was scrobbled by the user.\n\n# Environment variables\nYou need to set the following environment variables `.env` to use this script:\n- `LASTFM_API_KEY`: Your LastFM API key\n- `MAX_PLAYCOUNT`: The maximum number of plays to be considered for the chart (default: 10)\n\n# Usage \u0026 options\n```bash\npython main.py users [users...] -m {gettoptracks,gettopalbums,gettopartists}\n```\n\n## General options\n```\n-h, --help       show this help message and exit\n-p, --period     period to get the top items from, default: 7day {7day,1month,3month,6month,12month,overall}\n-l, --length     length of the top list, default: 10 {1-100}\n-d, --detail     show the detail of the top list\n```\n\n# Output\n\n## Example without detail\n```\nFinished collecting the items from 'USERNAME'\nFinished collecting the items from 'USERNAME'\nFinished collecting the items from 'USERNAME'\n#1. no tears left to cry - Ariana Grande [4.33]\n#2. bad idea right? - Olivia Rodrigo [4.28]\n#3. MORE - K/DA [4.16]\n#4. Howl - CHUU [3.66]\n#5. Hold On Tight - aespa [2.67]\n#6. Newtopia - Loosemble [2.67]\n#7. Sugarcoat (NATTY Solo) - KISS OF LIFE [2.67]\n#8. because i liked a boy - Sabrina Carpenter [2.62]\n#9. Dance the Night - Dua Lipa [2.62]\n#10. El Amor No Duele - Denise Rosenthal [2.62]\n```\n\n## Example with detail\n```\nFinished collecting the items from 'USERNAME'\nFinished collecting the items from 'USERNAME'\nFinished collecting the items from 'USERNAME'\n#1. no tears left to cry - Ariana Grande [4.33], # of plays: USERNAME (5), USERNAME (5), USERNAME (1)\n#2. bad idea right? - Olivia Rodrigo [4.28], # of plays: USERNAME (4), USERNAME (3), USERNAME (1)\n#3. MORE - K/DA [4.16], # of plays: USERNAME (5), USERNAME (2), USERNAME (1)\n#4. Howl - CHUU [3.66], # of plays: USERNAME (4), USERNAME (1), USERNAME (1)\n#5. Hold On Tight - aespa [2.67], # of plays: USERNAME (21), USERNAME (1)\n#6. Newtopia - Loosemble [2.67], # of plays: USERNAME (8), USERNAME (1)\n#7. Sugarcoat (NATTY Solo) - KISS OF LIFE [2.67], # of plays: USERNAME (7), USERNAME (1)\n#8. because i liked a boy - Sabrina Carpenter [2.62], # of plays: USERNAME (3), USERNAME (1)\n#9. Dance the Night - Dua Lipa [2.62], # of plays: USERNAME (3), USERNAME (1)\n#10. El Amor No Duele - Denise Rosenthal [2.62], # of plays: USERNAME (3), USERNAME (1)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheismauri%2Frolling-friend-chart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheismauri%2Frolling-friend-chart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheismauri%2Frolling-friend-chart/lists"}