Home

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

General-purpose SDK for building browser extensions and Tampermonkey/Greasemonkey userscripts for fishtank.live.

For installation and a quick-start example, see the README on the main repo.

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)
• Debug — Toggle SDK lifecycle logging

Archives

• Archives — Season archive listings, signed watch URLs, and schedule helpers

Chat

• Chat Store — Direct Zustand store access for filtering and modifying messages
• Chat Messages — Normalised chat, TTS, and SFX events from Socket.IO
• Chat Rooms — Subscribe to Season Pass and Season Pass XL rooms
• 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