v0.0.7 - mystical

$ oe 'a quote about seven'

gemma3n:e2b generated the command:

echo "Seven is a number that holds a special place in the world, representing completeness, perfection, and the mystical.  It's a powerful symbol, often associated with wholeness and divine harmony."

✅ Valid command: echo
✅ Valid Bash Syntax

Run command (y/N)?

Author: attogram

README.md

@@ -22,25 +22,47 @@ cd bash-screensavers
 ./screensaver.sh
 ```
 ```
-Bash Screensavers v0.0.6
-
-  1. alpha
-  2. bouncing
-  3. cutesaver
-  4. fireworks
-  5. matrix
-  6. pipes
-  7. rain
-  8. speaky
-  9. stars
-  10. tunnel
+Bash Screensavers v0.0.7
+
+  1 . alpha        - colorful pixels, one at a time
+  2 . bouncing     - classic bouncing 'O's
+  3 . cutesaver    - infinite loop of cuteness
+  4 . fireworks    - Ooh! Aah! Pretty lights!
+  5 . matrix       - classic digital rain
+  6 . pipes        - classic maze of pipes
+  7 . rain         - soothing, gentle rain
+  8 . speaky       - dramatic talking screensaver
+  9 . stars        - twinkling starfield
+  10. tunnel       - fly into the digital tunnel
 
 (Press ^C to exit)
 
 Choose your screensaver:
+
 ```
 
-## Create Your Own Screensaver
+## Join the Community
+
+Have questions, ideas, or just want to chat? Join our Discord server!
+
+[**Join our Discord!**](https://discord.gg/BGQJCbYVBa)
+
+
+## Developers Guide
+
+### Contributing
+
+We welcome contributions!
+
+Feel free to fork the repo,
+create a new screensaver,
+fix a bug,
+make something better 
+and submit a pull request.
+
+Let's make the command line a more colorful place, one ASCII character at a time.
+
+### Create Your Own Screensaver
 
 Got an idea for a cool ASCII animation? Want to contribute to the collection? It's easy!
 
@@ -53,13 +75,6 @@ Got an idea for a cool ASCII animation? Want to contribute to the collection? It
 
 That's it! The main `screensaver.sh` script will automatically detect your new creation.
 
-### Codespaces
-
-* whip up a [Codespace from attogram/bash-screensavers](https://codespaces.new/attogram/bash-screensavers) 
-  for fun!
-
-## Guide for Developers and AI agents
-
 ### Project Overview
 
 * `./screensaver.sh` is the main menu script
@@ -69,8 +84,10 @@ That's it! The main `screensaver.sh` script will automatically detect your new c
     * Each screensaver has its own directory inside `./gallery`
         * The name of the directory is the name of the screensaver.
         * example: screensaver named 'foo' is in: `./gallery/foo`
-    * Each screensaver must have a run script in format 'name.sh'
+    * Each screensaver has a run script in format 'name.sh'
         * example: `./gallery/foo/foo.sh`
+    * Each screensaver has a config file with name, tagline, etc
+        * example: `./gallery/foo/config.sh`
 * `./tests` directory is the BATS test suite for this project
 * `./.github` directory is for GitHub Workflows for this project.
 
@@ -84,13 +101,23 @@ That's it! The main `screensaver.sh` script will automatically detect your new c
 ├─ gallery           # Welcome to the Gallery of Terminal Visualizations
 │   ├─ name          # I'm a screensaver, and I have my own directory!
 │   │   └─ name.sh   # I'm a screensaver, and I can run, run, run!
+│   │   └─ config.sh # Psst... want some free metadata?
 ├─ tests             # I gotta BATSy idea, we should test this stuff
 │   └─ tests.sh      # It can't be that bad, can it?
 └─ .github           # GitHub magic lives here
     └─ workflows
         └─ create.release.for.tag.yml
 ```
 
+### Style Suggestions
+
+* Indents **SHOULD** be whatever works for you
+* Functions and variables **SHOULD** be in `snake_case`
+* Super-duper important variables **SHOULD** be in `SCREAMING_SNAKE_CASE`
+* You **MUST** have fun
+    * Why use boring function names like `main()`
+      when `start_the_visual_pleasure()` is just a few more characters
+
 ### Requirements
 
 * Bash v3.2 for `./screensaver.sh`
@@ -99,29 +126,10 @@ That's it! The main `screensaver.sh` script will automatically detect your new c
   * Gracefully handle `^C` to clean up the terminal and `exit 0`
 * All shell scripts must have execute permission: `chmod +x *.sh`
 
