> ## 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.

# Who knows & crowns

> Rank listeners in your server or globally, and compete for crowns.

Who-knows ranks everyone in your server by playcount for a given artist, album or track. Crowns go to whoever's top.

Requires a [synced library](/lastfm/setup#syncing-your-library) — the rankings read mira's own database, not Last.fm's API.

## Server rankings

<CodeGroup>
  ```javascript Artist theme={null}
  !whoknows
  !whoknows someone
  ```

  ```javascript Album theme={null}
  !lastfm wkalbum
  !lastfm wkalbum some album
  ```

  ```javascript Track theme={null}
  !lastfm wktrack
  !lastfm wktrack some song
  ```

  ```javascript Genre theme={null}
  !lastfm whoknowsgenre shoegaze
  ```
</CodeGroup>

With no argument, uses whatever you're currently playing.

`whoknows` aliases: `wk`. `wkalbum` aliases: `whoknowsalbum`, `wka`. `wktrack` aliases: `whoknowstrack`, `wkt`. `whoknowsgenre` aliases: `wkg`, `genreknows`.

## Global rankings

The same, across every server mira is in:

<CodeGroup>
  ```javascript Artist theme={null}
  !globalwhoknows someone
  ```

  ```javascript Album theme={null}
  !globalwhoknowsalbum some album
  ```

  ```javascript Track theme={null}
  !globalwhoknowstrack some song
  ```
</CodeGroup>

Aliases: `globalwk`, `gwk` / `gwka` / `gwkt`.

<Tip>
  Global rankings are the humbling version. Being your server's top listener for an artist and 400th globally is a normal experience.
</Tip>

## Crowns

You hold an artist's crown in a server when you're its top listener there.

<CodeGroup>
  ```javascript Yours theme={null}
  !lastfm crowns
  ```

  ```javascript Who holds one theme={null}
  !lastfm crown someone
  ```

  ```javascript Crown leaderboard theme={null}
  !lastfm crowns leaderboard
  ```
</CodeGroup>

Aliases: `kings`, `cr` / `whocrown`, `crownfor` / `topcrowns`, `crownlb`, `tc`.

Crowns update as playcounts change, so they genuinely move around. Passing someone who's been listening to an artist for years is a real achievement, which is what makes them work as a mechanic.

## Vote leaderboard

```javascript theme={null}
!lastfm leaderboard
!lastfm leaderboard global
```

Ranks members by [vote reactions](/lastfm/now-playing#vote-reactions) received on their now-playing messages, rather than by playcount. Aliases: `lb`.

## Reading a whoknows

Entries are ordered by playcount, with the crown holder marked. Your own row is highlighted, and if you're outside the visible page your position is shown separately — so you always know where you stand.

## Making it work in your server

<Steps>
  <Step title="Get people to connect">
    Rankings are only interesting with participants. Post `!lastfm connect <username>` somewhere visible and pin it.
  </Step>

  <Step title="Sync the server cache">
    ```javascript theme={null}
    !lastfm sync server
    ```

    After a batch of people connect, so they appear in rankings.
  </Step>

  <Step title="Add vote reactions">
    ```javascript theme={null}
    !lastfm server reactions 🔥 💀
    ```

    Turns now-playing into something people engage with. Requires **Manage Server**.
  </Step>

  <Step title="Consider a crown role">
    Not automatic, but `!lastfm crowns leaderboard` plus a monthly `!role add` for the top holder is a cheap and effective recurring event.
  </Step>
</Steps>

## Command reference

| Command                          | Aliases                | Description            |
| -------------------------------- | ---------------------- | ---------------------- |
| `lastfm whoknows [search]`       | `wk`                   | Server artist ranking  |
| `lastfm wkalbum [search]`        | `whoknowsalbum`, `wka` | Server album ranking   |
| `lastfm wktrack [search]`        | `whoknowstrack`, `wkt` | Server track ranking   |
| `lastfm whoknowsgenre [search]`  | `wkg`, `genreknows`    | Server genre ranking   |
| `lastfm globalwhoknows [search]` | `globalwk`, `gwk`      | Global artist ranking  |
| `lastfm globalwkalbum [search]`  | `gwka`                 | Global album ranking   |
| `lastfm globalwktrack [search]`  | `gwkt`                 | Global track ranking   |
| `lastfm crowns`                  | `kings`, `cr`          | Your crowns            |
| `lastfm crown [search]`          | `whocrown`, `crownfor` | Who holds a crown      |
| `lastfm crowns leaderboard`      | `lb`, `top`            | Crown leaderboard      |
| `lastfm topcrowns`               | `crownlb`, `tc`        | Same, standalone       |
| `lastfm leaderboard [scope]`     | `lb`                   | Most upvoted listeners |

`whoknows`, `whoknowsalbum`, `whoknowstrack`, `globalwhoknows`, `globalwhoknowsalbum` and `globalwhoknowstrack` all work standalone, without the `lastfm` prefix.