@solely/simple-fm

simple-fm

A simple, asynchronous Last.fm wrapper in TypeScript.

Search for what someone has been listening to lately, what tracks are trending in a country, an artist's top tracks, and a lot more.

For more information, please visit the documentation website.

Install

simple-fm requires that you have Node.js 18 (and above) and TypeScript v5+ installed.

• npm: npm i @solely/simple-fm
• pnpm: pnpm i @solely/simple-fm
• yarn: yarn add @solely/simple-fm
• bun: bun i @solely/simple-fm

Notice

simple-fm requires you to have a Last.fm API key.

To obtain a Last.fm API key, click here to register an API account.

Example usage

// Import the simple-fm package.
import SimpleFM from '@solely/simple-fm'; // ESM
const SimpleFM = require('@solely/simple-fm'); // CommonJS

// Replace the token with your Last.fm API key.
const client = new SimpleFM('Last.fm API key');

// Fetch the recent track from a user.
const json = await client.user.getRecentTracks({ username: 'solelychloe' });

console.log(json);
// => { search: { user: 'solelychloe', nowPlaying: true, ... }, tracks: [...] }

If you're using Deno, you can import simple-fm via a CDN:

import SimpleFM from 'https://esm.sh/@solely/simple-fm';

License

This package is licensed under the zlib license.

© 2024 Chloe Arciniega.

Changelog

1.6.2

Patch Changes

• d27fb25: Fix behavior of dateAdded with a track that's currently playing.