{"id":24287839,"url":"https://github.com/fn-fal113/github-readme-steam-card","last_synced_at":"2025-10-30T23:15:01.446Z","repository":{"id":108807727,"uuid":"558786750","full_name":"FN-FAL113/github-readme-steam-card","owner":"FN-FAL113","description":":video_game: A dynamically generated steam card for your github readme ","archived":false,"fork":false,"pushed_at":"2024-11-07T03:05:23.000Z","size":6736,"stargazers_count":17,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-07T04:18:17.569Z","etag":null,"topics":["card-generator","dynamic","gaming","github-readme","profile-card","profile-generator","profile-readme","readme","readme-badges","readme-card","readme-generator","readme-profile","readme-stats","steam","steam-api","steam-card","steam-github-readme","steam-readme"],"latest_commit_sha":null,"homepage":"https://github-readme-steam-card.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FN-FAL113.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-28T09:43:56.000Z","updated_at":"2024-11-07T03:05:27.000Z","dependencies_parsed_at":"2024-01-12T18:15:12.731Z","dependency_job_id":"a3d15d50-68be-49d4-aa01-c8cdf3fcc6e8","html_url":"https://github.com/FN-FAL113/github-readme-steam-card","commit_stats":null,"previous_names":["fn-fal113/github-readme-steam-card"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FN-FAL113%2Fgithub-readme-steam-card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FN-FAL113%2Fgithub-readme-steam-card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FN-FAL113%2Fgithub-readme-steam-card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FN-FAL113%2Fgithub-readme-steam-card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FN-FAL113","download_url":"https://codeload.github.com/FN-FAL113/github-readme-steam-card/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234173680,"owners_count":18791081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["card-generator","dynamic","gaming","github-readme","profile-card","profile-generator","profile-readme","readme","readme-badges","readme-card","readme-generator","readme-profile","readme-stats","steam","steam-api","steam-card","steam-github-readme","steam-readme"],"created_at":"2025-01-16T08:45:57.301Z","updated_at":"2025-09-25T10:30:24.876Z","avatar_url":"https://github.com/FN-FAL113.png","language":"TypeScript","funding_links":["https://www.paypal.com/paypalme/fnfal113"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eGithub Readme Steam Card\u003c/h1\u003e\n  \u003cp align=\"center\"\u003e:video_game: A dynamically generated steam card for your github readme\u003c/p\u003e\n  \u003cp align=\"center\"\u003eAnimated avatar or frames supported!\u003c/p\u003e\n\u003c/p\u003e\n\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/FN-FAL113/github-readme-steam-status/issues\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/FN-FAL113/github-readme-steam-status\"/\u003e \n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/FN-FAL113/github-readme-steam-status/pulls\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues-pr/FN-FAL113/github-readme-steam-status\"/\u003e \n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/FN-FAL113/github-readme-steam-status/network/members\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/FN-FAL113/github-readme-steam-status\"/\u003e \n  \u003c/a\u003e  \n  \u003ca href=\"https://github.com/FN-FAL113/github-readme-steam-status/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/FN-FAL113/github-readme-steam-status\"/\u003e \n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/FN-FAL113/github-readme-steam-status/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/FN-FAL113/github-readme-steam-status\"/\u003e \n  \u003c/a\u003e \n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github-readme-steam-card.vercel.app/status/?steamid=76561198085145110\"/\u003e\n    \u003cimg src=\"https://github-readme-steam-card.vercel.app/status/?steamid=76561198085145110\u0026animated_avatar=true\"/\u003e\n\u003c/p\u003e\n\n## :information_source: Usage\n\nAdd the following markdown to your github readme\n\nuse your steamid64 as the value for ```?steamid=``` (you may use [steam id finder](https://www.steamidfinder.com/)).\n\ndisplay through markup\n```html\n\u003cimg src=\"https://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64 here\u003e\"/\u003e\n```\nor through markdown\n```md\n![GRSS](https://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64 here\u003e)\n```\n\n## :gear: Available Options\n\n-   `show_in_game_bg` - display in game banner as a partial background, fallback to steam logo if set to false.\n-   `show_recent_game_bg` - display recent game banner as partial background, fallback to steam logo if set to false.\n\n```md\nhttps://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64here\u003e\u0026show_in_game_bg=false\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"https://github.com/FN-FAL113/github-readme-steam-status/assets/88238718/5dd9d19a-574f-4e44-a9e3-cb1a18984dc3\"/\u003e\n\u003c/p\u003e\n\n```md\nDefault\nhttps://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64here\u003e\u0026show_in_game_bg=true\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"https://github.com/FN-FAL113/github-readme-steam-status/assets/88238718/8aac2658-2168-498e-a205-dd3b72b115a8\"/\u003e\n\u003c/p\u003e\n\n```md\nhttps://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64here\u003e\u0026show_recent_game_bg=false\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"https://github.com/FN-FAL113/github-readme-steam-status/assets/88238718/060050ff-d898-426f-8a2b-10cb454a3ea5\"/\u003e\n\u003c/p\u003e\n\n```md\nDefault\nhttps://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64here\u003e\u0026show_recent_game_bg=true\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"https://github.com/FN-FAL113/github-readme-steam-status/assets/88238718/535aba84-c82d-4200-9f1d-dabefffee2c2\"/\u003e\n\u003c/p\u003e\n\n```md\nDefault: false (animated avatar only due to payload limit with serverless platforms)\nhttps://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64here\u003e\u0026show_recent_game_bg=true  \n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"https://github.com/FN-FAL113/github-readme-steam-status/assets/88238718/eb6dbbc1-5362-40d2-a095-09a79f873e99\"/\u003e\n\u003c/p\u003e\n\nYou may combine these options together\n```md\nhttps://github-readme-steam-card.vercel.app/status/?steamid=\u003cSteamID64here\u003e\u0026show_in_game_bg=true\u0026show_recent_game_bg=false\n```\n\n### :interrobang: FAQ\n1. **Enable animated avatar and frame at the same time**\n- Despite previously adding support even with proper image optimizations, the api is hitting a timeout against github's cdn proxy. This is due to the imposed time window by github for rendering images inside readme files which would be ~4s. After tireless testing, I had to further optimize and trim down the app in order to lessen api execution time. The dillemmas associated with enabling both animated avatar and frames:\n  1. animated avatars without image optimization reaches payload limit for functions.\n  2. animated avatars with image optimization increases execution time and function size due to additional package causing timeouts.\n  3. serverless payload limit is capped at 5mb, animated avatar and frames enabled altogether can have a payload size of over 5-7mb.\n\n2. **Cold Boot and Github CDN timeouts**\n- Cold boots may cause image loading or rendering timeouts through github's cdn proxy which has a time limit on serving content from the origin. Subsequent requests might return a stale response while revalidating the cache to serve the most recent content.\n\n3. **Recently played game not showing**\n- To be able to use this feature, an \u003ca href=\"#deploy-your-own-vercel-instance\"\u003einstance\u003ca/\u003e of the project through vercel with your steam api key must be created to access user recently played games. \n\n## :small_red_triangle: Deploy your own Vercel instance\n\nCreate an account on vercel if you don't have yet.\n\nGenerate your steam api key by going to [Steam Web API Docs](https://steamcommunity.com/dev) and supply the environment variable ```STEAM_API_KEY``` with your own.\n\n**Fork** this project and deploy it to your own vercel instance or click the deploy button below which does most of the stuffs for you.\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FFN-FAL113%2Fgithub-readme-steam-status\u0026env=STEAM_API_KEY)\n\n### :warning: Disclaimer\nThis project or its author are not affiliated, associated, authorized, endorsed by steam, its affiliates or subsidiaries. Images, names and other form of trademark are registered to their respective owners.\n\n## :sparkling_heart: Support the project/dev\n\nOpen-sourcing projects are great with all the effort and time I dedicate. However there are some ways you can show your support to me:\n\n- Giving a star or sharing this project to gamer devs out there.\n- Through pull requests, if you think you can make essential changes.\n- Donations are welcome but not required:\n\u003cbr/\u003e\n\u003ca href=\"https://www.paypal.com/paypalme/fnfal113\" target=_blank\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/stefan-niedermann/paypal-donate-button/master/paypal-donate-button.png\" alt=\"Donate with PayPal\" width=\"32%\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffn-fal113%2Fgithub-readme-steam-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffn-fal113%2Fgithub-readme-steam-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffn-fal113%2Fgithub-readme-steam-card/lists"}