{"id":15456150,"url":"https://github.com/ronoaldo/swgoh","last_synced_at":"2025-07-22T03:06:14.627Z","repository":{"id":57497660,"uuid":"72805376","full_name":"ronoaldo/swgoh","owner":"ronoaldo","description":"Archived Repository - Small tool and library to interact with https://api.swgoh.help API.","archived":false,"fork":false,"pushed_at":"2023-01-24T21:45:56.000Z","size":539,"stargazers_count":17,"open_issues_count":1,"forks_count":11,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-07-21T21:37:00.907Z","etag":null,"topics":["cli","command-line","go"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ronoaldo.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}},"created_at":"2016-11-04T02:08:53.000Z","updated_at":"2024-06-28T04:20:51.000Z","dependencies_parsed_at":"2023-02-14T01:45:40.694Z","dependency_job_id":null,"html_url":"https://github.com/ronoaldo/swgoh","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ronoaldo/swgoh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fswgoh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fswgoh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fswgoh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fswgoh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ronoaldo","download_url":"https://codeload.github.com/ronoaldo/swgoh/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fswgoh/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266417113,"owners_count":23925301,"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","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli","command-line","go"],"created_at":"2024-10-01T22:22:58.999Z","updated_at":"2025-07-22T03:06:14.595Z","avatar_url":"https://github.com/ronoaldo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SWGoH API client and CLI for Go\n\n[![Build Status](https://travis-ci.org/ronoaldo/swgoh.svg?branch=master)](https://travis-ci.org/ronoaldo/swgoh)\n\nThis project implements API client and command line interface (CLI)\nfor Star Wars Galaxy of Heroes game. Data is retrieved from third party services\nprovided by other developers:\n\n* https://swgoh.gg/ and https://swgoh.gg/api/\n* https://api.swgoh.help\n\nThe CLI uses https://api.swgoh.help and the https://crinolo-swgoh.glitch.me/statCalc helper\nto provide rich information about character, ships and mods.\n\nA basic client for https://swgoh.gg/ (website crawling) and https://swgoh.gg/api/\nis also provided. as of now this implementation is not extensivelly tested.\n\n## API client for Go lang\n\nThe API client for the Go programming language is available using the import\n\n    import \"github.com/ronoaldo/swgoh/swgohhelp\"\n\nRead the full documentation at https://godoc.org/github.com/ronoaldo/swgoh/swgohhelp\n\n## CLI\n\nYou can use this command line interface to parse your characters, ships, and mods.\nThe data is cached as a JSON file that you can parse and use in other apps.\nThe output to stdout can also be used for several purposes, such as feed data\ninto a spreadsheet.\n\n### Install or Download\n\nIf you just want to use it, go to the\n[Release Page](https://github.com/ronoaldo/swgoh/releases)\nand download the one for your operating system.\n\nYou can also install the tool using the Go toolchain:\n\n    go get github.com/ronoaldo/swgoh/cmd/swgoh\n\nTo see the full list of available options, run:\n\n    swgoh -help\n\n### Authentication\n\nFor each invocation you need to provide the https://api.swgoh.help credentials.\nThe parameters `-u \"myuser\"` and `-p \"mypass\"` are mandatory.\n\n### Ships list\n\nTo list your ships, you can use the following command:\n\n    swgoh -u \"myuser\" -p \"mypass\" -a \"allycode\" -ships\n\nThe result is a CSV list of your ships, their level, and stars.\n\n### Character list\n\nTo list your characters, you can use the following command:\n\n    swgoh -u \"myuser\" -p \"mypass\" -a \"allycode\" -characters\n\nThe result is a CSV list of your characters, their level, stars, and gear level.\n\n### Mods\n\nYou can use the -mods switch to export all your mods to the standard output\nformatted as CSV:\n\n    swgoh -u \"myuser\" -p \"mypass\" -a \"allycode\" -mods\n\n### Character and Arena stats\n\nIt is possible to display single character or your arena team statistics\nusing the -stats or -arena switches.\n\nTo display statistics from a single character, type:\n\n    swgoh -u \"myuser\" -p \"mypass\" -a \"allycode\" -stats -char Tarkin\n\nAnd to display the current stats of your arena team, use the -arena option.\nBoth character and ship arenas will be shown:\n\n    swgoh -u \"myuser\" -p \"mypass\" -a \"allycode\" -arena\n\n# Caching\n\nCaching is done for several API consumed files. \nThis serves two pourposes: avoid overloading the API\nendpoints and gives you a local copy of the JSON files\nfor your parsing needs.\n\nCached data is stored in `$HOME/.config/api.swgoh.help/` folder.\nYou can change the value using the system variable `$SWGOH_CACHE_DIR`.\nThis folder is created if does not exists.\n\nIn that folder, a file `gamedata.json` holds cached data for several game\nrelated info, such as unit names and other info.\n\nThe CLI also stores profile data in `ALLYCODE.json` files in the cache directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronoaldo%2Fswgoh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fronoaldo%2Fswgoh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronoaldo%2Fswgoh/lists"}