przn 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b33677433cd4802ee75ef9d7eb821d2dbb6faf8b1d2364d535b6aa28bffa6eb3
-  data.tar.gz: 930ecad39096eea771759134cd6c7e4a83c55a00ae98c59ead5afea1dcc46f17
+  metadata.gz: a02ff63ef48dadc49d46767f2f60e32457cd9562dffa726e6a6b3a811c3cf68d
+  data.tar.gz: 0a4c431ac13a990c06397626749de0b495e47efa3af5c3233800868b7fb56b41
 SHA512:
-  metadata.gz: 08eafdea3c2f55a29ccfd879b3bfa1541576be74fbb042cc33c527e39289e3dcf1375a10df033820e37f69e9f6726f580cd19ae468d633d73c9d65a23736674b
-  data.tar.gz: fcbf194e2a090de86a823fd8a0076977db73cf69f857cea6f4406f9fe31c2f44dab60120d61dbda7f10545e2fd750089df8e34233f0808fefd096bcec3cc25e1
+  metadata.gz: 98e45b37b5125ece026f9140dbd68225beddde0eb1eac76ad0e614b28610898580acc5a9e03a3cd36313740165216cec646e1224f80f2e951a4c82d3dde89d9d
+  data.tar.gz: eef32162b80aedbef88fafbc3834e85e12eda8db63918a762183f341f45ee694397aa39407c5887f7fb004ccbd0276cf59beded6a695a8441bcefceb3f8416ff

data/README.md

@@ -23,6 +23,23 @@ przn your_slides.md @42
 
 Out-of-range numbers are clamped to the last slide, so `@9999` jumps to the end.
 
