subtitles.py

from talon import Module, Context, actions

mod = Module()
ctx = Context()
subtitles_enabled = None

def update_subtitles(state):
    global subtitles_enabled
    subtitles_enabled = state
    if subtitles_enabled is not None:
        ctx.settings = {"speech._subtitles": subtitles_enabled}
    else:
        ctx.settings = {}

@mod.action_class
class ModuleActions:
    def subtitles_enable():
        """Enable subtitles temporarily."""
        update_subtitles(True)

    def subtitles_disable():
        """Disable subtitles temporarily."""
        update_subtitles(False)

    def subtitles_restore():
        """Restore subtitles to default state."""
        update_subtitles(None)

subtitles.talon

subtitles on: user.subtitles_enable()
subtitles off: user.subtitles_disable()
subtitles restore: user.subtitles_restore()