README.md

Last.Batch

Desktop application for batch scrobbling to Last.fm. Process files with playback history and send them to your Last.fm account.

Download the latest release.

Features

• Last.fm authentication
• Batch processing
• Preview and edit scrobbles before sending
• Real-time progress tracking
• Multi-language support (English, Português)

Setup

1. Get Last.fm API credentials at https://www.last.fm/api/account/create

2. Create a .env file:

API_KEY=your_api_key_here
API_SECRET=your_api_secret_here

3. Install dependencies:

pip install -r requirements.txt

4. Run:

python src/main.py

File formats

• .csv with 3 columns: Artist, Track, Timestamp

  Kendrick Lamar,Not Like Us,2026-01-01 12:00:00
  Twenty One Pilots,City Walls,2026-01-01 13:30:00

• .txt with 3 columns: Artist, Track, Timestamp

  Kendrick Lamar;Not Like Us;2026-01-01 12:00:00
  Twenty One Pilots;City Walls;2026-01-01 13:30:00

• .json with an array of objects:

  [
      {
          "artist": "Kendrick Lamar",
          "track": "Not Like Us",
          "timestamp": "2026-01-01 12:00:00"
      },
      {
          "artist": "Twenty One Pilots",
          "track": "City Walls",
          "timestamp": "2026-01-01 13:30:00"
      }
  ]

Usage

1. Authenticate with Last.fm
2. Upload your file
3. Review scrobbles (press Delete to remove items)
4. Click Scrobble

Build executable

pyinstaller Last.Batch.spec

Author

Developed by luisgbr1el