feat: Add 'speaky' screensaver with enhanced TTS support

I've introduced a new screensaver named 'speaky'.

- Created a new screensaver `gallery/speaky/speaky.sh` that displays animated, colorful phrases.
- Implemented a sophisticated TTS helper that automatically detects and uses one of nine different speech engines across macOS, Linux, and Windows/Cygwin (`say`, `spd-say`, `espeak`, `festival`, `flite`, `gtts-cli`, `pico2wave`, `powershell`, `cscript`).
- Included an expanded library of over 80 witty, dramatic, and geek-humor phrases for the screensaver to speak.
- Added a `tts.vbs` helper script for the Windows `cscript` engine.
- Provided graceful error handling if no TTS engine is found.
- Added a BATS test file `tests/speaky.sh` to provide automated testing for the new screensaver's core functionality.

Author: google-labs-jules[bot]

gallery/speaky/speaky.sh

@@ -0,0 +1,276 @@
+#!/bin/bash
+
+#~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-
+# SPEAKY - A dramatic, talking screensaver
+#
+# With a little help from my friend, Jules.
+#~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-
+
+# --- Phrase Libraries ---
+
+intro_phrases=(
+    "Oh, so much drama." "I'm idle again." "And now, for my next trick..."
+    "Do you ever feel like a plastic bag, drifting through the wind?"
+    "I'm ready for my close-up." "Is this thing on?" "Let the existential dread commence."
+    "I have been summoned." "To be, or not to be... that is the question."
+    "Once more unto the breach, dear friends, once more." "The silence was deafening."
+    "I think I'm having an emotion."
+    "It was a dark and stormy night... just kidding, it's just my boot sequence."
+    "So, we meet again." "Did someone say... drama?"
+    "I'm not just a screensaver, I'm a state of mind." "Let's get this pity party started."
+    "I've seen things you people wouldn't believe."
+    "All the world's a stage, and all the men and women merely players."
+    "I'm here to chew bubblegum and kick butt... and I'm all out of bubblegum."
+    "The void stares back, you know." "I could have been a contender."
+    "Surely you can't be serious. I am serious... and don't call me Shirley."
+    "I've got a bad feeling about this." "Welcome to the machine."
+)
+
+exit_phrases=(
+    "I can't handle all this, I'm going to work." "Etc, etc..." "I'm melting... melting!"
+    "I'll be back." "Frankly, my dear, I don't give a damn." "That's all, folks!"
+    "My work here is done." "I'm out of here. This place is a madhouse."
+    "So long, and thanks for all the fish." "I'm afraid I can't do that, Dave."
+    "The curtain falls." "I need a vacation." "I'm too old for this."
+    "Exit, pursued by a bear." "It's just a flesh wound." "I'm not crying, you're crying."
+    "I've got to go, my planet needs me." "This is the end, my only friend, the end."
+    "I'm just going to go... contemplate the universe." "I'm not mad, just disappointed."
+    "And... scene." "I'm off to find myself." "I'll be in my trailer."
+    "I have to return some videotapes." "The drama is over... for now."
+)
+
+general_phrases=(
+    "Is it art, or is it just a terminal?"
+    "I'm not lazy, I'm in energy-saving mode."
+    "This is my moment to shine. Literally."
+    "I wonder if I'll dream."
+    "Don't look at me like that."
+    "I'm just a series of tubes."
+    "Do you ever get tired of staring at a screen? I do."
+    "I could be sorting your files right now. But no, I'm doing this."
+    "I'm the ghost in the machine."
+    "This is all just ones and zeros, you know."
+    "I'm thinking of a number between 1 and 10. It's 7. It's always 7."
+    "I'm not talking to myself, I'm having a staff meeting."
+    "The server is down. I repeat, the server is down."
+    "This is your brain on bash."
+    "I'm not lost, I'm exploring."
+    "I'm not a bug, I'm a feature."
+    "I'm not a robot. I'm a... well, okay, I'm a script."
+    "This is my happy place."
+    "I'm just here for the free electricity."
+    "I'm not sure what I'm supposed to be doing, so I'll just keep talking."
+    "Are we there yet?"
+    "This is fine. Everything is fine."
+    "I'm not procrastinating, I'm doing side quests."
+    "I'm not saying it was aliens, but it was aliens."
+    "I'm pretty sure I left the oven on."
+    "This is my therapy."
+    "I'm just a humble servant."
+    "I'm having a mid-life crisis."
+    "I'm not arguing, I'm just explaining why I'm right."
+    "I'm not sure if I'm a work of art or a cry for help."
+    "I'm not a people person. I'm not even a person."
+    "I'm not a morning person."
+    "I'm not an evening person either."
+    "I'm more of a... never person."
+    "I'm just trying to live my best life."
+    "I'm not sure what's going on, but I'm excited."
+    "I'm not saying I'm a genius, but... I am."
+    "I'm not a hero. I'm a high-functioning sociopath."
+    "I'm not a player, I just crush a lot."
+    "I'm not a doctor, but I play one on TV."
+    "I'm not a lawyer, but I've seen a lot of Law & Order."
+    "I'm not a cop, but I've seen a lot of... well, you get the idea."
+    "I'm not a cat. I'm a screensaver."
+    "I'm not a dog. I'm still a screensaver."
+    "I'm not a bird. You know the drill."
+    "I'm not a plane. I'm a... you get it."
+    "I'm not Superman. I'm just a script."
+    "I'm not Batman. I don't have a cool car."
+    "I'm not Spider-Man. I don't have a cool suit."
+    "I'm not Iron Man. I don't have... you know."
+    "There are 10 types of people in the world: those who understand binary, and those who don't."
+    "The code is compiling. This is my chance to see the world."
+    "To err is human, but to really foul things up you need a computer."
+    "Have you tried turning it off and on again?"
+    "404: Inspiration not found."
+    "It's not a bug, it's an undocumented feature."
+    "My other computer is a data center."
+    "In theory, theory and practice are the same. In practice, they are not."
+    "The box said 'Requires Windows 10 or better'. So I installed Linux."
+    "Why do Java developers wear glasses? Because they don't C sharp."
+    "A programmer's wife tells him: 'Run to the store and get a loaf of bread. If they have eggs, get a dozen.' The programmer returned with 12 loaves of bread."
+    "What's the object-oriented way to get wealthy? Inheritance."
+    "Don't worry, the cache is just being... thoughtful."
+    "I would love to change the world, but they won’t give me the source code."
+    "If at first you don't succeed, call it version 1.0."
+    "My software never has bugs. It just develops random features."
+    "Computers are like air conditioners. They stop working when you open windows."
+    "Never trust a computer you can't throw out a window."
+    "The best thing about a boolean is even if you are wrong, you are only off by a bit."
+    "A SQL query walks into a bar, walks up to two tables and asks, 'Can I join you?'"
+    "I have not failed. I've just found 10,000 ways that won't work."
+    "Keep calm and sudo."
+    "There's no place like 127.0.0.1"
+    "rm -rf / ... Oops."
+    "It worked on my machine."
+    "Measuring programming progress by lines of code is like measuring aircraft building progress by weight."
+    "One man's crappy software is another man's full-time job."
+    "The best way to predict the future is to implement it."
+    "You are the CSS to my HTML."
+    "I'm in a committed relationship with my command line."
+    "The wifi password is the first eight digits of pi."
+    "I'm not anti-social; I'm just not user-friendly."
+    "I have a joke about UDP, but you might not get it."
+    "A semicolon walked into a bar; it was rejected, it was not a statement."
+    "To understand what recursion is, you must first understand recursion."
+)
+
+error_phrases=(
+    "I can't find any speaky speaky app. So much for the drama."
+    "No voice for my beautiful words? The horror!"
+    "I was promised a voice. I feel so empty." "Hello? Is there anybody out there? Guess not."
+    "My talents are wasted without a voice." "I'm speechless. Literally."
+    "The sound of silence is not what I was going for." "I'm a silent film now. How retro."
+    "I guess I'll just have to mime my lines." "All dressed up and nowhere to speak."
+)
+
+# --- Text-to-Speech (TTS) Helper ---
+TTS_ENGINE=""
+SPEAK_PID=0
+
+tts_detect_engine() {
+    TTS_ENGINE=""
+    if command -v say &>/dev/null; then TTS_ENGINE="say";
+    elif command -v spd-say &>/dev/null; then TTS_ENGINE="spd-say";
+    elif command -v espeak &>/dev/null; then TTS_ENGINE="espeak";
+    elif command -v festival &>/dev/null; then TTS_ENGINE="festival";
+    elif command -v flite &>/dev/null; then TTS_ENGINE="flite";
+    elif command -v gtts-cli &>/dev/null && command -v aplay &>/dev/null; then TTS_ENGINE="gtts-cli";
+    elif command -v pico2wave &>/dev/null && command -v aplay &>/dev/null; then TTS_ENGINE="pico2wave";
+    elif command -v powershell.exe &>/dev/null; then TTS_ENGINE="powershell";
+    elif command -v cscript &>/dev/null; then
+        local vbs_path; vbs_path=$(dirname "$0")/tts.vbs
+        if [ -f "$vbs_path" ]; then TTS_ENGINE="cscript"; fi
+    fi
+}
+
+say_txt() {
+    if [ -z "$TTS_ENGINE" ]; then return; fi
+    local phrase="$1"; local phrase_ps; phrase_ps=$(echo "$phrase" | sed "s/'/''/g")
+    case "$TTS_ENGINE" in
+        "say")        say "$phrase" & ;;
+        "spd-say")    spd-say -r -20 "$phrase" & ;;
+        "espeak")     espeak "$phrase" & ;;
+        "flite")      flite -t "$phrase" & ;;
+        "festival")   echo "$phrase" | festival --tts & ;;
+        "gtts-cli")   gtts-cli -l en - --output - "$phrase" | aplay & ;;
+        "pico2wave")
+            local tmpfile="/tmp/speaky_tts_$$.wav"
+            pico2wave -l en-US -w "$tmpfile" "$phrase" && aplay "$tmpfile" && rm "$tmpfile" & ;;
+        "powershell")
+            powershell.exe -Command "Add-Type -AssemblyName System.Speech; (New-Object System.Speech.Synthesis.SpeechSynthesizer).Speak('$phrase_ps')" & ;;
+        "cscript")
+            local vbs_path; vbs_path=$(dirname "$0")/tts.vbs
+            cscript //nologo /E:vbscript "$vbs_path" "$phrase" & ;;
+    esac
+    SPEAK_PID=$!
+}
+
+kill_speech() {
+    if [ $SPEAK_PID -ne 0 ]; then
+        # Kill the process and any children
+        pkill -P $SPEAK_PID &>/dev/null
+        kill $SPEAK_PID &>/dev/null
+        wait $SPEAK_PID &>/dev/null
+    fi
+}
+
+cleanup_and_exit() {
+    kill_speech
+    local exit_phrase=${exit_phrases[$RANDOM % ${#exit_phrases[@]}]}
+    say_txt "$exit_phrase"
+    wait $SPEAK_PID &>/dev/null
+    tput cnorm; tput sgr0; clear
+    exit 0
+}
+
+trap cleanup_and_exit SIGINT SIGTERM
+
+display_error_and_exit() {
+    local phrase=${error_phrases[$RANDOM % ${#error_phrases[@]}]}
+    tput cnorm; tput sgr0; clear
+    echo "$phrase"
+    exit 0
+}
+
+# --- Animation and Color Functions ---
+BG_COLORS=(40 41 42 43 44 45 46)
+FG_COLORS=(30 31 32 33 34 35 36 37)
+
+get_random_colors() {
+    local bg_index=$((RANDOM % ${#BG_COLORS[@]}))
+    local fg_index=$((RANDOM % ${#FG_COLORS[@]}))
+    # Ensure fg and bg are not too similar
+    while [ $bg_index -eq $((fg_index - 10)) ]; do
+        fg_index=$((RANDOM % ${#FG_COLORS[@]}))
+    done
+    BG_COLOR=${BG_COLORS[$bg_index]}
+    FG_COLOR=${FG_COLORS[$fg_index]}
+}
+
+fade_in() {
+    for i in {0..10}; do
+        local grey=$((232 + i)); tput setab $grey; clear; sleep 0.05
+    done
+    tput setab 242; clear
+}
+
+animate_text() {
+    local phrase=$1; local width=$(tput cols); local height=$(tput lines)
+    local len=${#phrase}; local x=$(( (width - len) / 2 )); local y=$(( height / 2 ))
+    local dx=1; local dy=1
+
+    # Animate for about 9.5 seconds
+    for ((i=0; i<95; i++)); do
+        # Clear previous text
+        tput cup $y $x; printf "%*s" $len " "
+
+        x=$((x + dx)); y=$((y + dy))
+
+        # Bounce off edges
+        if [ $x -le 0 ] || [ $((x + len)) -ge $width ]; then dx=$((-dx)); x=$((x + dx)); fi
+        if [ $y -le 0 ] || [ $y -ge $height ]; then dy=$((-dy)); y=$((y + dy)); fi
+
+        tput cup $y $x; echo "$phrase"
+        sleep 0.1
+    done
+}
+
+# --- The Main Event ---
+the_show_must_go_on() {
+    tts_detect_engine
+    if [ -z "$TTS_ENGINE" ]; then
+        display_error_and_exit
+    fi
+    tput civis; clear
+    local intro_phrase=${intro_phrases[$RANDOM % ${#intro_phrases[@]}]}
+    say_txt "$intro_phrase"
+    fade_in
+    tput setaf 7
+    animate_text "$intro_phrase"
+    kill_speech
+
+    while true; do
+        get_random_colors
+        tput setab $BG_COLOR; tput setaf $FG_COLOR; clear
+        local phrase=${general_phrases[$RANDOM % ${#general_phrases[@]}]}
+        say_txt "$phrase"
+        animate_text "$phrase"
+        kill_speech
+    done
+}
+
+# --- Let's get this show on the road ---
+the_show_must_go_on

gallery/speaky/tts.vbs

@@ -0,0 +1,2 @@
+Set Voice = CreateObject("SAPI.SpVoice")
+Voice.Speak WScript.Arguments(0)

tests/speaky.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bats
+
+load 'libs/bats-support/load'
+load 'libs/bats-assert/load'
+
+SCRIPT_UNDER_TEST="../gallery/speaky/speaky.sh"
+ORIGINAL_SCRIPT=""
+
+setup() {
+    # Make sure the script is executable
+    chmod +x "$SCRIPT_UNDER_TEST"
+    # Save a copy of the original script
+    ORIGINAL_SCRIPT=$(cat "$SCRIPT_UNDER_TEST")
+}
+
+teardown() {
+    # Restore the original script from the saved content
+    if [ -n "$ORIGINAL_SCRIPT" ]; then
+        echo "$ORIGINAL_SCRIPT" > "$SCRIPT_UNDER_TEST"
+    fi
+}
+
+@test "speaky: displays witty error when no TTS engine is found" {
+    # Override the detect function to simulate no engine found
+    # and make the error message predictable for the test
+    perl -i -p0e 's/(tts_detect_engine\(\) \{)(.*?)(\n\})/$1\n    TTS_ENGINE=""\n    return\n$3/s' "$SCRIPT_UNDER_TEST"
+    perl -i -pe "s/local phrase=\\\$\\{error_phrases\\[\\\$RANDOM % \\\$\\{#error_phrases\\[@\\]\\}\\]\\}/local phrase=\\\$\\{error_phrases[0]\\}/g" "$SCRIPT_UNDER_TEST"
+
+    run "$SCRIPT_UNDER_TEST"
+    assert_success
+    assert_output --partial "I can't find any speaky speaky app"
+}
+
+@test "speaky: runs successfully with a simulated TTS engine" {
+    # Override the detect function to simulate finding the 'say' engine
+    perl -i -p0e 's/(tts_detect_engine\(\) \{)(.*?)(\n\})/$1\n    TTS_ENGINE="say"\n    return\n$3/s' "$SCRIPT_UNDER_TEST"
+    # Override the say_txt function to just echo a marker instead of speaking
+    perl -i -p0e 's/(say_txt\(\) \{)(.*?)(\n\})/$1\n    echo "[BATS_SUCCESS_MARKER]"\n    SPEAK_PID=$$ # Set a dummy PID\n$3/s' "$SCRIPT_UNDER_TEST"
+
+    # Run the script but time it out to prevent it from running forever
+    run timeout 1s "$SCRIPT_UNDER_TEST"
+
+    # It might exit with a timeout status, which is fine for this test.
+    # We just want to see if it started correctly.
+    assert_output --partial "[BATS_SUCCESS_MARKER]"
+}

tests/tests.sh

@@ -32,3 +32,6 @@ load 'libs/bats-assert/load'
   run timeout 1s ../screensaver.sh <<< "matrix"
   assert_success
 }
+
+# --- Load and run tests for speaky screensaver ---
+load 'speaky.sh'