screenkit 0.0.7 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3dc4a6ebfa5fb6725aa40e4bbe699bcafca860135ef8cca01fc48ab66731392f
-  data.tar.gz: 42df45d24c11f800e20fff4dfc030102bef5747f758ee47378d98a56dd8732f8
+  metadata.gz: 60085249659092fa92d7fab2c913f5e8d8fc3b8d9ce0ac467322ef590a08e5f9
+  data.tar.gz: 318d53f5ba88c1b8f2edd6d19ac263f2fcee0df7e7b5cb639f760b867be6e4ad
 SHA512:
-  metadata.gz: c0eac47f990100559123217b0a54f1ae84629ea6ff7039c38d6212d72284cce07b10552f92b6504588ab74a013bb3242d8bc19fe66a7a06b0cb3a8014822248b
-  data.tar.gz: 5c43aae473d552c8f0d233c0ab19b8ca1a1eab91b26225b7533c53eb4caeb44e5909cbc5e20c04b66bad939acee49219d0a75f61edb1617e00e209e498546567
+  metadata.gz: 565c78ea1e6701ee66087d22f4e62614ab765e1e625b50bdbeb9a953b3b4d7980dc6f8e7cad87250e1760f2923b10747c83c867f59347d1b4c37089d5ac87bb0
+  data.tar.gz: df2439bbb02d0bf47ecc80abdeafdd285f5c1f63782ce2a4411cb326a7d6b5edb6ddc79b36969555ad699439f4acea557265f52e1fc4a52be1d8e2d75e614a73

data/CHANGELOG.md

@@ -11,6 +11,15 @@ Prefix your message with one of the following:
 - [Security] in case of vulnerabilities.
 -->
 
+## v0.0.9
+
+- [Added] Add social callouts.
+- [Added] Add align support for inline block callouts.
+
+## v0.0.8
+
+- [Fixed] Further improvements to support extensions.
+
 ## v0.0.7
 
 - [Fixed] Improve support for extensions.

data/DOCUMENTATION.md

@@ -474,7 +474,109 @@ during the video.
 
 ### Callout Styles
 
-ScreenKit provides two built-in callout styles:
+ScreenKit provides a few built-in callout styles:
+
+#### Social Style
+
+The social callout style displays social media information with icons.
+
+```yaml
+callout_styles:
+  # Basic setup to use presets
+  social:
+    style: social
+    anchor: [left, bottom]
+    margin: 100
+    animation: fade
+    in_transition:
+      duration: 0.4s
+      sound: pop.mp3
+    out_transition:
+      duration: 0.4s
+      sound: pop.mp3
+
+  # Custom setup
+  custom_social:
+    style: social
+    background_color: "#E0D300"
+    label_style:
+      size: 24
+      color: "#00000088"
+      font_path: "open-sans/OpenSans-ExtraBold.ttf"
+    text_style:
+      size: 50
+      color: "#000000"
+      font_path: "open-sans/OpenSans-ExtraBold.ttf"
+    label: "CUSTOM"
+    icon:
+      path: "images/custom.png" # Must be a 160x160 image
+      background_color: "#000000"
+    anchor: [left, bottom]
+    margin: 100
+    animation: fade
+    in_transition:
+      duration: 0.4s
+      sound: pop.mp3
+    out_transition:
+      duration: 0.4s
+      sound: pop.mp3
+```
+
+##### Usage in episode
+
+ScreenKit comes with some presets where you don't need to set up anything, but 
+you can also create custom callouts.
+
+Available presets:
+
+- `blog`
+- `bsky`
+- `discord`
+- `dribbble`
+- `github`
+- `linkedin`
+- `mastodon`
+- `snap`
+- `soundcloud`
+- `spotify`
+- `tiktok`
+- `twitch`
+- `youtube`
+
+```yaml
+callouts:
+  # Using a preset
+  - type: social
+    preset: github
+    text: "@fnando"
+    starts: 1
+    duration: 5s
+
+  # Using a custom callout style
+  - type: custom_social
+    text: "@fnando"
+    starts: 1
+    duration: 5s
+
+  # Defining a custom callout inline
+  - type: social
+    text: "@fnando"
+    starts: 1
+    duration: 5s
+    background_color: "#E0D300"
+    label_style:
+      size: 24
+      color: "#00000088"
+      font_path: "open-sans/OpenSans-ExtraBold.ttf"
+    text_style:
+      size: 50
+      color: "#000000"
+      font_path: "open-sans/OpenSans-ExtraBold.ttf"
+    label: "CUSTOM"
+    icon:
+      path: "images/custom.png" # Must be a 160x160 image
+      background_color: "#000000"
+```
 
 #### Shadow Block Style
 
