Add speak-countdown.ps1

Data/scripts.csv

@@ -129,6 +129,7 @@ SHA256.ps1, prints the SHA256 checksum of the given file
 show-dir-tree.ps1, visualizes the given/current directory tree
 simulate-matrix.ps1, simulates the Matrix (fun)
 simulate-presence.ps1, simulates the human presence against burglars
+speak-countdown.ps1, speaks a countdown by text-to-speech (TTS)
 speak-date.ps1, speaks the current date by text-to-speech (TTS)
 speak-english.ps1, speaks the given text with an English text-to-speech (TTS) voice
 speak-epub.ps1, speaks the content of the given Epub file by text-to-speech (TTS)

README.md

@@ -12,6 +12,7 @@ Mega Collection of PowerShell Scripts
 * [play-mp3.ps1](Scripts/play-mp3.ps1) - plays the given sound file (MP3 file format)
 * [play-super-mario.ps1](Scripts/play-super-mario.ps1) - plays the Super Mario Intro
 * [play-the-imperial-march.ps1](Scripts/play-the-imperial-march.ps1) - plays the Imperial March (Star Wars)
+* [speak-countdown.ps1](Scripts/speak-countdown.ps1) - speaks a countdown by text-to-speech (TTS)
 * [speak-date.ps1](Scripts/speak-date.ps1) - speaks the current date by text-to-speech (TTS)
 * [speak-english.ps1](Scripts/speak-english.ps1) - speaks the given text with an English text-to-speech (TTS) voice
 * [speak-epub.ps1](Scripts/speak-epub.ps1) - speaks the content of the given Epub file by text-to-speech (TTS)

Scripts/speak-countdown.ps1

@@ -0,0 +1,20 @@
+#!/usr/bin/pwsh
+<#
+.SYNTAX       speak-countdown.ps1 [start-number]
+.DESCRIPTION  speaks a countdown by text-to-speech (TTS)
+.LINK         https://github.com/fleschutz/PowerShell
+.NOTES        Author: Markus Fleschutz / License: CC0
+#>
+
+param([int]$StartNumber = 10)
+
+try {
+	for ([int]$i = $StartNumber; $i -gt 0; $i--) {
+		& "$PSScriptRoot/speak-english.ps1" $i
+		start-sleep -milliseconds 1000
+	}
+	exit 0
+} catch {
+	write-error "ERROR: line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}