+### Extended-display presenter mode
+
+```
+przn --present your_slides.md
+```
+
+On a setup with a secondary display (projector / external monitor) and running inside [Echoes](https://github.com/amatsuda/echoes), `--present` auto-spawns an **audience window** on the second display showing the clean current slide, while the laptop pane becomes the **presenter view**:
+
+- Current slide rendered as normal
+- Speaker notes (`{::note}` / `<note>` markup) shown in a side strip — stripped from the audience view
+- Next slide's title hint
+- Elapsed-time clock (or, when `rabbit:` is themed, the runner-bar visualization)
+
+If only one display is attached or Echoes isn't the host terminal, `--present` falls back to today's mirror mode with a one-line warning on stderr.
+
+Implementation: the two `przn` processes coordinate over a Unix socket. The presenter forwards every slide navigation as a `goto` message; the audience renders and otherwise stays silent. Notes are not transmitted to the audience side.
+
 ### PDF export
 
 Two flavors:
@@ -285,6 +302,9 @@ background:               # default slide background (Echoes OSC 7772)
   to:                     # gradient endpoint
   angle:                  # gradient angle in degrees
 
+# rabbit:                 # opt into the 🐇 / 🐢 bottom progress indicator
+#   duration: "30m"       # "1h30m", "1800s", or plain integer seconds; turtle hides when unset
+
 colors:
   code_bg: "313244"
   dim: "6c7086"
@@ -298,6 +318,7 @@ Notes:
 - **`font.family`** — applied to body text (terminal: via OSC 66 `f=`, requires Echoes; PDF: registered via fontconfig). Inline `<font face="...">` runs override it per-segment.
 - **`title`** — h1 typography. Each attribute is independent from `font`: `title.family` does **not** inherit `font.family`, `title.color` does **not** inherit `font.color`. `title.size` defaults to x-large (OSC 66 `s=4`). When `title.family` is proportional, every h1 OSC 66 sequence is emitted with `h=2` so a terminal that honors centered horizontal alignment ([Echoes](https://github.com/amatsuda/echoes)) keeps the title visually centered against its reserved cell block. h2–h6 stay body text.
 - **`background`** — the deck-wide default background. A per-slide `<bg .../>` directive overrides it for that slide. The Prawn fallback paints the PDF page in `background.color` when set; otherwise it leaves the page Prawn's default (white).
+- **`rabbit`** — opt-in Rabbit-style bottom-row progress indicator. With the key absent, przn shows the simple `N / M` counter at the bottom-right. With the key present, the bottom row becomes: current slide # at the very left, total at the very right, 🐇 running between them tracking slide progress. Set `rabbit.duration` to also show 🐢 tracking elapsed time against the goal; without a duration the turtle stays hidden. Inside [Echoes](https://github.com/amatsuda/echoes) the emojis are emitted via OSC 7772 `;multicell` with `flip=h` so they face rightward; outside Echoes they fall back to standard OSC 66 and render unflipped (left-facing).
 
 ## License
 

data/Rakefile

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rake/testtask"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
 end
 
 task default: :test

data/default_theme.yml

@@ -33,3 +33,11 @@ colors:
   code_bg: "313244"
   dim: "6c7086"
   inline_code: "a6e3a1"
+
+# Bottom-of-screen progress indicator (a nod to the Rabbit presentation tool).
+# Without this key, przn shows a simple " N / M " counter at the bottom-right.
+# To opt in: uncomment the block. The 🐇 rabbit anchors slide progress between
+# the left (current) and right (total) numbers. Set `duration:` to enable the
+# 🐢 turtle tracking elapsed time against the goal.
+# rabbit:
+#   duration:           # "30m", "1h30m", "1800s", or plain integer seconds

data/exe/przn

@@ -7,7 +7,7 @@ require 'optparse'
 
 options = {}
 OptionParser.new do |opts|
-  opts.banner = "Usage: przn [options] <presentation.md>"
+  opts.banner = 'Usage: przn [options] <presentation.md>'
   opts.on('--export [FORMAT]', 'Export to a format (pdf | prawn; default: pdf)') { |v|
     if v && v.end_with?('.md')
       ARGV.unshift(v)
@@ -19,12 +19,15 @@ OptionParser.new do |opts|
   opts.on('-o', '--output FILE', 'Output file path for export') { |v| options[:output] = v }
   opts.on('--theme FILE', 'Theme file (YAML)') { |v| options[:theme] = v }
   opts.on('--generate-theme', 'Generate theme.yml in current directory') { options[:generate_theme] = true }
+  opts.on('--present', 'Open the deck in presenter mode (auto-spawns an audience window on the secondary display)') { options[:present] = true }
+  opts.on('--audience', 'Run as the audience receiver (spawned by --present; expects --socket)') { options[:audience] = true }
+  opts.on('--socket PATH', 'Unix socket path used by --present/--audience to coordinate') { |v| options[:socket] = v }
 end.parse!
 
 if options[:generate_theme]
   content = File.read(Przn::Theme::DEFAULT_PATH).sub(/\A(#[^\n]*\n)+\n/, '')
   File.write('theme.yml', content)
-  puts "Generated: theme.yml"
+  puts 'Generated: theme.yml'
   exit
 end
 
@@ -38,7 +41,7 @@ end
 
 file = ARGV[0]
 unless file
-  $stderr.puts "Usage: przn [options] <presentation.md> [@N]"
+  $stderr.puts 'Usage: przn [options] <presentation.md> [@N]'
   exit 1
 end
 
@@ -50,11 +53,25 @@ end
 
 case options[:export]
 when 'pdf'
+  require_relative '../lib/przn/screenshot_pdf_exporter'
+
   output = options[:output] || File.basename(file, File.extname(file)) + '.pdf'
   Przn.export_pdf(file, output, theme: theme)
 when 'prawn'
+  require_relative '../lib/przn/prawn_pdf_exporter'
+
   output = options[:output] || File.basename(file, File.extname(file)) + '.pdf'
   Przn.export_pdf_prawn(file, output, theme: theme)
 else
-  Przn.start(file, theme: theme, start_at: start_at).run
+  if options[:audience]
+    unless options[:socket]
+      $stderr.puts 'przn: --audience requires --socket PATH'
+      exit 1
+    end
+    Przn.audience(file, socket: options[:socket], theme: theme)
+  elsif options[:present]
+    Przn.present(file, theme: theme, theme_path: options[:theme]).run
+  else
+    Przn.start(file, theme: theme, start_at: start_at).run
+  end
 end

data/lib/przn/audience_link.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'socket'
+
+module Przn
+  # Tiny line-delimited JSON protocol over a Unix-domain socket, joining the
+  # presenter and audience `przn` processes in extended-display mode.
+  #
+  # Messages currently exchanged:
+  #   {"type": "ready"}                  audience -> presenter
+  #   {"type": "goto", "index": N}       presenter -> audience
+  #   {"type": "quit"}                   presenter -> audience
+  module AudienceLink
+    module_function
+
+    # Audience-side: open a UNIXServer at `path`, wait for the presenter to
+    # connect, then yield each decoded message until EOF or {"type":"quit"}.
+    # The socket file is unlinked on exit.
+    def serve(path)
+      File.unlink(path) if File.exist?(path)
+      server = UNIXServer.new(path)
+      client = server.accept
+      send(client, {type: "ready"})
+      while (line = client.gets)
+        msg = JSON.parse(line.chomp, symbolize_names: true)
+        break if msg[:type] == "quit"
+        yield msg
+      end
+    rescue Errno::EPIPE, EOFError, IOError
+      # Presenter went away; let the caller exit cleanly.
+    ensure
+      client&.close
+      server&.close
+      File.unlink(path) if path && File.exist?(path)
+    end
+
+    # Presenter-side: connect to an audience socket at `path` and return a
+    # client object that responds to `#send` and `#close`. Caller drives the
+    # protocol from the controller.
+    def connect(path)
+      UNIXSocket.new(path)
+    end
+
+    def send(io, msg)
+      io.puts(JSON.generate(msg))
+    rescue Errno::EPIPE, IOError
+      # Other side hung up — caller decides whether to keep going.
+    end
+  end
+end

data/lib/przn/controller.rb

@@ -2,14 +2,16 @@
 
 module Przn
   class Controller
-    def initialize(presentation, terminal, renderer)
+    def initialize(presentation, terminal, renderer, audience_link: nil)
       @presentation = presentation
       @terminal = terminal
       @renderer = renderer
+      @audience_link = audience_link
       @preload_gen = 0
     end
 
     def run
+      @started_at = Time.now
       @terminal.enter_alt_screen
       @terminal.hide_cursor
       render_current
@@ -37,6 +39,10 @@ module Przn
     ensure
       @preload_gen += 1
       @preload_thread&.join
+      if @audience_link
+        AudienceLink.send(@audience_link, type: "quit")
+        @audience_link.close
+      end
       @terminal.write "\e]7772;bg-clear\a"
       @terminal.show_cursor
       @terminal.leave_alt_screen
@@ -48,8 +54,15 @@ module Przn
       @renderer.render(
         @presentation.current_slide,
         current: @presentation.current,
-        total: @presentation.total
+        total: @presentation.total,
+        started_at: @started_at
       )
+      if @audience_link
+        AudienceLink.send(@audience_link,
+                          type: "goto",
+                          index: @presentation.current,
+                          started_at: @started_at.to_f)
+      end
       schedule_preload
     end
 

data/lib/przn/echoes_client.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require 'io/console'
+require 'json'
+require 'timeout'
+
+module Przn
+  # Thin wrappers around Echoes-specific OSC 7772 commands the presenter uses
+  # to set up extended-display mode. Other terminals ignore OSC 7772, so each
+  # method silently fails (returns nil / false) when not running inside Echoes.
+  module EchoesClient
+    OSC = "\e]7772"
+    BEL = "\a"
+    REPLY_TIMEOUT_S = 0.5
+
+    module_function
+
+    # Ask Echoes how many displays are attached and a tiny descriptor for each.
+    # Returns an Array of Hashes like [{index: 0, w: 1920, h: 1080}, ...] or
+    # nil when no reply arrives within the timeout (non-Echoes terminal, or
+    # an Echoes that doesn't speak this command yet).
+    def display_info(io_in: $stdin, io_out: $stdout)
+      io_out.write("#{OSC};display-info#{BEL}")
+      io_out.flush if io_out.respond_to?(:flush)
+      reply = read_osc_reply(io_in)
+      return nil unless reply
+      JSON.parse(reply, symbolize_names: true)
+    rescue JSON::ParserError
+      nil
+    end
+
+    # Open a new Echoes window on the given display, running `argv` (an
+    # Array of strings — argv[0] is the executable). `fullscreen:` is a hint.
+    # Returns true if the request was emitted; nothing in the protocol confirms
+    # success synchronously.
+    def open_window(display:, argv:, fullscreen: true, io_out: $stdout)
+      # `pack('m0')` is strict (no-newline) base64 — same as
+      # Base64.strict_encode64 but without pulling in the base64 stdlib,
+      # which is no longer a default gem in Ruby 3.4+.
+      payload = [JSON.generate(argv)].pack('m0')
+      args = "display=#{display}:program=#{payload}:fullscreen=#{fullscreen ? 'yes' : 'no'}"
+      io_out.write("#{OSC};open-window;#{args}#{BEL}")
+      io_out.flush if io_out.respond_to?(:flush)
+      true
+    end
+
+    # Read an OSC reply up to ST or BEL. Returns the payload string or nil on
+    # timeout. Echoes replies follow the same `\e]7772;...\a` shape it accepts.
+    #
+    # Stdin defaults to canonical (line-buffered) mode in a shell context, so
+    # `getc` would block waiting for a newline that an OSC reply never sends.
+    # Put the input in raw mode for the duration of the read; IO#raw saves and
+    # restores termios automatically.
+    def read_osc_reply(io_in)
+      if io_in.respond_to?(:raw) && io_in.respond_to?(:tty?) && io_in.tty?
+        io_in.raw { read_osc_reply_inner(io_in) }
+      else
+        read_osc_reply_inner(io_in)
+      end
+    end
+
+    def read_osc_reply_inner(io_in)
+      Timeout.timeout(REPLY_TIMEOUT_S) do
+        buf = +""
+        loop do
+          c = io_in.getc
+          return nil if c.nil?
+          break if c == BEL
+          if c == "\e"
+            nxt = io_in.getc
+            break if nxt == "\\"
+            buf << c << nxt
+          else
+            buf << c
+          end
+        end
+        buf.sub(/\A\e?\]?7772;[\w-]+;/, '')
+      end
+    rescue Timeout::Error
+      nil
+    end
+  end
+end

data/lib/przn/image_util.rb

@@ -42,14 +42,14 @@ module Przn
         # GIF
         f.seek(0)
         sig = f.read(6)
-        if sig&.start_with?("GIF8")
+        if sig&.start_with?('GIF8')
           w = f.read(2)&.unpack1('v')
           h = f.read(2)&.unpack1('v')
           return [w, h] if w && h
         end
       end
       nil
-    rescue
+    rescue StandardError
       nil
     end
 
@@ -62,7 +62,9 @@ module Przn
     end
 
     def kitty_terminal?
-      ENV['TERM'] == 'xterm-kitty' || ENV['TERM_PROGRAM'] == 'kitty'
+      ENV['TERM'] == 'xterm-kitty' ||
+        ENV['TERM_PROGRAM'] == 'kitty' ||
+        ENV['TERM_PROGRAM'] == 'Echoes'
     end
 
     PNG_MAGIC = "\x89PNG\r\n\x1a\n".b.freeze

data/lib/przn/kitty_text.rb

@@ -5,19 +5,38 @@ module Przn
     HEADING_SCALES = {
       1 => 4,
       2 => 3,
-      3 => 2,
+      3 => 2
     }.freeze
 
     module_function
 
-    def sized(text, s:, h: nil, v: nil, n: nil, d: nil, f: nil)
+    # Emit sized multicell text. The `s/w/n/d/v/h` params are standard kitty
+    # OSC 66 (portable). The `f=` (font family) and `flip=` params are
+    # Echoes-only extensions — when one of them is set AND we're running
+    # inside Echoes, they ride on the private OSC 7772 ;multicell frame so
+    # that strict kitty terminals never see unknown params on OSC 66.
+    # Otherwise the extensions are silently dropped and we emit plain OSC
+    # 66, which renders without the flip / custom font on any kitty-
+    # compatible terminal (better than emitting an OSC 7772 frame the
+    # terminal would ignore entirely).
+    def sized(text, s:, h: nil, v: nil, n: nil, d: nil, f: nil, flip: nil)
       params = +"s=#{s}"
       params << ":n=#{n}" if n
       params << ":d=#{d}" if d
       params << ":h=#{h}" if h
       params << ":v=#{v}" if v
-      params << ":f=#{f}" if f
-      "\e]66;#{params};#{text}\a"
+
+      if (f || flip) && echoes?
+        params << ":f=#{f}" if f
+        params << ":flip=#{flip}" if flip
+        "\e]7772;multicell;#{params};#{text}\a"
+      else
+        "\e]66;#{params};#{text}\a"
+      end
+    end
+
+    def echoes?
+      ENV['TERM_PROGRAM'] == 'Echoes'
     end
 
     def heading(text, level:)

data/lib/przn/parser.rb

@@ -14,7 +14,7 @@ module Przn
       'xx-large' => 5,
       'xxx-large' => 6,
       'xxxx-large' => 7,
-      '1' => 1, '2' => 2, '3' => 3, '4' => 4, '5' => 5, '6' => 6, '7' => 7,
+      '1' => 1, '2' => 2, '3' => 3, '4' => 4, '5' => 5, '6' => 6, '7' => 7
     }.freeze
 
     NAMED_COLORS = {
@@ -22,7 +22,7 @@ module Przn
       'magenta' => 35, 'cyan' => 36, 'white' => 37,
       'bright_red' => 91, 'bright_green' => 92, 'bright_yellow' => 93,
       'bright_blue' => 94, 'bright_magenta' => 95, 'bright_cyan' => 96,
-      'bright_white' => 97,
+      'bright_white' => 97
     }.freeze
 
     module_function
@@ -35,7 +35,7 @@ module Przn
     # Split on h1 headings (Rabbit-compatible)
     def split_slides(markdown)
       chunks = []
-      current = +""
+      current = +''
       in_fence = false
 
       markdown.each_line do |line|
@@ -155,7 +155,7 @@ module Przn
               items << {text: Regexp.last_match(2), depth: depth}
             elsif lines[i].match(/\A {2,}(\S.*)/)
               # Continuation line
-              items.last[:text] << " " << Regexp.last_match(1) if items.last
+              items.last[:text] << ' ' << Regexp.last_match(1) if items.last
             else
               break
             end
@@ -189,7 +189,7 @@ module Przn
             attr_str = rest.sub(/\A\{:?\s*/, '')
             while !attr_str.include?('}') && (i + 1) < lines.size
               i += 1
-              attr_str << " " << lines[i].strip
+              attr_str << ' ' << lines[i].strip
             end
             attr_str = attr_str.sub(/\}\s*\z/, '')
             parse_image_attrs(attr_str, attrs)
@@ -283,14 +283,14 @@ module Przn
           segments << [:note, scanner[1]]
         elsif scanner.scan(/<note>(.*?)<\/note>/)
           segments << [:note, scanner[1]]
-        elsif scanner.scan(/\{::wait\/\}/) || scanner.scan(/<wait\s*\/>/)
+        elsif scanner.scan('{::wait/}') || scanner.scan(/<wait\s*\/>/)
           # skip wait markers in inline text
-        elsif scanner.scan(/&lt;/)
-          segments << [:text, "<"]
-        elsif scanner.scan(/&gt;/)
-          segments << [:text, ">"]
-        elsif scanner.scan(/&amp;/)
-          segments << [:text, "&"]
+        elsif scanner.scan('&lt;')
+          segments << [:text, '<']
+        elsif scanner.scan('&gt;')
+          segments << [:text, '>']
+        elsif scanner.scan('&amp;')
+          segments << [:text, '&']
         elsif scanner.scan(/`([^`]+)`/)
           segments << [:code, scanner[1]]
         elsif scanner.scan(/\*\*(.+?)\*\*/)

data/lib/przn/{pdf_exporter.rb → prawn_pdf_exporter.rb}

@@ -24,7 +24,7 @@ module PrawnCJKLineWrap
       "[#{CJK_CHARS}]",
       "[#{ews}]+",
       "#{ehy}+[^#{ebc}]*",
-      eshy.to_s,
+      eshy.to_s
     ]
 
     Regexp.new(patterns.join('|'))
@@ -32,13 +32,25 @@ module PrawnCJKLineWrap
 end
 
 module Przn
-  class PdfExporter
+  # Legacy PDF export via Prawn — renders the deck directly into a vector
+  # PDF without touching the terminal. Diverges from what's on screen for
+  # any feature the live renderer adds (OSC 66 sized text, OSC 7772
+  # backgrounds, proportional fonts) but works headlessly.
+  def self.export_pdf_prawn(file, output, theme: nil)
+    markdown = File.read(file)
+    presentation = Parser.parse(markdown)
+    base_dir = File.dirname(File.expand_path(file))
+    PrawnPdfExporter.new(presentation, base_dir: base_dir, theme: theme).export(output)
+    puts "Generated: #{output}"
+  end
+
+  class PrawnPdfExporter
     PAGE_WIDTH  = 960
     PAGE_HEIGHT = 540
     DEFAULT_FONT_SIZE = 18
     DEFAULT_SCALE_TO_PT = {
       1 => 10, 2 => 18, 3 => 24, 4 => 32,
-      5 => 40, 6 => 48, 7 => 56,
+      5 => 40, 6 => 48, 7 => 56
     }.freeze
 
     DEFAULT_SCALE = Renderer::DEFAULT_SCALE
@@ -48,7 +60,7 @@ module Przn
       'magenta' => 'FF79C6', 'cyan' => '8BE9FD', 'white' => 'F8F8F2',
       'bright_red' => 'FF6E6E', 'bright_green' => '69FF94', 'bright_yellow' => 'FFFFA5',
       'bright_blue' => 'D6ACFF', 'bright_magenta' => 'FF92DF', 'bright_cyan' => 'A4FFFF',
-      'bright_white' => 'FFFFFF',
+      'bright_white' => 'FFFFFF'
     }.freeze
 
     def initialize(presentation, base_dir: '.', theme: nil)
@@ -56,7 +68,7 @@ module Przn
       @base_dir = base_dir
       @theme = theme || Theme.default
       @bg_color = @theme.background && @theme.background[:color]
-      @fg_color = @theme.font[:color] || "000000"
+      @fg_color = @theme.font[:color] || '000000'
       @code_bg = @theme.colors[:code_bg]
       @dim_color = @theme.colors[:dim]
       @inline_code_color = @theme.colors[:inline_code]
@@ -73,7 +85,7 @@ module Przn
       -> { Dir.glob('/usr/share/fonts/**/NotoSansJP-Regular.ttf').first },
       -> { File.join(Dir.home, 'Library/Fonts/HackGen-Regular.ttf') },
       -> { '/Library/Fonts/Arial Unicode.ttf' },
-      -> { '/System/Library/Fonts/Supplemental/Arial Unicode.ttf' },
+      -> { '/System/Library/Fonts/Supplemental/Arial Unicode.ttf' }
     ].freeze
 
     FALLBACK_FONT_FAMILIES = %w[NotoSansCJK NotoSansJP HackGen].freeze
@@ -84,7 +96,7 @@ module Przn
 
       pdf = Prawn::Document.new(
         page_size: [PAGE_WIDTH, PAGE_HEIGHT],
-        margin: 0,
+        margin: 0
       )
 
       register_fonts(pdf)
@@ -108,7 +120,7 @@ module Przn
           'CJK' => {
             normal: {file: font_path, font: 0},
             bold:   {file: font_path.sub('W3', 'W6').then { |p| File.exist?(p) ? p : font_path }, font: 0},
-            italic: {file: font_path, font: 0},
+            italic: {file: font_path, font: 0}
           }
         )
       else
@@ -117,7 +129,7 @@ module Przn
           'CJK' => {
             normal: font_path,
             bold:   bold_path,
-            italic: font_path,
+            italic: font_path
           }
         )
       end
@@ -144,10 +156,10 @@ module Przn
         pdf.font_families.update(family => {
           normal: path,
           bold: bold_path,
-          italic: path,
+          italic: path
         })
         @registered_inline_fonts[family] = true
-      rescue
+      rescue StandardError
         next
       end
     end
@@ -218,7 +230,7 @@ module Przn
         'Emoji' => { normal: emoji_path, bold: emoji_path, italic: emoji_path }
       )
       pdf.fallback_fonts = ['Emoji']
-    rescue
+    rescue StandardError
       nil
     end
 
@@ -231,7 +243,7 @@ module Przn
         # Only use fonts with glyf outlines (not SBIX/COLR bitmap-only fonts)
         ttf = TTFunk::File.open(path)
         return path if ttf.directory.tables.key?('glyf')
-      rescue
+      rescue StandardError
         next
       end
       nil
@@ -609,7 +621,7 @@ module Przn
     end
 
     def bullet
-      @font_registered ? @theme.bullet[:text] : "-"
+      @font_registered ? @theme.bullet[:text] : '-'
     end
 
   end

data/lib/przn/presenter_renderer.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Przn
+  # Drives the laptop-side view in extended-display mode. Reuses the existing
+  # Renderer to draw the current slide (notes still rendered dim-inline so the
+  # presenter sees them in context), then overlays a three-line strip at the
+  # bottom of the terminal: speaker notes summary, next-slide preview, and a
+  # footer with the slide counter + elapsed time.
+  class PresenterRenderer < Renderer
+    def initialize(terminal, presentation:, base_dir: '.', theme: nil)
+      super(terminal, base_dir: base_dir, theme: theme, mode: :presenter)
+      @presentation = presentation
+      @started_at = Time.now
+    end
+
+    def render(slide, current:, total:, started_at: nil)
+      super(slide, current: current, total: total, started_at: started_at)
+      @mutex.synchronize { draw_presenter_strip(current, total) }
+    end
+
+    private
+
+    def draw_presenter_strip(current, total)
+      w = @terminal.width
+      h = @terminal.height
+      slide = @presentation.slides[current]
+      notes_text = slide.notes.join(' / ')
+      next_title = current + 1 < total ? preview_title(@presentation.slides[current + 1]) : nil
+      elapsed = format_elapsed(Time.now - @started_at)
+      footer = "Slide #{current + 1} / #{total}   #{elapsed}"
+
+      # When the theme opts into the rabbit/turtle indicator, the parent
+      # renderer has already drawn it on rows h-1 and h. Lift the strip up
+      # so it doesn't clobber the runner bar; the indicator itself replaces
+      # the strip's own footer line (slide #, elapsed time are visible there
+      # anyway via rabbit position and turtle position).
+      rabbit_mode = !@theme.rabbit.nil?
+      notes_row = rabbit_mode ? h - 3 : h - 2
+      next_row  = rabbit_mode ? h - 2 : h - 1
+
+      @terminal.move_to(notes_row, 1)
+      @terminal.write "#{ANSI[:dim]}Notes: #{truncate_to_width(notes_text, [w - 8, 1].max)}#{ANSI[:reset]}"
+      @terminal.move_to(next_row, 1)
+      @terminal.write "#{ANSI[:dim]}Next:  #{truncate_to_width(next_title || '—', [w - 8, 1].max)}#{ANSI[:reset]}"
+
+      unless rabbit_mode
+        @terminal.move_to(h, 1)
+        @terminal.write "#{ANSI[:dim]}#{truncate_to_width(footer, w)}#{ANSI[:reset]}"
+      end
+
+      @terminal.flush
+    end
+
+    def preview_title(slide)
+      return nil unless slide
+      slide.blocks.each do |b|
+        case b[:type]
+        when :heading, :paragraph then return strip_markup(b[:content].to_s)
+        end
+      end
+      nil
+    end
+
+    def format_elapsed(seconds)
+      h = (seconds / 3600).to_i
+      m = ((seconds % 3600) / 60).to_i
+      s = (seconds % 60).to_i
+      format('%02d:%02d:%02d', h, m, s)
+    end
+  end
+end

data/lib/przn/renderer.rb

@@ -10,21 +10,35 @@ module Przn
       dim:           "\e[2m",
       cyan:          "\e[36m",
       gray_bg:       "\e[48;5;236m",
-      reset:         "\e[0m",
+      reset:         "\e[0m"
     }.freeze
 
     DEFAULT_SCALE = 2
 
-    def initialize(terminal, base_dir: '.', theme: nil)
+    # Default `relative_height` (as a percent of terminal height) applied to
+    # image blocks that don't carry an explicit one. Caps how much of the
+    # screen a single image can occupy; the rest leaves predictable margin
+    # for the slide footer and avoids placement-clearing edge cases in some
+    # terminals when an image lands right against the bottom row.
+    DEFAULT_IMAGE_RELATIVE_HEIGHT_PERCENT = 70
+
+    # `mode:` controls whether `{::note}` / `<note>` segments are rendered:
+    #   :solo      — dim-inline (today's behavior), default for stand-alone runs.
+    #   :audience  — stripped from output; the projector view never shows notes.
+    #   :presenter — dim-inline (so the presenter sees them in context) and
+    #                ALSO aggregated separately for the side panel via
+    #                Slide#notes; this renderer just keeps the inline copy.
+    def initialize(terminal, base_dir: '.', theme: nil, mode: :solo)
       @terminal = terminal
       @base_dir = base_dir
       @theme = theme || Theme.default
+      @mode = mode
       @image_cache = {}
       @kitty_uploads = {}
       @mutex = Mutex.new
     end
 
-    def render(slide, current:, total:)
+    def render(slide, current:, total:, started_at: nil)
       @mutex.synchronize do
         @terminal.clear
         apply_slide_background(slide)
@@ -49,9 +63,13 @@ module Przn
           end
         end
 
-        status = " #{current + 1} / #{total} "
-        @terminal.move_to(h, w - status.size)
-        @terminal.write "#{ANSI[:dim]}#{status}#{ANSI[:reset]}"
+        if @theme.rabbit
+          draw_runner_bar(h, w, current, total, started_at)
+        else
+          status = " #{current + 1} / #{total} "
+          @terminal.move_to(h, w - status.size)
+          @terminal.write "#{ANSI[:dim]}#{status}#{ANSI[:reset]}"
+        end
 
         @terminal.flush
       end
@@ -119,6 +137,60 @@ module Przn
       @terminal.write "\e]7772;bg-gradient;type=#{type}:angle=#{angle}:colors=#{colors.join(',')}\a"
     end
 
+    # Bottom-row progress indicator (Rabbit-style):
+    #
+    #   1                   🐢                🐇                   9
+    #   └ current slide #   └ elapsed time    └ slide progress     └ goal (total slides)
+    #
+    # The anchor numbers (current at the left, total at the right) sit on the
+    # very bottom row; the emojis render at OSC 66 scale 2 and are anchored at
+    # row `h-1` so their bottom half lands on row `h` next to the numbers,
+    # making them visibly twice as large as the labels without needing more
+    # vertical screen real-estate. The turtle is hidden when
+    # `theme.rabbit.duration` is unset / unparseable. `flip=h` mirrors each
+    # glyph horizontally on terminals that honor it (Echoes); others ignore
+    # the parameter and the emojis face left.
+    EMOJI_RUNNER_CELLS = 4 # 🐇/🐢 are 2 source cells wide, rendered at s=2 → 4 cells
+
+    def draw_runner_bar(h, w, current, total, started_at)
+      left  = (current + 1).to_s
+      right = total.to_s
+      track_left  = left.size + 2          # 1 cell gap after the left number
+      track_right = w - right.size - 1     # 1 cell gap before the right number
+      return if track_right - track_left < EMOJI_RUNNER_CELLS
+
+      @terminal.move_to(h, 1)
+      @terminal.write "#{ANSI[:dim]}#{left}#{ANSI[:reset]}"
+      @terminal.move_to(h, w - right.size + 1)
+      @terminal.write "#{ANSI[:dim]}#{right}#{ANSI[:reset]}"
+
+      rabbit_row = [h - 1, 1].max
+      rabbit_col = runner_col(current, [total - 1, 1].max, track_left, track_right)
+      @terminal.move_to(rabbit_row, rabbit_col)
+      @terminal.write KittyText.sized('🐇', s: 2, flip: 'h')
+
+      duration_s = Theme.parse_duration(@theme.rabbit[:duration])
+      return unless started_at && duration_s && duration_s.positive?
+
+      elapsed = Time.now - started_at
+      frac = (elapsed / duration_s).clamp(0.0, 1.0)
+      span = (track_right - (EMOJI_RUNNER_CELLS - 1)) - track_left
+      turtle_col = track_left + (frac * [span, 0].max).round
+      @terminal.move_to(rabbit_row, turtle_col)
+      @terminal.write KittyText.sized('🐢', s: 2, flip: 'h')
+    end
+
+    # Linear-interpolate a runner's column inside the track. `step` is 0..max
+    # (e.g. current slide index 0..total-1), and the returned column leaves
+    # enough room for an emoji `EMOJI_RUNNER_CELLS` cells wide before the
+    # right-anchor number.
+    def runner_col(step, max, track_left, track_right)
+      return track_left if max <= 0
+      span = (track_right - (EMOJI_RUNNER_CELLS - 1)) - track_left
+      span = 0 if span < 0
+      track_left + (step.to_f / max * span).round
+    end
+
     def render_heading(block, width, row)
       text = block[:content]
 
@@ -152,7 +224,7 @@ module Przn
           if li == 0
             @terminal.write "#{render_bullet(prefix)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           else
-            @terminal.write "#{KittyText.sized(" " * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
+            @terminal.write "#{KittyText.sized(' ' * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           end
           row += DEFAULT_SCALE
         end
@@ -206,7 +278,7 @@ module Przn
       left = content_left(width)
       block[:items].each do |item|
         depth = item[:depth] || 0
-        indent = "  " * depth
+        indent = '  ' * depth
         prefix = "#{indent}#{@theme.bullet[:text]}"
         prefix_w = display_width(prefix)
         max_w = max_text_width(width, left, DEFAULT_SCALE) - prefix_w
@@ -219,7 +291,7 @@ module Przn
           if li == 0
             @terminal.write "#{render_bullet(prefix)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           else
-            @terminal.write "#{KittyText.sized(" " * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
+            @terminal.write "#{KittyText.sized(' ' * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           end
           row += DEFAULT_SCALE
         end
@@ -232,7 +304,7 @@ module Przn
       left = content_left(width)
       block[:items].each_with_index do |item, i|
         depth = item[:depth] || 0
-        indent = "  " * depth
+        indent = '  ' * depth
         prefix = "#{indent}#{i + 1}. "
         prefix_w = display_width(prefix)
         max_w = max_text_width(width, left, DEFAULT_SCALE) - prefix_w
@@ -245,7 +317,7 @@ module Przn
           if li == 0
             @terminal.write "#{KittyText.sized(prefix, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           else
-            @terminal.write "#{KittyText.sized(" " * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
+            @terminal.write "#{KittyText.sized(' ' * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           end
           row += DEFAULT_SCALE
         end
@@ -281,7 +353,7 @@ module Przn
 
     def render_blockquote(block, width, row)
       left = content_left(width)
-      prefix = "| "
+      prefix = '| '
       prefix_w = display_width(prefix)
       max_w = max_text_width(width, left + 1, DEFAULT_SCALE) - prefix_w
 
@@ -292,7 +364,7 @@ module Przn
 
         wrapped.each_with_index do |line_segs, li|
           @terminal.move_to(row, left + 1)
-          p = li == 0 ? prefix : " " * prefix_w
+          p = li == 0 ? prefix : ' ' * prefix_w
           @terminal.write "#{ANSI[:dim]}#{KittyText.sized(p, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}#{ANSI[:reset]}"
           row += DEFAULT_SCALE
         end
@@ -316,7 +388,7 @@ module Przn
         @terminal.move_to(row, left)
         line = cells.each_with_index.map { |cell, ci|
           pad_to_width(cell, col_widths[ci] || 0)
-        }.join("  |  ")
+        }.join('  |  ')
         if ri == 0
           @terminal.write "#{ANSI[:bold]}#{KittyText.sized(line, s: DEFAULT_SCALE)}#{ANSI[:reset]}"
         else
@@ -326,7 +398,7 @@ module Przn
 
         if ri == 0
           @terminal.move_to(row, left)
-          @terminal.write KittyText.sized(col_widths.map { |w| "-" * w }.join("--+--"), s: DEFAULT_SCALE)
+          @terminal.write KittyText.sized(col_widths.map { |w| '-' * w }.join('--+--'), s: DEFAULT_SCALE)
           row += DEFAULT_SCALE
         end
       end
@@ -347,10 +419,16 @@ module Przn
       left = content_left(width)
       available_cols = width - left * 2
 
-      if (rh = block[:attrs]['relative_height'])
-        target_rows = (@terminal.height * rh.to_i / 100.0).to_i
-        available_rows = [target_rows, available_rows].min
-      end
+      # Cap the default vertical area to 70 % of the screen, matching what
+      # `{:relative_height="70"}` would do explicitly. Large images that
+      # extend to within a couple of rows of the screen edge render
+      # unreliably in some terminals — they're known-good at 70 %, and
+      # smaller images sit well within this cap so they're unaffected.
+      # An explicit `relative_height` still overrides.
+      default_rh = DEFAULT_IMAGE_RELATIVE_HEIGHT_PERCENT
+      rh = block[:attrs]['relative_height'] || default_rh
+      target_rows = (@terminal.height * rh.to_i / 100.0).to_i
+      available_rows = [target_rows, available_rows].min
 
       # Calculate target cell size maintaining aspect ratio
       img_cell_w = img_w.to_f / cell_w
@@ -504,7 +582,7 @@ module Przn
       f = default_face == :body ? @theme.font[:family] : default_face
       h = default_h
       c = default_color == :body ? @theme.font[:color] : default_color
-      body_open = c ? color_code(c) : ""
+      body_open = c ? color_code(c) : ''
       inner = segments.map { |segment|
         type = segment[0]
         content = segment[1]
@@ -519,7 +597,7 @@ module Przn
             KittyText.sized(content, s: para_scale, f: f, h: h)
           end
         when :font          then "#{render_font_segment(content, segment[2] || {}, para_scale, default_face: f, default_h: h)}#{(segment[2] || {})[:color] ? body_open : ''}"
-        when :note          then "#{ANSI[:dim]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
+        when :note          then @mode == :audience ? "" : "#{ANSI[:dim]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :bold          then "#{ANSI[:bold]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :italic        then "#{ANSI[:italic]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :strikethrough then "#{ANSI[:strikethrough]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
@@ -545,7 +623,7 @@ module Przn
       used = 0
 
       segments.each do |seg|
-        content = seg[1] || ""
+        content = seg[1] || ''
         next if content.empty?
 
         seg_scale = effective_seg_scale(seg, para_scale)
@@ -594,7 +672,7 @@ module Przn
 
     def segments_visible_cells(segments, para_scale)
       segments.sum { |seg|
-        content = seg[1] || ""
+        content = seg[1] || ''
         display_width(content) * effective_seg_scale(seg, para_scale)
       }
     end
@@ -636,7 +714,7 @@ module Przn
 
     def pad_to_width(text, target_width)
       current = display_width(text)
-      text + " " * [target_width - current, 0].max
+      text + ' ' * [target_width - current, 0].max
     end
 
     def max_inline_scale(text)
@@ -669,7 +747,7 @@ module Przn
         r, g, b = color.scan(/../).map { |h| h.to_i(16) }
         "\e[38;2;#{r};#{g};#{b}m"
       else
-        ""
+        ''
       end
     end
 
@@ -706,12 +784,12 @@ module Przn
       text
         .gsub(/\{::tag\s+name="[^"]+"\}(.*?)\{:\/tag\}/, '\1')
         .gsub(/\{::note\}(.*?)\{:\/note\}/, '\1')
-        .gsub(/\{::wait\/\}/, '')
+        .gsub('{::wait/}', '')
         .gsub(/\*\*(.+?)\*\*/, '\1')
         .gsub(/\*(.+?)\*/, '\1')
         .gsub(/~~(.+?)~~/, '\1')
         .gsub(/`([^`]+)`/, '\1')
-        .gsub(/&(lt|gt|amp);/) { |_| {"lt" => "<", "gt" => ">", "amp" => "&"}[$1] }
+        .gsub(/&(lt|gt|amp);/) { |_| {'lt' => '<', 'gt' => '>', 'amp' => '&'}[$1] }
     end
 
     def calculate_height(blocks, width)

data/lib/przn/screenshot_pdf_exporter.rb

@@ -4,6 +4,20 @@ require 'tmpdir'
 require 'fileutils'
 
 module Przn
+  # Default PDF export: drives the live renderer, asks the terminal to save
+  # each rendered slide as a one-page vector PDF via OSC 7772 `capture`,
+  # then concatenates the per-slide PDFs into a single multi-page PDF.
+  # Requires Echoes (or any terminal that implements the same capture
+  # command); use `export_pdf_prawn` instead for environments where that's
+  # not possible (CI, headless).
+  def self.export_pdf(file, output, theme: nil)
+    markdown = File.read(file)
+    presentation = Parser.parse(markdown)
+    base_dir = File.dirname(File.expand_path(file))
+    ScreenshotPdfExporter.new(presentation, base_dir: base_dir, theme: theme).export(output)
+    puts "Generated: #{output}"
+  end
+
   # Renders each slide live to the user's terminal, asks the terminal to save
   # the current pane as a vector PDF via Echoes' OSC 7772 `capture` command,
   # then concatenates the per-slide PDFs into a single multi-page PDF.
@@ -53,7 +67,7 @@ module Przn
       @terminal.enter_alt_screen
       @terminal.hide_cursor
       @presentation.slides.each_with_index do |slide, i|
-        pdf_path = File.join(dir, format("slide-%04d.pdf", i))
+        pdf_path = File.join(dir, format('slide-%04d.pdf', i))
         @renderer.render(slide, current: i, total: @presentation.total)
         request_capture(pdf_path)
         wait_for_capture(pdf_path)
@@ -77,7 +91,7 @@ module Przn
       until File.exist?(path) && File.size?(path).to_i.positive?
         if Time.now > deadline
           raise "Capture timed out for #{path}. " \
-                "Is Echoes running and recent enough to honor OSC 7772 `capture` to a .pdf path?"
+                'Is Echoes running and recent enough to honor OSC 7772 `capture` to a .pdf path?'
         end
         sleep POLL_INTERVAL
       end
@@ -86,7 +100,7 @@ module Przn
     end
 
     def merge_pdfs(pdf_paths, output_path)
-      raise "No slides captured" if pdf_paths.empty?
+      raise 'No slides captured' if pdf_paths.empty?
 
       output = HexaPDF::Document.new
       pdf_paths.each do |path|

data/lib/przn/slide.rb

@@ -7,5 +7,30 @@ module Przn
     def initialize(blocks)
       @blocks = blocks.freeze
     end
+
+    # Aggregate every `{::note}` / `<note>` segment in the slide's text-bearing
+    # fields. The presenter view renders these in its side panel; the audience
+    # renderer strips them from the rendered output.
+    def notes
+      out = []
+      blocks.each do |b|
+        texts = []
+        texts << b[:content] if b[:content].is_a?(String)
+        texts << b[:term]    if b[:term].is_a?(String)
+        texts << b[:definition] if b[:definition].is_a?(String)
+        if b[:items].is_a?(Array)
+          b[:items].each { |it| texts << it[:text] if it.is_a?(Hash) && it[:text].is_a?(String) }
+        end
+        if b[:rows].is_a?(Array)
+          (Array(b[:header]) + b[:rows].flatten).each { |c| texts << c if c.is_a?(String) }
+        end
+        texts.each do |text|
+          Parser.parse_inline(text).each do |seg|
+            out << seg[1] if seg[0] == :note && seg[1] && !seg[1].empty?
+          end
+        end
+      end
+      out
+    end
   end
 end

data/lib/przn/theme.rb

@@ -6,7 +6,7 @@ module Przn
   class Theme
     DEFAULT_PATH = File.expand_path('../../../default_theme.yml', __FILE__)
 
-    attr_reader :colors, :font, :bullet, :background, :title
+    attr_reader :colors, :font, :bullet, :background, :title, :rabbit
 
     def self.load(path)
       raise ArgumentError, "Theme file not found: #{path}" unless File.exist?(path)
@@ -19,10 +19,37 @@ module Przn
         bullet: defaults[:bullet].merge(overrides[:bullet] || {}),
         background: defaults[:background].merge(overrides[:background] || {}),
         title: defaults[:title].merge(overrides[:title] || {}),
+        # `rabbit` is opt-in: absent → nil → renderer uses the plain N/M footer.
+        # Present (even as an empty block) → hash → renderer uses the runner bar.
+        rabbit: defaults[:rabbit] || overrides[:rabbit] ?
+          (defaults[:rabbit] || {}).merge(overrides[:rabbit] || {}) :
+          nil
       }
       new(merged)
     end
 
+    # Convert a human-friendly duration string to seconds.
+    #   "30m"     -> 1800
+    #   "1h30m"   -> 5400
+    #   "1h2m3s"  -> 3723
+    #   "45"      -> 45  (bare integers are seconds)
+    #   45        -> 45  (already a number)
+    #   nil / ""  -> nil
+    #   "garbage" -> nil
+    def self.parse_duration(input)
+      return nil if input.nil?
+      return input.to_i if input.is_a?(Numeric)
+
+      s = input.to_s.strip
+      return nil if s.empty?
+      return s.to_i if s =~ /\A\d+\z/
+
+      m = s.match(/\A(?:(\d+)h)?(?:(\d+)m)?(?:(\d+)s)?\z/)
+      return nil unless m && m[0] != ''
+      h, mi, se = m[1].to_i, m[2].to_i, m[3].to_i
+      h * 3600 + mi * 60 + se
+    end
+
     def self.default
       new(load_yaml(DEFAULT_PATH))
     end
@@ -44,6 +71,9 @@ module Przn
         bullet: (data[:bullet] || {}).compact,
         background: (data[:background] || {}).compact,
         title: (data[:title] || {}).compact,
+        # nil when the `rabbit:` key isn't in the YAML at all (opt-in feature);
+        # empty hash when it's present but childless.
+        rabbit: data.key?(:rabbit) ? (data[:rabbit] || {}).compact : nil
       }
     end
     private_class_method :load_yaml
@@ -54,6 +84,7 @@ module Przn
       @bullet = config[:bullet]
       @background = config[:background]
       @title = config[:title]
+      @rabbit = config[:rabbit]
     end
   end
 end

data/lib/przn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Przn
-  VERSION = "0.3.0"
+  VERSION = '0.4.0'
 end

data/lib/przn.rb

@@ -1,17 +1,22 @@
 # frozen_string_literal: true
 
-require_relative "przn/version"
-require_relative "przn/kitty_text"
-require_relative "przn/image_util"
-require_relative "przn/slide"
-require_relative "przn/parser"
-require_relative "przn/presentation"
-require_relative "przn/terminal"
-require_relative "przn/renderer"
-require_relative "przn/controller"
-require_relative "przn/pdf_exporter"
-require_relative "przn/screenshot_pdf_exporter"
-require_relative "przn/theme"
+require 'tmpdir'
+require 'securerandom'
+
+require_relative 'przn/version'
+require_relative 'przn/kitty_text'
+require_relative 'przn/image_util'
+require_relative 'przn/parser'
+require_relative 'przn/slide'
+require_relative 'przn/presentation'
+require_relative 'przn/terminal'
+require_relative 'przn/renderer'
+require_relative 'przn/presenter_renderer'
+require_relative 'przn/audience_link'
+require_relative 'przn/echoes_client'
+require_relative 'przn/controller'
+require_relative 'przn/screenshot_pdf_exporter'
+require_relative 'przn/theme'
 
 module Przn
   class Error < StandardError; end
@@ -26,29 +31,72 @@ module Przn
     Controller.new(presentation, terminal, renderer)
   end
 
-  # Default PDF export: drives the live renderer, asks the terminal to save
-  # each rendered slide as a one-page vector PDF via OSC 7772 `capture`,
-  # then concatenates the per-slide PDFs into a single multi-page PDF.
-  # Requires Echoes (or any terminal that implements the same capture
-  # command); use `export_pdf_prawn` instead for environments where that's
-  # not possible (CI, headless).
-  def self.export_pdf(file, output, theme: nil)
+  # Audience-side entry: opens the file, listens on `socket`, and renders
+  # whatever slide the presenter sends a `goto` for. Notes are stripped.
+  # Spawned by Echoes when the presenter requests an extended-display window.
+  def self.audience(file, socket:, theme: nil)
     markdown = File.read(file)
     presentation = Parser.parse(markdown)
+    terminal = Terminal.new
     base_dir = File.dirname(File.expand_path(file))
-    ScreenshotPdfExporter.new(presentation, base_dir: base_dir, theme: theme).export(output)
-    puts "Generated: #{output}"
+    renderer = Renderer.new(terminal, base_dir: base_dir, theme: theme, mode: :audience)
+
+    terminal.enter_alt_screen
+    terminal.hide_cursor
+    begin
+      render = ->(idx, started_at) {
+        presentation.go_to(idx)
+        renderer.render(presentation.current_slide,
+                        current: presentation.current,
+                        total: presentation.total,
+                        started_at: started_at)
+      }
+      render.call(0, nil)
+      AudienceLink.serve(socket) do |msg|
+        next unless msg[:type] == "goto" && msg[:index].is_a?(Integer)
+        started_at = msg[:started_at] ? Time.at(msg[:started_at]) : nil
+        render.call(msg[:index], started_at)
+      end
+    ensure
+      terminal.write "\e]7772;bg-clear\a"
+      terminal.show_cursor
+      terminal.leave_alt_screen
+    end
   end
 
-  # Legacy PDF export via Prawn — renders the deck directly into a vector
-  # PDF without touching the terminal. Diverges from what's on screen for
-  # any feature the live renderer adds (OSC 66 sized text, OSC 7772
-  # backgrounds, proportional fonts) but works headlessly.
-  def self.export_pdf_prawn(file, output, theme: nil)
+  # Presenter-side entry: detects a second display via Echoes, spawns the
+  # audience window on it, connects to the spawned process over a Unix
+  # socket, and returns a Controller wired up to drive both sides.
+  # Falls back to today's mirror-mode (`start`) when only one display is
+  # attached or Echoes is not the host terminal.
+  def self.present(file, theme: nil, theme_path: nil)
+    info = EchoesClient.display_info
+    if info.nil? || info.size < 2
+      warn "przn: extended-display unavailable (no secondary display detected), falling back to mirror mode"
+      return start(file, theme: theme)
+    end
+
+    socket_path = File.join(Dir.tmpdir, "przn-#{Process.pid}-#{SecureRandom.hex(4)}.sock")
+    audience_argv = [File.expand_path($PROGRAM_NAME), '--audience', '--socket', socket_path]
+    audience_argv += ['--theme', theme_path] if theme_path
+    audience_argv << File.expand_path(file)
+    EchoesClient.open_window(display: info.last[:index], argv: audience_argv)
+
+    deadline = Time.now + 5
+    sleep 0.1 until File.exist?(socket_path) || Time.now > deadline
+    unless File.exist?(socket_path)
+      warn "przn: audience window did not come up within 5s, falling back to mirror mode"
+      return start(file, theme: theme)
+    end
+
+    link = AudienceLink.connect(socket_path)
+    link.gets # discard the {"type":"ready"} handshake
+
     markdown = File.read(file)
     presentation = Parser.parse(markdown)
+    terminal = Terminal.new
     base_dir = File.dirname(File.expand_path(file))
-    PdfExporter.new(presentation, base_dir: base_dir, theme: theme).export(output)
-    puts "Generated: #{output}"
+    renderer = PresenterRenderer.new(terminal, presentation: presentation, base_dir: base_dir, theme: theme)
+    Controller.new(presentation, terminal, renderer, audience_link: link)
   end
 end

data/sample/sample.md

@@ -40,6 +40,14 @@ This is **bold**, this is *italic*, and this is `inline code`.
 
 normal and {::tag name="red"}red text{:/tag} mixed
 
+# Image (PNG)
+
+![](doge.png){:relative_height="70"}
+
+# Image (JPG)
+
+![](doge.jpg){:relative_height="70"}
+
 # Thank You!
 
 That's all! Enjoy!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: przn
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
   - Akira Matsuda
@@ -55,18 +55,23 @@ files:
   - default_theme.yml
   - exe/przn
   - lib/przn.rb
+  - lib/przn/audience_link.rb
   - lib/przn/controller.rb
+  - lib/przn/echoes_client.rb
   - lib/przn/image_util.rb
   - lib/przn/kitty_text.rb
   - lib/przn/parser.rb
-  - lib/przn/pdf_exporter.rb
+  - lib/przn/prawn_pdf_exporter.rb
   - lib/przn/presentation.rb
+  - lib/przn/presenter_renderer.rb
   - lib/przn/renderer.rb
   - lib/przn/screenshot_pdf_exporter.rb
   - lib/przn/slide.rb
   - lib/przn/terminal.rb
   - lib/przn/theme.rb
   - lib/przn/version.rb
+  - sample/doge.jpg
+  - sample/doge.png
   - sample/sample.md
   - sig/przn.rbs
 homepage: "https://github.com/amatsuda/przn"