https://github.com/nesticle8bit/vinyl-scrobbler
🎵 A Node.js CLI tool that bridges your vinyl collection to Last.fm. Automatically scrobble vinyl records from Discogs to your Last.fm profile with accurate timestamps and track information. Perfect for audiophiles who want to track their vinyl listening habits.
https://github.com/nesticle8bit/vinyl-scrobbler
cli command-line command-line-tool console-application discogs lastfm nodejs vinyl vinyl-records
Last synced: about 1 month ago
JSON representation
🎵 A Node.js CLI tool that bridges your vinyl collection to Last.fm. Automatically scrobble vinyl records from Discogs to your Last.fm profile with accurate timestamps and track information. Perfect for audiophiles who want to track their vinyl listening habits.
- Host: GitHub
- URL: https://github.com/nesticle8bit/vinyl-scrobbler
- Owner: nesticle8bit
- Created: 2025-03-30T22:13:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-01T22:29:00.000Z (about 1 year ago)
- Last Synced: 2025-10-24T08:16:33.813Z (7 months ago)
- Topics: cli, command-line, command-line-tool, console-application, discogs, lastfm, nodejs, vinyl, vinyl-records
- Language: JavaScript
- Homepage:
- Size: 26.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎵 Vinyl Scrobbler CLI
[](https://www.buymeacoffee.com/nesticle8bit)
Scrobble vinyl tracks from [Discogs](https://www.discogs.com) to [Last.fm](https://www.last.fm) with accurate timestamps and metadata.
[](#)
[](#)
[](#)
[](#)
*(Example workflow: fetching release data and scrobbling tracks)*
## ✨ Features
- **Discogs Integration**
Fetch tracklists and metadata automatically
- **Reverse Chronological Scrobbling**
Tracks appear in correct order on Last.fm (newest first)
- **Duration Parsing**
Supports MM:SS and HH:MM:SS formats
- **Dry Run Mode**
Test without actually scrobbling
- **Session Logging**
JSON logs of all scrobbled releases
- **Interactive Prompts**
Confirm/edit metadata before scrobbling
## 🛠 Installation
1. Install Node.js (v14+ recommended):
[https://nodejs.org/](https://nodejs.org/)
2. Clone the repository:
```bash
git clone https://github.com/nesticle8bit/vinyl-scrobbler.git
cd vinyl-scrobbler
```
3. Create a `.env` file with your API credentials:
```bash
LASTFM_API_KEY=your_api_key
LASTFM_API_SECRET=your_api_secret
LASTFM_USERNAME=your_username
LASTFM_PASSWORD=your_password
DISCOGS_USER_TOKEN=your_discogs_token
```
## 🚀 Usage
Basic Command:
```bash
node .\vinyl-scrobbler.js --album=DISCOGS_RELEASE_ID_OR_URL
```
Options:
| Flag | Description | Example |
| ------------ | ---------------------------------------------- | ------------------ |
| `--album` | Discogs release ID or URL | `--album=24132131` |
| `--dry-run` | Test without scrobbling | `--dry-run` |
| `--delay=MS` | Delay between scrobbles (default: 1000ms) | `--delay=2000` |
| `--help` | Show help | `--help` |
## 🧑🏻🏫 Examples
1. Scrobble with release ID:
```bash
node vinyl-scrobbler.js --album=24132131
```
2. Dry run mode:
```bash
node vinyl-scrobbler.js --album=24132131 --dry-run
```
3. Interactive mode (prompt for URL):
```bash
node vinyl-scrobbler.js
```
## 📝 Logs
Scrobble sessions are saved to:
`/logs/scrobbles_YYYY-MM-DD.json`
Example log entry:
```json
[
{
"timestamp": "2025-04-01T19:46:25.040Z",
"artist": "Wampyric Rites",
"album": "The Eternal Melancholy Of The Wampyre",
"url": "https://www.discogs.com/release/24132131",
"tracks": [
{
"position": 1,
"title": "Ancient Specters Of The Forlorn Forest",
"duration": "5:37"
},
{
"position": 2,
"title": "As Light Is Absorbed By Darkness",
"duration": "7:42"
},
{
"position": 3,
"title": "Tyrant's Blood",
"duration": "4:43"
},
{
"position": 4,
"title": "The Eternal Melancholy Of The Wampyre",
"duration": "8:12"
},
{
"position": 5,
"title": "Grim Funeral Inside The Dusty Dungeons Of Time",
"duration": "7:36"
},
{
"position": 6,
"title": "Under An Amethyst Sky",
"duration": "12:07"
}
]
}
]
```
## ✅ Requirements
1. Node.js 14+
2. Last.fm API credentials
3. Discogs API token
4. A Discogs release URL for the vinyl you want to scrobble
## ⚠️ Troubleshooting
Common Issues
1. Chalk colors not working:
```bash
npm uninstall chalk && npm install chalk
```
2. Cannot use import error:
Ensure `package.json` contains:
```json
{
"type": "module"
}
```
Or rename file to `.mjs` extension
3. Missing environment variables:
```txt
Verify .env file exists with all required keys
```
## 🫶 Contributing
Contributions are welcome! Please open an issue or submit a pull request for any improvements.
## 📜 License
MIT © Julio Poveda
---
## ☕ Support the Project
***Hi, I'm Julio Poveda** – a fullstack developer who crafts robust web symphonies by day and vinyl-scrobbling tools by night.*
[](https://www.buymeacoffee.com/nesticle8bit)
`Your coffee keeps my IDE open and my turntable spinning!`