{"id":16793247,"url":"https://github.com/mririgoyen/codex","last_synced_at":"2026-03-06T10:05:55.862Z","repository":{"id":37196042,"uuid":"235254613","full_name":"mririgoyen/codex","owner":"mririgoyen","description":"A minimalistic, cross-platform item tracker for randomized games.","archived":false,"fork":false,"pushed_at":"2023-02-03T03:31:15.000Z","size":6073,"stargazers_count":4,"open_issues_count":24,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-11T09:31:56.368Z","etag":null,"topics":["gaming","item-tracker","randomizer"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mririgoyen.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},"funding":{"github":["goyney"],"custom":"https://www.extra-life.org/participant/goyney"}},"created_at":"2020-01-21T04:19:02.000Z","updated_at":"2023-07-21T22:55:33.000Z","dependencies_parsed_at":"2024-10-28T12:18:46.154Z","dependency_job_id":"e7dae130-bd6f-4834-b5c0-b3c255e0f841","html_url":"https://github.com/mririgoyen/codex","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mririgoyen/codex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mririgoyen%2Fcodex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mririgoyen%2Fcodex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mririgoyen%2Fcodex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mririgoyen%2Fcodex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mririgoyen","download_url":"https://codeload.github.com/mririgoyen/codex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mririgoyen%2Fcodex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30171657,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["gaming","item-tracker","randomizer"],"created_at":"2024-10-13T08:48:40.278Z","updated_at":"2026-03-06T10:05:55.823Z","avatar_url":"https://github.com/mririgoyen.png","language":"JavaScript","funding_links":["https://github.com/sponsors/goyney","https://www.extra-life.org/participant/goyney"],"categories":[],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD033 --\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Codex\" src=\"assets/github-banner.png\" width=\"880\"\u003e\n\u003c/div\u003e\n\n# Codex\n\nCodex is a minimalistic, cross-platform item tracker for randomized games. Built on React and Electron, it allows gamers on any operating system the ability to enjoy their favorite randomized games with ease.\n\n# How to Install\n\nCheck the [releases tab](https://github.com/goyney/codex/releases) and download Codex for your operating system.\n\n- **Windows**: The `exe` file will automatically install and launch Codex upon running it.\n- **macOS**: Open the `dmg` file and drag Codex to your Applications folder.\n- **Linux**: Make the `AppImage` file executable and run it.\n\n# Supported Games\n\n- [A Link to the Past Randomizer](https://alttpr.com/) (SNES)\n\n# Adding New Games\n\nThere's a couple ways you can get a new game into Codex.\n\n1. [Open an issue](https://github.com/goyney/codex/issues/new?labels=Game+Addition\u0026template=1_game_addition.md\u0026title=) requesting a game you'd like to see added.\n2. Develop it yourself and open a PR.\n\n## Developing New Game Trackers\n\nTo start developing, `yarn install` and then `yarn develop`.\n\nGame tracker components are written in React, so an understanding of the React ecosystem is required to create new trackers. Game tracker components are located in the `src/renderer/components/Games` directory.\n\n1. Create a new directory for a specific game (if one does not currently exist).\n2. Develop your new item tracker component(s) for the game.\n    - Any assets, such as custom `SCSS` files or `SVG` graphics specific to the game should be nested in the game directory.\n3. Add a new entry in `src/renderer/components/Games/games.js` to register your item tracker(s).\n\nThere is a common `\u003cItem/\u003e` component that can be used that should fit most use cases. Game-specific components should remain scoped to the game.\n\n# License\n\nMIT\n\nGame trademarks and copyrights are properties of their respective owners.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmririgoyen%2Fcodex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmririgoyen%2Fcodex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmririgoyen%2Fcodex/lists"}