firefly-meadow 0.1.0__tar.gz

firefly_meadow-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rahul Bantupalli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

firefly_meadow-0.1.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: firefly-meadow
+Version: 0.1.0
+Summary: A terminal ASCII firefly meadow. Wave your mouse, leave a rainbow trail.
+Author: Rahul Bantupalli
+License-Expression: MIT
+Keywords: terminal,ascii,game,fireflies,iterm,toy
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# firefly-meadow
+
+A tiny ASCII firefly meadow for your terminal. Move your mouse over the window:
+the grass rustles and fireflies burst out, leaving a rainbow trail behind your cursor.
+
+## Install and play
+
+```
+pip install firefly-meadow
+fireflies
+```
+
+Or run it without installing:
+
+```
+pipx run firefly-meadow
+# or
+uvx firefly-meadow
+```
+
+## Controls
+
+| Input        | What it does                 |
+|--------------|------------------------------|
+| Mouse move   | Disturb the grass, leave a trail of glowing fireflies |
+| Left click   | Big burst of fireflies       |
+| `c`          | Clear the screen             |
+| `q`/`Ctrl-C` | Quit                         |
+
+## Requirements
+
+- macOS or Linux (it uses `termios`, so no native Windows; WSL works)
+- A terminal with truecolor and mouse reporting: iTerm2, Kitty, WezTerm, Alacritty,
+  GNOME Terminal, and most modern terminals
+- Python 3.8+, no other dependencies
+
+Tips: make the window fullscreen for the best effect. In iTerm2, enable
+Preferences > Profiles > Terminal > "Report mouse clicks & drags" if the mouse
+does nothing. Inside tmux, turn on `set -g mouse on`.
+
+## License
+
+MIT

firefly_meadow-0.1.0/README.md

@@ -0,0 +1,43 @@
+# firefly-meadow
+
+A tiny ASCII firefly meadow for your terminal. Move your mouse over the window:
+the grass rustles and fireflies burst out, leaving a rainbow trail behind your cursor.
+
+## Install and play
+
+```
+pip install firefly-meadow
+fireflies
+```
+
+Or run it without installing:
+
+```
+pipx run firefly-meadow
+# or
+uvx firefly-meadow
+```
+
+## Controls
+
+| Input        | What it does                 |
+|--------------|------------------------------|
+| Mouse move   | Disturb the grass, leave a trail of glowing fireflies |
+| Left click   | Big burst of fireflies       |
+| `c`          | Clear the screen             |
+| `q`/`Ctrl-C` | Quit                         |
+
+## Requirements
+
+- macOS or Linux (it uses `termios`, so no native Windows; WSL works)
+- A terminal with truecolor and mouse reporting: iTerm2, Kitty, WezTerm, Alacritty,
+  GNOME Terminal, and most modern terminals
+- Python 3.8+, no other dependencies
+
+Tips: make the window fullscreen for the best effect. In iTerm2, enable
+Preferences > Profiles > Terminal > "Report mouse clicks & drags" if the mouse
+does nothing. Inside tmux, turn on `set -g mouse on`.
+
+## License
+
+MIT

firefly_meadow-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "firefly-meadow"
+version = "0.1.0"
+description = "A terminal ASCII firefly meadow. Wave your mouse, leave a rainbow trail."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Rahul Bantupalli" }]
+keywords = ["terminal", "ascii", "game", "fireflies", "iterm", "toy"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Environment :: Console",
+    "Topic :: Games/Entertainment",
+]
+
+[project.scripts]
+fireflies = "firefly_meadow.game:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

firefly_meadow-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

firefly_meadow-0.1.0/src/firefly_meadow/__init__.py

@@ -0,0 +1,3 @@
+"""firefly-meadow: a terminal ASCII firefly game."""
+
+__version__ = "0.1.0"

firefly_meadow-0.1.0/src/firefly_meadow/game.py

