Home

Fishtank Live Extended SDK (ftl-ext-sdk) Wiki

General-purpose SDK for building browser extensions and Tampermonkey/Greasemonkey userscripts for [fishtank.live](https://fishtank.live).

For installation and a quick-start example, see the [README on the main repo](https://github.com/BarryThePirate/ftl-ext-sdk).

Modules

Core

• Site — Detect site version, ready state, and the logged-in user
• Socket — Socket.IO connection to the fishtank.live WebSocket server
• Events — Open, close, and observe site modals
• Dom — Stable element selectors and DOM observation helpers
• Storage — Namespaced localStorage wrapper
• Transport — Cross-origin fetch layer
• React — Walk the React fiber tree (advanced)

Chat

• Chat Messages — Normalised chat, TTS, and SFX events from Socket.IO
• Chat Rooms — Subscribe to Season Pass and Season Pass XL rooms
• Chat Observer — Lightweight DOM-based chat observation
• Chat Input — Helpers for the chat input field

UI

• Ui Modals — Inject content into site modals
• Ui Keyboard — Register keyboard shortcuts
• Ui Toasts — Show your own toast notifications
• Ui Toast Observer — Watch the site's own toasts
• Ui Download — Trigger browser file downloads

Player

• Player — Video element and stream/room name resolution

Guides

• Firefox Compatibility — Required reading if you target Firefox
• Raw Socket Data — Quirks of the underlying socket events