{"id":49222999,"url":"https://github.com/2alf/ctfd-solve-fx","last_synced_at":"2026-04-24T05:03:26.285Z","repository":{"id":352876049,"uuid":"1216996052","full_name":"2alf/CTFd-solve-FX","owner":"2alf","description":"Solve celebration  plugin for your CTFD instance(s).","archived":false,"fork":false,"pushed_at":"2026-04-21T13:18:51.000Z","size":12529,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-21T15:29:03.786Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/2alf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-21T12:47:45.000Z","updated_at":"2026-04-21T13:28:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/2alf/CTFd-solve-FX","commit_stats":null,"previous_names":["2alf/ctfd-solve-fx"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/2alf/CTFd-solve-FX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2alf%2FCTFd-solve-FX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2alf%2FCTFd-solve-FX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2alf%2FCTFd-solve-FX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2alf%2FCTFd-solve-FX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2alf","download_url":"https://codeload.github.com/2alf/CTFd-solve-FX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2alf%2FCTFd-solve-FX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32209897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T03:15:14.334Z","status":"ssl_error","status_checked_at":"2026-04-24T03:15:11.608Z","response_time":64,"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":[],"created_at":"2026-04-24T05:03:21.207Z","updated_at":"2026-04-24T05:03:26.280Z","avatar_url":"https://github.com/2alf.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CTFd Solve FX\n\nFullscreen celebration (sound + visual) when a team submits a correct\nflag. Configurable from CTFd's admin panel, ships with three presets,\nand exposes a small JS API for building your own.\n\n## Install\n\nDrop the folder in, restart CTFd, and a **\"Solve FX\"** link appears in\nthe admin menu bar.\n\n## Admin panel\n\nAll settings are stored in CTFd's config table and injected into every\npage as `window.__CTFdSolveFXConfig` so changes take effect on page\nrefresh, no rebuild needed.\n\n![alt text](/images/image.png)\n\n## Presets\n\n| Name | Celebration |\n|---|---|\n| `pulse` | Radial square-grid pulse (3 expanding rings) |\n| `matrix` | matrix rain |\n| `conway` | Conway's Game of Life |\n| `flow` | Perlin noise from my [old proccesing project](https://openprocessing.org/sketch/2211359) |\n\nEach preset is a self-contained file in `assets/presets/`. \nTo add new presets just drop them as `.js` files in this folder and `__init__.py` should recognize them after a refresh.\n\n## Build your own preset\n\nA preset is an object with a `celebration(onDone)` function:\n\n```js\nCTFdSolveFX.register('my-preset', {\n  celebration(onDone) {\n    const overlay = CTFdSolveFX.helpers.makeOverlay();\n    const canvas = overlay.querySelector('.solvefx-canvas');\n    const ctx = CTFdSolveFX.helpers.fitCanvas(\n      canvas, window.innerWidth, window.innerHeight\n    );\n    // draw loop using CTFdSolveFX.config.color, etc.\n    setTimeout(onDone, 3000);\n  },\n});\n```\nThe celebration's sound is the admin's configured sound preset so you\ndon't need to handle audio yourself. If your preset wants a specific\nsound, call `CTFdSolveFX.helpers.chime([...])` from\ninside `celebration()`.\n\n## Preview\n\n`flow` and `matrix` presets: \u003cbr\u003e\n\n\u003cimage width=\"350px\" src=\"./images/flow.gif\"\u003e\n\u003cimage width=\"350px\" src=\"./images/matrix.gif\"\u003e\n\n\n\n\n## Solve detection\n\nFour overlapping hooks (Response.prototype.json, window.fetch,\nXMLHttpRequest, and CTFd.api.post_challenge_attempt) all watch for\n`POST /api/v1/challenges/attempt` returning `data.status === \"correct\"`.\nThis layered approach survives CTFd's use of swagger-client, which\ncaptures a fetch reference at module-load time and bypasses a plain\n`window.fetch` patch.\n\n## Testing without solving\n\nGo to `/challanges/` -\u003e preview challange and insert the flag and your effect should appear like in this gif demo:\n\nHere we used `pulse` preset:\n\n![alt text](/images/test.gif)\n\n## Contributions\n\nYou can contribute fixes or new presets with a PR.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2alf%2Fctfd-solve-fx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2alf%2Fctfd-solve-fx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2alf%2Fctfd-solve-fx/lists"}