A reverse index of Twitch moderator and VIP roles, at moddex.tv.
Twitch only lets a broadcaster see their own mod and VIP list. moddex answers the inverse question: given an account, which channels does it hold a role on. The index is crowdsourced. Looking up a channel reads its lists, and that is what lets an account's page say where it moderates.
| repository | runs at | what it is |
|---|---|---|
| moddex-web | moddex.tv | The website. Next.js. Holds no database and reads everything from the api. |
| moddex-api | api.moddex.tv | The core. Owns the database, the Twitch scraping and the public REST api. Private. |
| moddex-ws | ws.moddex.tv | WebSocket fan-out for live role and badge changes, and the Twitch EventSub connection they arrive on. |
| moddex-status | status.moddex.tv | Uptime and health monitoring. Shares nothing with the services it watches, not even the host. |
| moddex-discord | the community server | The Discord bot. Announces joins and boosts, answers slash commands through the api. |
Each service is its own repository and deploys on its own, as a container built by GitHub Actions. Only moddex-api talks to the database. Everything else asks it over HTTP.
https://api.moddex.tv/v1/…, documented at api.moddex.tv/docs.
Public reads need no key. A chat bot serving many viewers from one address can
be given a key that lifts the per-address rate limit; ask on Discord.
A FrankerFaceZ add-on shows the badge a moddex user wears beside their name in chat, and keeps it current without a reload. It is submitted upstream as FrankerFaceZ/Add-Ons#386.
moddex lists what Twitch already shows publicly on a channel. Any account can opt out of being listed: sign in at moddex.tv and switch it off under settings. The privacy page says exactly what that covers.
- Discord: discord.gg/qhJEfAwRJ9
- Made by maersux, maersux.dev
- The public repositories are MIT licensed.
