PowerShell/Scripts/speak-english.ps1

34 lines
883 B
PowerShell
Raw Normal View History

2021-09-27 10:38:12 +02:00
<#
2021-07-13 21:10:02 +02:00
.SYNOPSIS
2021-10-16 12:31:08 +02:00
Speaks text with an English text-to-speech voice
2021-10-04 21:29:23 +02:00
.DESCRIPTION
2021-10-16 12:31:08 +02:00
This scripts speaks the given text with an English text-to-speech (TTS) voice.
.PARAMETER text
Specifies the text to speak
2021-07-13 21:10:02 +02:00
.EXAMPLE
2021-09-27 08:35:45 +02:00
PS> ./speak-english "Hello World"
2021-08-29 17:50:03 +02:00
.NOTES
Author: Markus Fleschutz · License: CC0
2021-07-13 21:10:02 +02:00
.LINK
https://github.com/fleschutz/PowerShell
2021-02-08 19:32:45 +01:00
#>
2021-09-16 08:36:43 +02:00
param([string]$text = "")
2021-02-08 19:32:45 +01:00
try {
2021-09-16 08:36:43 +02:00
if ("$text" -eq "") { $text = read-host "Enter the English text to speak" }
2021-07-15 15:51:22 +02:00
2021-11-27 14:16:50 +01:00
$TTSVoice = New-Object -ComObject SAPI.SPVoice
foreach ($Voice in $TTSVoice.GetVoices()) {
2021-11-27 14:37:44 +01:00
if ($Voice.GetDescription() -like "*- English*") {
$TTSVoice.Voice = $Voice
[void]$TTSVoice.Speak($text)
exit 0 # success
}
2021-02-08 19:32:45 +01:00
}
2021-11-27 14:37:44 +01:00
throw "No English text-to-speech voice found - please install one."
2021-02-08 19:32:45 +01:00
} catch {
2021-09-16 20:19:10 +02:00
"⚠️ Error: $($Error[0]) ($($MyInvocation.MyCommand.Name):$($_.InvocationInfo.ScriptLineNumber))"
2021-02-08 19:32:45 +01:00
exit 1
}