From f18ff005f68528566a2cd8016d14cca106495c73 Mon Sep 17 00:00:00 2001
From: Markus Fleschutz <markus@fleschutz.de>
Date: Thu, 8 Apr 2021 13:06:38 +0200
Subject: [PATCH] Add speak-countdown.ps1

---
 Data/scripts.csv            |  1 +
 README.md                   |  1 +
 Scripts/speak-countdown.ps1 | 20 ++++++++++++++++++++
 3 files changed, 22 insertions(+)
 create mode 100755 Scripts/speak-countdown.ps1

diff --git a/Data/scripts.csv b/Data/scripts.csv
index a8c86a83..ef2c2b90 100644
--- a/Data/scripts.csv
+++ b/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)
diff --git a/README.md b/README.md
index eb6d3eac..6ed6477e 100644
--- a/README.md
+++ b/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)
diff --git a/Scripts/speak-countdown.ps1 b/Scripts/speak-countdown.ps1
new file mode 100755
index 00000000..efc99a67
--- /dev/null
+++ b/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
+}