@solely/simple-fm
Advanced tools
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.
Node.js 16+ and TypeScript v5+ is recommended for this package.
npm i @solely/simple-fmpnpm i @solely/simple-fmyarn add @solely/simple-fmsimple-fm requires you to have a Last.fm API token.
To obtain a Last.fm API token, click here to register an API account.
// 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 token.
const client = new simpleFM('last.fm token');
// Fetch the recent track from a user.
const json = await client.user.fetchRecentTracks('solelychloe');
console.log(json);
// => { currentlyPlaying: true, name: 'Dark World', artist: 'Mikel', album: 'Zelda & Chill', ...}
If you're using Deno, you can import simple-fm via a CDN:
import client from 'https://esm.sh/@solely/simple-fm';
Fetches and returns metadata information for an album.
artistName: The name of the artist.albumName: The name of the album.userName?: The username for the context of the request. If supplied, the user's playcount for this artist's album is included in the response.Fetches and returns popular tags for an album.
artistName: The name of the artist.albumName: The name of the album.Search for an album by name.
albumName: The name of the album.limit?: The number of results to fetch per page. Defaults to 30.page?: The page number to fetch. Defaults to the first page.Fetches and returns metadata information for an artist.
artistName: The artist's name.userName?: The username for the context of the request. If supplied, the user's playcount for this artist is included in the response.Fetches and returns similar artists to this artist.
artistName: The artist's name.limit?: The number of results to fetch per page. Defaults to 30.Fetches and returns popular albums for an artist.
artistName: The artist's name.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns popular tags for an artist.
artistName: The artist's name.Fetches and returns popular tracks for an artist.
artistName: The artist's name.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Search for an artist by name.
artistName: The artist's name.limit?: The number of results to fetch per page. Defaults to 30.page?: The page number to fetch. Defaults to the first page.Fetches and returns the most popular artists.
limit?: The number of results to fetch per page. Defaults to 30.page?: The page number to fetch. Defaults to the first page.Fetches and returns the most popular tags for tracks.
limit?: The number of results to fetch per page. Defaults to 30.page?: The page number to fetch. Defaults to the first page.Fetches and returns the most popular tracks.
limit?: The number of results to fetch per page. Defaults to 30.page?: The page number to fetch. Defaults to the first page.Fetches and returns the most popular artists by country.
Ordered by relevance.
country: The name of the country.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns the most popular tracks by country.
Ordered by relevance.
country: The name of the country.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns metadata information on a tag.
tagName: The name of the tag.tagName: The name of the tag.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.tagName: The name of the tag.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns popular tracks for a tag.
tagName: The name of the tag.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns a list of available charts for a tag.
tagName: The name of the tag.Fetches and returns metadata information for a track.
artistName: The name of the artist.trackName: The name of the track.Fetches and returns similar tracks for this track.
artistName: The name of the artist.trackName: The name of the track.limit?: The number of results to fetch per page. Defaults to 30.Fetches and returns popular tags for a track.
artistName: The name of the artist.trackName: The name of the track.Search for a track by name.
trackName: The name of the track.limit?: The number of results to fetch per page. Defaults to 30.page?: The page number to fetch. Defaults to the first page.Fetches and returns information about a user's profile.
userName: The name of the user.Fetches and returns a list of all the artists in a user's library.
userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns a list of the user's friends.
userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns the loved tracks as set by the user.
userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.Fetches and returns a list of the user's personal tags.
userName: The name of the user.tagName: The name of the tag.tagType: The type of items which have been tagged. Accepted options: album, artist, trackFetches and returns the most recent track listened by the user.
userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50. Maximum is 200.page?: The page number to fetch. Defaults to the first page.Fetches and returns a list of popular albums in a user's library.
userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50.Fetches and returns a list of popular tracks in a user's library.
userName: The name of the user.limit?: The number of results to fetch per page. Defaults to 50.page?: The page number to fetch. Defaults to the first page.This package is licensed under the zlib license.
© 2023 Chloe Arciniega.
FAQs
A simple, asynchronous Last.fm wrapper in TypeScript.
The npm package @solely/simple-fm receives a total of 66 weekly downloads. As such, @solely/simple-fm popularity was classified as not popular.
We found that @solely/simple-fm demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.