A CTFd plugin that allows administrators to organize challenges into scheduled waves and release them automatically — or manually with a single click.
- Scheduled Release — Define a release time and the plugin reveals challenges automatically when it's due.
- Instant Release — One-click Release Now button to push a wave live immediately during an event.
- Live Countdown — Real-time countdown timers on all pending waves so you always know what's next.
- Challenge Grouping — Assign any combination of existing challenges to a wave via searchable checkboxes.
- Global Notifications — Optionally broadcast an alert to all participants the moment a wave drops.
- Local Timezone Support — Times are displayed and entered in the admin's local timezone; stored as UTC on the server.
- Admin-Only Access — Every route is protected behind CTFd's
admins_onlydecorator. - Seamless Integration — Registers in the admin navbar, uses CTFd/Bootstrap 4 styling, and relies on CTFd's built-in CSRF protection.
-
Copy the
WaveManager/directory into your CTFd plugins folder:CTFd/ └── plugins/ └── WaveManager/ -
Restart CTFd. Database tables are created automatically on first load.
No additional Python packages are required.
After installation, a Wave Manager link appears in the admin navbar under the Plugins dropdown. Alternatively, navigate directly to /admin/waves.
- Click Create Wave.
- Fill in the form:
Field Description Wave Name A descriptive label (e.g. "Wave 2 — Crypto"). Release Time Displayed in your local timezone; converted to UTC automatically. Notification Text (Optional) Message broadcast to all users on release. Challenges Searchable checklist of all challenges in the database. - Click Create Wave.
| Action | Description |
|---|---|
| Release Now | Immediately reveals all linked challenges and sends the notification. |
| Edit | Update the wave name, time, notification text, or challenge selection. |
| Delete | Remove a wave entirely. Challenges themselves are not affected. |
On every incoming request, the plugin checks for unprocessed waves whose release time has passed:
- All linked challenges are set to
state = "visible". - If notification text is present, a global notification is created in CTFd.
- The wave is marked as processed to ensure it only triggers once.
WaveManager/
├── __init__.py # Plugin entry point, blueprint, routes, and release logic
├── models.py # Wave and WaveChallenges SQLAlchemy models
├── requirements.txt # Dependencies (none beyond CTFd)
├── README.md
└── templates/
└── waves/
├── waves.html # Admin list view with countdown & release controls
└── wave_form.html # Create / Edit form with timezone handling
Contributions, bug reports, and feature requests are welcome. Feel free to open an issue or submit a pull request.
Created by surakhii