@@ -552,6 +654,7 @@ callouts_styles:
       color: "#ffffff"
       size: 40
       font_path: open-sans/OpenSans-ExtraBold.ttf
+      align: left # Text alignment: left, center, right
 
     # Layout
     padding: 20
@@ -719,7 +822,9 @@ tts:
 
 ### ElevenLabs Engine
 
-Professional AI voice synthesis.
+The ElevenLabs TTS engine requires an API key. Set it via the `--tts-api-key`
+option when exporting an episode. The API key must be prefixed with
+`eleven_labs:`, e.g. `eleven_labs:sk_c195c0131de...`.
 
 ```yaml
 tts:
@@ -764,21 +869,26 @@ module. Custom engines must implement the `generate` method:
 module ScreenKit
   module TTS
     class CustomEngine < Base
-      extend Shell
-
       # Optional: Define schema path for validation
       def self.schema_path
-        ScreenKit.root_dir.join("screenkit/schemas/tts/custom_engine.json")
+        File.join(__dir__, "yourschema.json")
       end
 
       # This method is required.
+      # The keyword arguments will be all the configuration options, plus
+      # api_key and segments. If you don't care about those, remember to use
+      # the `**` operator to ignore them.
       def self.available?(**)
-        command_exist?("some-command")
+        # If you're running a local command:
+        # command_exist?("some-command")
+
+        # If you're using an API key:
+        # api_key.to_s.start_with?("#{engine_name}:")
       end
 
       # This method is required.
       def generate(text:, output_path:, log_path: nil)
-        # Optional: validate options against JSON schema.
+        # Optional, but recommended: validate options against JSON schema.
         self.class.validate!(options)
 
         # If you need access to previous/next text, you can access the method
@@ -790,11 +900,19 @@ module ScreenKit
         # Write output to output_path
         # Optionally log to log_path
 
-        # Example implementation:
+        # Example calling a command (provided by ScreenKit::Shell)
         # self.class.run_command "some-command",
         #                        "-o", output_path.sub_ext(".wav"),
         #                        text,
         #                        log_path:
+
+        # Example using an API (provided by ScreenKit::HTTP)
+        # response = json_post(
+        #   url: "https://api.example.com/tts",
+        #   headers: {authorization: "Bearer #{api_key}"},
+        #   api_key:,
+        #   log_path:
+        # )
       end
     end
   end
@@ -821,6 +939,7 @@ The engine name is camelized (e.g., `custom_engine` → `CustomEngine`,
 
 - [Search Github](https://github.com/topics/screenkit-tts)
 - [Google Text to Speech](https://github.com/fnando/screenkit-tts-google)
+- [Minimax Text to Speech](https://github.com/fnando/screenkit-tts-minimax)
 
 > [!TIP]
 >
@@ -1121,26 +1240,26 @@ be processed).
 
 ### Common Issues
 
-**"Gem not found" error:**
+#### "Gem not found" error
 
 ```bash
 bundle install
 bundle exec screenkit ...
 ```
 
-**"Schema validation failed":**
+#### Schema validation failed
 
 - Check YAML syntax
 - Verify required fields are present
 - Use schema hints with `yaml-language-server`
 
-**Missing resources:**
+#### Missing resources
 
 - Check `resources_dir` configuration
 - Verify file paths are relative to resource directories
 - Use absolute paths for system resources
 
-**TTS not working:**
+#### TTS not working
 
 - For ElevenLabs: Set `--tts-api-key`
 - For macOS `say`: Verify voice name with `say -v ?`

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

@@ -5,8 +5,7 @@ module ScreenKit
     module Styles
       class FileCopy < Base
         def self.schema_path
-          ScreenKit.root_dir
-                   .join("screenkit/schemas/callout_styles/file_copy.json")
+          ScreenKit.root_dir.join("schemas/callout_styles/file_copy.json")
         end
 
         def initialize(source:, **kwargs)

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

@@ -10,8 +10,7 @@ module ScreenKit
                     :padding, :text, :width
 
         def self.schema_path
-          ScreenKit.root_dir
-                   .join("screenkit/schemas/callout_styles/inline_block.json")
+          ScreenKit.root_dir.join("schemas/callout_styles/inline_block.json")
         end
 
         def initialize(source:, **kwargs)
@@ -88,18 +87,27 @@ module ScreenKit
             image << "xc:none"
 
             line_images.each do |path, width, height|
+              offset_x = case text_style.align
+                         when "right"
+                           max_line_width - width
+                         when "center"
+                           (max_line_width - width) / 2
+                         else
+                           0
+                         end
+
               # Draw rectangle background
               image << "-fill"
               image << background_color
               image << "-draw"
-              image << "rectangle 0,#{offset_y}," \
-                       "#{width + padding_x}," \
+              image << "rectangle #{offset_x},#{offset_y}," \
+                       "#{width + padding_x + offset_x}," \
                        "#{offset_y + height + padding_y}"
 
               # Composite line text
               image << path
               image << "-geometry"
-              image << "+#{padding.top}+#{offset_y + padding.left}"
+              image << "+#{padding.left + offset_x}+#{offset_y + padding.top}"
               image << "-composite"
               offset_y += padding_y + height
             end

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

@@ -10,8 +10,7 @@ module ScreenKit
                     :title, :title_style, :width
 
         def self.schema_path
-          ScreenKit.root_dir
-                   .join("screenkit/schemas/callout_styles/shadow_block.json")
+          ScreenKit.root_dir.join("schemas/callout_styles/shadow_block.json")
         end
 
         def initialize(source:, **kwargs)

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

@@ -0,0 +1,304 @@
+# frozen_string_literal: true
+
+require "mini_magick"
+
+module ScreenKit
+  class Callout
+    module Styles
+      class Social < Base
+        attr_reader :text, :label, :icon, :label_style, :text_style,
+                    :background_color
+
+        LABEL_STYLE = {
+          color: "#ffffff88",
+          size: 24,
+          font_path: "open-sans/OpenSans-ExtraBold.ttf"
+        }.freeze
+
+        TEXT_STYLE = {
+          color: "#ffffff",
+          size: 50,
+          font_path: "open-sans/OpenSans-ExtraBold.ttf"
+        }.freeze
+
+        def self.presets
+          @presets ||= {
+            instagram: {
+              label: "INSTAGRAM",
+              icon: {
+                path: "callout_styles/social/instagram.png",
+                background_color: "#C13684"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#693050"
+            },
+
+            spotify: {
+              label: "SPOTIFY",
+              icon: {
+                path: "callout_styles/social/spotify.png",
+                background_color: "#1cd760"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#205C36"
+            },
+
+            bsky: {
+              label: "BSKY",
+              icon: {
+                path: "callout_styles/social/bsky.png",
+                background_color: "#0085FF"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#004483"
+            },
+
+            linkedin: {
+              label: "LINKEDIN",
+              icon: {
+                path: "callout_styles/social/linkedin.png",
+                background_color: "#007EBB"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#00486A"
+            },
+
+            dribbble: {
+              label: "DRIBBBLE",
+              icon: {
+                path: "callout_styles/social/dribbble.png",
+                background_color: "#EC4989"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#7A2245"
+            },
+
+            tiktok: {
+              label: "TIKTOK",
+              icon: {
+                path: "callout_styles/social/tiktok.png",
+                background_color: "#000000"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#252525"
+            },
+
+            youtube: {
+              label: "YOUTUBE",
+              icon: {
+                path: "callout_styles/social/youtube.png",
+                background_color: "#FF0000"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#7B1212"
+            },
+
+            snap: {
+              label: "SNAP",
+              icon: {
+                path: "callout_styles/social/snap.png",
+                background_color: "#FEFC05"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#51511A"
+            },
+
+            mastodon: {
+              label: "MASTODON",
+              icon: {
+                path: "callout_styles/social/mastodon.png",
+                background_color: "#3188D4"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#1F4566"
+            },
+
+            blog: {
+              label: "BLOG",
+              icon: {
+                path: "callout_styles/social/blog.png",
+                background_color: "#5831D4"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#321E6F"
+            },
+
+            twitch: {
+              label: "TWITCH",
+              icon: {
+                path: "callout_styles/social/twitch.png",
+                background_color: "#9146FF"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#461B85"
+            },
+
+            github: {
+              label: "GITHUB",
+              icon: {
+                path: "callout_styles/social/github.png",
+                background_color: "#161514"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#373737"
+            },
+
+            soundcloud: {
+              label: "SOUNDCLOUD",
+              icon: {
+                path: "callout_styles/social/soundcloud.png",
+                background_color: "#FE2401"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#6D1507"
+            },
+
+            discord: {
+              label: "DISCORD",
+              icon: {
+                path: "callout_styles/social/discord.png",
+                background_color: "#5865F2"
+              },
+              label_style: LABEL_STYLE,
+              text_style: TEXT_STYLE,
+              background_color: "#2E389D"
+            }
+          }
+        end
+
+        def self.schema_path
+          ScreenKit.root_dir.join("schemas/callout_styles/social.json")
+        end
+
+        def initialize(source:, text:, preset: nil, **kwargs)
+          @text = text
+          self.class.validate!(kwargs)
+          super
+          self.options = self.class.presets.fetch(preset.to_sym) if preset
+
+          options.each do |key, value|
+            value = case key
+                    when :label_style, :text_style
+                      TextStyle.new(source:, **hi_res(**value))
+                    else
+                      value
+                    end
+
+            instance_variable_set(:"@#{key}", value)
+          end
+        end
+
+        def as_json(*)
+          {}
+        end
+
+        def render
+          label_path, label_width, label_height = render_text_image(
+            type: "label",
+            text: label,
+            style: label_style,
+            width: 600
+          )
+
+          text_path, text_width, _ = render_text_image(
+            type: "label",
+            text:,
+            style: text_style,
+            width: 600
+          )
+
+          sizes = hi_res(
+            icon: 132,
+            padding: 20,
+            content_width: [label_width, text_width].max,
+            image_height: 172,
+            icon_radius: 30,
+            panel_radius: 40
+          )
+
+          image_width = (sizes[:icon] + (sizes[:padding] * 2)) +
+                        sizes[:padding] +
+                        (sizes[:content_width] / 2) +
+                        (sizes[:padding] * 2)
+          image_height = sizes[:image_height]
+          offset_x = sizes[:icon] + sizes[:padding]
+          offset_y = sizes[:padding]
+          icon_y = offset_y + sizes[:icon]
+
+          MiniMagick.convert do |image|
+            # Create transparent canvas
+            image << "-size"
+            image << "#{image_width}x#{image_height}"
+            image << "xc:none"
+
+            # Draw main background
+            image << "-fill"
+            image << options[:background_color]
+            image << "-draw"
+            image << "roundrectangle 0,0,#{image_width},#{image_height}," \
+                     "#{sizes[:panel_radius]},#{sizes[:panel_radius]}"
+
+            # Draw icon background
+            image << "-fill"
+            image << icon[:background_color]
+            image << "-draw"
+            image << "roundrectangle #{sizes[:padding]},#{sizes[:padding]}," \
+                     "#{offset_x},#{icon_y}," \
+                     "#{sizes[:icon_radius]},#{sizes[:icon_radius]}"
+
+            # Draw icon
+            icon_path = source.search(icon[:path])
+            icon_image = MiniMagick::Image.open(icon_path)
+            icon_x = sizes[:padding] + ((sizes[:icon] - icon_image.width) / 2)
+            icon_y = offset_y + ((sizes[:icon] - icon_image.height) / 2)
+
+            image << icon_path
+            image << "-geometry"
+            image << "+#{icon_x}+#{icon_y}"
+            image << "-composite"
+
+            offset_x += sizes[:padding]
+            offset_y += sizes[:padding] / 2
+
+            # Composite label
+            image << label_path
+            image << "-geometry"
+            image << "+#{offset_x}+#{offset_y}"
+            image << "-composite"
+
+            offset_y += label_height
+
+            # Composite text
+            image << text_path
+            image << "-geometry"
+            image << "+#{offset_x}+#{offset_y}"
+            image << "-composite"
+
+            image << "PNG:#{output_path}"
+          end
+
+          output_path
+        rescue MiniMagick::Error => error
+          retry if error.message.include?("No such file or directory")
+          raise
+        ensure
+          remove_file(label_path)
+          remove_file(text_path)
+        end
+      end
+    end
+  end
+end

data/lib/screenkit/callout/text_style.rb

@@ -3,7 +3,7 @@
 module ScreenKit
   class Callout
     class TextStyle
-      attr_reader :color, :size, :font_path
+      attr_reader :color, :size, :font_path, :align
 
       def initialize(source:, **kwargs)
         @source = source
@@ -37,7 +37,7 @@ module ScreenKit
       end
 
       def as_json(*)
-        {color:, size:, font_path:, rgb_color:, opacity:}
+        {color:, size:, font_path:, rgb_color:, opacity:, align:}
       end
     end
   end

data/lib/screenkit/callout.rb

@@ -32,7 +32,7 @@ module ScreenKit
                   :style_props, :style_class, :animation, :source, :log_path
 
     def self.schema_path
-      ScreenKit.root_dir.join("screenkit/schemas/refs/callout_style.json")
+      ScreenKit.root_dir.join("schemas/refs/callout_style.json")
     end
 
     def initialize(

data/lib/screenkit/config/base.rb

@@ -5,12 +5,17 @@ module ScreenKit
     class Base
       extend SchemaValidator
 
+      attr_reader :raw_options
+
       def self.load_file(path)
         unless File.file?(path)
           raise FileNotFoundError, "Config file not found: #{path}"
         end
 
-        config = YAML.load_file(path, symbolize_names: true)
+        template = File.read(path)
+        contents = ERB.new(template).result
+
+        config = YAML.load(contents, symbolize_names: true)
         load(config)
       end
 
@@ -21,6 +26,8 @@ module ScreenKit
       end
 
       def initialize(**kwargs)
+        @raw_options = kwargs
+
         kwargs.each do |key, value|
           value = process(key, value)
           instance_variable_set(:"@#{key}", value)

data/lib/screenkit/config/episode.rb

@@ -26,7 +26,7 @@ module ScreenKit
 
       def self.schema_path
         @schema_path ||=
-          ScreenKit.root_dir.join("screenkit/schemas/episode.json")
+          ScreenKit.root_dir.join("schemas/episode.json")
       end
 
       def initialize(**)

data/lib/screenkit/config/project.rb

@@ -32,7 +32,7 @@ module ScreenKit
 
       def self.schema_path
         @schema_path ||=
-          ScreenKit.root_dir.join("screenkit/schemas/project.json")
+          ScreenKit.root_dir.join("schemas/project.json")
       end
 
       private def process(key, value)
@@ -45,6 +45,10 @@ module ScreenKit
           value
         end
       end
+
+      def to_h
+        raw_options
+      end
     end
   end
 end

data/lib/screenkit/exporter/intro.rb

@@ -8,7 +8,7 @@ module ScreenKit
       extend SchemaValidator
 
       def self.schema_path
-        ScreenKit.root_dir.join("screenkit/schemas/refs/intro.json")
+        ScreenKit.root_dir.join("schemas/refs/intro.json")
       end
 
       # The intro scene configuration.
@@ -109,11 +109,10 @@ module ScreenKit
         # Background layer
         if background_path&.file?
           if video_file?(background_path)
-            # Ensure video is 24fps
             extname = background_path.extname
             optimized_path = background_path.sub_ext("_24fps#{extname}")
 
-            if (-0.02..0.02).cover?(fps(background_path))
+            if Video.right_fps?(background_path)
               optimized_path = background_path
             end
 

data/lib/screenkit/exporter/outro.rb

@@ -8,7 +8,7 @@ module ScreenKit
       extend SchemaValidator
 
       def self.schema_path
-        ScreenKit.root_dir.join("screenkit/schemas/refs/outro.json")
+        ScreenKit.root_dir.join("schemas/refs/outro.json")
       end
 
       # The outro scene configuration.
@@ -65,7 +65,6 @@ module ScreenKit
         cmd = [
           "ffmpeg",
           *inputs,
-          "-sws_flags", "lanczos+accurate_rnd+full_chroma_int",
           "-filter_complex", filters,
           *maps,
           "-c:v", "libx264", "-crf", "0", "-pix_fmt", "yuv444p",
@@ -95,15 +94,26 @@ module ScreenKit
         # Background layer
         if background_path&.file?
           if video_file?(background_path)
+            extname = background_path.extname
+            optimized_path = background_path.sub_ext("_24fps#{extname}")
+
+            if Video.right_fps?(background_path)
+              optimized_path = background_path
+            end
+
+            unless optimized_path.file?
+              Video.new(input_path: background_path).export(optimized_path)
+            end
+
             # Video background
-            video_duration = duration(background_path)
+            video_duration = duration(optimized_path)
 
             # Calculate how many loops we need
             loops_needed = (duration / video_duration).ceil
 
             inputs += [
               "-stream_loop", (loops_needed - 1).to_s, "-i",
-              background_path
+              optimized_path
             ]
 
             # Scale, crop, then trim to exact duration needed

data/lib/screenkit/exporter/video.rb

@@ -4,7 +4,7 @@ module ScreenKit
   module Exporter
     class Video
       include Shell
-      include Utils
+      extend Utils
 
       # The path to the input video file.
       attr_reader :input_path
@@ -17,10 +17,12 @@ module ScreenKit
         @log_path = log_path
       end
 
-      def export(output_path)
-        fps = fps(input_path)
+      def self.right_fps?(path)
+        (-0.02..0.02).cover?(24 - fps(path))
+      end
 
-        if (-0.02..0.02).cover?(24 - fps)
+      def export(output_path)
+        if self.class.right_fps?(input_path)
           FileUtils.cp(input_path, output_path)
           return
         end

data/lib/screenkit/generators/project/screenkit.yml

@@ -41,6 +41,7 @@ resources_dir:
   - "%{episode_dir}/resources/fonts"
   - resources
   - "%{episode_dir}/resources"
+  - "<%= ScreenKit.resources_dir %>"
   - ~/Library/Fonts
   - /Library/Fonts
   - /System/Library/Fonts
@@ -272,6 +273,8 @@ demotape:
 # in the video. Callouts are visual elements that highlight important
 # information. Each callout type can have its own settings for icon, background,
 # text styles, animations, and sounds.
+#
+# https://github.com/fnando/screenkit/blob/main/DOCUMENTATION.md#callouts
 callout_styles:
   shadow_block:
     # yaml-language-server: $schema=https://screenkit.dev/schemas/callout_styles/default.json
@@ -311,3 +314,16 @@ callout_styles:
     out_transition:
       duration: 0.4s
       sound: pop.mp3
+
+  social:
+    # yaml-language-server: $schema=https://screenkit.dev/schemas/callout_styles/social.json
+    style: social
+    anchor: [left, bottom]
+    margin: 100
+    animation: fade
+    in_transition:
+      duration: 0.4s
+      sound: pop.mp3
+    out_transition:
+      duration: 0.4s
+      sound: pop.mp3

data/lib/screenkit/http.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module ScreenKit
+  module HTTP
+    # Sends a POST request.
+    # @param url [String] The request URL.
+    # @param params [Hash] The request parameters.
+    # @param headers [Hash] The request headers.
+    # @param api_key [String] The API key to redact from logs.
+    # @param log_path [String, nil] The path to log the request details.
+    # @return [Aitch::Response] The response.
+    def post(url:, params:, headers:, api_key:, log_path: nil)
+      if log_path
+        File.open(log_path, "w") do |f|
+          f << JSON.pretty_generate(url:, params:, headers:)
+        end
+      end
+
+      client = Aitch::Namespace.new
+      client.configure do |config|
+        config.logger = Logger.new(log_path) if log_path
+      end
+
+      client.post(
+        url:,
+        params:,
+        options: {expect: 200},
+        headers: headers.merge(user_agent: "ScreenKit/#{ScreenKit::VERSION}")
+      )
+    ensure
+      redact_file(log_path, api_key)
+    end
+
+    # Sends a JSON POST request.
+    # @param url [String] The request URL.
+    # @param params [Hash] The request parameters.
+    # @param headers [Hash] The request headers.
+    # @param api_key [String] The API key to redact from logs.
+    # @param log_path [String, nil] The path to log the request details.
+    # @return [Aitch::Response] The response.
+    def json_post(headers:, **)
+      headers = headers.merge(content_type: "application/json")
+      post(headers:, **)
+    end
+
+    # Redacts sensitive text from a file.
+    # @param path [String] The file path.
+    # @param text [String] The text to redact.
+    # @return [void]
+    def redact_file(path, text)
+      return unless path
+      return unless File.file?(path)
+
+      content = File.read(path).gsub(text, "[REDACTED]")
+      File.write(path, content)
+    end
+  end
+end

data/lib/screenkit/schemas/callout_styles/social.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "$id": "https://screenkit.dev/schemas/callout_styles/shadow_block.json",
+  "title": "Social Callout",
+  "oneOf": [
+    {
+      "preset": {
+        "type": "string",
+        "enum": [
+          "spotify",
+          "youtube",
+          "tiktok",
+          "snap",
+          "mastodon",
+          "blog",
+          "linkedin",
+          "discord",
+          "twitch",
+          "github",
+          "soundcloud",
+          "dribbble"
+        ]
+      }
+    },
+    {
+      "type": "object",
+      "required": ["label", "icon", "label_style", "account_style"],
+      "properties": {
+        "icon": {
+          "type": "object",
+          "required": ["path", "background_color"],
+          "properties": {
+            "path": { "type": "string", "format": "uri" },
+            "background_color": { "$ref": "../refs/color.json" }
+          }
+        },
+        "background_color": {
+          "$ref": "../refs/color.json"
+        },
+        "label_style": {
+          "$ref": "../refs/text_style.json"
+        },
+        "account_style": {
+          "$ref": "../refs/text_style.json"
+        },
+        "label": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        }
+      }
+    }
+  ]
+}

data/lib/screenkit/schemas/refs/text_style.json

@@ -13,6 +13,10 @@
     },
     "color": {
       "$ref": "color.json"
+    },
+    "align": {
+      "type": "string",
+      "enum": ["left", "center", "right"]
     }
   }
 }

data/lib/screenkit/sound.rb

@@ -20,7 +20,7 @@ module ScreenKit
 
       case input
       when FalseClass, nil
-        @path = ScreenKit.root_dir.join("screenkit/resources/mute.mp3")
+        @path = ScreenKit.resources_dir.join("mute.mp3")
       when Hash
         {path: nil, volume: 1.0}.merge(input) => {path:, volume:}
         @path = Pathname(path)

data/lib/screenkit/tts/base.rb

@@ -1,12 +1,21 @@
 # frozen_string_literal: true
 
+require "json-schema"
+require "aitch"
+require "logger"
+
 module ScreenKit
   module TTS
     class Base
-      require_relative "../core_ext"
       require_relative "../schema_validator"
+      require_relative "../shell"
+      require_relative "../http"
+      require_relative "../core_ext"
+      require_relative "../version"
 
       extend SchemaValidator
+      extend Shell
+      include HTTP
 
       using CoreExt
 
@@ -33,18 +42,18 @@ module ScreenKit
         name.split("::").last.underscore
       end
 
+      def self.api_key_prefix
+        "#{engine_name}:"
+      end
+
       def initialize(id: nil, segments: nil, api_key: nil, **options)
         @segments = Array(segments)
         @options = options
         @id = id
-        @api_key = api_key
-      end
 
-      def redact_file(path, text)
-        return unless File.file?(path)
+        return unless api_key
 
-        content = File.read(path).gsub(text, "[REDACTED]")
-        File.write(path, content)
+        @api_key = api_key.delete_prefix("#{self.class.engine_name}:")
       end
     end
   end

data/lib/screenkit/tts/eleven_labs.rb

@@ -3,13 +3,15 @@
 module ScreenKit
   module TTS
     class ElevenLabs < Base
+      include HTTP
+
       def self.schema_path
         ScreenKit.root_dir
                  .join("screenkit/schemas/tts/elevenlabs.json")
       end
 
       def self.available?(api_key: nil, **)
-        api_key.to_s.empty?
+        api_key.to_s.start_with?(api_key_prefix)
       end
 
       def all_texts
@@ -19,18 +21,6 @@ module ScreenKit
       def generate(output_path:, text:, log_path: nil)
         voice_id = options[:voice_id]
 
-        if log_path
-          File.open(log_path, "w") do |f|
-            f << JSON.pretty_generate(options.merge(text:))
-          end
-        end
-
-        require "aitch"
-
-        Aitch.configure do |config|
-          config.logger = Logger.new(log_path) if log_path
-        end
-
         current_index = all_texts.index { it == text }
 
         if current_index
@@ -41,20 +31,15 @@ module ScreenKit
         params = options.merge(text:, previous_text:, next_text:)
                         .except(:voice_id)
 
-        response = Aitch.post(
+        response = json_post(
           url: "https://api.elevenlabs.io/v1/text-to-speech/#{voice_id}",
-          body: JSON.dump(params),
-          options: {expect: 200},
-          headers: {
-            "content-type": "application/json",
-            "user-agent": "ScreenKit/#{ScreenKit::VERSION}",
-            "xi-api-key": api_key
-          }
+          params:,
+          headers: {"xi-api-key": api_key},
+          api_key:,
+          log_path:
         )
 
         File.binwrite(output_path, response.body)
-      ensure
-        redact_file(log_path, api_key)
       end
     end
   end

data/lib/screenkit/tts/espeak.rb

@@ -10,7 +10,7 @@ module ScreenKit
       end
 
       def self.schema_path
-        ScreenKit.root_dir.join("screenkit/schemas/tts/espeak.json")
+        ScreenKit.root_dir.join("schemas/tts/espeak.json")
       end
 
       def generate(text:, output_path:, log_path: nil)

data/lib/screenkit/tts/say.rb

@@ -6,7 +6,7 @@ module ScreenKit
       extend Shell
 
       def self.schema_path
-        ScreenKit.root_dir.join("screenkit/schemas/tts/say.json")
+        ScreenKit.root_dir.join("schemas/tts/say.json")
       end
 
       def self.available?(**)

data/lib/screenkit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ScreenKit
-  VERSION = "0.0.7"
+  VERSION = "0.0.9"
 end

data/lib/screenkit.rb

@@ -10,6 +10,8 @@ require "tty-spinner"
 require "etc"
 require "securerandom"
 require "demo_tape/duration"
+require "aitch"
+require "erb"
 
 module ScreenKit
   require_relative "screenkit/version"
@@ -23,6 +25,7 @@ module ScreenKit
   require_relative "screenkit/watermark"
   require_relative "screenkit/spinner"
   require_relative "screenkit/shell"
+  require_relative "screenkit/http"
   require_relative "screenkit/schema_validator"
   require_relative "screenkit/generators/project"
   require_relative "screenkit/generators/episode"
@@ -65,7 +68,11 @@ module ScreenKit
   require_files.call("screenkit/tts/*.rb")
 
   def self.root_dir
-    @root_dir ||= Pathname(__dir__)
+    @root_dir ||= Pathname(__dir__).join("screenkit")
+  end
+
+  def self.resources_dir
+    @resources_dir ||= root_dir.join("resources")
   end
 
   # Raised when the configuration schema is invalid.

data/screenkit.gemspec

@@ -37,6 +37,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "aitch"
   spec.add_dependency "demotape"
+  spec.add_dependency "erb"
   spec.add_dependency "etc"
   spec.add_dependency "json-schema"
   spec.add_dependency "mini_magick"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: screenkit
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: ruby
 authors:
 - Nando Vieira
@@ -37,6 +37,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: erb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: etc
   requirement: !ruby/object:Gem::Requirement
@@ -289,6 +303,7 @@ files:
 - lib/screenkit/callout/styles/file_copy.rb
 - lib/screenkit/callout/styles/inline_block.rb
 - lib/screenkit/callout/styles/shadow_block.rb
+- lib/screenkit/callout/styles/social.rb
 - lib/screenkit/callout/text_style.rb
 - lib/screenkit/cli.rb
 - lib/screenkit/cli/base.rb
@@ -328,15 +343,31 @@ files:
 - lib/screenkit/generators/project/resources/sounds/pop.mp3
 - lib/screenkit/generators/project/resources/sounds/whoosh.mp3
 - lib/screenkit/generators/project/screenkit.yml
+- lib/screenkit/http.rb
 - lib/screenkit/logfile.rb
 - lib/screenkit/parallel_processor.rb
 - lib/screenkit/path_lookup.rb
+- lib/screenkit/resources/callout_styles/social/blog.png
+- lib/screenkit/resources/callout_styles/social/bsky.png
+- lib/screenkit/resources/callout_styles/social/discord.png
+- lib/screenkit/resources/callout_styles/social/dribbble.png
+- lib/screenkit/resources/callout_styles/social/github.png
+- lib/screenkit/resources/callout_styles/social/instagram.png
+- lib/screenkit/resources/callout_styles/social/linkedin.png
+- lib/screenkit/resources/callout_styles/social/mastodon.png
+- lib/screenkit/resources/callout_styles/social/snap.png
+- lib/screenkit/resources/callout_styles/social/soundcloud.png
+- lib/screenkit/resources/callout_styles/social/spotify.png
+- lib/screenkit/resources/callout_styles/social/tiktok.png
+- lib/screenkit/resources/callout_styles/social/twitch.png
+- lib/screenkit/resources/callout_styles/social/youtube.png
 - lib/screenkit/resources/mute.mp3
 - lib/screenkit/resources/transparent.png
 - lib/screenkit/schema_validator.rb
 - lib/screenkit/schemas/callout_styles/file_copy.json
 - lib/screenkit/schemas/callout_styles/inline_block.json
 - lib/screenkit/schemas/callout_styles/shadow_block.json
+- lib/screenkit/schemas/callout_styles/social.json
 - lib/screenkit/schemas/callouts/inline_block.json
 - lib/screenkit/schemas/callouts/shadow_block.json
 - lib/screenkit/schemas/episode.json
@@ -387,10 +418,10 @@ metadata:
   rubygems_mfa_required: 'true'
   homepage_uri: https://github.com/fnando/screenkit
   bug_tracker_uri: https://github.com/fnando/screenkit/issues
-  source_code_uri: https://github.com/fnando/screenkit/tree/v0.0.7
-  changelog_uri: https://github.com/fnando/screenkit/tree/v0.0.7/CHANGELOG.md
-  documentation_uri: https://github.com/fnando/screenkit/tree/v0.0.7/README.md
-  license_uri: https://github.com/fnando/screenkit/tree/v0.0.7/LICENSE.md
+  source_code_uri: https://github.com/fnando/screenkit/tree/v0.0.9
+  changelog_uri: https://github.com/fnando/screenkit/tree/v0.0.9/CHANGELOG.md
+  documentation_uri: https://github.com/fnando/screenkit/tree/v0.0.9/README.md
+  license_uri: https://github.com/fnando/screenkit/tree/v0.0.9/LICENSE.md
 rdoc_options: []
 require_paths:
 - lib