blib/lib/Speak.pm

filter: Statementstmt 44.8% 207 / 462 Branchbran 30.0% 68 / 226 Conditioncond 20.9% 43 / 205 MC/DCmcdc 6.8% 8 / 117 Subroutinesub 91.1% 31 / 34 Podpod 100% 5 / 5 totaltotal 34.5% 362 / 1049 CC 208 SCAR 75.9
CC
208
Cov
36%
speak
4353.9
resolve_persona
1141.5
say_persona
90.0
CRAP 1983.3
↑ Summary bin/speak »
1  
2 =pod
3  
4 =head1 NAME
5  
6 Speak - Convert text to speech using Google's engine and play it on speakers
7  
8 =head1 VERSION
9  
10 =over
11  
12 =item Author
13  
14 Andrew DeFaria <Andrew@DeFaria.com>
15  
16 =item Revision
17  
18 $Revision: 1.04 $
19  
20 =item Created
21  
22 =item Modified
23  
24 Fri 06 Sep 2026 08:30:00 AM PST
25  
26 =back
27  
28 =head1 SYNOPSIS
29  
30 This module offers subroutines to convert text into speach and speak them.
31  
32 =head2 DESCRIPTION
33  
34 This module exports subroutines to process text to speach and speak them.
35  
36 =head1 ROUTINES
37  
38 The following routines are exported:
39  
40 =cut
41  
42 package Speak;
43  
44 6 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
45 6 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
46 6 ▶use feature 'signatures';
Subroutine BEGIN: called CC=1 SCAR=0.0
47 ## no critic (TestingAndDebugging::ProhibitNoWarnings)
48 6 ▶no warnings 'experimental::signatures';
Subroutine BEGIN: called CC=1 SCAR=0.0
49 ## use critic
50  
51 6 ▶use base 'Exporter';
Subroutine BEGIN: called CC=1 SCAR=0.0
52  
53 6 ▶use Clipboard;
Subroutine BEGIN: called CC=1 SCAR=0.0
54 6 ▶use Fcntl qw(:flock);
Subroutine BEGIN: called CC=1 SCAR=0.0
55  
56 6 our $VERSION = '1.09';
57  
58 {
59  
60 ## no critic (Modules::ProhibitMultiplePackages)
61 package Speak::Logger;
62  
63 6 ▶ use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
64 6 ▶ use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
65 6 ▶ use File::Basename;
Subroutine BEGIN: called CC=1 SCAR=0.0
66 6 ▶ use POSIX qw(strftime);
Subroutine BEGIN: called CC=1 SCAR=0.0
67 6 ▶ use IO::Handle;
Subroutine BEGIN: called CC=1 SCAR=0.0
68 6 ▶ use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
69  
70 7 ▶ sub new ($class, %args) {
Subroutine new: called CC=5 SCAR=18.1
71 my $self = {
72 path => $args{path} || '.',
73 name => $args{name} || 'speak',
74 timestamped => $args{timestamped},
75 append => $args{append},
76 7 ▶ handle => undef,
Condition50%2/4
$args{'path'} || '.'
l!l
70
$args{'name'} || 'speak'
l!l
70
MC/DC0%0/1
$args{'path'} || '.'
$args{'path'}
MC/DC0%0/1
$args{'name'} || 'speak'
$args{'name'}
Truth table50%1/2
A
A= $args{'path'}
Aresult
11
00
Truth table50%1/2
A
A= $args{'name'}
Aresult
11
00
77 };
78  
79 7 ▶ my $mode = $self->{append} ? '>>' : '>';
Branch: 1 branch
BranchTrueFalseTotal
$self->{'append'} ? : 7 0 7
80 7 my $logfile = File::Spec->catfile ($self->{path}, $self->{name} . '.log');
81  
82 # We try to open the logfile, but if it fails we just warn and carry on
83 # effectively logging nowhere (or we could default to STDERR)
84 ## no critic (InputOutput::RequireBriefOpen)
85 7 ▶ if (open my $fh, $mode, $logfile) {
Branch: 1 branch
BranchTrueFalseTotal
if (open my $fh, $mode, $logfile) { } 0 7 7
86 0 $fh->autoflush (1);
87 0 $self->{handle} = $fh;
88 } else {
89 7 carp "Could not open logfile $logfile: $!";
90 }
91  
92 7 bless $self, $class;
93 7 return $self;
94 } ## end sub new
95  
96 7 ▶ sub log ($self, $msg, $nolinefeed = undef) {
Subroutine log: called CC=7 SCAR=28.4
97 7 ▶ return unless defined $msg;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $msg 0 7 7
98  
99 7 ▶ if (defined $nolinefeed) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $nolinefeed) { } 0 7 7
100 0 print $msg;
101 } else {
102 7 print "$msg\n";
103 }
104  
105 7 ▶ if ($self->{handle}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->{"handle"}) 0 7 7
106 my $timestamp =
107 $self->{timestamped}
108 0 ▶ ? strftime ("%Y-%m-%d %H:%M:%S", localtime) . ": "
Branch: 1 branch
BranchTrueFalseTotal
$self->{'timestamped'} ? : 0 0 0
109 : "";
110  
111 0 my $fh = $self->{handle};
112  
113 0 ▶ if (defined $nolinefeed) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $nolinefeed) { } 0 0 0
114 0 print $fh $timestamp, $msg;
115 } else {
116 0 print $fh $timestamp, $msg, "\n";
117 }
118 } ## end if ($self->{handle})
119  
120 7 return;
121 } ## end sub log
122  
123 7 ▶ sub DESTROY ($self) {
Subroutine DESTROY: called CC=2 SCAR=7.2
124 7 ▶ close $self->{handle} if $self->{handle};
Branch: 1 branch
BranchTrueFalseTotal
if $self->{"handle"} 0 7 7
125 7 return;
126 }
127 }
128  
129 6 ▶sub _get_config ($file) {
Subroutine _get_config: called CC=8 SCAR=21.8
130 1 my %config;
131 1 ▶ return %config unless -f $file;
Branch: 1 branch
BranchTrueFalseTotal
unless -f $file 0 1 1
132  
133 ## no critic (InputOutput::RequireBriefOpen)
134 1 ▶ if (open my $fh, '<', $file) {
Branch: 1 branch
BranchTrueFalseTotal
if (open my $fh, "<", $file) 1 0 1
135 1 ▶ while (my $line = <$fh>) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined(my $line = readline $fh)) 2 1 3
136 2 chomp $line;
137 2 ▶ next if $line =~ /^\s*[#!]/ || $line =~ /^\s*$/;
Branch: 1 branch
BranchTrueFalseTotal
if $line =~ /^\s*[#!]/ or $line =~ /^\s*$/ 0 2 2
Condition33%1/3
$line =~ /^\s*[#!]/ or $line =~ /^\s*$/
l!l&&r!l&&!r
002
MC/DC0%0/2
$line =~ /^\s*[#!]/ or $line =~ /^\s*$/
$line =~ /^\s*[#!]/ $line =~ /^\s*$/
Truth table33%1/3
A or B
A= $line =~ /^\s*[#!]/B= $line =~ /^\s*$/
ABresult
1X1
011
000
138 2 ▶ if ($line =~ /^\s*([^:=]+?)\s*[:=]\s*(.*?)\s*$/) {
Branch: 1 branch
BranchTrueFalseTotal
if ($line =~ /^\s*([^:=]+?)\s*[:=]\s*(.*?)\s*$/) 2 0 2
139 2 my $key = $1;
140 2 my $val = $2;
141  
142 # Simple variable interpolation for $ENV
143 2 ▶ $val =~ s/\$(\w+)/$ENV{$1} || "\$$1"/ge;
Condition50%1/2
$ENV{$1} || "\$$1"
l!l
10
MC/DC0%0/1
$ENV{$1} || "\$$1"
$ENV{$1}
Truth table50%1/2
A
A= $ENV{$1}
Aresult
11
00
144 2 $config{$key} = $val;
145 } ## end if ($line =~ /^\s*([^:=]+?)\s*[:=]\s*(.*?)\s*$/)
146 } ## end while (my $line = <$fh>)
147 1 close $fh;
148 } ## end if (open my $fh, '<', ...)
149 1 return %config;
150 } ## end sub _get_config
151  
152 6 ▶use Sys::Hostname;
Subroutine BEGIN: called CC=1 SCAR=0.0
153 6 ▶use JSON::PP;
Subroutine BEGIN: called CC=1 SCAR=0.0
154 6 ▶use HTTP::Request;
Subroutine BEGIN: called CC=1 SCAR=0.0
155 6 ▶use LWP::UserAgent;
Subroutine BEGIN: called CC=1 SCAR=0.0
156 6 ▶use URI::Escape;
Subroutine BEGIN: called CC=1 SCAR=0.0
157 6 ▶use File::Temp qw(tempfile);
Subroutine BEGIN: called CC=1 SCAR=0.0
158 6 ▶use File::Path qw(rmtree);
Subroutine BEGIN: called CC=1 SCAR=0.0
159 6 ▶use File::Basename;
Subroutine BEGIN: called CC=1 SCAR=0.0
160 6 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
161  
162 6 our @EXPORT_OK = qw(speak say_persona last_message is_persona resolve_persona %PERSONA_MAP);
163  
164 6 our %PERSONA_MAP = (
165 'Smith' => 'Agent Smith',
166 'Picard' => 'Captain Picard',
167 'Data' => 'Commander Data',
168 'Trump' => 'Donald Trump',
169 'Arnold' => 'Arnold Schwarzenegger',
170 'Worf' => 'Commander Worf',
171 'Sylvester' => 'Sylvester Stallone',
172 'Lennon' => 'John Lennon',
173 'Judy' => 'Judy',
174 'Michael' => 'Michael',
175 'Charles Clarke III' => 'Charles Clarke III',
176 'Charles Clark III' => 'Charles Clark III',
177 'Default' => 'default',
178 'default' => 'default',
179 );
180  
181 # Config paths searched in order; override @Speak::CONFIG_PATHS before calling
182 # speak() to redirect config loading (useful in tests).
183 our @CONFIG_PATHS = (
184 6 ▶ ($ENV{HOME} || q{}) . '/.speak/speak.conf',
Condition50%1/2
$ENV{'HOME'} || ''
l!l
60
MC/DC0%0/1
$ENV{'HOME'} || ''
$ENV{'HOME'}
Truth table50%1/2
A
A= $ENV{'HOME'}
Aresult
11
00
185 '/etc/speak.conf',
186 '/opt/clearscm/Speak/etc/speak.conf',
187 );
188  
189 9 ▶sub _split_text ($text) {
Subroutine _split_text: called CC=5 SCAR=16.1
190 9 ▶ return unless defined $text;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $text 0 9 9
191  
192 9 my @sentences;
193 9 ▶ while (length $text) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $text) 12 9 21
194 12 ▶ if ($text =~ s/^(.{1,100}?(?:[.!?;]|$))//) {
Branch: 2 branches
BranchTrueFalseTotal
if ($text =~ s/^(.{1,100}?(?:[.!?;]|$))//) { } 10 2 12
elsif ($text =~ s/^(.{1,100})\s//) { } 1 1 2
195 10 push @sentences, $1;
196 } elsif ($text =~ s/^(.{1,100})\s//) {
197 1 push @sentences, $1;
198 } else {
199  
200 # Fallback: force-slice the first 100 characters if no punctuation is found within 100 chars
201 1 push @sentences, substr ($text, 0, 100, "");
202 }
203 } ## end while (length $text)
204  
205 9 return @sentences;
206 } ## end sub _split_text
207  
208 =head2 last_message($logfile)
209  
210 Retrieves the last spoken message from the log file (defaulting to
211 C</var/log/speak.log>).
212  
213 Parameters:
214  
215 =over
216  
217 =item C<$logfile>
218  
219 Optional. Path to the speak log file. Defaults to C</var/log/speak.log>.
220  
221 =back
222  
223 Returns:
224  
225 In scalar context, returns the message text. In list context, returns
226 C<($message, $tag)> where C<$tag> is the application or persona tag if present.
227  
228 =cut
229  
230 4 ▶sub last_message ($logfile = '/var/log/speak.log') {
Subroutine last_message: called CC=11 SCAR=24.1
Pod documented
231 4 ▶ return unless -f $logfile && -r $logfile;
Branch: 1 branch
BranchTrueFalseTotal
unless -f $logfile and -r $logfile 1 3 4
Condition66%2/3
-f $logfile and -r $logfile
!ll&&!rl&&r
103
MC/DC50%1/2
-f $logfile and -r $logfile
-f $logfile -r $logfile
Truth table66%2/3
A and B
A= -f $logfileB= -r $logfile
ABresult
0X0
100
111
232  
233 3 ▶ open my $fh, '<', $logfile or return;
Branch: 1 branch
BranchTrueFalseTotal
open my $fh, "<", $logfile or return 3 0 3
234 3 my @lines = <$fh>;
235 3 close $fh;
236  
237 3 for my $line (reverse @lines) {
238 9 chomp $line;
239 9 ▶ next if $line =~ /^\s*$/;
Branch: 1 branch
BranchTrueFalseTotal
if $line =~ /^\s*$/ 4 5 9
240 5 ▶ next if $line =~ /\[silent shh\]/;
Branch: 1 branch
BranchTrueFalseTotal
if $line =~ /\[silent shh\]/ 2 3 5
241  
242 # Strip timestamp: YYYY-MM-DD HH:MM:SS:
243 3 $line =~ s/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}:\s*//;
244  
245 # Extract tag if present: [tag] message
246 3 my ($tag, $text);
247 3 ▶ if ($line =~ /^\[(.*?)\]\s*(.*)$/) {
Branch: 1 branch
BranchTrueFalseTotal
if ($line =~ /^\[(.*?)\]\s*(.*)$/) { } 2 1 3
248 2 $tag = $1;
249 2 $text = $2;
250 } else {
251 1 $text = $line;
252 }
253  
254 3 ▶ next unless length $text;
Branch: 1 branch
BranchTrueFalseTotal
unless length $text 0 3 3
255 3 ▶ return wantarray ? ($text, $tag) : $text;
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 2 1 3
256 }
257  
258 0 return;
259 }
260  
261 =head2 is_persona($tag)
262  
263 Checks if the given string represents a valid persona or persona display name.
264  
265 =cut
266  
267 10 ▶sub is_persona ($tag) {
Subroutine is_persona: called CC=18 SCAR=44.6
Pod documented
268 10 ▶ return 0 unless defined $tag && length $tag;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $tag and length $tag 1 9 10
Condition66%2/3
defined $tag and length $tag
!ll&&!rl&&r
109
MC/DC50%1/2
defined $tag and length $tag
defined $tag length $tag
Truth table66%2/3
A and B
A= defined $tagB= length $tag
ABresult
0X0
100
111
269 9 ▶ return 1 if lc $tag eq 'default';
Branch: 1 branch
BranchTrueFalseTotal
if lc $tag eq "default" 2 7 9
270  
271 7 for my $k (keys %PERSONA_MAP) {
272 50 ▶ return 1 if lc $k eq lc $tag || lc $PERSONA_MAP{$k} eq lc $tag;
Branch: 1 branch
BranchTrueFalseTotal
if lc $k eq lc $tag or lc $Speak::PERSONA_MAP{$k} eq lc $tag 5 45 50
Condition100%3/3
lc $k eq lc $tag or lc $Speak::PERSONA_MAP{$k} eq lc $tag
l!l&&r!l&&!r
3245
MC/DC100%2/2
lc $k eq lc $tag or lc $Speak::PERSONA_MAP{$k} eq lc $tag
lc $k eq lc $tag lc $Speak::PERSONA_MAP{$k} eq lc $tag
Truth table100%3/3
A or B
A= lc $k eq lc $tagB= lc $Speak::PERSONA_MAP{$k} eq lc $tag
ABresult
1X1
011
000
273 }
274  
275 2 my $voices_dir = '/opt/tts/voices';
276 2 my @dirs = ($voices_dir, "$voices_dir/contacts", "$voices_dir/contact");
277 2 for my $d (@dirs) {
278 6 ▶ next unless -d $d;
Branch: 1 branch
BranchTrueFalseTotal
unless -d $d 6 0 6
279 0 ▶ return 1 if -f "$d/$tag";
Branch: 1 branch
BranchTrueFalseTotal
if -f "$d/$tag" 0 0 0
280 0 for my $ext ('.wav', '.mp3', '.flac', '.ogg') {
281 0 ▶ return 1 if -f "$d/$tag$ext";
Branch: 1 branch
BranchTrueFalseTotal
if -f "$d/$tag$ext" 0 0 0
282 }
283 0 opendir (my $dh, $d);
284 0 ▶ my @files = grep { -f "$d/$_" && !/\.(txt|json|orig)$/i && !/^\./ } readdir ($dh);
Condition0%0/6
-f "$d/$_" && !/\.(txt|json|orig)$/i && !/^\./
!ll&&!rl&&r
000
-f "$d/$_" and not /\.(txt|json|orig)$/i
!ll&&!rl&&r
000
MC/DC0%0/3
-f "$d/$_" && !/\.(txt|json|orig)$/i && !/^\./
-f "$d/$_" not /\.(txt|json|orig)$/i !/^\./
Truth table0%0/4
A and not(B) && not(C)
A= -f "$d/$_"B= not /\.(txt|json|orig)$/iC= !/^\./
ABCresult
0XX0
10X0
1100
1111
285 0 closedir ($dh);
286 0 for my $f (@files) {
287 0 my ($base) = $f =~ /^([^.]+)/;
288 0 ▶ $base //= $f;
Condition0%0/3
$base //= $f
l!l&&r!l&&!r
000
MC/DC0%0/2
$base //= $f
$base $f
Truth table0%0/3
A //= B
A= $baseB= $f
ABresult
1X1
011
000
289 0 ▶ return 1 if lc $f eq lc $tag || lc $base eq lc $tag;
Branch: 1 branch
BranchTrueFalseTotal
if lc $f eq lc $tag or lc $base eq lc $tag 0 0 0
Condition0%0/3
lc $f eq lc $tag or lc $base eq lc $tag
l!l&&r!l&&!r
000
MC/DC0%0/2
lc $f eq lc $tag or lc $base eq lc $tag
lc $f eq lc $tag lc $base eq lc $tag
Truth table0%0/3
A or B
A= lc $f eq lc $tagB= lc $base eq lc $tag
ABresult
1X1
011
000
290 }
291 }
292  
293 2 return 0;
294 }
295  
296 =head2 resolve_persona($persona, %args)
297  
298 Resolves a requested persona (name, display name, 'random', or 'default') to:
299 C<($resolved_voice_key, $display_persona, $is_fallback)>.
300 If the persona is not found or invalid, it returns C<('Default', 'default', 1)>.
301  
302 =cut
303  
304 3 ▶sub resolve_persona ($persona, %args) {
Subroutine resolve_persona: called CC=50 SCAR=70.4
Pod documented
305 3 ▶ my $voices_dir = $args{voices_dir} || '/opt/tts/voices';
Condition50%1/2
$args{'voices_dir'} || '/opt/tts/voices'
l!l
03
MC/DC0%0/1
$args{'voices_dir'} || '/opt/tts/voices'
$args{'voices_dir'}
Truth table50%1/2
A
A= $args{'voices_dir'}
Aresult
11
00
306 3 my @contact_dirs = ("$voices_dir/contacts", "$voices_dir/contact");
307  
308 3 ▶ return (undef, undef, 0) unless defined $persona && length $persona;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $persona and length $persona 0 3 3
Condition33%1/3
defined $persona and length $persona
!ll&&!rl&&r
003
MC/DC0%0/2
defined $persona and length $persona
defined $persona length $persona
Truth table33%1/3
A and B
A= defined $personaB= length $persona
ABresult
0X0
100
111
309  
310 # Random persona selection
311 3 ▶ if ($persona =~ /^(random|rand|any)$/i) {
Branch: 1 branch
BranchTrueFalseTotal
if ($persona =~ /^(random|rand|any)$/i) 0 3 3
312 0 ▶ if (-d $voices_dir) {
Branch: 1 branch
BranchTrueFalseTotal
if (-d $voices_dir) 0 0 0
313 0 opendir (my $dh, $voices_dir);
314 0 ▶ my @primary = grep { -f "$voices_dir/$_" && !/\.(txt|json|orig)$/i && !/^\./ && !/^default(\.|$)/i } readdir ($dh);
Condition0%0/9
-f "$voices_dir/$_" && !/\.(txt|json|orig)$/i && !/^\./ && !/^default(\.|$)/i
!ll&&!rl&&r
000
-f "$voices_dir/$_" and not /\.(txt|json|orig)$/i and not /^\./
!ll&&!rl&&r
000
-f "$voices_dir/$_" and not /\.(txt|json|orig)$/i
!ll&&!rl&&r
000
MC/DC0%0/4
-f "$voices_dir/$_" && !/\.(txt|json|orig)$/i && !/^\./ && !/^default(\.|$)/i
-f "$voices_dir/$_" not /\.(txt|json|orig)$/i not /^\./ !/^default(\.|$)/i
Truth table0%0/5
A and not(B) and not(C) && not(D)
A= -f "$voices_dir/$_"B= not /\.(txt|json|orig)$/iC= not /^\./D= !/^default(\.|$)/i
ABCDresult
0XXX0
10XX0
110X0
11100
11111
315 0 closedir ($dh);
316 0 ▶ if (@primary) {
Branch: 1 branch
BranchTrueFalseTotal
if (@primary) 0 0 0
317 0 my $chosen = $primary[rand @primary];
318 0 my ($base) = $chosen =~ /^([^.]+)/;
319 0 ▶ $base = $chosen unless defined $base && length $base;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $base and length $base 0 0 0
Condition0%0/3
defined $base and length $base
!ll&&!rl&&r
000
MC/DC0%0/2
defined $base and length $base
defined $base length $base
Truth table0%0/3
A and B
A= defined $baseB= length $base
ABresult
0X0
100
111
320 0 ▶ my $display = $PERSONA_MAP{$base} || $base;
Condition0%0/3
$Speak::PERSONA_MAP{$base} || $base
l!l&&r!l&&!r
000
MC/DC0%0/2
$Speak::PERSONA_MAP{$base} || $base
$Speak::PERSONA_MAP{$base} $base
Truth table0%0/3
A || B
A= $Speak::PERSONA_MAP{$base}B= $base
ABresult
1X1
011
000
321 0 return ($base, $display, 0);
322 }
323 }
324 0 return ('Default', 'default', 0);
325 }
326  
327 # Explicit default
328 3 ▶ if ($persona =~ /^default$/i) {
Branch: 1 branch
BranchTrueFalseTotal
if ($persona =~ /^default$/i) 1 2 3
329 1 return ('Default', 'default', 0);
330 }
331  
332 # Check Reverse Persona Map
333 2 my $reverse_base;
334 2 for my $k (keys %PERSONA_MAP) {
335 16 ▶ if (lc $PERSONA_MAP{$k} eq lc $persona || lc $k eq lc $persona) {
Branch: 1 branch
BranchTrueFalseTotal
if (lc $Speak::PERSONA_MAP{$k} eq lc $persona or lc $k eq lc $persona) 1 15 16
Condition66%2/3
lc $Speak::PERSONA_MAP{$k} eq lc $persona or lc $k eq lc $persona
l!l&&r!l&&!r
1015
MC/DC50%1/2
lc $Speak::PERSONA_MAP{$k} eq lc $persona or lc $k eq lc $persona
lc $Speak::PERSONA_MAP{$k} eq lc $persona lc $k eq lc $persona
Truth table66%2/3
A or B
A= lc $Speak::PERSONA_MAP{$k} eq lc $personaB= lc $k eq lc $persona
ABresult
1X1
011
000
336 1 $reverse_base = $k;
337 1 last;
338 }
339 }
340  
341 2 my @candidates_to_check = ();
342 2 ▶ push @candidates_to_check, $reverse_base if defined $reverse_base;
Branch: 1 branch
BranchTrueFalseTotal
if defined $reverse_base 1 1 2
343 2 ▶ push @candidates_to_check, $persona unless defined $reverse_base && lc $reverse_base eq lc $persona;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $reverse_base and lc $reverse_base eq lc $persona 2 0 2
Condition66%2/3
defined $reverse_base and lc $reverse_base eq lc $persona
!ll&&!rl&&r
110
MC/DC0%0/2
defined $reverse_base and lc $reverse_base eq lc $persona
defined $reverse_base lc $reverse_base eq lc $persona
Truth table66%2/3
A and B
A= defined $reverse_baseB= lc $reverse_base eq lc $persona
ABresult
0X0
100
111
344  
345 2 my @dirs_to_search = ($voices_dir, @contact_dirs);
346  
347 2 for my $dir (@dirs_to_search) {
348 6 ▶ next unless -d $dir;
Branch: 1 branch
BranchTrueFalseTotal
unless -d $dir 6 0 6
349 0 for my $cand (@candidates_to_check) {
350 0 ▶ if (-f "$dir/$cand") {
Branch: 1 branch
BranchTrueFalseTotal
if (-f "$dir/$cand") 0 0 0
351 0 ▶ my $display = $PERSONA_MAP{$cand} || $cand;
Condition0%0/3
$Speak::PERSONA_MAP{$cand} || $cand
l!l&&r!l&&!r
000
MC/DC0%0/2
$Speak::PERSONA_MAP{$cand} || $cand
$Speak::PERSONA_MAP{$cand} $cand
Truth table0%0/3
A || B
A= $Speak::PERSONA_MAP{$cand}B= $cand
ABresult
1X1
011
000
352 0 return ($cand, $display, 0);
353 }
354 0 for my $ext ('.wav', '.mp3', '.flac', '.ogg') {
355 0 ▶ if (-f "$dir/$cand$ext") {
Branch: 1 branch
BranchTrueFalseTotal
if (-f "$dir/$cand$ext") 0 0 0
356 0 ▶ my $display = $PERSONA_MAP{$cand} || $cand;
Condition0%0/3
$Speak::PERSONA_MAP{$cand} || $cand
l!l&&r!l&&!r
000
MC/DC0%0/2
$Speak::PERSONA_MAP{$cand} || $cand
$Speak::PERSONA_MAP{$cand} $cand
Truth table0%0/3
A || B
A= $Speak::PERSONA_MAP{$cand}B= $cand
ABresult
1X1
011
000
357 0 return ($cand, $display, 0);
358 }
359 }
360 }
361  
362 0 opendir (my $dh, $dir);
363 0 ▶ my @files = grep { -f "$dir/$_" && !/\.(txt|json|orig)$/i && !/^\./ } readdir ($dh);
Condition0%0/6
-f "$dir/$_" && !/\.(txt|json|orig)$/i && !/^\./
!ll&&!rl&&r
000
-f "$dir/$_" and not /\.(txt|json|orig)$/i
!ll&&!rl&&r
000
MC/DC0%0/3
-f "$dir/$_" && !/\.(txt|json|orig)$/i && !/^\./
-f "$dir/$_" not /\.(txt|json|orig)$/i !/^\./
Truth table0%0/4
A and not(B) && not(C)
A= -f "$dir/$_"B= not /\.(txt|json|orig)$/iC= !/^\./
ABCresult
0XX0
10X0
1100
1111
364 0 closedir ($dh);
365  
366 0 for my $f (@files) {
367 0 my ($fbase) = $f =~ /^([^.]+)/;
368 0 ▶ $fbase //= $f;
Condition0%0/3
$fbase //= $f
l!l&&r!l&&!r
000
MC/DC0%0/2
$fbase //= $f
$fbase $f
Truth table0%0/3
A //= B
A= $fbaseB= $f
ABresult
1X1
011
000
369 0 for my $cand (@candidates_to_check) {
370 0 ▶ if (lc $f eq lc $cand || lc $fbase eq lc $cand) {
Branch: 1 branch
BranchTrueFalseTotal
if (lc $f eq lc $cand or lc $fbase eq lc $cand) 0 0 0
Condition0%0/3
lc $f eq lc $cand or lc $fbase eq lc $cand
l!l&&r!l&&!r
000
MC/DC0%0/2
lc $f eq lc $cand or lc $fbase eq lc $cand
lc $f eq lc $cand lc $fbase eq lc $cand
Truth table0%0/3
A or B
A= lc $f eq lc $candB= lc $fbase eq lc $cand
ABresult
1X1
011
000
371 0 ▶ my $display = $PERSONA_MAP{$fbase} || $fbase;
Condition0%0/3
$Speak::PERSONA_MAP{$fbase} || $fbase
l!l&&r!l&&!r
000
MC/DC0%0/2
$Speak::PERSONA_MAP{$fbase} || $fbase
$Speak::PERSONA_MAP{$fbase} $fbase
Truth table0%0/3
A || B
A= $Speak::PERSONA_MAP{$fbase}B= $fbase
ABresult
1X1
011
000
372 0 return ($fbase, $display, 0);
373 }
374 }
375 }
376  
377 # Token / partial word matching
378 0 my @target_tokens = grep { length $_ } split /[^a-zA-Z0-9]+/, lc $persona;
379 0 ▶ if (@target_tokens) {
Branch: 1 branch
BranchTrueFalseTotal
if (@target_tokens) 0 0 0
380 0 for my $f (@files) {
381 0 my ($fbase) = $f =~ /^([^.]+)/;
382 0 ▶ $fbase //= $f;
Condition0%0/3
$fbase //= $f
l!l&&r!l&&!r
000
MC/DC0%0/2
$fbase //= $f
$fbase $f
Truth table0%0/3
A //= B
A= $fbaseB= $f
ABresult
1X1
011
000
383 0 my @cand_tokens = grep { length $_ } split /[^a-zA-Z0-9]+/, lc $fbase;
384 0 ▶ next unless @cand_tokens;
Branch: 1 branch
BranchTrueFalseTotal
unless @cand_tokens 0 0 0
385  
386 0 my %t_set = map { $_ => 1 } @target_tokens;
387 0 my %c_set = map { $_ => 1 } @cand_tokens;
388 0 my $all_c_in_t = 1;
389 0 ▶ for my $t (@cand_tokens) { $all_c_in_t = 0 unless $t_set{$t}; }
Branch: 1 branch
BranchTrueFalseTotal
unless $t_set{$t} 0 0 0
390 0 my $all_t_in_c = 1;
391 0 ▶ for my $t (@target_tokens) { $all_t_in_c = 0 unless $c_set{$t}; }
Branch: 1 branch
BranchTrueFalseTotal
unless $c_set{$t} 0 0 0
392  
393 0 ▶ if ($all_c_in_t || $all_t_in_c) {
Branch: 1 branch
BranchTrueFalseTotal
if ($all_c_in_t or $all_t_in_c) 0 0 0
Condition0%0/3
$all_c_in_t or $all_t_in_c
l!l&&r!l&&!r
000
MC/DC0%0/2
$all_c_in_t or $all_t_in_c
$all_c_in_t $all_t_in_c
Truth table0%0/3
A or B
A= $all_c_in_tB= $all_t_in_c
ABresult
1X1
011
000
394 0 ▶ my $display = $PERSONA_MAP{$fbase} || $fbase;
Condition0%0/3
$Speak::PERSONA_MAP{$fbase} || $fbase
l!l&&r!l&&!r
000
MC/DC0%0/2
$Speak::PERSONA_MAP{$fbase} || $fbase
$Speak::PERSONA_MAP{$fbase} $fbase
Truth table0%0/3
A || B
A= $Speak::PERSONA_MAP{$fbase}B= $fbase
ABresult
1X1
011
000
395 0 return ($fbase, $display, 0);
396 }
397 }
398 }
399 }
400  
401 2 ▶ if (defined $reverse_base && !-d $voices_dir) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $reverse_base and not -d $voices_dir) 1 1 2
Condition66%2/3
defined $reverse_base and not -d $voices_dir
!ll&&!rl&&r
101
MC/DC50%1/2
defined $reverse_base and not -d $voices_dir
defined $reverse_base not -d $voices_dir
Truth table66%2/3
A and not(B)
A= defined $reverse_baseB= not -d $voices_dir
ABresult
0X0
100
111
402 1 ▶ my $display = $PERSONA_MAP{$reverse_base} || $reverse_base;
Condition33%1/3
$Speak::PERSONA_MAP{$reverse_base} || $reverse_base
l!l&&r!l&&!r
100
MC/DC0%0/2
$Speak::PERSONA_MAP{$reverse_base} || $reverse_base
$Speak::PERSONA_MAP{$reverse_base} $reverse_base
Truth table33%1/3
A || B
A= $Speak::PERSONA_MAP{$reverse_base}B= $reverse_base
ABresult
1X1
011
000
403 1 return ($reverse_base, $display, 0);
404 }
405  
406 1 return ('Default', 'default', 1);
407 }
408  
409 0 ▶sub _fetch_mp3 ($ua, $text, $lang) {
Subroutine _fetch_mp3: not called CC=4 SCAR=30.0
410  
411 0 my $url =
412 "https://translate.google.com/translate_tts?ie=UTF-8&tl=$lang&q="
413 . uri_escape_utf8 ($text)
414 . "&total=1&idx=0&client=tw-ob";
415  
416 0 my $response = $ua->get ($url);
417  
418 0 ▶ if ($response->is_success) {
Branch: 1 branch
BranchTrueFalseTotal
if ($response->is_success) { } 0 0 0
419 0 my $content = $response->content;
420 0 ▶ if (length ($content) == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $content == 0) 0 0 0
421 0 carp "Fetch successful but content is empty";
422 0 return;
423 }
424  
425 # Check if we got HTML instead of MP3 (e.g. Captcha/Error)
426 0 ▶ if ($content =~ /^\s*<(!DOCTYPE|html)/i) {
Branch: 1 branch
BranchTrueFalseTotal
if ($content =~ /^\s*<(!DOCTYPE|html)/i) 0 0 0
427 0 carp
428 "Received HTML response instead of MP3 (likely CAPTCHA/Blocked) from URL: $url";
429 0 return;
430 }
431  
432 0 return $content;
433 } else {
434 0 carp "Failed to fetch TTS: " . $response->status_line;
435 0 return;
436 }
437 } ## end sub _fetch_mp3
438  
439 0 ▶sub _convert_mp3_to_wav ($mp3, $wav) {
Subroutine _convert_mp3_to_wav: not called CC=4 SCAR=30.0
440  
441 # Try ffmpeg
442 0 ▶ if (system ("which ffmpeg >/dev/null 2>&1") == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (system("which ffmpeg >/dev/null 2>&1") == 0) 0 0 0
443 0 return system ("ffmpeg -y -v error -i \"$mp3\" \"$wav\"") == 0;
444 }
445  
446 # Try mpg123
447 0 ▶ if (system ("which mpg123 >/dev/null 2>&1") == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (system("which mpg123 >/dev/null 2>&1") == 0) 0 0 0
448 0 return system ("mpg123 -q -w \"$wav\" \"$mp3\"") == 0;
449 }
450  
451 # Try lame
452 0 ▶ if (system ("which lame >/dev/null 2>&1") == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (system("which lame >/dev/null 2>&1") == 0) 0 0 0
453 0 return system ("lame --decode --quiet \"$mp3\" \"$wav\"") == 0;
454 }
455  
456 # Fallback to sox (might fail if no mp3 handler)
457 0 return system ("sox \"$mp3\" \"$wav\"") == 0;
458 } ## end sub _convert_mp3_to_wav
459  
460 ## no critic (Subroutines::ProhibitExcessComplexity)
461 7 ▶sub speak ($msg, $log = undef, $lang = undef, $persona = undef, $output_file = undef, $app = undef) {
Subroutine speak: called CC=96 SCAR=83.8
Pod documented
462  
463 =pod
464  
465 =head2 speak($msg, $log, $lang, $persona, $output_file, $app)
466  
467 Convert $msg to speech.
468  
469 Parameters:
470  
471 =for html <blockquote>
472  
473 =over
474  
475 =item $msg:
476  
477 Message to speak. If $msg is defined and scalar then that is the message
478 to speak. If it is a file handle then the text will be read from that file.
479 Otherwise the text in the clipboard will be used.
480  
481 =item $log
482  
483 If provided, errors and messages will be logged to the logfile, otherwise to speak.log
484  
485 =item $lang
486  
487 Language code (e.g. 'en', 'en-gb', 'en-au'). Defaults to $ENV{SPEAK_LANG} or 'en'.
488  
489 =item $persona
490  
491 Optional. The persona name to use for the voice. If provided, the MCP server is used instead of standard TTS.
492  
493 =item $output_file
494  
495 Optional. Path to save output speech audio file.
496  
497 =item $app
498  
499 Optional. Application name to tag in the log (e.g. 'announceEmail Gmail').
500  
501 =back
502  
503  
504  
505 =for html </blockquote>
506  
507 Returns:
508  
509 =for html <blockquote>
510  
511 =over
512  
513 =item Nothing
514  
515 =back
516  
517 =for html </blockquote>
518  
519 =cut
520  
521 # Support passing options as named key-value pairs or HASH ref
522 7 ▶ if (defined $log && !ref ($log) && ($log eq 'app' || $log eq 'persona' || $log eq 'lang' || $log eq 'output')) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $log and not ref $log and $log eq 'app' || $log eq 'persona' || $log eq 'lang' || $log eq 'output') { } 0 7 7
elsif (defined $log and ref $log eq 'HASH') { } 0 14 14
Condition13%2/15
defined $log and not ref $log and $log eq "app" || $log eq "persona" || $log eq "lang" || $log eq "output"
!ll&&!rl&&r
700
defined $log and not ref $log
!ll&&!rl&&r
700
$log eq "app" or $log eq "persona" or $log eq "lang" or $log eq "output"
l!l&&r!l&&!r
000
$log eq "app" or $log eq "persona" or $log eq "lang"
l!l&&r!l&&!r
000
$log eq "app" or $log eq "persona"
l!l&&r!l&&!r
000
MC/DC0%0/6
defined $log and not ref $log and $log eq "app" || $log eq "persona" || $log eq "lang" || $log eq "output"
defined $log not ref $log $log eq "app" $log eq "persona" $log eq "lang" $log eq "output"
Truth table14%1/7
A and not(B) and C or D or E or F
A= defined $logB= not ref $logC= $log eq "app"D= $log eq "persona"E= $log eq "lang"F= $log eq "output"
ABCDEFresult
0XXXXX0
10XXXX0
1100000
111XXX1
1101XX1
11001X1
1100011
523 0 ▶ my %args = ($log => $lang, defined $persona ? ($persona => $output_file) : (), defined $app ? ($app => undef) : ());
Branch: 2 branches
BranchTrueFalseTotal
defined $persona ? : 0 0 0
defined $app ? : 0 0 0
524 0 $log = $args{log};
525 0 $lang = $args{lang};
526 0 $persona = $args{persona};
527 0 ▶ $output_file = $args{output} || $args{output_file};
Condition0%0/3
$args{'output'} || $args{'output_file'}
l!l&&r!l&&!r
000
MC/DC0%0/2
$args{'output'} || $args{'output_file'}
$args{'output'} $args{'output_file'}
Truth table0%0/3
A || B
A= $args{'output'}B= $args{'output_file'}
ABresult
1X1
011
000
528 0 $app = $args{app};
529 ▶ } elsif (defined $log && ref ($log) eq 'HASH') {
Condition33%1/3
defined $log and ref $log eq "HASH"
!ll&&!rl&&r
700
MC/DC0%0/2
defined $log and ref $log eq "HASH"
defined $log ref $log eq "HASH"
Truth table33%1/3
A and B
A= defined $logB= ref $log eq "HASH"
ABresult
0X0
100
111
530 0 my $opts = $log;
531 0 $log = $opts->{log};
532 0 $lang = $opts->{lang};
533 0 $persona = $opts->{persona};
534 0 ▶ $output_file = $opts->{output} || $opts->{output_file};
Condition0%0/3
$opts->{'output'} || $opts->{'output_file'}
l!l&&r!l&&!r
000
MC/DC0%0/2
$opts->{'output'} || $opts->{'output_file'}
$opts->{'output'} $opts->{'output_file'}
Truth table0%0/3
A || B
A= $opts->{'output'}B= $opts->{'output_file'}
ABresult
1X1
011
000
535 0 $app = $opts->{app};
536 }
537  
538 7 ▶ $log = Speak::Logger->new (
Branch: 1 branch
BranchTrueFalseTotal
unless $log 7 0 7
539 path => '/var/log',
540 name => 'speak',
541 timestamped => 'yes',
542 append => 1,
543 ) unless $log;
544  
545 7 ▶ unless ($msg) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($msg) 0 7 7
546 0 $msg = eval {
547 ## no critic (InputOutput::RequireBriefOpen)
548 0 ▶ open my $olderr, '>&', \*STDERR or croak "Cannot dup STDERR: $!";
Branch: 1 branch
BranchTrueFalseTotal
open my $olderr, ">&", \*STDERR or croak("Cannot dup STDERR: $!") 0 0 0
549 0 ▶ open STDERR, '>', '/dev/null' or croak "Cannot redirect STDERR: $!";
Branch: 1 branch
BranchTrueFalseTotal
open STDERR, ">", "/dev/null" or croak("Cannot redirect STDERR: $!") 0 0 0
550 0 my $res = Clipboard->paste;
551 0 ▶ open STDERR, '>&', $olderr or croak "Cannot restore STDERR: $!";
Branch: 1 branch
BranchTrueFalseTotal
open STDERR, ">&", $olderr or croak("Cannot restore STDERR: $!") 0 0 0
552 0 close $olderr;
553 ## use critic
554 0 $res;
555 };
556 0 ▶ $msg //= '';
Condition0%0/2
$msg //= ""
l!l
00
MC/DC0%0/1
$msg //= ""
$msg
Truth table0%0/2
A
A= $msg
Aresult
11
00
557 } ## end unless ($msg)
558 0 ▶ $msg = do {local $/; <$msg>} if ref $msg eq 'GLOB';
Branch: 1 branch
BranchTrueFalseTotal
if ref $msg eq "GLOB" 0 7 7
559  
560 7 my %sys_conf;
561 7 foreach my $conf_file (@CONFIG_PATHS) {
562 3 ▶ if (-f $conf_file) {
Branch: 1 branch
BranchTrueFalseTotal
if (-f $conf_file) 0 3 3
563 0 %sys_conf = _get_config ($conf_file);
564 0 last;
565 }
566 } ## end foreach my $conf_file (@CONFIG_PATHS)
567  
568 7 ▶ $persona ||= $ENV{SPEAK_PERSONA} || $sys_conf{persona};
Condition33%2/6
$persona ||= $ENV{"SPEAK_PERSONA"} || $sys_conf{"persona"}
l!l&&r!l&&!r
007
$ENV{'SPEAK_PERSONA'} || $sys_conf{'persona'}
l!l&&r!l&&!r
007
MC/DC0%0/3
$persona ||= $ENV{"SPEAK_PERSONA"} || $sys_conf{"persona"}
$persona $ENV{'SPEAK_PERSONA'} $sys_conf{'persona'}
Truth table0%0/4
A ||= B || C
A= $personaB= $ENV{'SPEAK_PERSONA'}C= $sys_conf{'persona'}
ABCresult
1XX1
01X1
0011
0000
569 7 ▶ $app ||= $ENV{SPEAK_APP};
Condition33%1/3
$app ||= $ENV{"SPEAK_APP"}
l!l&&r!l&&!r
007
MC/DC0%0/2
$app ||= $ENV{"SPEAK_APP"}
$app $ENV{"SPEAK_APP"}
Truth table33%1/3
A ||= B
A= $appB= $ENV{"SPEAK_APP"}
ABresult
1X1
011
000
570  
571 7 ▶ my $server = $ENV{SPEAK_SERVER} || $sys_conf{server};
Condition33%1/3
$ENV{'SPEAK_SERVER'} || $sys_conf{'server'}
l!l&&r!l&&!r
007
MC/DC0%0/2
$ENV{'SPEAK_SERVER'} || $sys_conf{'server'}
$ENV{'SPEAK_SERVER'} $sys_conf{'server'}
Truth table33%1/3
A || B
A= $ENV{'SPEAK_SERVER'}B= $sys_conf{'server'}
ABresult
1X1
011
000
572 7 ▶ my $port = $ENV{SPEAK_PORT} || $sys_conf{port};
Condition33%1/3
$ENV{'SPEAK_PORT'} || $sys_conf{'port'}
l!l&&r!l&&!r
007
MC/DC0%0/2
$ENV{'SPEAK_PORT'} || $sys_conf{'port'}
$ENV{'SPEAK_PORT'} $sys_conf{'port'}
Truth table33%1/3
A || B
A= $ENV{'SPEAK_PORT'}B= $sys_conf{'port'}
ABresult
1X1
011
000
573 7 ▶ my $wan_server = $ENV{SPEAK_WAN_SERVER} || $sys_conf{wan_server};
Condition33%1/3
$ENV{'SPEAK_WAN_SERVER'} || $sys_conf{'wan_server'}
l!l&&r!l&&!r
007
MC/DC0%0/2
$ENV{'SPEAK_WAN_SERVER'} || $sys_conf{'wan_server'}
$ENV{'SPEAK_WAN_SERVER'} $sys_conf{'wan_server'}
Truth table33%1/3
A || B
A= $ENV{'SPEAK_WAN_SERVER'}B= $sys_conf{'wan_server'}
ABresult
1X1
011
000
574 7 ▶ my $wan_port = $ENV{SPEAK_WAN_PORT} || $sys_conf{wan_port} || 443;
Condition40%2/5
$ENV{'SPEAK_WAN_PORT'} || $sys_conf{'wan_port'} || 443
l!l
07
$ENV{"SPEAK_WAN_PORT"} or $sys_conf{"wan_port"}
l!l&&r!l&&!r
007
MC/DC0%0/2
$ENV{'SPEAK_WAN_PORT'} || $sys_conf{'wan_port'} || 443
$ENV{"SPEAK_WAN_PORT"} $sys_conf{"wan_port"}
Truth table33%1/3
A or B
A= $ENV{"SPEAK_WAN_PORT"}B= $sys_conf{"wan_port"}
ABresult
1X1
011
000
575 7 ▶ my $wan_scheme = $ENV{SPEAK_WAN_SCHEME} || $sys_conf{wan_scheme} || (($wan_port eq '443') ? 'https' : 'http');
Branch: 1 branch
BranchTrueFalseTotal
$wan_port eq '443' ? : 7 0 7
Condition33%2/6
$ENV{'SPEAK_WAN_SCHEME'} || $sys_conf{'wan_scheme'} || ($wan_port eq '443' ? 'https' : 'http')
l!l&&r!l&&!r
070
$ENV{"SPEAK_WAN_SCHEME"} or $sys_conf{"wan_scheme"}
l!l&&r!l&&!r
007
MC/DC0%0/3
$ENV{'SPEAK_WAN_SCHEME'} || $sys_conf{'wan_scheme'} || ($wan_port eq '443' ? 'https' : 'http')
$ENV{"SPEAK_WAN_SCHEME"} $sys_conf{"wan_scheme"} ($wan_port eq '443' ? 'https' : 'http')
Truth table25%1/4
A or B || C
A= $ENV{"SPEAK_WAN_SCHEME"}B= $sys_conf{"wan_scheme"}C= ($wan_port eq '443' ? 'https' : 'http')
ABCresult
1XX1
01X1
0011
0000
576  
577 # Sanitize escape sequences
578 # 1. Remove bells (\a)
579 7 $msg =~ s/(\\a|\a)//g;
580  
581 # 2. Convert other escapes to space
582 # Literals: \n, \t, \r, \f, \b
583 7 $msg =~ s/\\[ntrfb]/ /g;
584  
585 # 3. Convert actual control characters to space
586 7 $msg =~ s/[\n\t\r\f\b]/ /g;
587  
588 # 4. Collapse multiple spaces
589 7 $msg =~ s/\s+/ /g;
590 7 $msg =~ s/^\s+|\s+$//g;
591  
592 7 my ($resolved_persona, $display_persona, $is_fallback);
593 7 ▶ if ($persona) {
Branch: 1 branch
BranchTrueFalseTotal
if ($persona) 0 7 7
594 0 ($resolved_persona, $display_persona, $is_fallback) = resolve_persona ($persona);
595 0 $persona = $resolved_persona;
596 }
597  
598 7 ▶ my $tag = $app || $display_persona || basename ($0);
Condition33%2/6
$app || $display_persona || basename($0)
l!l&&r!l&&!r
070
$app or $display_persona
l!l&&r!l&&!r
007
MC/DC0%0/3
$app || $display_persona || basename($0)
$app $display_persona basename($0)
Truth table25%1/4
A or B || C
A= $appB= $display_personaC= basename($0)
ABCresult
1XX1
01X1
0011
0000
599 7 ▶ $tag =~ s/\.pl$// if $tag;
Branch: 1 branch
BranchTrueFalseTotal
if $tag 7 0 7
600  
601 7 ▶ my $log_msg = (defined $tag && length $tag) ? "[$tag] $msg" : $msg;
Branch: 1 branch
BranchTrueFalseTotal
defined $tag && length $tag ? : 7 0 7
Condition33%1/3
defined $tag and length $tag
!ll&&!rl&&r
007
MC/DC0%0/2
defined $tag and length $tag
defined $tag length $tag
Truth table33%1/3
A and B
A= defined $tagB= length $tag
ABresult
0X0
100
111
602  
603 my @mute_paths =
604 7 ($ENV{SPEAK_MUTE}, $ENV{HOME} . "/.speak/shh", "/etc/speak/shh");
605  
606 7 foreach my $path (@mute_paths) {
607 19 ▶ if ($path && -f $path) {
Branch: 1 branch
BranchTrueFalseTotal
if ($path and -f $path) 1 18 19
Condition100%3/3
$path and -f $path
!ll&&!rl&&r
6121
MC/DC100%2/2
$path and -f $path
$path -f $path
Truth table100%3/3
A and B
A= $pathB= -f $path
ABresult
0X0
100
111
608 1 $log_msg .= ' [silent shh]';
609 1 $log->log ($log_msg);
610 1 return;
611 }
612 } ## end foreach my $path (@mute_paths)
613  
614 6 $log->log ($log_msg);
615  
616 6 ▶ if ($server && $port) {
Branch: 1 branch
BranchTrueFalseTotal
if ($server and $port) 0 6 6
Condition33%1/3
$server and $port
!ll&&!rl&&r
600
MC/DC0%0/2
$server and $port
$server $port
Truth table33%1/3
A and B
A= $serverB= $port
ABresult
0X0
100
111
617 0 ▶ if (hostname () eq $server) {
Branch: 1 branch
BranchTrueFalseTotal
if (hostname() eq $server) { } 0 0 0
618 0 local $ENV{TTS_DAEMON_URL} = "http://127.0.0.1:$port";
619 0 say_persona (undef, $msg, $persona, $output_file);
620 0 return;
621 } else {
622 0 my $ua = LWP::UserAgent->new;
623 0 $ua->agent ("Mozilla/5.0");
624 0 my $json = JSON::PP->new->utf8;
625 0 my $req_data = {text => $msg};
626 0 ▶ $req_data->{ref_audio} = $persona if $persona;
Branch: 1 branch
BranchTrueFalseTotal
if $persona 0 0 0
627 0 my $req_json = $json->encode ($req_data);
628  
629 0 ▶ my $scheme = ($port eq '443' || $server =~ /^https/i) ? 'https' : 'http';
Branch: 1 branch
BranchTrueFalseTotal
$port eq '443' || $server =~ /^https/i ? : 0 0 0
Condition0%0/3
$port eq 443 or $server =~ /^https/i
l!l&&r!l&&!r
000
MC/DC0%0/2
$port eq 443 or $server =~ /^https/i
$port eq 443 $server =~ /^https/i
Truth table0%0/3
A or B
A= $port eq 443B= $server =~ /^https/i
ABresult
1X1
011
000
630 0 my $clean_server = $server;
631 0 $clean_server =~ s{^https?://}{};
632 0 ▶ my $url = ($port eq '443' || $port eq '80')
Branch: 1 branch
BranchTrueFalseTotal
$port eq '443' || $port eq '80' ? : 0 0 0
Condition0%0/3
$port eq 443 or $port eq 80
l!l&&r!l&&!r
000
MC/DC0%0/2
$port eq 443 or $port eq 80
$port eq 443 $port eq 80
Truth table0%0/3
A or B
A= $port eq 443B= $port eq 80
ABresult
1X1
011
000
633 ? "$scheme://$clean_server/clone_voice_audio"
634 : "$scheme://$clean_server:$port/clone_voice_audio";
635  
636 0 my $req = HTTP::Request->new ('POST', $url);
637 0 $req->header ('Content-Type' => 'application/json');
638 0 $req->header ('Accept' => 'audio/wav');
639 0 $req->content ($req_json);
640  
641 0 my $res = $ua->request ($req);
642 0 ▶ if (!$res->is_success && $wan_server && $clean_server ne $wan_server) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $res->is_success and $wan_server and $clean_server ne $wan_server) 0 0 0
Condition0%0/6
not $res->is_success and $wan_server and $clean_server ne $wan_server
!ll&&!rl&&r
000
not $res->is_success and $wan_server
!ll&&!rl&&r
000
MC/DC0%0/3
not $res->is_success and $wan_server and $clean_server ne $wan_server
not $res->is_success $wan_server $clean_server ne $wan_server
Truth table0%0/4
not(A) and B and C
A= not $res->is_successB= $wan_serverC= $clean_server ne $wan_server
ABCresult
0XX0
10X0
1100
1111
643 0 my $clean_wan_server = $wan_server;
644 0 $clean_wan_server =~ s{^https?://}{};
645 0 ▶ my $fallback_url = ($wan_port eq '443' || $wan_port eq '80')
Branch: 1 branch
BranchTrueFalseTotal
$wan_port eq '443' || $wan_port eq '80' ? : 0 0 0
Condition0%0/3
$wan_port eq 443 or $wan_port eq 80
l!l&&r!l&&!r
000
MC/DC0%0/2
$wan_port eq 443 or $wan_port eq 80
$wan_port eq 443 $wan_port eq 80
Truth table0%0/3
A or B
A= $wan_port eq 443B= $wan_port eq 80
ABresult
1X1
011
000
646 ? "$wan_scheme://$clean_wan_server/clone_voice_audio"
647 : "$wan_scheme://$clean_wan_server:$wan_port/clone_voice_audio";
648  
649 0 my $fb_req = HTTP::Request->new ('POST', $fallback_url);
650 0 $fb_req->header ('Content-Type' => 'application/json');
651 0 $fb_req->header ('Accept' => 'audio/wav');
652 0 $fb_req->content ($req_json);
653 0 $res = $ua->request ($fb_req);
654 }
655 0 ▶ if ($res->is_success) {
Branch: 1 branch
BranchTrueFalseTotal
if ($res->is_success) { } 0 0 0
656 0 my ($fh, $filename) = tempfile (SUFFIX => '.wav', UNLINK => 0);
657 0 binmode $fh;
658 0 print $fh $res->content;
659 0 close $fh;
660  
661 0 my $os = $^O;
662 0 ▶ if ($os eq 'darwin') {
Branch: 2 branches
BranchTrueFalseTotal
if ($os eq 'darwin') { } 0 0 0
elsif ($os eq 'MSWin32' or $os eq 'cygwin') { } 0 0 0
663 0 system ("afplay \"$filename\"");
664 ▶ } elsif ($os eq 'MSWin32' || $os eq 'cygwin') {
Condition0%0/3
$os eq "MSWin32" or $os eq "cygwin"
l!l&&r!l&&!r
000
MC/DC0%0/2
$os eq "MSWin32" or $os eq "cygwin"
$os eq "MSWin32" $os eq "cygwin"
Truth table0%0/3
A or B
A= $os eq "MSWin32"B= $os eq "cygwin"
ABresult
1X1
011
000
665 0 my $cmd_wav =
666 "powershell -c (New-Object Media.SoundPlayer '$filename').PlaySync()";
667 0 ▶ system ($cmd_wav) == 0 or system ("play -q \"$filename\"");
Branch: 1 branch
BranchTrueFalseTotal
system($cmd_wav) == 0 or system qq[play -q "$filename"] 0 0 0
668 } else {
669 0 ▶ my $player =
Branch: 2 branches
BranchTrueFalseTotal
-x '/usr/bin/paplay' ? : 0 0 0
-x '/bin/paplay' ? : 0 0 0
670 -x '/usr/bin/paplay'
671 ? 'paplay'
672 : (-x '/bin/paplay' ? 'paplay' : 'play -q');
673 0 my $lock_file = '/tmp/.speak_playback.lock';
674 0 my $lock_fh;
675 0 ▶ if (open $lock_fh, '>>', $lock_file) {
Branch: 1 branch
BranchTrueFalseTotal
if (open $lock_fh, ">>", $lock_file) 0 0 0
676 0 flock ($lock_fh, LOCK_EX);
677 }
678 0 system ("$player \"$filename\"");
679 0 select (undef, undef, undef, 0.25);
680 0 ▶ if ($lock_fh) {
Branch: 1 branch
BranchTrueFalseTotal
if ($lock_fh) 0 0 0
681 0 flock ($lock_fh, LOCK_UN);
682 0 close $lock_fh;
683 }
684 } ## end else [ if ($os eq 'darwin') ]
685 0 unlink $filename;
686 0 return;
687 } else {
688 0 carp "Failed to fetch TTS from $url: " . $res->status_line;
689 0 $msg = "Warning - could not reach $server. " . $msg;
690 0 $persona = undef; # clear persona so it falls through to Google TTS
691 }
692 } ## end else [ if (hostname () eq $server)]
693 } ## end if ($server && $port)
694  
695 6 ▶ if ($persona) {
Branch: 1 branch
BranchTrueFalseTotal
if ($persona) 0 6 6
696 0 say_persona (undef, $msg, $persona, $output_file);
697 0 return;
698 }
699  
700 # New Implementation
701 6 my $ua = LWP::UserAgent->new;
702 6 $ua->agent ("Mozilla/5.0");
703  
704 # Determine language:
705 # 1. Argument $lang
706 # 2. Environment variable SPEAK_LANG
707 # 3. Config file
708 # 4. Default 'en'
709  
710 6 ▶ unless ($lang) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($lang) 6 0 6
711 6 ▶ $lang = $ENV{SPEAK_LANG} || $sys_conf{language} || 'en';
Condition40%2/5
$ENV{'SPEAK_LANG'} || $sys_conf{'language'} || 'en'
l!l
06
$ENV{"SPEAK_LANG"} or $sys_conf{"language"}
l!l&&r!l&&!r
006
MC/DC0%0/2
$ENV{'SPEAK_LANG'} || $sys_conf{'language'} || 'en'
$ENV{"SPEAK_LANG"} $sys_conf{"language"}
Truth table33%1/3
A or B
A= $ENV{"SPEAK_LANG"}B= $sys_conf{"language"}
ABresult
1X1
011
000
712 }
713  
714 6 my @sentences = _split_text ($msg);
715 6 my @mp3_files;
716 my @valid_sentences;
717  
718 6 foreach my $sentence (@sentences) {
719 6 ▶ next unless $sentence =~ /\S/;
Branch: 1 branch
BranchTrueFalseTotal
unless $sentence =~ /\S/ 0 6 6
720  
721 6 my $mp3_data = _fetch_mp3 ($ua, $sentence, $lang);
722 6 ▶ next unless $mp3_data;
Branch: 1 branch
BranchTrueFalseTotal
unless $mp3_data 6 0 6
723  
724 0 my ($fh, $filename) = tempfile (SUFFIX => '.mp3', UNLINK => 0);
725 0 binmode $fh;
726 0 print $fh $mp3_data;
727 0 close $fh;
728  
729 0 push @mp3_files, $filename;
730 0 push @valid_sentences, $sentence;
731 } ## end foreach my $sentence (@sentences)
732  
733 6 ▶ if (@mp3_files) {
Branch: 1 branch
BranchTrueFalseTotal
if (@mp3_files) 0 6 6
734  
735 # Combine or play sequentially
736 # Using 'sox' to play directly or concatenate would be better,
737 # but for compatibility with existing 'play' command:
738  
739 # Concatenate using sox if multiple files
740 0 my $final_file;
741 0 ▶ if (@mp3_files > 1) {
Branch: 1 branch
BranchTrueFalseTotal
if (@mp3_files > 1) { } 0 0 0
742  
743 # Trim boundary silences for artificial (non-punctuation) splits
744 0 ▶ for (my $i = 0; $i < $#mp3_files; $i++) {
Branch: 1 branch
BranchTrueFalseTotal
if ($i < $#mp3_files) 0 0 0
745 0 my $sentence = $valid_sentences[$i];
746 0 ▶ if ($sentence !~ /[.!?;]$/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($sentence =~ /[.!?;]$/) 0 0 0
747  
748 # Trim trailing silence of $mp3_files[$i]
749 0 my ($fh_t, $trimmed_t) = tempfile (SUFFIX => '.mp3', UNLINK => 0);
750 0 close $fh_t;
751 0 ▶ if (
Branch: 1 branch
BranchTrueFalseTotal
if (system(qq[sox "$mp3_files[$i]" "$trimmed_t" reverse silence 1 0.01 1% reverse]) == 0) { } 0 0 0
752 system (
753 "sox \"$mp3_files[$i]\" \"$trimmed_t\" reverse silence 1 0.01 1% reverse"
754 ) == 0
755 )
756 {
757 0 unlink $mp3_files[$i];
758 0 $mp3_files[$i] = $trimmed_t;
759 } else {
760 0 unlink $trimmed_t;
761 }
762 } ## end if ($sentence !~ /[.!?;]$/)
763 } ## end for (my $i = 0; $i < $#mp3_files...)
764  
765 0 my ($fh, $joined) = tempfile (SUFFIX => '.mp3', UNLINK => 0);
766 0 close $fh;
767 0 $final_file = $joined;
768  
769 # Using system sox to join.
770 # Note: This requires sox with mp3 handler.
771 0 my $cmd = "sox " . join (" ", @mp3_files) . " $final_file";
772 0 system ($cmd);
773 } else {
774 0 $final_file = $mp3_files[0];
775 }
776  
777 # Play it
778 0 ▶ if (-f $final_file) {
Branch: 1 branch
BranchTrueFalseTotal
if (-f $final_file) 0 0 0
779 0 ▶ if ($ENV{DEBUG_SPEAK}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($ENV{"DEBUG_SPEAK"}) 0 0 0
780 0 print "File info for $final_file:\n";
781 0 system ("ls -l $final_file");
782 0 system ("file $final_file");
783 }
784  
785 # Cross-platform playback logic
786 0 my $os = $^O;
787  
788 0 ▶ if ($os eq 'darwin') {
Branch: 2 branches
BranchTrueFalseTotal
if ($os eq 'darwin') { } 0 0 0
elsif ($os eq 'MSWin32' or $os eq 'cygwin') { } 0 0 0
789  
790 # macOS
791 0 system ("afplay \"$final_file\"");
792 ▶ } elsif ($os eq 'MSWin32' || $os eq 'cygwin') {
Condition0%0/3
$os eq "MSWin32" or $os eq "cygwin"
l!l&&r!l&&!r
000
MC/DC0%0/2
$os eq "MSWin32" or $os eq "cygwin"
$os eq "MSWin32" $os eq "cygwin"
Truth table0%0/3
A or B
A= $os eq "MSWin32"B= $os eq "cygwin"
ABresult
1X1
011
000
793  
794 # Windows / Cygwin
795 # Use powershell for headless playback if available, or start
796 # Note: 'start' might pop up a window.
797 # Cygwin often has 'play' (sox) as well.
798  
799 # Try PowerShell first as it's cleaner
800 0 my $win_path = $final_file;
801 0 ▶ if ($os eq 'cygwin') {
Branch: 1 branch
BranchTrueFalseTotal
if ($os eq "cygwin") 0 0 0
802 0 chomp ($win_path = `cygpath -w "$final_file"`);
803 }
804  
805 # Use PowerShell to play audio hidden
806 # System.Media.SoundPlayer only supports WAV, so convert MP3 -> WAV first
807 0 my ($fh_wav, $wav_file) = tempfile (SUFFIX => '.wav', UNLINK => 0);
808 0 close $fh_wav;
809  
810 # Convert to WAV using sox
811 0 ▶ if (system ("sox \"$final_file\" \"$wav_file\"") == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (system(qq[sox "$final_file" "$wav_file"]) == 0) { } 0 0 0
812 0 my $wav_win_path = $wav_file;
813 0 ▶ if ($os eq 'cygwin') {
Branch: 1 branch
BranchTrueFalseTotal
if ($os eq "cygwin") 0 0 0
814 0 chomp ($wav_win_path = `cygpath -w "$wav_file"`);
815 }
816  
817 0 my $cmd_wav =
818 "powershell -c (New-Object Media.SoundPlayer '$wav_win_path').PlaySync()";
819 0 ▶ if (system ($cmd_wav) != 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (system($cmd_wav) != 0) 0 0 0
820  
821 # Fallback
822 0 system ("play -q \"$final_file\"");
823 }
824 0 unlink $wav_file;
825 } else {
826  
827 # Conversion failed logic fallback
828 0 my $cmd =
829 "powershell -c (New-Object Media.SoundPlayer '$win_path').PlaySync()";
830 0 ▶ if (system ($cmd) != 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (system($cmd) != 0) 0 0 0
831  
832 # Fallback to sox 'play' if powershell fails
833 0 system ("play -q \"$final_file\"");
834 }
835 } ## end else [ if (system ("sox \"$final_file\" \"$wav_file\""...))]
836 } else {
837  
838 # Linux / Unix
839 # paplay often requires WAV if libsndfile lacks mp3 support (e.g. on Mars)
840 # We convert to WAV to be safe.
841 0 my $lock_file = '/tmp/.speak_playback.lock';
842 0 my $lock_fh;
843 0 ▶ if (open $lock_fh, '>>', $lock_file) {
Branch: 1 branch
BranchTrueFalseTotal
if (open $lock_fh, ">>", $lock_file) 0 0 0
844 0 flock ($lock_fh, LOCK_EX);
845 }
846 0 ▶ if (-x '/usr/bin/paplay' || -x '/bin/paplay') {
Branch: 1 branch
BranchTrueFalseTotal
if (-x '/usr/bin/paplay' or -x '/bin/paplay') { } 0 0 0
Condition0%0/3
-x "/usr/bin/paplay" or -x "/bin/paplay"
l!l&&r!l&&!r
000
MC/DC0%0/2
-x "/usr/bin/paplay" or -x "/bin/paplay"
-x "/usr/bin/paplay" -x "/bin/paplay"
Truth table0%0/3
A or B
A= -x "/usr/bin/paplay"B= -x "/bin/paplay"
ABresult
1X1
011
000
847 0 my ($fh_wav, $wav_file) = tempfile (SUFFIX => '.wav', UNLINK => 0);
848 0 close $fh_wav;
849  
850 # Convert to WAV
851 0 ▶ if (_convert_mp3_to_wav ($final_file, $wav_file)) {
Branch: 1 branch
BranchTrueFalseTotal
if (_convert_mp3_to_wav($final_file, $wav_file)) { } 0 0 0
852 0 system ("paplay \"$wav_file\"");
853 0 unlink $wav_file;
854 } else {
855  
856 # Conversion failed, try playing mp3 directly
857 0 system ("paplay \"$final_file\"");
858 }
859 } else {
860 0 system ("play -q $final_file");
861 }
862 0 select (undef, undef, undef, 0.25);
863 0 ▶ if ($lock_fh) {
Branch: 1 branch
BranchTrueFalseTotal
if ($lock_fh) 0 0 0
864 0 flock ($lock_fh, LOCK_UN);
865 0 close $lock_fh;
866 }
867 } ## end else [ if ($os eq 'darwin') ]
868  
869 0 unlink $final_file;
870 } ## end if (-f $final_file)
871 ## end if (-f $final_file)
872 } ## end if (@mp3_files)
873  
874 # Cleanup temp files
875 6 unlink @mp3_files;
876  
877 6 return;
878 } # speak
879  
880 =head2 say_persona($self, $text, $persona)
881  
882 Experimental subroutine that requires an MCP server.
883 Converts the given C<$text> to speech using the specified C<$persona> voice.
884  
885 =over
886  
887 =item C<$self>
888  
889 Object reference (if called as a method) or class name.
890  
891 =item C<$text>
892  
893 The text message to be spoken.
894  
895 =item C<$persona>
896  
897 The persona name to use for the voice. The system will look for a file named C<lc($persona)> with extensions like .mp3, .wav, or .flac in the voices directory. If not found, it defaults to C<default.mp3>.
898  
899 =back
900  
901 =cut
902  
903 0 ▶sub say_persona {
Subroutine say_persona: not called CC=9 SCAR=45.0
Pod documented
904  
905 # Experimental - requires MCP server
906 0 my ($self, $text, $persona, $output_file) = @_;
907  
908 # Handle positional invocation if not called as method
909 0 ▶ if (defined $self && !ref $self && $self !~ /^\// && length $self > 0 && !defined $persona) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $self and not ref $self and not $self =~ m[^/] and length $self > 0 and not defined $persona) 0 0 0
Condition0%0/12
defined $self and not ref $self and not $self =~ m[^/] and length $self > 0 and not defined $persona
!ll&&!rl&&r
000
defined $self and not ref $self and not $self =~ m[^/] and length $self > 0
!ll&&!rl&&r
000
defined $self and not ref $self and not $self =~ m[^/]
!ll&&!rl&&r
000
defined $self and not ref $self
!ll&&!rl&&r
000
MC/DC0%0/5
defined $self and not ref $self and not $self =~ m[^/] and length $self > 0 and not defined $persona
defined $self not ref $self not $self =~ m[^/] length $self > 0 not defined $persona
Truth table0%0/6
A and not(B) and not(C) and D and not(E)
A= defined $selfB= not ref $selfC= not $self =~ m[^/]D= length $self > 0E= not defined $persona
ABCDEresult
0XXXX0
10XXX0
110XX0
1110X0
111100
111111
910 0 $output_file = $persona;
911 0 $persona = $text;
912 0 $text = $self;
913 }
914  
915 0 my $mcp_client = '/opt/tts/mcp_client.pl';
916  
917 0 ▶ unless (-x $mcp_client) {
Branch: 1 branch
BranchTrueFalseTotal
unless (-x $mcp_client) 0 0 0
918 0 carp "Warning: MCP client not found or not executable at $mcp_client";
919 0 return;
920 }
921  
922 0 my @cmd = ($mcp_client, "--text", $text);
923 0 ▶ if ($persona) {
Branch: 1 branch
BranchTrueFalseTotal
if ($persona) 0 0 0
924 0 push @cmd, "--voice", $persona;
925 }
926 0 ▶ if ($output_file) {
Branch: 1 branch
BranchTrueFalseTotal
if ($output_file) 0 0 0
927 0 push @cmd, "--output", $output_file;
928 0 push @cmd, "--keep";
929 }
930  
931 0 system (@cmd);
932  
933 0 return;
934 } ## end sub say_persona
935  
936 6 1;
937  
938 =pod
939  
940 =head1 CONFIGURATION AND ENVIRONMENT
941  
942 SPEAK_LANG: Language code (e.g. 'en', 'en-gb', 'en-au').
943 See etc/speak.conf for available languages.
944 Defaults to $ENV{SPEAK_LANG} or 'en'.
945  
946 SPEAK_PERSONA: Default persona to use for the voice (e.g. 'Arnold').
947 If set, the MCP TTS engine is used by default.
948  
949 SPEAK_SERVER: MCP TTS primary server hostname or IP address.
950  
951 SPEAK_PORT: MCP TTS primary server port number.
952  
953 SPEAK_WAN_SERVER: MCP TTS WAN/external server hostname for failover when off-LAN.
954  
955 SPEAK_WAN_PORT: MCP TTS WAN/external server port number (defaults to 443).
956  
957 SPEAK_WAN_SCHEME: MCP TTS WAN/external server scheme ('https' or 'http').
958  
959 SPEAK_MUTE: If set to a true value, speech output is muted.
960 Alternatively, if a file exists at $ENV{HOME}/.speak/shh
961 or /etc/speak/shh, speech is muted.
962  
963 To silence Speak for while simply touch $ENV{HOME}/.speak/shh
964 or /etc/speak/shh file. To unsilence Speak, remove the file.
965  
966 =head2 Configuration File
967  
968 Speak supports a configuration file located at $ENV{HOME}/.speak/speak.conf
969 or /etc/speak/speak.conf.
970  
971 Format:
972 language: en-gb
973 # other options...
974  
975 Supported keys:
976 language - Default language code for speech generation.
977 persona - Default persona to use for the MCP voice engine.
978 server - MCP server hostname or IP address.
979 port - MCP server port number.
980 wan_server - Public WAN server hostname for failover when off-LAN.
981 wan_port - Public WAN server port number.
982 wan_scheme - Public WAN URL scheme (http/https).
983  
984 =head1 DEPENDENCIES
985  
986 =head2 Perl Modules
987  
988 L<Clipboard|Clipboard>
989  
990 L<LWP::UserAgent|LWP::UserAgent>
991  
992 L<URI::Escape|URI::Escape>
993  
994 =head1 BUGS AND LIMITATIONS
995  
996 There are no known bugs in this module.
997  
998 Please report problems to Andrew DeFaria <Andrew@DeFaria.com>.
999  
1000 =head1 LICENSE AND COPYRIGHT
1001  
1002 This Perl Module is freely available; you can redistribute it and/or
1003 modify it under the terms of the GNU General Public License as
1004 published by the Free Software Foundation; either version 2 of the
1005 License, or (at your option) any later version.
1006  
1007 This Perl Module is distributed in the hope that it will be useful,
1008 but WITHOUT ANY WARRANTY; without even the implied warranty of
1009 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1010 General Public License (L<http://www.gnu.org/copyleft/gpl.html>) for more
1011 details.
1012  
1013 You should have received a copy of the GNU General Public License
1014 along with this Perl Module; if not, write to the Free Software Foundation,
1015 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
1016 reserved.
1017  
1018 =cut
↑ Summary bin/speak »