@@ -0,0 +1,251 @@
+#!/usr/bin/env python3
+"""
+firefly_meadow - a tiny ASCII firefly meadow for iTerm2 / any truecolor terminal.
+
+Move your mouse over the terminal: the grass rustles and fireflies burst out,
+leaving a rainbow trail. Click for a big burst of fireflies.
+
+Keys:  q = quit    c = clear    Ctrl-C = quit
+Run:   fireflies
+"""
+import colorsys
+import math
+import os
+import random
+import re
+import select
+import shutil
+import sys
+import time
+
+try:
+    import termios
+    import tty
+except ImportError:  # Windows
+    termios = None
+    tty = None
+
+FPS = 30
+MAX_PARTICLES = 1800
+GRASS_CHARS = "|'\",;!"
+MOUSE_RE = re.compile(r"\x1b\[<(\d+);(\d+);(\d+)([Mm])")
+
+ESC = "\x1b"
+
+
+def hsv(h, s, v):
+    r, g, b = colorsys.hsv_to_rgb(h % 1.0, s, v)
+    return r, g, b
+
+
+class Particle:
+    __slots__ = ("x", "y", "vx", "vy", "life", "maxlife", "hue", "phase")
+
+    def __init__(self, x, y, hue, burst=False):
+        self.x = x + random.uniform(-0.5, 0.5)
+        self.y = y + random.uniform(-0.3, 0.3)
+        spread = 1.4 if burst else 0.35
+        self.vx = random.uniform(-spread, spread)
+        self.vy = random.uniform(-spread * 0.5, spread * 0.2)
+        self.maxlife = random.uniform(30, 90) if not burst else random.uniform(40, 110)
+        self.life = self.maxlife
+        self.hue = hue + random.uniform(-0.04, 0.04)
+        self.phase = random.uniform(0, 6.28)
+
+
+class Ambient:
+    """Faint yellow-green fireflies that blink on their own."""
+
+    def __init__(self, w, h):
+        self.x = random.uniform(0, w)
+        self.y = random.uniform(0, h)
+        self.phase = random.uniform(0, 6.28)
+        self.speed = random.uniform(0.5, 1.2)
+
+
+def make_grass(w, h):
+    rng = random.Random(7)
+    return [
+        [rng.choice(GRASS_CHARS) if rng.random() < 0.28 else " " for _ in range(w)]
+        for _ in range(h)
+    ]
+
+
+def main():
+    if termios is None:
+        sys.exit("firefly-meadow needs macOS or Linux (or WSL on Windows).")
+    if not (sys.stdin.isatty() and sys.stdout.isatty()):
+        sys.exit("firefly-meadow must be run in an interactive terminal.")
+    fd = sys.stdin.fileno()
+    old = termios.tcgetattr(fd)
+    out = sys.stdout
+
+    w, h = shutil.get_terminal_size()
+    grass = make_grass(w, h)
+    particles = []
+    ambient = [Ambient(w, h) for _ in range(16)]
+    disturbed = {}  # (x, y) -> frames left
+    last_mouse = None
+    hue_base = random.random()
+    frame = 0
+    running = True
+
+    def spawn_trail(x0, y0, x1, y1):
+        nonlocal hue_base
+        steps = max(abs(x1 - x0), abs(y1 - y0), 1)
+        for i in range(steps):
+            t = (i + 1) / steps
+            cx = x0 + (x1 - x0) * t
+            cy = y0 + (y1 - y0) * t
+            hue_base += 0.006
+            for _ in range(random.choice((1, 2, 2, 3))):
+                if len(particles) < MAX_PARTICLES:
+                    particles.append(Particle(cx, cy, hue_base))
+            # rustle the grass around the cursor
+            for dy in range(-2, 3):
+                for dx in range(-3, 4):
+                    if dx * dx / 2.2 + dy * dy <= 4:
+                        disturbed[(int(cx) + dx, int(cy) + dy)] = 14
+
+    def burst(x, y):
+        nonlocal hue_base
+        for _ in range(70):
+            if len(particles) < MAX_PARTICLES:
+                particles.append(Particle(x, y, hue_base + random.random() * 0.5, burst=True))
+
+    try:
+        tty.setcbreak(fd)
+        # alt screen, hide cursor, no autowrap, mouse: any-motion + SGR coords
+        out.write(f"{ESC}[?1049h{ESC}[?25l{ESC}[?7l{ESC}[?1003h{ESC}[?1006h{ESC}[2J")
+        out.flush()
+
+        while running:
+            t0 = time.time()
+            frame += 1
+
+            # ---- resize ----
+            nw, nh = shutil.get_terminal_size()
+            if (nw, nh) != (w, h):
+                w, h = nw, nh
+                grass = make_grass(w, h)
+                out.write(f"{ESC}[2J")
+
+            # ---- input ----
+            while select.select([fd], [], [], 0)[0]:
+                data = os.read(fd, 4096).decode("utf-8", "ignore")
+                for m in MOUSE_RE.finditer(data):
+                    b, mx, my, kind = int(m.group(1)), int(m.group(2)) - 1, int(m.group(3)) - 1, m.group(4)
+                    if last_mouse is None:
+                        last_mouse = (mx, my)
+                    spawn_trail(last_mouse[0], last_mouse[1], mx, my)
+                    last_mouse = (mx, my)
+                    if kind == "M" and (b & 3) == 0 and not (b & 32):
+                        burst(mx, my)
+                rest = MOUSE_RE.sub("", data)
+                if "q" in rest or "\x03" in rest:
+                    running = False
+                if "c" in rest:
+                    particles.clear()
+                    disturbed.clear()
+
+            # ---- update ----
+            now = time.time()
+            for p in particles:
+                p.x += p.vx
+                p.y += p.vy * 0.6
+                p.vx += random.uniform(-0.06, 0.06)
+                p.vy += random.uniform(-0.05, 0.03) - 0.004
+                p.vx *= 0.95
+                p.vy *= 0.95
+                p.life -= 1
+            particles[:] = [p for p in particles if p.life > 0 and -2 < p.x < w + 2 and -2 < p.y < h + 2]
+
+            for a in ambient:
+                a.x += random.uniform(-0.15, 0.15) * a.speed
+                a.y += random.uniform(-0.08, 0.08) * a.speed
+                a.x %= w
+                a.y %= h
+
+            for k in list(disturbed):
+                disturbed[k] -= 1
+                if disturbed[k] <= 0:
+                    del disturbed[k]
+
+            # ---- glow buffer: cell -> [r, g, b, char] ----
+            glow = {}
+
+            def add(x, y, rgb, strength, char=None):
+                if 0 <= x < w and 0 <= y < h:
+                    c = glow.setdefault((x, y), [0.0, 0.0, 0.0, None])
+                    c[0] = min(1.0, c[0] + rgb[0] * strength)
+                    c[1] = min(1.0, c[1] + rgb[1] * strength)
+                    c[2] = min(1.0, c[2] + rgb[2] * strength)
+                    if char and (c[3] is None or char in "*O@"):
+                        c[3] = char
+
+            for p in particles:
+                b = p.life / p.maxlife
+                b *= 0.65 + 0.35 * math.sin(now * 9 + p.phase)
+                b = max(0.0, b)
+                rgb = hsv(p.hue, 0.65, 1.0)
+                ch = "O" if b > 0.8 else "*" if b > 0.5 else "+" if b > 0.28 else "."
+                cx, cy = int(p.x), int(p.y)
+                add(cx, cy, rgb, min(1.0, b * 1.2), ch)
+                for dx, dy in ((1, 0), (-1, 0), (0, 1), (0, -1)):
+                    add(cx + dx, cy + dy, rgb, b * 0.35)
+
+            for a in ambient:
+                b = max(0.0, math.sin(now * 0.9 * a.speed + a.phase)) ** 3
+                if b > 0.05:
+                    rgb = hsv(0.17, 0.75, 1.0)
+                    add(int(a.x), int(a.y), rgb, b * 0.7, "*" if b > 0.5 else ".")
+                    add(int(a.x) + 1, int(a.y), rgb, b * 0.2)
+                    add(int(a.x) - 1, int(a.y), rgb, b * 0.2)
+
+            # ---- render ----
+            buf = []
+            for y in range(h):
+                buf.append(f"{ESC}[{y + 1};1H")
+                last = None
+                for x in range(w):
+                    g = grass[y][x]
+                    cell = glow.get((x, y))
+                    if (x, y) in disturbed and g != " ":
+                        g = "/" if (x + frame // 3) % 2 == 0 else "\\"
+                    if cell:
+                        r, gg, bb, ch = cell
+                        base = (12, 45, 18) if g != " " else (0, 0, 0)
+                        R = min(255, int(base[0] + r * 255))
+                        G = min(255, int(base[1] + gg * 255))
+                        B = min(255, int(base[2] + bb * 255))
+                        char = ch if ch else (g if g != " " else ("." if (r + gg + bb) > 0.5 else " "))
+                        col = (R, G, B)
+                    elif g != " ":
+                        char = g
+                        col = (30, 95, 40) if (x, y) in disturbed else (12, 45, 18)
+                    else:
+                        char = " "
+                        col = None
+                    if col != last:
+                        buf.append(f"{ESC}[38;2;{col[0]};{col[1]};{col[2]}m" if col else f"{ESC}[0m")
+                        last = col
+                    buf.append(char)
+                buf.append(f"{ESC}[0m")
+            out.write("".join(buf))
+            out.write(f"{ESC}[1;2H{ESC}[38;2;80;80;80mmove mouse | click = burst | c = clear | q = quit{ESC}[0m")
+            out.flush()
+
+            dt = time.time() - t0
+            if dt < 1 / FPS:
+                time.sleep(1 / FPS - dt)
+
+    except KeyboardInterrupt:
+        pass
+    finally:
+        out.write(f"{ESC}[?1003l{ESC}[?1006l{ESC}[?7h{ESC}[?25h{ESC}[0m{ESC}[?1049l")
+        out.flush()
+        termios.tcsetattr(fd, termios.TCSADRAIN, old)
+
+
+if __name__ == "__main__":
+    main()

firefly_meadow-0.1.0/src/firefly_meadow.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: firefly-meadow
+Version: 0.1.0
+Summary: A terminal ASCII firefly meadow. Wave your mouse, leave a rainbow trail.
+Author: Rahul Bantupalli
+License-Expression: MIT
+Keywords: terminal,ascii,game,fireflies,iterm,toy
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# firefly-meadow
+
+A tiny ASCII firefly meadow for your terminal. Move your mouse over the window:
+the grass rustles and fireflies burst out, leaving a rainbow trail behind your cursor.
+
+## Install and play
+
+```
+pip install firefly-meadow
+fireflies
+```
+
+Or run it without installing:
+
+```
+pipx run firefly-meadow
+# or
+uvx firefly-meadow
+```
+
+## Controls
+
+| Input        | What it does                 |
+|--------------|------------------------------|
+| Mouse move   | Disturb the grass, leave a trail of glowing fireflies |
+| Left click   | Big burst of fireflies       |
+| `c`          | Clear the screen             |
+| `q`/`Ctrl-C` | Quit                         |
+
+## Requirements
+
+- macOS or Linux (it uses `termios`, so no native Windows; WSL works)
+- A terminal with truecolor and mouse reporting: iTerm2, Kitty, WezTerm, Alacritty,
+  GNOME Terminal, and most modern terminals
+- Python 3.8+, no other dependencies
+
+Tips: make the window fullscreen for the best effect. In iTerm2, enable
+Preferences > Profiles > Terminal > "Report mouse clicks & drags" if the mouse
+does nothing. Inside tmux, turn on `set -g mouse on`.
+
+## License
+
+MIT

firefly_meadow-0.1.0/src/firefly_meadow.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/firefly_meadow/__init__.py
+src/firefly_meadow/game.py
+src/firefly_meadow.egg-info/PKG-INFO
+src/firefly_meadow.egg-info/SOURCES.txt
+src/firefly_meadow.egg-info/dependency_links.txt
+src/firefly_meadow.egg-info/entry_points.txt
+src/firefly_meadow.egg-info/top_level.txt

firefly_meadow-0.1.0/src/firefly_meadow.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

firefly_meadow-0.1.0/src/firefly_meadow.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fireflies = firefly_meadow.game:main

firefly_meadow-0.1.0/src/firefly_meadow.egg-info/top_level.txt

@@ -0,0 +1 @@
+firefly_meadow