screenkit 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6686849b372a2cc81451fb2855e2d97704c6584b5fc5f6f119df6f49d3fadb60
-  data.tar.gz: 585e7481be4aa3b27eed57b2ed62424ed809ade1f15975255e9a71b16d912ee3
+  metadata.gz: 3dc4a6ebfa5fb6725aa40e4bbe699bcafca860135ef8cca01fc48ab66731392f
+  data.tar.gz: 42df45d24c11f800e20fff4dfc030102bef5747f758ee47378d98a56dd8732f8
 SHA512:
-  metadata.gz: 2c1016f94efb78c43c09854d0de46df93c99f45a0f9683d0b8f7d399fdeca891378fc5bf3b9e2f14be06ad467259dbb7c987622c4916bbce940832404b492571
-  data.tar.gz: 92ed7474f18ee43689ff8d2977b04633193bd195a274483137fe0cfd103b213ab968e0cb3eafcdefa1a192fe62563aa402c0742b01dbc77425cc764dd8d2a9ae
+  metadata.gz: c0eac47f990100559123217b0a54f1ae84629ea6ff7039c38d6212d72284cce07b10552f92b6504588ab74a013bb3242d8bc19fe66a7a06b0cb3a8014822248b
+  data.tar.gz: 5c43aae473d552c8f0d233c0ab19b8ca1a1eab91b26225b7533c53eb4caeb44e5909cbc5e20c04b66bad939acee49219d0a75f61edb1617e00e209e498546567

data/.github/workflows/docker.yml

@@ -7,7 +7,7 @@ on:
     paths:
       - Dockerfile
     tags:
-      - v*
+      - v[0-9]+.[0-9]+.[0-9]+
   workflow_dispatch:
     inputs:
       ref:
@@ -23,7 +23,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           ref: ${{ github.event.inputs.ref }}
 

data/CHANGELOG.md

@@ -11,18 +11,26 @@ Prefix your message with one of the following:
 - [Security] in case of vulnerabilities.
 -->
 
+## v0.0.7
+
+- [Fixed] Improve support for extensions.
+
+## v0.0.6
+
+- [Added] Add `--tts-preset` option to select TTS preset when exporting
+  episodes.
+
 ## v0.0.5
 
-- [Added] Added `--skip-bundler` option to skip bundler when generating
-  projects.
+- [Added] Add `--skip-bundler` option to skip bundler when generating projects.
 
 ## v0.0.4
 
-- [Fixed] Fixed Gemfile template that was pointing to a local path.
+- [Fixed] Fix Gemfile template that was pointing to a local path.
 
 ## v0.0.3
 
-- [Changed] Do not expand path when creating project/episode.
+- [Changed] Keep path as it is when creating project/episode.
 
 ## v0.0.2
 

data/DOCUMENTATION.md

