{"id":24807473,"url":"https://github.com/nicconike/steam-stats","last_synced_at":"2025-07-06T14:33:17.104Z","repository":{"id":229065583,"uuid":"775664836","full_name":"Nicconike/Steam-Stats","owner":"Nicconike","description":"Showcase your Steam Gaming Stats on your GitHub Profile","archived":false,"fork":false,"pushed_at":"2025-06-30T15:50:15.000Z","size":9852,"stargazers_count":3,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-04T14:54:42.303Z","etag":null,"topics":["automated-release","pypi-package","readme-profile","steam-api","steam-profile","steam-readme","steam-readme-stats","steam-stats","steam-stats-card","steam-web-api","steam-workshop","steamwebapi"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/Steam-Stats/","language":"Python","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/Nicconike.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"nicconike","ko_fi":"nicconike"}},"created_at":"2024-03-21T20:10:15.000Z","updated_at":"2025-06-29T18:48:55.000Z","dependencies_parsed_at":"2024-03-31T19:22:40.036Z","dependency_job_id":"c36dec2a-fca3-4350-b541-ce307358e0f1","html_url":"https://github.com/Nicconike/Steam-Stats","commit_stats":null,"previous_names":["nicconike/steam-stats"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/Nicconike/Steam-Stats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nicconike%2FSteam-Stats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nicconike%2FSteam-Stats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nicconike%2FSteam-Stats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nicconike%2FSteam-Stats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nicconike","download_url":"https://codeload.github.com/Nicconike/Steam-Stats/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nicconike%2FSteam-Stats/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263604171,"owners_count":23487228,"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":["automated-release","pypi-package","readme-profile","steam-api","steam-profile","steam-readme","steam-readme-stats","steam-stats","steam-stats-card","steam-web-api","steam-workshop","steamwebapi"],"created_at":"2025-01-30T09:18:44.143Z","updated_at":"2025-07-06T14:33:17.098Z","avatar_url":"https://github.com/Nicconike.png","language":"Python","funding_links":["https://github.com/sponsors/nicconike","https://ko-fi.com/nicconike","https://github.com/sponsors/Nicconike"],"categories":[],"sub_categories":[],"readme":"# Steam Stats📶\n[![Steam Stats](https://github.com/Nicconike/Steam-Stats/actions/workflows/steam-stats.yml/badge.svg)](https://github.com/Nicconike/Steam-Stats/actions/workflows/steam-stats.yml)\n[![Release](https://github.com/Nicconike/Steam-Stats/actions/workflows/release.yml/badge.svg)](https://github.com/Nicconike/Steam-Stats/actions/workflows/release.yml)\n[![CodeQL \u0026 Pylint](https://github.com/Nicconike/Steam-Stats/actions/workflows/codeql.yml/badge.svg)](https://github.com/Nicconike/Steam-Stats/actions/workflows/codeql.yml)\n[![Bandit](https://github.com/Nicconike/Steam-Stats/actions/workflows/bandit.yml/badge.svg)](https://github.com/Nicconike/Steam-Stats/actions/workflows/bandit.yml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Steam-Stats\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Steam-Stats)\n![Pylint](https://img.shields.io/badge/Pylint-10.00-brightgreen?logo=python)\n[![codecov](https://codecov.io/gh/Nicconike/Steam-Stats/graph/badge.svg?token=SC5P7CS1BW)](https://codecov.io/gh/Nicconike/Steam-Stats)\n![Docker Image Size](https://img.shields.io/docker/image-size/nicconike/steam-stats?logo=docker\u0026label=Docker%20Image\u0026link=https%3A%2F%2Fhub.docker.com%2Fr%2Fnicconike%2Fsteam-stats)\n![Docker Pulls](https://img.shields.io/docker/pulls/nicconike/steam-stats?logo=docker\u0026label=Docker%20Pulls\u0026link=https%3A%2F%2Fhub.docker.com%2Fr%2Fnicconike%2Fsteam-stats)\n![GitHub Release](https://img.shields.io/github/v/release/nicconike/steam-stats)\n![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fgithub.com%2FNicconike%2FSteam-Stats%2Fblob%2Fmaster%2Fpyproject.toml%3Fraw%3Dtrue)\n![PyPI - Version](https://img.shields.io/pypi/v/steam-stats)\n![GitHub License](https://img.shields.io/github/license/nicconike/Steam-Stats)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Nicconike/Steam-Stats/badge)](https://scorecard.dev/viewer/?uri=github.com/Nicconike/Steam-Stats)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/9965/badge)](https://www.bestpractices.dev/projects/9965)\n[![wakatime](https://wakatime.com/badge/user/018e538b-3f55-4e8e-95fa-6c3225418eed/project/018e62a4-056d-49fd-babd-b079ee94859f.svg)](https://wakatime.com/badge/user/018e538b-3f55-4e8e-95fa-6c3225418eed/project/018e62a4-056d-49fd-babd-b079ee94859f)\n[![Visitor Badge](https://badges.pufler.dev/visits/nicconike/steam-stats)](https://badges.pufler.dev)\n\n\u003e ### From one Passionate Gamer and Developer to Another 🍻\n***\n## Prerequisites\n1. **Steam Web API Key:** API key is important to fetch your account details and for that you will require a key which you can create for your account [here](https://steamcommunity.com/dev)\n2. **Markdown Comments:** Update the markdown file by adding the comments where the Steam Stats will be embedded to. Refer [here](#Update-Readme) to learn more.\n3. **Steam ID:** You can get your 64-bit Steam id (SteamID64 - 17 digit number) by clicking on your profile name in the top right corner in steam desktop client, select \"Account Details\" and your Steam ID will be displayed directly under your account name\n4. **Steam Custom ID:** Open the Steam desktop application, click on your profile name in the top right corner. Select _View Profile_ and your custom URL will be displayed in the URL bar. From this url you will know your Steam Custom ID\n\nThe Github Actions is set to run on every Monday 12 AM IST (UTC+5:30) which you can modify to your own time as per your liking by updating it in the workflow file\n\n```yml\nschedule:\n        - cron: \"30 18 * * 0\"\n```\n\u003e [!IMPORTANT]\n\u003e Please don't forget any of the steps mentioned in the prerequisites else the Github Action will not work.\n\u003e Also, make sure that you have set the country correctly in your Steam Account.\n\u003e\n\u003e You can refer the [Steam Stats Wiki](https://github.com/Nicconike/Steam-Stats/wiki) if you have any questions related to any of the steps mentioned in [Prerequisites](#Prerequisites).\n***\n## Samples (From my [Steam Account](https://steamcommunity.com/id/nicconike/))\n**Example for Steam User Stats**\n\u003c!-- Steam-Stats start --\u003e\n![Steam Summary](https://github.com/Nicconike/Steam-Stats/blob/master/assets/steam_summary.png)\n![Recently Played Games](https://github.com/Nicconike/Steam-Stats/blob/master/assets/recently_played_games.png)\n\u003c!-- Steam-Stats end --\u003e\n\n**Example for Steam Workshop Stats**\n\u003c!-- Steam-Workshop start --\u003e\n![Steam Workshop Stats](https://github.com/Nicconike/Steam-Stats/blob/master/assets/steam_workshop_stats.png)\n\u003c!-- Steam-Workshop end --\u003e\n***\n## Update README\n1. Add below comment in your markdown file for Steam User Stats\n\t```md\n\t\u003c!-- Steam-Stats start --\u003e\n\t\u003c!-- Steam-Stats end --\u003e\n\t```\n2. Add below comment for Steam Workshop Stats (Optional)\n\t```md\n\t\u003c!-- Steam-Workshop start --\u003e\n\t\u003c!-- Steam-Workshop end --\u003e\n\t```\n3. Don't forget to add these comments in your readme file or wherever you want to display your steam stats, because without the comments the readme will not get updated\n\n\u003e [!CAUTION]\n\u003e The `Steam-Stats` marker should be placed before the `Steam-Workshop` markers if you are using both.\n***\n## Features\n1. Steam Player Summary[^1]\n2. Recently Played Games from Steam in the Last 2 Weeks\n3. Steam Workshop Stats (If Applicable)\n\n### Feature Flags\n1. Steam User Stats (Required | Default)\n\t1. Steam Player Summary\n\t2. Steam's Recently Played Games in the last 2 weeks\n\t\t1. The Graph plot for recently played games is by default implemented in a fixed linear scale but if you want you can update it to be in a logarithmic scale by using this flag in your workflow: `LOG_SCALE: True`\n\t\t2. When `LOG_SCALE` is `False`\n\n\t\t\t![Recently Played Games](https://github.com/Nicconike/Steam-Stats/blob/master/assets/recently_played_games(linear).png)\n\t\t3. When `LOG_SCALE` is `True`\n\n\t\t\t![Recently Played Games](https://github.com/Nicconike/Steam-Stats/blob/master/assets/recently_played_games(logarithmic).png)\n2. Steam Workshop Stats (Optional)\n\t1. Workshop Stats Module can be used by adding this flag in your workflow file in the environment variables: `WORKSHOP_STATS: True`\n\t2. This module displays the total number of Unique Visitors, Subscribers and Favorites for your Steam Workshop Items\n***\n## Setup with Example\nAfter completing the steps mentioned in the [Prerequisites](#Prerequisites), you have to save all the mentioned keys(except markdown comments) like Steam API Key, Steam-ID, Custom-ID as Secrets in your Github repo's settings.\n\n\u003e Repo Settings -\u003e Security -\u003e Secrets and Variables -\u003e Actions -\u003e Add in Repository Secrets\n\nIf you are new to **Github Secrets** then you can checkout this official doc [here](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions).\n\n**Sample Workflow File**\n\n`steam-stats.yml`\n\n```yaml\nname: Steam Stats\n\non:\n  push:\n    branches: master\n    schedule:\n      # Runs every Monday at 12AM IST (UTC+5:30)\n      - cron: \"30 18 * * 0\"\n    workflow_dispatch:\n\njobs:\n  steam-stats:\n    name: Steam Stats\n    runs-on: ubuntu-latest\n    steps:\n      - uses: nicconike/steam-stats@master\n        with:\n          STEAM_API_KEY: ${{ secrets.STEAM_API_KEY }} # Created Steam API key env var\n          STEAM_ID: ${{ vars.STEAM_ID }} # Steam ID env var\n          STEAM_CUSTOM_ID: ${{ vars.STEAM_CUSTOM_ID }} # Custom ID env var\n          WORKSHOP_STATS: True # Optional\n          LOG_SCALE: True # Optional\n```\n\nCheckout this real time usage example in a github repo from [here](https://github.com/Nicconike/Nicconike?tab=readme-ov-file#gaming-) and also the github actions [workflow file](https://github.com/Nicconike/Nicconike/blob/master/.github/workflows/steam-stats.yml).\n\n***\n## Contributions\n\nStar⭐ and Fork🍴 the Repo to start with your feature request(or bug) and experiment with the project to implement whatever Idea you might have and sent the Pull Request through 🤙\n\nPlease refer [Contributing.md](https://github.com/Nicconike/Steam-Stats/blob/master/.github/CONTRIBUTING.md) to get to know how to contribute to this project.\nAnd thank you for considering to contribute.\n\n***\n## Credits\n\n- **Actions**\n\t- **[GitHub Actions](https://github.com/actions)**\n\t- **[Python Semantic Release](https://github.com/python-semantic-release/python-semantic-release)**\n\t- **[Docker](https://github.com/docker)**\n\t- **[CodeQL](https://github.com/github/codeql-action)**\n\t- **[Codecov](https://github.com/codecov/codecov-action)**\n\n***\n## Support💙\nIf you are using this project and are really happy with it, then there are few ways to support me so that I can keep doing what I like doing:\n- Credit in your readme where you use this action\n- Drop a follow!😁\n- Starring and Sharing the project\n- Donations through [GitHub Sponsers](https://github.com/sponsors/Nicconike) or whichever platform you like. So, that I can create more projects like these and play more games🎮🎧\n\n#### **Thanks!🫡**\n***\nCreated with 🐍 \u0026 ❤️ by [Nicco](https://x.com/Nicco_nike)\n\n[^1]: Unfortunately, Steam Web API doesn't support Web Sockets so the profile status cannot be updated in real time as it gets updated in steam profile 🥲\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicconike%2Fsteam-stats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicconike%2Fsteam-stats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicconike%2Fsteam-stats/lists"}