Add speak-checklist.ps1

Data/Checklists/handwashing.txt

@@ -0,0 +1,5 @@
+Wet your hands with clean, running water (warm or cold), turn off the tap, and apply soap.
+Lather your hands by rubbing them together with the soap. Lather the backs of your hands, between your fingers, and under your nails.
+Scrub your hands for at least 20 seconds. Need a timer? Hum the “Happy Birthday” song from beginning to end twice.
+Rinse your hands well under clean, running water.
+Dry your hands using a clean towel or air dry them.

Data/scripts.csv

@@ -168,6 +168,7 @@ SHA1.ps1, prints the SHA1 checksum of the given file
 SHA256.ps1, prints the SHA256 checksum of the given file
 simulate-matrix.ps1, simulates the Matrix (fun)
 simulate-presence.ps1, simulates the human presence against burglars
+speak-checklist.ps1, speaks the given checklist by text-to-speech (TTS)
 speak-countdown.ps1, starts 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

README.md

@@ -16,6 +16,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-checklist.ps1](Scripts/speak-checklist.ps1) - speaks the given checklist by text-to-speech (TTS)
 * [speak-countdown.ps1](Scripts/speak-countdown.ps1) - starts 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

Scripts/speak-checklist.ps1

@@ -0,0 +1,22 @@
+<#
+.SYNTAX       speak-checklist.ps1 [<name>]
+.DESCRIPTION  speaks the given checklist by text-to-speech (TTS)
+.LINK         https://github.com/fleschutz/PowerShell
+.NOTES        Author: Markus Fleschutz / License: CC0
+#>
+
+param($Name = "")
+if ($Name -eq "") { $Name = read-host "Enter the name of the checklist" }
+
+try {
+	$Lines = Get-Content -path "$PSScriptRoot/../Data/Checklists/$Name.txt"
+	foreach($Line in $Lines) {
+		"> $Line"
+		& "$PSScriptRoot/speak-english.ps1" "$Line"
+		$Dummy = read-host "Press <Return> to continue ..."
+	}
+	exit 0
+} catch {
+	write-error "⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}