This is a small project that I forked and edited from user melipass's original code 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.
- A README.md file.
- Last.fm API key
- Fill this form to instantly get one. Requires a last.fm account.
- Set up a GitHub Secret called
LASTFM_API_KEY
with the value given by last.fm. - Also set up a
LASTFM_USER
GitHub Secret with the user you'll get the weekly charts for. - Add a
<!-- lastfm -->
tag in your README.md file, with two blank lines below it. The album covers will be placed here.
To use this release, add a lastfm.yml
workflow file to the .github/workflows
folder in your repository with the following code:
name: lastfmweekly
on:
schedule:
- cron: '2 0 * * *'
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
jobs:
# This workflow contains a single job called "build"
build:
runs-on: ubuntu-latest
steps:
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
- name: repo checkout
uses: actions/checkout@v2
- name: python setup
uses: actions/setup-python@v2
with:
python-version: '3.x'
- name: python packages installation
run: |
python -m pip install --upgrade pip
pip install -r dependencies.txt
- name: use lastfm api
env:
LASTFM_API_KEY: ${{ secrets.LASTFM_API_KEY }}
LASTFM_USER: ${{ secrets.LASTFM_USER }}
IMAGE_COUNT: 8 # Optional. Defaults to 10. Feel free to remove this line if you want.
IMAGE_SIZE: 2 # "0" for small image. "1" for medium image. "2" for large image. "3" for extralarge image.
run: python lastfm.py
- name: commit changes
continue-on-error: true
run: |
git config --local user.email "action@github.com"
git config --local user.name "GitHub Action"
git add -A
git commit -m "Updated last.fm's weekly chart" -a
- name: push changes
continue-on-error: true
uses: ad-m/github-push-action@v0.6.0
with:
github_token: ${{ secrets.GITHUB_TOKEN }}\
branch: main
The 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.
- Feel free to open an issue or send a pull request for anything you believe would be useful.