LastFM Discord Rich Presence

Display your currently playing music on Discord — from any platform, any device.

English • Español

---

English

About

LastFM-RPC is a Discord Rich Presence client that syncs with your Last.fm account. Share what you're listening to with friends — whether you're using Spotify, Apple Music, YouTube Music, or any other scrobbling-compatible player.

Features

• 🎵 Now Playing — Shows current track with remaining time
• 📻 Last Played — Falls back to last scrobbled track when idle
• ⚡ Real-time Updates — Polls every 6 seconds for changes
• 🎨 Clean Display — Artist and track info in Discord presence

Screenshots

Now Playing	Last Played

Prerequisites

• Node.js 18+ or Bun
• Last.fm Account
• Last.fm API Key
• Discord Application

Quick Start

1. Clone the repository

   git clone https://github.com/Chere3/LastFM-RPC.git
   cd LastFM-RPC

2. Install dependencies

   yarn install
   # or: npm install

3. Configure environment

   cp .env.example .env

   Edit .env with your credentials:

   API_KEY=your-lastfm-api-key
   API_SECRET=your-lastfm-api-secret
   USER=your-lastfm-username
   CLIENT_ID=your-discord-application-id

4. Run the application

   yarn start
   # or: npm start

Configuration

Variable	Required	Description
API_KEY	✅	Your Last.fm API key
API_SECRET	✅	Your Last.fm API secret
USER	✅	Your Last.fm username
CLIENT_ID	✅	Discord application ID

Troubleshooting

Discord presence not showing

1. Ensure Discord desktop app is running (not web version)
2. Check Activity Status is enabled in Discord settings
3. Verify CLIENT_ID matches your Discord application

"No song found" error

1. Verify your Last.fm username is correct
2. Ensure you have scrobbled at least one track
3. Check your API credentials are valid

Rate limiting issues

The app polls every 6 seconds. If you experience rate limiting, increase the interval in src/rpc/start.ts.

---

Español

Acerca de

LastFM-RPC es un cliente de Discord Rich Presence que se sincroniza con tu cuenta de Last.fm. Comparte lo que estás escuchando con tus amigos — ya sea que uses Spotify, Apple Music, YouTube Music, o cualquier otro reproductor compatible con scrobbling.

Características

• 🎵 Reproduciendo Ahora — Muestra la canción actual con tiempo restante
• 📻 Última Reproducida — Muestra la última canción cuando no hay música activa
• ⚡ Actualizaciones en Tiempo Real — Consulta cada 6 segundos
• 🎨 Visualización Limpia — Información del artista y canción en Discord

Capturas de Pantalla

Reproduciendo Ahora	Última Reproducida

Requisitos

• Node.js 18+ o Bun
• Cuenta de Last.fm
• API Key de Last.fm
• Aplicación de Discord

Inicio Rápido

1. Clonar el repositorio

   git clone https://github.com/Chere3/LastFM-RPC.git
   cd LastFM-RPC

2. Instalar dependencias

   yarn install
   # o: npm install

3. Configurar variables de entorno

   cp .env.example .env

   Edita .env con tus credenciales:

   API_KEY=tu-api-key-de-lastfm
   API_SECRET=tu-api-secret-de-lastfm
   USER=tu-usuario-de-lastfm
   CLIENT_ID=tu-id-de-aplicacion-discord

4. Ejecutar la aplicación

   yarn start
   # o: npm start

Solución de Problemas

La presencia no aparece en Discord

1. Asegúrate de usar la app de escritorio de Discord (no la versión web)
2. Verifica que el Estado de Actividad esté habilitado en configuración
3. Confirma que CLIENT_ID coincida con tu aplicación de Discord

Error "No se encontró canción"

1. Verifica que tu nombre de usuario de Last.fm sea correcto
2. Asegúrate de haber hecho scrobble de al menos una canción
3. Revisa que tus credenciales de API sean válidas

---

Contributing

See ROADMAP.md for planned features and improvements.

License

MIT © Chere3

---

_{Made with 🎵 for music lovers}