{"id":25448071,"url":"https://github.com/mthomason12/battlenet-api-browser","last_synced_at":"2026-02-21T11:02:08.794Z","repository":{"id":275850988,"uuid":"927388392","full_name":"mthomason12/battlenet-api-browser","owner":"mthomason12","description":"Battle.NET API Browser","archived":false,"fork":false,"pushed_at":"2025-02-23T14:56:01.000Z","size":2097,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"public","last_synced_at":"2025-10-30T07:02:00.330Z","etag":null,"topics":["angular","api","battle-dot-net","blizzard-api","json","spa","world-of-warcraft"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mthomason12.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"mthomason","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2025-02-04T21:46:24.000Z","updated_at":"2025-02-23T14:56:04.000Z","dependencies_parsed_at":"2025-05-16T07:09:18.582Z","dependency_job_id":"7dad7c4f-e517-49de-9ce1-6d23b2b1a862","html_url":"https://github.com/mthomason12/battlenet-api-browser","commit_stats":null,"previous_names":["mthomason12/battlenet-api-browser"],"tags_count":54,"template":false,"template_full_name":null,"purl":"pkg:github/mthomason12/battlenet-api-browser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthomason12%2Fbattlenet-api-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthomason12%2Fbattlenet-api-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthomason12%2Fbattlenet-api-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthomason12%2Fbattlenet-api-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mthomason12","download_url":"https://codeload.github.com/mthomason12/battlenet-api-browser/tar.gz/refs/heads/public","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthomason12%2Fbattlenet-api-browser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29679049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T09:33:50.764Z","status":"ssl_error","status_checked_at":"2026-02-21T09:33:19.949Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["angular","api","battle-dot-net","blizzard-api","json","spa","world-of-warcraft"],"created_at":"2025-02-17T19:18:42.336Z","updated_at":"2026-02-21T11:02:08.768Z","avatar_url":"https://github.com/mthomason12.png","language":"TypeScript","funding_links":["https://ko-fi.com/mthomason"],"categories":[],"sub_categories":[],"readme":"# Battle\u0026#46;NET API Browser\n\n[![Automated Build Status](https://github.com/mthomason12/battlenet-api-browser/actions/workflows/node.js.yml/badge.svg 'automated build status')](https://github.com/mthomason12/battlenet-api-browser/releases)\n\n[SPA](https://en.wikipedia.org/wiki/Single-page_application) client for the [Battle.net API](https://develop.battle.net/), written in [Angular](https://angular.dev).\n\nThis is a work in progress, many parts of the API are not implemented yet and only have a placeholder folder icon.  \n\nView the [changelog](CHANGELOG.md) for details on new releases\n\n![screenshot of the Covenants API viewing the Kyrian covenant](doc/images/screenshot-kyrian.png)\n\n## Requirements\n\n### Development and Build\n\n- Node v22.12.0, not tested on earlier versions.  \n\n### Runtime\n\nTested on Chrome (132.0.6834.110), Firefox (113.0.3), and Edge (132.0.2957.127) running from a local webserver.\n\nPrecompiled releases can be found at https://github.com/mthomason12/battlenet-api-browser/releases\n\nBuilds are triggered by going to the **battlenet-api-browser** directory and running:\n\n```npm run build``` for the self-hosted version (which will be output to the **dist** folder), you'll need to put this onto a webserver to run it.\n\n```npm run electron-build``` for the Electron version (which will be output to the **out** folder)- this should automatically pick the Electron binary for the platform you're running on.  You can then run this as a local application. No installer is generated.\n\n```npm run electron-make-deb``` on a compatible Linux system will build a .deb package for the Electron version in the **out** folder.\n\n```npm run electron-make-win``` on a compatible Windows system will build a Windows setup.exe for the Electron version in the **out** folder.\n\nOr if you want to work on the live codebase:\n\n```ng serve``` to serve the Angular application, rebuilding live on file edits.\n\n## Usage\n\n### Battle\u0026#46;net Client Registration\n\nYou will need to provide your own Battle\u0026#46;net API Key and secret. \nYou can get this from the [Battle.net Developer Portal](https://develop.battle.net/access/clients)\n\nWhen registering your client, you'll need to provide a redirect URL.  If running locally under the defaults, this will be http://localhost:4200/auth-callback\n\nCheck \"I do not have a service URL for this client\"\n\nOne item on the [roadmap](#roadmap) is to provide a public API proxy for use by this app.\n\n### Data\n\nThis application makes extensive use of IndexedDB.  \n\nThe vast majority of data is left as-is from the Battle.net API.  \n\nHowever, some things are tweaked for usability, and some are combined. For example, exporting \"achievements\" as JSON will give you an object with both \"items\" and \"details\" arrays, with \"items\" containing the data from getAchievementIndex and \"details\" containing the individual items from getAchievement.  get....Media calls are automatically run after the applicable query, with the results being appended to a mediaData property on the original item.  The focus is on making it easier for end users, not on matching the API layout 1:1 - if you want that, you can just call the API directly yourself ;)\n\nWhere these additional fields are added to the API result, these are prefixed with $\n\n## Known Issues\n\nThere is currently very little in the way of error checking and handling. \n\nAny problem with an API call tends to just fail silently other than an error message in the browser console.  The Electron build is only checked intermittently and may be broken at any time.\n\nCurrently everything is hard-coded to the US region.\n\nMany functions lack progress indicators\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmthomason12%2Fbattlenet-api-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmthomason12%2Fbattlenet-api-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmthomason12%2Fbattlenet-api-browser/lists"}