Last.fm to Mastodon

This Python script automatically posts your loved tracks from Last.fm to your Mastodon profile.

Features

• Posts newly loved tracks from Last.fm to Mastodon.
• Shortens track URLs using your Shlink server.
• Adds relevant hashtags to posts (artist, album, genre).
• Prevents duplicate posts by checking track titles.

Requirements

• Python 3.7 or higher
• A Last.fm account
• A Mastodon account
• A Shlink server (optional, for URL shortening)

Installation

1. Clone this repository:

git clone https://github.com/cfultz/last2mast

2. Create a virtual environment:

python3 -m venv .venv
source .venv/bin/activate

3. Install the required libraries:

pip install pylast mastodon.py requests

Configuration

Obtain API credentials:

Last.fm:Get your API key and secret from the Last.fm API website.

Mastodon: Follow the instructions for your Mastodon instance to obtain an access token (usually in the "Settings" or "Development" section).

Shlink (optional): Get your API key from your Shlink server settings.

Edit the script: Open the last2mast.py file in a text editor. Replace the placeholder API credentials with your actual credentials:

LASTFM_API_KEY
LASTFM_API_SECRET
LASTFM_USERNAME

MASTODON_ACCESS_TOKEN
MASTODON_API_BASE_URL

SHLINK_API_KEY
SHLINK_SERVER_URL (include a trailing slash, e.g., https://your-shlink-server.com/)

Running the script

1. Activate your virtual environment:

source .venv/bin/activate

2. Run the script:

python main.py

This will run the script in the foreground. To run it in the background, you can use:

nohup python main.py &

For continuous operation, consider using a task scheduler (cron, Task Scheduler) or a systemd service (on Linux) to run the script periodically.

Using the systemd file for Linux operating systems:

[Unit]
Description=Last.fm to Mastodon posting service
After=network.target

[Service]
User=your_username  # Replace with your actual username
WorkingDirectory=/path/to/your/script  # Replace with the actual path
ExecStart=/path/to/your/virtualenv/bin/python main.py  # Replace with the actual path to your virtualenv's Python
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Remember to replace the placeholder values (your_username, /path/to/your/script, and /path/to/your/virtualenv/bin/python) with your actual username, script path, and virtual environment path before using the service file.

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.