{"id":13910658,"url":"https://github.com/melipass/lastfm-to-markdown","last_synced_at":"2025-07-18T09:32:26.926Z","repository":{"id":37302175,"uuid":"381229720","full_name":"melipass/lastfm-to-markdown","owner":"melipass","description":"GitHub Actions workflow that automatically updates the covers from your last.fm's weekly chart everyday, inside your profile repository's README.md file. Useful for customizing your profile in repos named after your GitHub username.","archived":false,"fork":false,"pushed_at":"2024-09-22T01:38:59.000Z","size":316,"stargazers_count":37,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-15T20:03:15.268Z","etag":null,"topics":["api","github-actions","lastfm","lastfm-api","lastfm-collage-generator","markdown","python","workflow"],"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/melipass.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-06-29T03:40:32.000Z","updated_at":"2024-09-22T14:00:56.000Z","dependencies_parsed_at":"2024-01-23T02:40:29.334Z","dependency_job_id":"dbeafbe4-180f-4751-995b-080204de12c5","html_url":"https://github.com/melipass/lastfm-to-markdown","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melipass%2Flastfm-to-markdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melipass%2Flastfm-to-markdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melipass%2Flastfm-to-markdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melipass%2Flastfm-to-markdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/melipass","download_url":"https://codeload.github.com/melipass/lastfm-to-markdown/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226388692,"owners_count":17617317,"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":["api","github-actions","lastfm","lastfm-api","lastfm-collage-generator","markdown","python","workflow"],"created_at":"2024-08-07T00:01:40.859Z","updated_at":"2024-11-25T19:31:35.216Z","avatar_url":"https://github.com/melipass.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# last.fm to markdown\n\n![banner](banner.png)\n\n## 🤖 About this repo\nThis is a small project that I started because I wanted to have my last.fm weekly chart on my GitHub profile. I used GitHub Actions because they can be scheduled with cron jobs and you won't need to pass any sensitive information to modify the README.md file.\n\n## 🎵 Example output, automatically updated every day\n\u003c!-- lastfm --\u003e\n\u003cp align=\"center\"\u003e\u003c/p\u003e\n\n          \n## 👩🏽‍💻 What you'll need\n* A README.md file.\n* Last.fm API key\n  * Fill [this form](https://www.last.fm/api/account/create) to instantly get one. Requires a last.fm account.\n* Set up a GitHub Secret called ```LASTFM_API_KEY``` with the value given by last.fm.\n* Also set up a ```LASTFM_USER``` GitHub Secret with the user you'll get the weekly charts for.\n* Add a ```\u003c!-- lastfm --\u003e``` tag in your README.md file, with two blank lines below it. The album covers will be placed here.\n\n## Instructions\nTo use this release, add a ```lastfm.yml``` workflow file to the ```.github/workflows``` folder in your repository with the following code:\n```diff\nname: lastfm-to-markdown\n\non:\n  schedule:\n    - cron: '2 0 * * *'\n  workflow_dispatch:\n\njobs:\n  lastfm:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v2\n      - name: lastfm to markdown\n        uses: melipass/lastfm-to-markdown@v1.3.1\n        with:\n          LASTFM_API_KEY: ${{ secrets.LASTFM_API_KEY }}\n          LASTFM_USER: ${{ secrets.LASTFM_USER }}\n#         INCLUDE_LINK: true # Optional. Defaults is false. If you want to include the link to the album page, set this to true.\n#         IMAGE_COUNT: 6 # Optional. Defaults to 10. Feel free to remove this line if you want.\n      - name: commit changes\n        continue-on-error: true\n        run: |\n          git config --local user.email \"action@github.com\"\n          git config --local user.name \"GitHub Action\"\n          git add -A\n          git commit -m \"Updated last.fm's weekly chart\" -a\n\n      - name: push changes\n        continue-on-error: true\n        uses: ad-m/github-push-action@v0.6.0\n        with:\n          github_token: ${{ secrets.GITHUB_TOKEN }}\\\n          branch: main\n```\nThe cron job is scheduled to run once a day because Last.fm's API updates weekly chart data daily at 00:00, it's useless to make more than 1 request per day because you'll get the same information back every time. You can manually run the workflow in case Last.fm's API was down at the time, going to the Actions tab in your repository.\n\n## 🚧 To do\n* Allow users to choose the image size for the album covers.\n* Feel free to open an issue or send a pull request for anything you believe would be useful.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelipass%2Flastfm-to-markdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelipass%2Flastfm-to-markdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelipass%2Flastfm-to-markdown/lists"}