@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 key.
To obtain a Last.fm API key, 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 API key.
const client = new SimpleFM('Last.fm API key');
// Fetch the recent track from a user.
const json = await client.user.getRecentTracks({ user: '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';
Returns metadata information for an album.
artist (string): The name of the artist.album (string): The name of the album.username? (string): The username for the context of the request. If supplied, the user's playcount for this artist's album is included in the response.Returns popular tags for an album.
artist (string): The name of the artist.album (string): The name of the album.Search for an album by name.
album (string): The name of the album.limit? (number): The number of results to fetch per page. Defaults to 30.page? (number): The page number to fetch. Defaults to the first page.Returns metadata information for an artist.
artist (string): The artist's name.username? (string): The username for the context of the request. If supplied, the user's playcount for this artist is included in the response.Returns similar artists to this artist.
artist (string): The artist's name.limit? (number): The number of results to fetch per page. Defaults to 30.Returns popular albums for an artist.
artist (string): The artist's name.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns popular tags for an artist.
artist (string): The artist's name.Returns popular tracks for an artist.
artist (string): The artist's name.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Search for an artist by name.
artist (string): The artist's name.limit? (number): The number of results to fetch per page. Defaults to 30.page? (number): The page number to fetch. Defaults to the first page.Returns the most popular artists.
limit? (number): The number of results to fetch per page. Defaults to 30.page? (number): The page number to fetch. Defaults to the first page.Returns the most popular tags for tracks.
limit? (number): The number of results to fetch per page. Defaults to 30.page? (number): The page number to fetch. Defaults to the first page.Returns the most popular tracks.
limit? (number): The number of results to fetch per page. Defaults to 30.page? (number): The page number to fetch. Defaults to the first page.Returns the most popular artists by country.
country (string): The name of the country.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns the most popular tracks by country.
country (string): The name of the country.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns metadata information on a tag.
tag (string): The name of the tag.tag (string): The name of the tag.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.tag (string): The name of the tag.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns popular tracks for a tag.
tag (string): The name of the tag.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns a list of available charts for a tag.
tag (string): The name of the tag.Returns metadata information for a track.
artist (string): The name of the artist.track (string): The name of the track.Returns similar tracks for this track.
artist (string): The name of the artist.track (string): The name of the track.limit? (number): The number of results to fetch per page. Defaults to 30.Returns popular tags for a track.
artist (string): The name of the artist.track (string): The name of the track.Search for a track by name.
track (string): The name of the track.limit? (number): The number of results to fetch per page. Defaults to 30.page? (number): The page number to fetch. Defaults to the first page.Returns information about a user's profile.
username (string): The name of the user.Returns a list of popular artists in a user's library.
username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns a list of the user's friends.
username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns the loved tracks as set by the user.
username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.Returns a list of the user's personal tags.
username (string): The name of the user.tag (string): The name of the tag.tagType (album, artist, track): The type of items which have been tagged.Returns the most recent track listened by the user.
username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50. Maximum is 200.page? (number): The page number to fetch. Defaults to the first page.Returns a list of popular albums in a user's library.
username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): The page number to fetch. Defaults to the first page.username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50.Returns a list of popular tracks in a user's library.
username (string): The name of the user.limit? (number): The number of results to fetch per page. Defaults to 50.page? (number): 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.