A simple command-line tool to check a user's Discord status using Lanyard and get an output in a readable format.

Installation

To run discid on your machine, install it using npm:

npm install -g discid

Usage

[!IMPORTANT] The user must be in the Lanyard Discord server in order to retrieve information about them.

discid [userID]

You will need to replace [userID] with the ID of the user you are trying to fetch the status of. To find the ID of a user, you can follow a guide with images, or you can follow the steps below:

1. Enable Developer Mode by going to Settings ➔ Advanced ➔ Developer Mode, and check the toggle to be on.

2. Right click on a user and click the Copy User ID button.

3. Go back to your command line and run the same command from above, replacing [userID] with the ID you copied.

For example, to check the status of the user iinter, you can run the following command:

discid 514106760299151372

Depending on what the user is doing, you may get different outputs. Here is an example of what might be returned:

lunar (iinter) • 🟢 Online (Desktop)
Listening To: Never More by Shihoko Hirata • 3min 42sec left
Avatar URL: https://api.lanyard.rest/514106760299151372.png

To see everything that can be displayed and for slightly more information, see this page.

Options

| Option | Description | | ----------- | ----------- | | --json | Shows a formatted, syntax-highlighted JSON response of information about the user from https://api.lanyard.rest/v1/users/:user_id, replacing :user_id with the user ID you entered. | | --visit, --open | Opens the user's profile on the Discord website (in your browser). This works with any user on Discord. | | --kv | Displays the user's Lanyard key-value (KV) pairs (see here for more information). |

License

© 2025 - Licensed under the MIT License.