@@ -39,7 +39,74 @@ gem "screenkit"
 ### Docker
 
 ```bash
-docker run --shm-size=2g -v $PWD:/source --rm -it docker.io/fnando/screenkit
+$ docker run \
+    --platform=linux/amd64 \
+    --shm-size=2g \
+    -v $PWD:/source \
+    --rm -it \
+    docker.io/fnando/screenkit new --skip-bundler example
+      create  Gemfile
+      create  screenkit.yml
+      create  resources
+      create  resources/backtracks/default.aac
+      create  resources/fonts/open-sans/OFL.txt
+      create  resources/fonts/open-sans/OpenSans-ExtraBold.ttf
+      create  resources/fonts/open-sans/OpenSans-SemiBold.ttf
+      create  resources/fonts/open-sans/README.txt
+      create  resources/images/logo.png
+      create  resources/images/watermark.png
+      create  resources/sounds/chime.mp3
+      create  resources/sounds/pop.mp3
+      create  resources/sounds/whoosh.mp3
+
+$ cd example
+
+$ docker run \
+    --platform=linux/amd64 \
+    --shm-size=2g \
+    -v $PWD:/source \
+    --rm -it \
+    docker.io/fnando/screenkit episode new --title 'Hello, world!'
+      create  episodes/001-hello-world/config.yml
+      create  episodes/001-hello-world/scripts
+      create  episodes/001-hello-world/scripts/001.txt
+      create  episodes/001-hello-world/content
+      create  episodes/001-hello-world/content/001.tape
+      create  episodes/001-hello-world/resources
+      create  episodes/001-hello-world/voiceovers
+      create  episodes/001-hello-world/resources/.keep
+      create  episodes/001-hello-world/voiceovers/.keep
+
+$ docker run \
+    --platform=linux/amd64 \
+    --shm-size=2g \
+    -v $PWD:/source \
+    --rm -it \
+    docker.io/fnando/screenkit episode export --dir episodes/001-hello-world
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  Terminal to screencast, simplified                                      ┃═╗
+┃  ███████╗ ██████╗██████╗ ███████╗███████╗███╗   ██╗██╗  ██╗██╗████████╗  ┃ ║
+┃  ██╔════╝██╔════╝██╔══██╗██╔════╝██╔════╝████╗  ██║██║ ██╔╝██║╚══██╔══╝  ┃ ║
+┃  ███████╗██║     ██████╔╝█████╗  █████╗  ██╔██╗ ██║█████╔╝ ██║   ██║     ┃ ║
+┃  ╚════██║██║     ██╔══██╗██╔══╝  ██╔══╝  ██║╚██╗██║██╔═██╗ ██║   ██║     ┃ ║
+┃  ███████║╚██████╗██║  ██║███████╗███████╗██║ ╚████║██║  ██╗██║   ██║     ┃ ║
+┃  ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝   ╚═╝     ┃ ║
+┃                                                               v0.0.5     ┃ ║
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ║
+  ╚══════════════════════════════════════════════════════════════════════════╝
+
+        info  Project root dir: .
+        info  Episode root dir: episodes/001-hello-world
+        info  Matching all 1 segments
+        info  Exported intro in 2.39s
+        info  Exported outro in 2.11s
+        info  Generated voiceover in 0.89s
+        info  Exported videos in 0.00s
+        info  Created callouts in 0.00s
+        info  Created segments in 2.55s
+        info  Merged videos in 8.31s
+        info  Exported video to output/001-hello-world/001-hello-world.mp4
+        info  Exported episode in 16.29s
 ```
 
 Notice that Chrome requires a lot of memory, so you need `--shm-size=2g` (or
@@ -138,7 +205,8 @@ Export an episode to video.
 **Options:**
 
 - `--dir` (required) - Episode directory path
-- `--voice-api-key` - API key for TTS service (e.g., ElevenLabs)
+- `--tts-api-key` - API key for TTS service (e.g., ElevenLabs)
+- `--tts-preset` - TTS preset name that will be used
 - `--overwrite` - Overwrite existing exported files (default: `false`)
 - `--match-segment` - Only export segments matching this string
 - `--output-dir` - Custom output directory path
@@ -220,12 +288,12 @@ watermark:
 watermark: false
 ```
 
-### Callout Definitions
+### Callout Styles
 
 Define reusable callout styles:
 
 ```yaml
-callouts:
+callout_styles:
   shadow_block:
     background_color: "#ffff00"
     shadow: "#2242d3" # Color string or false
@@ -290,8 +358,9 @@ backtrack: false  # Disable for this episode
 
 # Override TTS settings
 tts:
-  engine: elevenlabs
-  voice_id: custom_voice_id
+  - id: eleven_labs
+    engine: eleven_labs
+    voice_id: custom_voice_id
 
 # Override watermark
 watermark: false
@@ -642,9 +711,10 @@ Uses the built-in macOS `say` command.
 
 ```yaml
 tts:
-  engine: say
-  voice: Alex # Optional: Voice name
-  rate: 150 # Words per minute (optional)
+  - id: say
+    engine: say
+    voice: Alex # Optional: Voice name
+    rate: 150 # Words per minute (optional)
 ```
 
 ### ElevenLabs Engine
@@ -653,22 +723,23 @@ Professional AI voice synthesis.
 
 ```yaml
 tts:
-  engine: elevenlabs
-  voice_id: "56AoDkrOh6qfVPDXZ7Pt" # Required: ElevenLabs voice ID
-  language_code: en # 2-letter language code
-
-  # Optional: Voice settings
-  voice_settings:
-    speed: 0.9 # Speech speed (default: 1.0)
-    stability: 0.5 # Voice stability (0.0 - 1.0)
-    similarity: 0.75 # Voice similarity (0.0 - 1.0)
-    style: 0.0 # Speaking style (0.0+)
-
-  # Optional: Output format
-  output_format: mp3_44100_128
-
-  # Optional: Model ID
-  model_id: eleven_monolingual_v1
+  - id: eleven_labs
+    engine: eleven_labs
+    voice_id: "56AoDkrOh6qfVPDXZ7Pt" # Required: ElevenLabs voice ID
+    language_code: en # 2-letter language code
+
+    # Optional: Voice settings
+    voice_settings:
+      speed: 0.9 # Speech speed (default: 1.0)
+      stability: 0.5 # Voice stability (0.0 - 1.0)
+      similarity: 0.75 # Voice similarity (0.0 - 1.0)
+      style: 0.0 # Speaking style (0.0+)
+
+    # Optional: Output format
+    output_format: mp3_44100_128
+
+    # Optional: Model ID
+    model_id: eleven_monolingual_v1
 ```
 
 #### ElevenLabs Output Formats
@@ -693,7 +764,7 @@ module. Custom engines must implement the `generate` method:
 module ScreenKit
   module TTS
     class CustomEngine < Base
-      include Shell
+      extend Shell
 
       # Optional: Define schema path for validation
       def self.schema_path
@@ -701,8 +772,8 @@ module ScreenKit
       end
 
       # This method is required.
-      def available?
-        enabled? && command_exist?("some-command")
+      def self.available?(**)
+        command_exist?("some-command")
       end
 
       # This method is required.
@@ -710,15 +781,20 @@ module ScreenKit
         # Optional: validate options against JSON schema.
         self.class.validate!(options)
 
+        # If you need access to previous/next text, you can access the method
+        # `segments`.
+        # current_index = segments.index { it.script_content == text }
+        # next_text = segments[current_index + 1]&.script_content
+
         # Generate audio file from text
         # Write output to output_path
         # Optionally log to log_path
 
         # Example implementation:
-        # run_command "some-command",
-        #             "-o", output_path.sub_ext(".wav"),
-        #             text,
-        #             log_path:
+        # self.class.run_command "some-command",
+        #                        "-o", output_path.sub_ext(".wav"),
+        #                        text,
+        #                        log_path:
       end
     end
   end
@@ -729,16 +805,28 @@ end
 
 ```yaml
 tts:
-  engine: custom_engine # Camelized to CustomEngine
-  # Add your custom options here
-  api_key: your_api_key
-  custom_option: value
+  - id: custom_engine
+    engine: custom_engine # Camelized to CustomEngine
+    enabled: true
+    # Add your custom options here
+    api_key: your_api_key
+    custom_option: value
 ```
 
 The engine name is camelized (e.g., `custom_engine` → `CustomEngine`,
 `google_cloud` → `GoogleCloud`) and loaded as
 `ScreenKit::TTS::#{CamelizedName}`.
 
+### 3rd-party TTS Engines
+
+- [Search Github](https://github.com/topics/screenkit-tts)
+- [Google Text to Speech](https://github.com/fnando/screenkit-tts-google)
+
+> [!TIP]
+>
+> If you host your TTS engine on Github, use the topic `screekit-tts`, so other
+> people can find it.
+
 ---
 
 ## Animations
@@ -825,6 +913,12 @@ Enter
 Sleep 2s
 ```
 
+When running tape files, the working directory will be the episode directory. If
+you're importing anything from the parent directory, you must specify relative
+paths accordingly. For instance, `episodes/001-episode-name/content/001.tape`
+would need to reference `../../resources/some-file` to access
+`resources/some-file` in the project's directory.
+
 ### Script Files
 
 Plain text files for voiceover generation:
@@ -839,7 +933,7 @@ Today we'll learn how to create amazing screencasts.
 
 Files are matched by number:
 
-- `content/001.tape` → `scripts/001.txt` → `voiceovers/001.aiff`
+- `content/001.tape` → `scripts/001.txt` → `voiceovers/001.:ext`
 - Segments are processed in numerical order
 - Missing scripts create silent segments
 
@@ -962,7 +1056,7 @@ ScreenKit validates configurations against JSON schemas:
 Use the `yaml-language-server` comment for IDE support:
 
 ```yaml
-# yaml-language-server: $schema=../../schemas/project.json
+# yaml-language-server: $schema=https://screenkit.dev/schemas/project.json
 ```
 
 ---
@@ -1048,8 +1142,9 @@ bundle exec screenkit ...
 
 **TTS not working:**
 
-- For ElevenLabs: Set `--voice-api-key`
+- For ElevenLabs: Set `--tts-api-key`
 - For macOS `say`: Verify voice name with `say -v ?`
+- For `espeak`: Ensure `espeak` is installed and in PATH
 
 ---
 

data/Dockerfile

@@ -34,6 +34,7 @@ RUN apk add --no-cache \
     chromium \
     chromium-chromedriver \
     curl \
+    espeak \
     fish \
     ffmpeg \
     font-liberation \

data/action.yml

@@ -0,0 +1,140 @@
+---
+name: ScreenKit Episode
+description: Export a screencast episode using Docker
+inputs:
+  episode:
+    description: "Episode number (e.g. 001)"
+    required: true
+  tts_preset:
+    description: "TTS preset name"
+    default: ""
+    required: false
+  tts_api_key:
+    description: "TTS API key"
+    required: false
+  overwrite:
+    description: "Regenerate files"
+    default: "false"
+    required: false
+  match:
+    description: "Match pattern for segments (e.g. 001)"
+    default: ""
+    required: false
+  github_token:
+    description: "GitHub token for cache operations"
+    required: true
+  retention:
+    description: "Retention days for artifacts"
+    default: "2"
+
+runs:
+  using: composite
+  steps:
+    - name: Generate cache keys
+      shell: bash
+      run: |
+        VOICEOVER_HASH=$(find episodes/${{ inputs.episode }}-*/scripts/*.txt -type f 2>/dev/null | sort | xargs sha256sum 2>/dev/null | sha256sum | cut -d' ' -f1 || echo "none")
+        CONTENT_HASH=$(find episodes/${{ inputs.episode }}-*/*/*.* -type f 2>/dev/null | sort | xargs sha256sum 2>/dev/null | sha256sum | cut -d' ' -f1 || echo "none")
+
+        echo "VOICEOVER_CACHE_KEY=episode-voiceover-${{ inputs.episode }}-${VOICEOVER_HASH}" >> $GITHUB_ENV
+        echo "VOICEOVER_RESTORE_KEY=episode-voiceover-${{ inputs.episode }}-" >> $GITHUB_ENV
+        echo "VIDEO_CACHE_KEY=episode-${{ inputs.episode }}-${CONTENT_HASH}" >> $GITHUB_ENV
+        echo "VIDEO_RESTORE_KEY=episode-${{ inputs.episode }}-" >> $GITHUB_ENV
+
+    - name: Find episode dir
+      shell: bash
+      run: |
+        EPISODE_DIR=$(ls -1d episodes/${{ inputs.episode }}-* | head -n 1)
+        echo "EPISODE_DIR=$EPISODE_DIR" >> $GITHUB_ENV
+
+        if [[ ! -d "$EPISODE_DIR" ]]; then
+          echo "Episode directory not found!"
+          echo "Available episodes:"
+          ls -1 episodes
+          exit 1
+        fi
+
+    - name: Restore episode voice cache
+      id: cache-voice
+      uses: actions/cache/restore@v4
+      with:
+        path: episodes/${{ inputs.episode }}-*/voiceovers
+        key: ${{ env.VOICEOVER_CACHE_KEY }}
+        restore-keys: ${{ env.VOICEOVER_RESTORE_KEY }}
+        enableCrossOsArchive: true
+
+    - name: Restore videos cache
+      id: cache-videos
+      uses: actions/cache/restore@v4
+      with:
+        path: output/${{ inputs.episode }}-*/videos/*.mp4
+        key: ${{ env.VIDEO_CACHE_KEY }}
+        restore-keys: ${{ env.VIDEO_RESTORE_KEY }}
+        enableCrossOsArchive: true
+
+    - name: Export Episode
+      shell: bash
+      id: screenkit
+      run: |
+        set -e
+        docker run \
+          --rm \
+          --cap-add=SYS_ADMIN \
+          --shm-size=2g \
+          --security-opt seccomp=unconfined \
+          -v ${{ github.workspace }}:/source \
+          fnando/screenkit:latest \
+          episode export \
+          --dir="${{ env.EPISODE_DIR }}" \
+          ${{ inputs.match != '' && format('--match {0}', inputs.match) || '' }} \
+          ${{ inputs.overwrite == 'true' && '--overwrite' || '--no-overwrite' }} \
+          ${{ inputs.tts_preset != '' && format('--tts-preset {0}', inputs.tts_preset) || '' }} \
+          ${{ inputs.tts_api_key != '' && format('--tts-api-key {0}', inputs.tts_api_key) || '' }}
+        echo "result=true" >> $GITHUB_OUTPUT
+
+    - name: Delete voice cache
+      if: steps.screenkit.outputs.result == 'true'
+      shell: bash
+      run: gh cache delete "${{ env.VOICEOVER_CACHE_KEY }}" || true
+      env:
+        GH_TOKEN: ${{ inputs.github_token }}
+
+    - name: Delete videos cache
+      if: steps.screenkit.outputs.result == 'true'
+      shell: bash
+      run: gh cache delete "${{ env.VIDEO_CACHE_KEY }}" || true
+      env:
+        GH_TOKEN: ${{ inputs.github_token }}
+
+    - name: List cache entries
+      shell: bash
+      run: |
+        echo "= Voiceover Cache ="
+        ls -la episodes/${{ inputs.episode }}-*/voiceovers || true
+        echo
+        echo "= Videos Cache ="
+        ls -la output/${{ inputs.episode }}-*/videos || true
+
+    - name: Save episode voiceover cache
+      if: steps.screenkit.outputs.result == 'true'
+      uses: actions/cache/save@v4
+      with:
+        path: episodes/${{ inputs.episode }}-*/voiceovers
+        key: ${{ env.VOICEOVER_CACHE_KEY }}
+        enableCrossOsArchive: true
+
+    - name: Save video recordings cache
+      if: steps.screenkit.outputs.result == 'true'
+      uses: actions/cache/save@v4
+      with:
+        path: output/${{ inputs.episode }}-*/videos/*.mp4
+        key: ${{ env.VIDEO_CACHE_KEY }}
+        enableCrossOsArchive: true
+
+    - name: Upload output artifacts
+      uses: actions/upload-artifact@v5
+      if: always()
+      with:
+        name: output
+        path: output
+        retention-days: ${{ inputs.retention }}

data/lib/screenkit/callout/styles/base.rb

@@ -4,6 +4,8 @@ module ScreenKit
   class Callout
     module Styles
       class Base
+        require_relative "../../schema_validator"
+
         attr_reader :source, :output_path, :log_path
         attr_accessor :options
 
@@ -16,6 +18,11 @@ module ScreenKit
           @options = options
         end
 
+        # Wrap text to fit within the specified maximum width.
+        # @param text [String] The text to wrap.
+        # @param max_width [Integer] The maximum width in pixels.
+        # @param font_size [Integer] The font size in points.
+        # @return [Array<String>] The wrapped lines of text.
         def text_wrap(text, max_width:, font_size:)
           words = text.to_s.split(/\s+/)
           width_factor = 0.6
@@ -42,10 +49,19 @@ module ScreenKit
           text.gsub("'", "\\\\'")
         end
 
+        # Remove a file if it exists.
+        # @param path [String] The file path to remove.
         def remove_file(path)
           File.unlink(path) if path && File.exist?(path)
         end
 
+        # Render text into an image using MiniMagick.
+        # @param text [String] The text to render.
+        # @param style [TextStyle] The text style to apply.
+        # @param width [Integer] The width of the text image.
+        # @param type [String] The ImageMagick text type (e.g., "caption").
+        # @return [Array] The path to the generated text image, width, and
+        # height.
         def render_text_image(text:, style:, width:, type:)
           return [nil, 0, 0] if text.to_s.empty?
 

data/lib/screenkit/cli/episode.rb

@@ -55,12 +55,19 @@ module ScreenKit
              type: :array,
              default: [],
              desc: "Additional Ruby files to require"
+      option :tts_preset,
+             type: :string,
+             desc: "Preset voice configuration for TTS"
       def export
         puts Banner.banner if options.banner
 
-        episode_config = Config::Episode.load_file(
-          File.join(options.dir, "config.yml")
-        )
+        episode_config = File.join(options.dir, "config.yml")
+
+        episode_config = if File.file?(episode_config)
+                           Config::Episode.load_file(episode_config)
+                         else
+                           {}
+                         end
 
         options.require.each { require(it) }
 

data/lib/screenkit/content_type.rb

@@ -4,7 +4,7 @@ module ScreenKit
   module ContentType
     def self.video = %w[mp4 webm mov]
     def self.audio = %w[mp3 wav m4a aac aiff]
-    def self.image = %w[gif jpg jpeg png]
+    def self.image = %w[gif jpg jpeg png tiff]
     def self.demotape = %w[tape]
 
     def self.all = video + image + demotape

data/lib/screenkit/core_ext/json.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "json"
+
 module ScreenKit
   module CoreExt
     refine JSON.singleton_class do

data/lib/screenkit/core_ext/string.rb

@@ -7,6 +7,8 @@ module ScreenKit
         unicode_normalize(:nfkd)
           .delete("'")
           .gsub(/[^\x00-\x7F]/, "")
+          .gsub(/([a-z\d])([A-Z])/, '\1-\2')
+          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1-\2')
           .gsub(/[^-\w]+/xim, "-")
           .tr("_", "-")
           .gsub(/-+/xm, "-")
@@ -14,6 +16,10 @@ module ScreenKit
           .downcase
       end
 
+      def underscore
+        dasherize.tr("-", "_")
+      end
+
       def camelize(first_letter = :upper)
         split(/_|-/).map.with_index do |part, index|
           if index.zero? && first_letter == :lower

data/lib/screenkit/core_ext.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "core_ext/string"
+require_relative "core_ext/json"

data/lib/screenkit/exporter/demotape.rb

@@ -27,7 +27,8 @@ module ScreenKit
                     "--fps", 24,
                     "--overwrite",
                     "--output-path", output_path,
-                    log_path:
+                    log_path:,
+                    chdir: demotape_path.parent.parent
       end
 
       def options_to_args(options)

data/lib/screenkit/exporter/episode.rb

@@ -38,7 +38,7 @@ module ScreenKit
       end
 
       def tts_available?
-        tts_engines.any?(&:available?)
+        tts_engine
       end
 
       def demotape_options
@@ -46,11 +46,11 @@ module ScreenKit
       end
 
       def tts_engine
-        tts_engines.find(&:available?)
+        tts_engines.first
       end
 
-      def tts_engines
-        @tts_engines ||= begin
+      def tts_config
+        @tts_config ||= begin
           project_tts = if project_config.tts.is_a?(Hash)
                           [project_config.tts]
                         else
@@ -63,10 +63,23 @@ module ScreenKit
                           Array(config.tts)
                         end
 
-          (episode_tts + project_tts).map do |opts|
-            TTS.const_get(opts[:engine].camelize)
-               .new(**opts.except(:engine), api_key: options.tts_api_key)
-          end
+          episode_tts + project_tts
+        end
+      end
+
+      def tts_engines
+        @tts_engines ||= tts_config.filter_map do |opts|
+          next unless opts[:enabled]
+
+          api_key = options.tts_api_key
+          tts_class = TTS.const_get(opts[:engine].camelize)
+          tts_preset = options.tts_preset.to_s
+
+          next if !tts_preset.empty? && tts_preset != opts[:id]
+          next unless tts_class.available?(api_key:, **opts)
+
+          opts = opts.except(:engine, :enabled)
+          tts_class.new(**opts, api_key:, segments:)
         end
       end