/steam-box

🎮 Update profile README / pinned gist to contain your Steam playtime leaderboard. 在你的 profile README / pinned gist 上显示你的 steam 游玩时间排行榜。

Primary LanguageGoApache License 2.0Apache-2.0

steam-box

Update pinned gist / profile README to contain your Steam playtime leaderboard.

Update gist with Steam Playtime


English | 简体中文

📌✨ For more pinned-gist projects like this one, check out: https://github.com/matchai/awesome-pinned-gists

💻 Setup

🎒 Prep work

if only want's to update a markdown,like profile README,skip step 1 and step 2.

  1. Create a new public GitHub Gist (https://gist.github.com/)
  2. Create a token with the gist scope and copy it. (https://github.com/settings/tokens/new)
  3. Create a Steam API key. (https://steamcommunity.com/dev/apikey)
  4. Find the steam ID (steamID64) of your account. (https://steamid.io)
  5. For updating a markdown file,add comments to the place where you want to update in the markdown file.
     <!-- steam-box start -->
     <!-- steam-box end -->
     

🚀 Project setup

  1. Fork this repo
  2. Edit the environment variable in .github/workflows/schedule.yml:

For updating github profile README,you can follow steam-box.yml in YouEclipse to create a Action in your README repo.Remember it's unsafe to use token with repo scope for updating the repo, steam-box update the profile repo using git command in Github Action instead of using github API.

  • GIST_ID: The ID portion from your gist url: https://gist.github.com/YouEclipse/9bc7025496e478f439b9cd43eba989a4.
  1. Go to the repo Settings > Secrets
  2. Add the following environment variables:
    • GH_TOKEN: The GitHub token generated above.
    • STEAM_API_KEY: The steam API key you created above.
    • STEAM_ID: The steam ID of your account.
  3. If you want to show specific games,put the ids in environmet variable APP_ID:
    • like APP_ID=431960,730
    • you can get the id of a game from the store url: https://store.steampowered.com/app/730/CounterStrike_Global_Offensive/

🕵️ How it works

  • Get your games playtime from Steamwork Web API
  • Update Gist with Github API
  • Use Github Actions for updating Gist

📄 License

This project is licensed under Apache-2.0