> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira.party/llms.txt
> Use this file to discover all available pages before exploring further.

# Charts & collages

> Top artists, albums and tracks — as lists, as image grids, and per artist.

## Top charts

<CodeGroup>
  ```javascript Artists theme={null}
  !lastfm topartists
  ```

  ```javascript Albums theme={null}
  !lastfm topalbums
  ```

  ```javascript Tracks theme={null}
  !lastfm toptracks
  ```

  ```javascript Over a period theme={null}
  !lastfm topartists weekly
  !lastfm topalbums monthly
  !lastfm toptracks yearly
  ```
</CodeGroup>

`!topartists`, `!topalbums` and `!toptracks` work standalone too.

### Timeframes

| Value        | Aliases           |
| ------------ | ----------------- |
| `weekly`     | `7day`, `week`    |
| `monthly`    | `1month`, `month` |
| `quarterly`  | `3month`          |
| `halfyearly` | `6month`          |
| `yearly`     | `12month`, `year` |
| `overall`    | `alltime`, `all`  |

Omitting the timeframe gives all-time.

## Collages

```javascript theme={null}
!lastfm collage
```

Aliases: `chart`, `grid`, `cg`. Generates an image grid of album covers. Arguments are free-form and order doesn't matter:

<CodeGroup>
  ```javascript Someone else's 3x3 theme={null}
  !lastfm collage 3x3 @someone
  ```

  ```javascript Top tracks this month theme={null}
  !lastfm collage tracks month
  ```

  ```javascript A 5x5 of someone's week theme={null}
  !lastfm collage @someone 5x5 tracks 7day
  ```

  ```javascript Big grid, no labels theme={null}
  !lastfm collage large albums off
  ```

  ```javascript Labels, but no playcounts theme={null}
  !lastfm collage noplays
  ```
</CodeGroup>

| Argument       | Options                                  |
| -------------- | ---------------------------------------- |
| **Size**       | `3x3`, `4x4`, `5x5`, `10x10`, or `large` |
| **Type**       | `albums` (default), `artists`, `tracks`  |
| **Timeframe**  | Any from the table above                 |
| **Labels**     | `off` to hide text                       |
| **Playcounts** | `noplays` to hide the badge              |
| **Member**     | Mention anyone                           |

<Tip>
  `!lastfm collage 3x3 weekly` posted regularly is the single most popular thing a music server does. Bigger grids look impressive but get unreadable past 5x5 on mobile.
</Tip>

## Per-artist charts

<CodeGroup>
  ```javascript Their albums, by your playcount theme={null}
  !lastfm artisttopalbums someone
  ```

  ```javascript Their tracks, by your playcount theme={null}
  !lastfm artisttoptracks someone
  ```
</CodeGroup>

Aliases: `atal`, `ata` / `att`, `at`. These read your **synced library**, so [sync](/lastfm/setup#syncing-your-library) first.

## Playcounts

<CodeGroup>
  ```javascript An artist theme={null}
  !lastfm plays someone
  ```

  ```javascript An album theme={null}
  !lastfm plays album some album
  ```

  ```javascript A track theme={null}
  !lastfm plays track some song
  ```
</CodeGroup>

With no argument, uses whatever you're currently playing. Shortcuts: `!lastfm playsalbum`, `!lastfm playstrack`, `!lastfm album`.

## Artist overview

```javascript theme={null}
!lastfm overview someone
```

An in-depth breakdown of one artist — your playcount, top albums and tracks, listening history and whether you hold the [crown](/lastfm/whoknows#crowns). Aliases: `artist`, `ov`.

## Recent history

<CodeGroup>
  ```javascript Recent scrobbles theme={null}
  !lastfm recent
  ```

  ```javascript Filtered to an artist theme={null}
  !lastfm recent someone
  ```

  ```javascript Loved tracks theme={null}
  !lastfm favorites
  ```
</CodeGroup>

Aliases: `history`, `recenttracks` / `loved`, `favs`, `liked`, `hearts`.

## Milestones

<CodeGroup>
  ```javascript What your 10,000th scrobble was theme={null}
  !lastfm milestone 10000
  ```

  ```javascript When you'll hit the next one theme={null}
  !lastfm pace
  ```

  ```javascript Toward a specific goal theme={null}
  !lastfm pace 100000
  ```
</CodeGroup>

`pace` estimates a date from your recent scrobbling rate. Alias for milestone: `ms`.

## Cover art and links

<CodeGroup>
  ```javascript Album art theme={null}
  !lastfm cover
  ```

  ```javascript On Spotify theme={null}
  !lastfm spotify
  ```

  ```javascript On SoundCloud theme={null}
  !lastfm soundcloud
  ```

  ```javascript Lyrics theme={null}
  !lastfm lyrics
  ```
</CodeGroup>

All default to the currently playing track. Aliases: `art`, `artwork` / `sp` / `sc` / `lyric`, `lyr`, `genius`.

## Command reference

| Command                           | Aliases                   | Description                      |
| --------------------------------- | ------------------------- | -------------------------------- |
| `lastfm topartists [timeframe]`   | `artists`, `ta`, `top`    | Top artists                      |
| `lastfm topalbums [timeframe]`    | `albums`, `tal`, `tab`    | Top albums                       |
| `lastfm toptracks [timeframe]`    | `tracks`, `ttr`, `tt`     | Top tracks                       |
| `lastfm collage [arguments]`      | `chart`, `grid`, `cg`     | Image grid                       |
| `lastfm artisttopalbums [search]` | `atal`, `ata`             | An artist's albums by your plays |
| `lastfm artisttoptracks [search]` | `att`, `at`               | An artist's tracks by your plays |
| `lastfm plays [search]`           | `ap`                      | Artist playcount                 |
| `lastfm plays album [search]`     | `al`, `a`                 | Album playcount                  |
| `lastfm plays track [search]`     | `tr`, `t`                 | Track playcount                  |
| `lastfm overview [search]`        | `artist`, `ov`            | Full artist breakdown            |
| `lastfm recent [artist]`          | `history`, `recenttracks` | Recent scrobbles                 |
| `lastfm favorites`                | `loved`, `favs`, `liked`  | Loved tracks                     |
| `lastfm milestone [number]`       | `ms`                      | What a scrobble was              |
| `lastfm pace [goal]`              | —                         | Estimated date for a milestone   |
| `lastfm cover [search]`           | `art`, `artwork`          | Album art                        |
| `lastfm spotify`                  | `sp`                      | Track on Spotify                 |
| `lastfm soundcloud`               | `sc`                      | Track on SoundCloud              |
| `lastfm lyrics`                   | `lyric`, `genius`         | Lyrics                           |
| `lastfm scrobbles`                | `scrobble`, `count`       | Total scrobbles                  |