PowerShell/Scripts/speak-english.ps1

35 lines
974 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.
2021-10-27 07:17:41 +02:00
Requires that an English TTS voice is installed.
2021-10-16 12:31:08 +02:00
.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-09-27 17:16:29 +02:00
$CurrentVoice = New-Object -ComObject SAPI.SPVoice
$Voices = $CurrentVoice.GetVoices()
foreach ($Voice in $Voices) {
if ($Voice.GetDescription() -notlike "*- English*") { continue }
$CurrentVoice.Voice = $Voice
[void]$CurrentVoice.Speak($text)
2021-09-27 10:09:45 +02:00
exit 0 # success
2021-02-08 19:32:45 +01:00
}
2021-09-16 20:19:10 +02: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
}