https://github.com/wardbox/lastfm-to-mastodon
Post top album of the month to Mastodon
https://github.com/wardbox/lastfm-to-mastodon
Last synced: 3 months ago
JSON representation
Post top album of the month to Mastodon
- Host: GitHub
- URL: https://github.com/wardbox/lastfm-to-mastodon
- Owner: wardbox
- License: mit
- Created: 2023-11-11T05:01:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-27T05:23:19.000Z (12 months ago)
- Last Synced: 2025-01-15T21:27:26.377Z (4 months ago)
- Language: Python
- Size: 335 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# lastfm-to-mastodon
A simple Python script for sharing your monthly top album from LastFM to your Mastodon account.
## What does this script do?
On the first day of each month, this script fetches your most-played album from the previous month on LastFM and posts about it on Mastodon. It includes details like the album name, artist, play count, a link to the album, and some hashtags.
## Requirements
- Python 3.x
- LastFM account and [application](https://www.last.fm/api/account/create)
- Mastodon account and [application](https://docs.joinmastodon.org/client/intro/)
## Configuration
Create a copy of the `.env.example` file and call it `.env`, then populate all of the variables with your own data.
## Usage
Run the script:
```shell
python main.py
```
For automated monthly posts, set up a cron job or a similar scheduler. There is an example github action in `./github/workflows/monthly_poster.yml`
## Contributing
Ideas, bug reports, and pull requests are welcome on GitHub at [https://github.com/wardbox/lastfm-to-mastodon].
## License
This script is available as open source under the terms of the MIT License.