{"id":50488126,"url":"https://github.com/lightpohl/gb-dl","last_synced_at":"2026-06-02T00:04:11.064Z","repository":{"id":40669046,"uuid":"219404491","full_name":"lightpohl/gb-dl","owner":"lightpohl","description":"A CLI for downloading Giant Bomb videos.","archived":false,"fork":false,"pushed_at":"2023-01-29T21:32:58.000Z","size":185,"stargazers_count":59,"open_issues_count":1,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-13T23:30:54.408Z","etag":null,"topics":["archiver","cli","downloader","gb-dl","giantbomb"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/lightpohl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"ko_fi":"lightpohl"}},"created_at":"2019-11-04T02:52:48.000Z","updated_at":"2025-04-30T04:32:45.000Z","dependencies_parsed_at":"2023-02-16T01:15:34.370Z","dependency_job_id":null,"html_url":"https://github.com/lightpohl/gb-dl","commit_stats":null,"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/lightpohl/gb-dl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightpohl%2Fgb-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightpohl%2Fgb-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightpohl%2Fgb-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightpohl%2Fgb-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lightpohl","download_url":"https://codeload.github.com/lightpohl/gb-dl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightpohl%2Fgb-dl/sbom","scorecard":{"id":589259,"data":{"date":"2025-08-11","repo":{"name":"github.com/lightpohl/gb-dl","commit":"dfc3708f082f8ff99efa89b0fb1c70b7c2a52b05"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.7,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 1/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v3.1.3 not signed: https://api.github.com/repos/lightpohl/gb-dl/releases/90612526","Warn: release artifact v3.1.2 not signed: https://api.github.com/repos/lightpohl/gb-dl/releases/89818987","Warn: release artifact v2.11.0 not signed: https://api.github.com/repos/lightpohl/gb-dl/releases/64311255","Warn: release artifact v2.10.0 not signed: https://api.github.com/repos/lightpohl/gb-dl/releases/49720157","Warn: release artifact v2.9.0 not signed: https://api.github.com/repos/lightpohl/gb-dl/releases/47938534","Warn: release artifact v3.1.3 does not have provenance: https://api.github.com/repos/lightpohl/gb-dl/releases/90612526","Warn: release artifact v3.1.2 does not have provenance: https://api.github.com/repos/lightpohl/gb-dl/releases/89818987","Warn: release artifact v2.11.0 does not have provenance: https://api.github.com/repos/lightpohl/gb-dl/releases/64311255","Warn: release artifact v2.10.0 does not have provenance: https://api.github.com/repos/lightpohl/gb-dl/releases/49720157","Warn: release artifact v2.9.0 does not have provenance: https://api.github.com/repos/lightpohl/gb-dl/releases/47938534"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 1 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T21:24:44.920Z","repository_id":40669046,"created_at":"2025-08-20T21:24:44.920Z","updated_at":"2025-08-20T21:24:44.920Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33798943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["archiver","cli","downloader","gb-dl","giantbomb"],"created_at":"2026-06-02T00:04:07.887Z","updated_at":"2026-06-02T00:04:11.051Z","avatar_url":"https://github.com/lightpohl.png","language":"JavaScript","funding_links":["https://ko-fi.com/lightpohl"],"categories":[],"sub_categories":[],"readme":"# gb-dl\n\n## A CLI for downloading [Giant Bomb](https://www.giantbomb.com) videos.\n\n![gb-dl example gif](./docs/gb-dl-example.gif)\n\n## How to Use\n\n### Binaries\n\n[Visit the releases page](https://github.com/lightpohl/gb-dl/releases) and download the latest binary for your system.\n\n`gb-dl --api-key \u003cYOUR_API_KEY\u003e --video-name \u003cstring\u003e`\n\n### npx\n\n**[Node Required](https://nodejs.org/en/)**\n\n`npx gb-dl --api-key \u003cYOUR_API_KEY\u003e --video-name \u003cstring\u003e`\n\n### [More Examples](./examples/README.md)\n\n## Options\n\n**API key may be provided via `--api-key` option or `GIANTBOMB_TOKEN` env variable.**\n\n**Either `--video-name`, `--video-guid`, or `--video-number` must be provided.**\n\n| Option                 | Type   | Required | Description                                                                                           |\n| ---------------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------- |\n| --api-key              | String | false\\*  | Individual [Giant Bomb API key](https://www.giantbomb.com/api/).                                      |\n| --video-name           | String | false\\*  | Used to find matching video title.                                                                    |\n| --video-guid           | String | false\\*  | Used to grab a video by its GUID directly.                                                            |\n| --video-number         | Number | false\\*  | Zero-based video index for provided show (most recent video is `0`). Defaults to `0`.                 |\n| --video-number-reverse |        | false    | Swaps direction of provided \"--video-number\" (oldest video is now `0`).                               |\n| --show-name            | String | false    | Used to find matching show title.                                                                     |\n| --only-premium         |        | false    | Filter search to only premium videos.                                                                 |\n| --only-free            |        | false    | Filter search to only free videos.                                                                    |\n| --quality              | String | false    | Specify quality of video to download. Defaults to highest. Other options: hd, high, low and mobile.   |\n| --date-after           | String | false    | Check if video was published after date before downloading (i.e. MM/DD/YYY, inclusive).               |\n| --date-before          | String | false    | Check if video was published before date before downloading (i.e. MM/DD/YYY, inclusive).              |\n| --out-dir              | String | false    | Specify output directory for video. Defaults to current working directory.                            |\n| --add-guid-prefix      |        | false    | Prefixes the downloaded video with its associated GUID (e.g. \"2300-14149 - Quick Look\\_ Forager.mp4\") |\n| --add-date-prefix      |        | false    | Prefixes the downloaded video with its publish date (e.g. \"2021-05-08 - Quick Look\\_ Forager.mp4\")    |\n| --info                 |        | false    | Output video information instead of download.                                                         |\n| --archive              |        | false    | Check archive before downloading.                                                                     |\n| --blocklist            |        | false    | Check blocklist before downloading.                                                                   |\n| --clean                |        | false    | Ignore cache when making query.                                                                       |\n| --debug                |        | false    | Show debug statements.                                                                                |\n| --health-check         |        | false    | Check the Giant Bomb API for ongoing issues.                                                          |\n| --version              |        | false    | Output the version number.                                                                            |\n| --help                 |        | false    | Output usage information.                                                                             |\n\n## [Giant Bomb API](https://www.giantbomb.com/api/)\n\n- Make sure to stay within the [Giant Bomb API usage guidelines](https://www.giantbomb.com/api/).\n- The Giant Bomb API has an unmentioned account download limit of **100 videos per day.**\n\n## Rate Limiting\n\n- A one second delay between requests is added to avoid flooding the Giant Bomb API.\n- `gb-dl` may need to make a few requests to find a video, so expect a short delay after starting.\n\n## Caching\n\n- `gb-dl` will generate a `gb-dl-cache.json` in the current working directory when run in order to avoid hitting the Giant Bomb API repeatedly for the same set of data.\n- Cached responses will be used for one hour.\n- Adding `--clean` to the command will bypass the cache.\n- Expired cache results will be removed on script start.\n\n## Archive\n\n- If passed the `--archive` flag, `gb-dl` will generate/use a `gb-dl-archive.json` in the current working directory.\n- Before downloading a video, it'll check if the video was downloaded previously and abort the download if found.\n\n## Blocklist\n\n- If the `--blocklist` flag is passed, `gb-dl` will look up a `gb-dl-blocklist.json` in the current working directory.\n- Before downloading a video it'll check if the `video_show` title is included in the blocklist and ignore the download if found.\n- See [Examples](./examples) for an example blocklist.\n\n## [More Examples](./examples)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightpohl%2Fgb-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flightpohl%2Fgb-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightpohl%2Fgb-dl/lists"}