-### Style Suggestions
-
-* Indents **SHOULD** be 2 spaces, but whatever works for you
-* `snake_case` for function names and variables
-* `SCREAMING_SNAKE_CASE` for super-duper important variables
-* You **MUST** have fun!
-    * Don't use boring function names like `main()`
-    * More fun are function names like `start_the_visual_pleasure()`
-
-## Contributing
-
-We welcome contributions!
-
-Feel free to fork the repo, create a new screensaver, and submit a pull request.
-
-Let's make the command line a more colorful place, one ASCII character at a time.
-
-## Join the Community
-
-Have questions, ideas, or just want to chat? Join our Discord server!
+### Codespaces
 
-[**Join our Discord!**](https://discord.gg/BGQJCbYVBa)
+* whip up a [Codespace from attogram/bash-screensavers](https://codespaces.new/attogram/bash-screensavers) for fun!
 
 ---
 
-*Made with ❤️ and a whole lot of bash.*
+*Made with ❤️ and a lot of bash.*

gallery/alpha/alpha.sh

@@ -3,12 +3,12 @@
 # alpha screensaver (optimized for speed)
 #
 
-SLEEPY_TIME="0.03" # Number of seconds of sleepy time between alpha-ness
+SLEEPY_TIME="0.7" # Number of seconds of sleepy time between alpha-ness
 
 _cleanup_and_exit() { # handler for SIGINT (Ctrl‑C)
   tput cnorm       # show the cursor again
   tput sgr0
-  clear
+  echo
   exit 0
 }
 
@@ -24,12 +24,12 @@ tput civis # no cursor
 
 while true; do
   # Get random location and color
-  local x=$((RANDOM % width + 1))
-  local y=$((RANDOM % height + 1))
-  local color_code=$((RANDOM % 256))
+  x=$((RANDOM % width + 1))
+  y=$((RANDOM % height + 1))
+  color_code=$((RANDOM % 256))
 
   # Build the string to print
-  local frame_buffer="\e[${y};${x}H\e[38;5;${color_code}m█"
+  frame_buffer="\e[${y};${x}H\e[38;5;${color_code}m█"
 
   # Print the frame
   printf '%b' "$frame_buffer"

gallery/alpha/config.sh

@@ -1,5 +1,5 @@
 name="alpha"
-tagline="Colorful pixels, one at a time"
+tagline="colorful pixels, one at a time"
 description="A simple screensaver that prints random colored blocks at random locations on the screen."
 authors="attogram"
 license="MIT"

gallery/bouncing/config.sh

@@ -1,5 +1,5 @@
 name="bouncing"
-tagline="Bouncing 'O's, a classic."
+tagline="classic bouncing 'O's"
 description="A classic screensaver effect with multiple objects bouncing off the edges of the terminal."
 authors="attogram"
 license="MIT"

gallery/cutesaver/config.sh

@@ -1,5 +1,5 @@
 name="cutesaver"
-tagline="An infinite loop of cuteness."
+tagline="infinite loop of cuteness"
 description="An ASCII screensaver of cuteness. A huge shoutout to some of the most wonderful cuties I know: Mispy, Catherine, Ninji, Fiora, __builtin_trap, Gewt, Hachidorii, Kwanre, Talen, Whitequark, Louise, Emma, Chris, Katnarine, Dirt, Nimby, Hoodie, Simon... and more!"
 authors="kestraI, attogram"
 license="MIT"

gallery/matrix/config.sh

@@ -1,5 +1,5 @@
 name="matrix"
-tagline="The classic digital rain."
+tagline="classic digital rain"
 description="A matrix-style screensaver with falling green characters. This version is optimized for speed."
 authors="attogram"
 license="MIT"

gallery/pipes/config.sh

@@ -1,5 +1,5 @@
 name="pipes"
-tagline="A classic, endless maze of pipes."
+tagline="classic maze of pipes"
 description="An animated pipes terminal screensaver. This is a classic, highly customizable screensaver."
 authors="Pipeseroni/pipes.sh contributors, Yu-Jie Lin, Matthew Simpson"
 license="MIT"

gallery/rain/config.sh

@@ -1,5 +1,5 @@
 name="rain"
-tagline="Soothing, gentle rain."
+tagline="soothing, gentle rain"
 description="A simple screensaver that simulates falling rain in your terminal."
 authors="attogram"
 license="MIT"

gallery/speaky/config.sh

@@ -1,5 +1,5 @@
 name="speaky"
-tagline="A dramatic, talking screensaver."
+tagline="dramatic talking screensaver"
 description="A screensaver that uses text-to-speech to deliver dramatic and humorous phrases, displaying each phrase at a random location on the screen."
 authors="Jules"
 license="MIT"

gallery/stars/config.sh

@@ -1,5 +1,5 @@
 name="stars"
-tagline="A twinkling starfield."
+tagline="twinkling starfield"
 description="A simple starfield screensaver that randomly places stars on the screen and makes them twinkle."
 authors="attogram"
 license="MIT"