Documentation

API
SETUP

Ludra uses your own API keys to connect to Steam, IGDB, and YouTube. Your keys stay on your device — we never see them, store them, or share them.

🔑
Why bring your own keys?

It means no backend, no subscriptions, no rate limits shared with other users. Your data goes directly from the API to your app.

In this guide
🎮

The Steam Web API lets Ludra read your game library, playtime, and achievements directly from Steam. You'll need a free API key and your Steam ID.

01

Get your Steam API Key

Go to the Steam API key registration page. You'll need to be logged into your Steam account. Enter any domain name in the field (e.g. localhost) — it doesn't matter for personal use.

steamcommunity.com/dev/apikey
Tip Your key looks like a 32-character string of letters and numbers: A1B2C3D4E5F6...
02

Find your Steam ID

Your Steam ID is a unique 17-digit number. The easiest way to find it is via SteamID.io — just enter your Steam username or profile URL and it'll show your ID.

steamid.io
Tip You want the steamID64 value — it starts with 7656119...
03

Make sure your profile is public

Steam's API can only read libraries that are set to public. In Steam, go to your profile → Edit Profile → Privacy Settings and set Game Details to Public.

Important If your library is private, the import will return 0 games. You can set it back to private after importing if you prefer.
🎯

IGDB (Internet Games Database) powers Ludra's game search, cover art, genres, ratings, and release dates. It's owned by Twitch, so access is through the Twitch Developer Console.

01

Create or log into a Twitch account

You'll need a Twitch account to access the developer console. A regular free account is all you need — you don't need to be a streamer or have 2FA enabled for this step.

twitch.tv/signup
02

Enable Two-Factor Authentication

Twitch requires 2FA before you can register a developer application. Go to your Twitch Security settings and enable it via an authenticator app or SMS.

twitch.tv/settings/security
03

Register a new application

Go to the Twitch Developer Console and click Register Your Application. Fill in the fields:

Name: anything, e.g. Ludra Personal
OAuth Redirect URL: http://localhost
Category: Application Integration

dev.twitch.tv/console
04

Copy your Client ID and generate a Client Secret

After creating the app, click Manage. You'll see your Client ID — copy it. Then click New Secret to generate a Client Secret — copy that too.

Tip Copy the Client Secret immediately — Twitch won't show it again. If you lose it you'll need to generate a new one.
05

Enter both keys in Ludra

In Ludra's settings, paste your Client ID and Client Secret into the IGDB fields. Ludra handles the OAuth token exchange automatically — you don't need to do anything else.

The YouTube Data API lets Ludra surface trailers and video reviews for your games. It requires a Google Cloud project, but the free tier is generous — 10,000 requests per day, which is more than enough for personal use.

01

Go to Google Cloud Console

You'll need a Google account. Head to the Google Cloud Console — no credit card is required to use the YouTube Data API within the free quota.

console.cloud.google.com
02

Create a new project

Click the project dropdown at the top of the page → New Project. Give it a name like Ludra and click Create. Wait a few seconds for it to be provisioned, then select it.

03

Enable the YouTube Data API v3

In the left sidebar go to APIs & ServicesLibrary. Search for YouTube Data API v3 and click it, then click Enable.

Enable YouTube Data API v3
04

Create an API Key

Go to APIs & ServicesCredentialsCreate CredentialsAPI Key. Google will generate your key immediately.

Optional but recommended Click Edit API Key and under API restrictions, select Restrict keyYouTube Data API v3. This prevents the key from being used for other Google services if it were ever exposed.
05

Configure the OAuth consent screen (if prompted)

Google may ask you to configure an OAuth consent screen before generating credentials. Select External, fill in your app name (e.g. Ludra), and save. You don't need to submit it for verification — personal use works in testing mode.

06

Paste the API Key into Ludra

Copy your API key and paste it into the YouTube field in Ludra's settings. That's it — Ludra will now surface trailers and video content for games in your library.

Daily quota The free tier gives you 10,000 units per day. Each video search costs around 100 units, so you have roughly 100 searches per day — more than enough for personal use. Quota resets at midnight Pacific Time.

YOU'RE ALL SET

Head into Ludra's settings and paste your keys in. Your library, metadata, and videos will all start loading straight away.

← Back to Ludra