Live Steam Stats in Your GitHub README

Paste a URL into your Markdown file. Get a beautiful, auto-updating SVG card showing your Steam playtime, achievements, and more. No GitHub Actions required.

Build Your Card View on GitHub Buy Me a Coffee

Build Your Embed URL

Customize your card and see a live preview instantly.

Steam ID or Vanity URL

Card Type

Theme

Hide border Transparent background

Available Themes

Append ?theme=NAME to any card URL.

Default Dark Radical Merko Gruvbox Tokyonight Onedark Cobalt Synthwave Highcontrast Dracula Steam

Parameter Reference

All parameters use underscores. Boolean values accept true/false, 1/0, yes/no.

Common Parameters

Accepted by every card endpoint.

Parameter	Required	Default	Description
`steamid`	Yes	—	SteamID64 or vanity URL username
`theme`	No	`default`	Color theme name
`hide_border`	No	`false`	Remove the card border
`hide_bg`	No	`false`	Transparent background
`border_radius`	No	`4`	Corner radius in SVG units (0–20)
`title_color`	No	theme	Hex color for the card title (no `#`)
`text_color`	No	theme	Hex color for body text
`icon_color`	No	theme	Hex color for the header icon
`bg_color`	No	theme	Hex color for the background
`border_color`	No	theme	Hex color for the border
`locale`	No	`en`	IETF language tag for number formatting
`cache_seconds`	No	`3600`	Cache TTL in seconds (min 14400, max 86400)

Card-Specific Parameters

Only accepted by the card listed in the Card column.

Card	Parameter	Default	Description
Recently Played	`count`	`5`	Number of games to show (1–5)
Recently Played	`show_playtime`	`true`	Show playtime label next to each bar
Recently Played	`show_icons`	`true`	Show game icons
Top Games	`count`	`5`	Number of games to show (1–10)
Top Games	`show_icons`	`true`	Show game icons
Top Games	`show_rank_numbers`	`true`	Show rank numbers (1., 2., …)
Library Overview	`show_free_games`	`true`	Include free-to-play games in counts
Library Overview	`highlight_top_game`	`true`	Show the most-played game stat box
Achievements	`appids`	required	Comma-separated App IDs (max 5)
Achievements	`show_ratio`	`true`	Show earned/total ratio
Achievements	`progress_style`	`bar`	Progress indicator style: `bar` or `arc`
Profile Overview	`show_avatar`	`true`	Show the player avatar
Profile Overview	`show_status`	`true`	Show online/offline/in-game status
Profile Overview	`show_currently_playing`	`true`	Show currently or recently played game
Playtime Milestone	`milestone_style`	`fun`	Label style: `fun` (humorous) or `numeric`
Game Stats	`appid`	required	Steam App ID of the game
Game Stats	`count`	`5`	Number of stats to show (1–10)
Game Stats	`stats`	—	Comma-separated internal stat names to pin specific stats

Frequently Asked Questions

How do I find my Steam ID?

Go to your Steam profile page. If you have a custom URL like steamcommunity.com/id/yourname, your vanity URL is yourname. Otherwise, your numeric SteamID64 appears in the URL as steamcommunity.com/profiles/76561198XXXXXXXXX.

How do I find a game's App ID?

The easiest way is SteamDB. Search for any game and the App ID appears in the URL and next to the title (e.g. 730 for Counter-Strike 2). You can also find it on the Steam store page URL: store.steampowered.com/app/730/.

Why does my profile show as private?

In Steam, go to your profile, Edit Profile, Privacy Settings, and set Game Details to Public. The Steam Web API only returns game data for public profiles.

How often does the data update?

Cards are cached for 1 hour on the CDN. After that, the next request fetches fresh data from Steam. GitHub also caches images through its proxy, so updates may take up to a few hours to appear in your README.

Why is my README showing an old version of the card?

GitHub caches external images. To force a refresh, append ?_cb=1 to your embed URL (then remove it afterwards so the CDN cache is shared again).

Is my data stored anywhere?

No. This service is stateless. Steam API responses are used in-memory to render your SVG and are not stored.