dripfetch 0.2.2__tar.gz → 0.4.0__tar.gz

dripfetch-0.4.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: dripfetch
+Version: 0.4.0
+Summary: A customizable terminal system information display with animated rain.
+Author: Amir Shygun
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/a-shygun/dripfetch
+Project-URL: Repository, https://github.com/a-shygun/dripfetch
+Project-URL: Issues, https://github.com/a-shygun/dripfetch/issues
+Project-URL: Security, https://github.com/a-shygun/dripfetch/security
+Keywords: terminal,system information,fetch,curses,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil
+Requires-Dist: ruamel.yaml
+Dynamic: license-file
+
+# Dripfetch
+
+A customizable terminal dashboard with animated Matrix-style rain. Place system info, logos, clocks, calendars, weather, text, and network graphs anywhere on screen, and tune everything from one YAML file.
+
+<p align="center">
+  <img src="docs/dripfetch.gif" alt="Dripfetch demo" width="850">
+</p>
+
+## Features
+
+- Rain with adjustable density, symbols, colors, speed, length, and box collisions
+- Seven box types: `logo`, `sysinfo`, `clock`, `calendar`, `weather`, `net`, `text`
+- 487 ASCII logos, auto-detected from your OS or chosen explicitly
+- Five border styles, shared palette and padding
+- Click a box and move it with arrows or WASD; the position is saved to YAML
+- Seven presets plus a default (`0`), validated configs with clear error paths
+
+## Install
+
+Requires Python 3.10+ and a POSIX terminal with curses (macOS, Linux).
+
+```bash
+pipx install dripfetch                       # recommended
+python -m pip install dripfetch              # inside a virtual environment
+pipx install .                               # from a source checkout
+
+brew tap a-shygun/dripfetch https://github.com/a-shygun/dripfetch.git
+brew install a-shygun/dripfetch/dripfetch    # Homebrew
+
+yay -S dripfetch                             # Arch (AUR)
+```
+
+`bash install.sh` sets up a local virtual environment in `~/dripfetch` and links `dripfetch` into `~/.local/bin`; `bash uninstall.sh` removes it and keeps your config.
+
+**Uninstall:** `pipx uninstall dripfetch` · `python -m pip uninstall dripfetch` · `brew uninstall dripfetch` · `yay -R dripfetch`
+
+### Nix
+
+`psutil` and `ruamel.yaml` are **runtime** dependencies, not native build inputs. Put them in `dependencies` (or `propagatedBuildInputs`), not `nativeBuildInputs`, or the installed command fails with `ModuleNotFoundError`:
+
+```nix
+python3Packages.buildPythonApplication {
+  pname = "dripfetch";
+  version = "0.4.0";
+  pyproject = true;
+  src = ./.;
+  build-system = [ python3Packages.setuptools ];
+  dependencies = with python3Packages; [ psutil ruamel-yaml ];
+}
+```
+
+## Usage
+
+```bash
+dripfetch
+```
+
+| Key | Action |
+| --- | --- |
+| `q` | Quit |
+| `Space` | Pause / resume rain |
+| Click | Select a box |
+| Arrows / `WASD` | Move the selected box (saved automatically) |
+| `Esc` | Deselect |
+
+### Commands
+
+| Command | Action |
+| --- | --- |
+| `dripfetch -c, --use-config NUMBER\|NAME\|PATH` | Run with a preset or YAML file for this session only |
+| `dripfetch --set-config NUMBER\|NAME\|PATH` | Save a preset or file as the active config |
+| `dripfetch --set-logo NAME` | Save a logo in the active config |
+| `dripfetch --list-configs` / `--list-logos` / `--list-boxes` | List presets, logos, or box types |
+| `dripfetch --print-logo NAME` | Print a logo |
+| `dripfetch --config-path` | Show the config path in use |
+| `dripfetch --init-config` | Create or restore the default config |
+| `dripfetch -v, --version` / `--version-raw` | Show the version |
+| `dripfetch -h, --help` | Show help |
+
+```bash
+dripfetch --use-config 2                  # try a preset
+dripfetch -c ./my-layout.yaml             # try your own file
+dripfetch --set-config moonlight_observatory
+```
+
+Presets are `01_neon_matrix`, `02_moonlight_observatory`, `03_ops_console`, `04_citrus_pop`, `05_arcade_white`, `06_ink_and_amber`, `07_arcade_cabinet`, and `0` for the default. A selector can be the number, full name, or short name.
+
+### Lower CPU usage
+
+The rain is the main cost. **Lower `rain.intensity` to use less CPU**; `0` disables rain and leaves the dashboard nearly idle. Around `20`–`60` suits a laptop on battery. Pausing with `Space` and shorter `lengths` also help.
+
+## Configuration
+
+The active config is `~/.config/dripfetch/config.yaml`. The packaged [`0_default.yaml`](src/dripfetch/assets/configs/0_default.yaml) documents every option. Moving a box writes its new position back to the file in use.
+
+```yaml
+background: "#080B12"
+keyboard:
+  layout: qwerty            # qwerty | azerty | qwertz
+rain:
+  collision: true
+  intensity: 60             # lower = less CPU
+  character: ["│", "┃", "╎"]
+  colors:  [[0.7, "#21F7A8"], [0.3, "#45B8FF"]]   # [probability, value], must sum to 1
+  speeds:  [[0.5, 30], [0.5, 50]]                 # ms per step, lower = faster
+  lengths: [[0.8, 6], [0.2, 14]]
+  effects: {acceleration: false, splash: false}
+boxes:
+  border: titled_single     # single | double | titled_single | titled_double | none
+  border_color: "#50FFC1"
+  text_color: "#D9E5F4"
+  accent_color: "#50FFC1"
+  padding: {horizontal: 2, vertical: 0}
+  items:
+    - type: logo
+      logo: arch2
+      position: {horizontal: -32, vertical: 0}
+    - type: clock
+      clock_size: small
+      show_date: true
+      position: {horizontal: 28, vertical: -7}
+    - type: text
+      title: NOTE
+      text: |
+        Dripfetch is running.
+      alignment: center
+      position: {horizontal: 28, vertical: 7}
+```
+
+Colors are `#RRGGBB` or `#RRGGBBAA`. Positions are cell offsets from the center (positive = right / down).
+
+### Box options
+
+| Type | Options |
+| --- | --- |
+| `logo` | `logo` (omit to detect your OS), `colors` for `$1`, `$2`, … markers |
+| `sysinfo` | `sections`: `system`, `display`, `hardware`, `disk`, `connectivity` (true/false) |
+| `clock` | `clock_size` small/medium/big, `clock_style` single/double, `clock_24h`, `show_seconds`, `show_am_pm`, `blink_colon`, `show_date` |
+| `calendar` | `starting_day`: monday, sunday, saturday |
+| `weather` | `location` or `latitude`/`longitude`, `units` celsius/fahrenheit (or metric/imperial), `days` 1–7. Uses Open-Meteo and needs internet. |
+| `net` | `width`, `height`, `interval`, `download_color`, `upload_color` |
+| `text` | `text` (string, block, or list), `alignment` left/center/right |
+
+Every box also accepts `title`, `border`, and `position`.
+
+## Gallery
+
+<table>
+  <tr>
+    <td><img src="docs/screenshots/01_neon_matrix.png" alt="Neon Matrix"><br><b>01 · Neon Matrix</b></td>
+    <td><img src="docs/screenshots/02_moonlight_observatory.png" alt="Moonlight Observatory"><br><b>02 · Moonlight Observatory</b></td>
+  </tr>
+  <tr>
+    <td><img src="docs/screenshots/03_ops_console.png" alt="Ops Console"><br><b>03 · Ops Console</b></td>
+    <td><img src="docs/screenshots/04_citrus_pop.png" alt="Citrus Pop"><br><b>04 · Citrus Pop</b></td>
+  </tr>
+  <tr>
+    <td><img src="docs/screenshots/05_arcade_white.png" alt="Arcade White"><br><b>05 · Arcade White</b></td>
+    <td><img src="docs/screenshots/06_ink_and_amber.png" alt="Ink and Amber"><br><b>06 · Ink and Amber</b></td>
+  </tr>
+  <tr>
+    <td><img src="docs/screenshots/07_arcade_cabinet.png" alt="Arcade Cabinet"><br><b>07 · Arcade Cabinet</b></td>
+    <td><img src="docs/screenshots/0_default.png" alt="Default layout"><br><b>0 · Default</b></td>
+  </tr>
+</table>
+
+## Project layout
+
+```
+src/dripfetch/
+├── app/      cli.py (arguments), app.py (main loop), config.py (YAML + validation), terminal.py (renderer)
+├── box/      base, manager, layout, placement, border, colors, registry, validation
+│   └── types/  one module per box type; helper/ holds their support code
+├── rain/     manager, spawning, physics, rendering, colors, models, constants
+└── assets/   logos/*.txt and configs/*.yaml
+Formula/      Homebrew formula        packaging/arch/  AUR PKGBUILD
+```
+
+To add a box type, drop a module with one `BaseBox` subclass into `box/types/`. It is discovered automatically and the module name becomes its `type`. An optional `validate_config(cls, item, path)` classmethod validates its options.
+
+## License
+
+[MIT](LICENSE). Report vulnerabilities privately, see [SECURITY.md](SECURITY.md).

dripfetch-0.4.0/README.md

@@ -0,0 +1,183 @@
+# Dripfetch
+
+A customizable terminal dashboard with animated Matrix-style rain. Place system info, logos, clocks, calendars, weather, text, and network graphs anywhere on screen, and tune everything from one YAML file.
+
+<p align="center">
+  <img src="docs/dripfetch.gif" alt="Dripfetch demo" width="850">
+</p>
+
+## Features
+
+- Rain with adjustable density, symbols, colors, speed, length, and box collisions
+- Seven box types: `logo`, `sysinfo`, `clock`, `calendar`, `weather`, `net`, `text`
+- 487 ASCII logos, auto-detected from your OS or chosen explicitly
+- Five border styles, shared palette and padding
+- Click a box and move it with arrows or WASD; the position is saved to YAML
+- Seven presets plus a default (`0`), validated configs with clear error paths
+
+## Install
+
+Requires Python 3.10+ and a POSIX terminal with curses (macOS, Linux).
+
+```bash
+pipx install dripfetch                       # recommended
+python -m pip install dripfetch              # inside a virtual environment
+pipx install .                               # from a source checkout
+
+brew tap a-shygun/dripfetch https://github.com/a-shygun/dripfetch.git
+brew install a-shygun/dripfetch/dripfetch    # Homebrew
+
+yay -S dripfetch                             # Arch (AUR)
+```
+
+`bash install.sh` sets up a local virtual environment in `~/dripfetch` and links `dripfetch` into `~/.local/bin`; `bash uninstall.sh` removes it and keeps your config.
+
+**Uninstall:** `pipx uninstall dripfetch` · `python -m pip uninstall dripfetch` · `brew uninstall dripfetch` · `yay -R dripfetch`
+
+### Nix
+
+`psutil` and `ruamel.yaml` are **runtime** dependencies, not native build inputs. Put them in `dependencies` (or `propagatedBuildInputs`), not `nativeBuildInputs`, or the installed command fails with `ModuleNotFoundError`:
+
+```nix
+python3Packages.buildPythonApplication {
+  pname = "dripfetch";
+  version = "0.4.0";
+  pyproject = true;
+  src = ./.;
+  build-system = [ python3Packages.setuptools ];
+  dependencies = with python3Packages; [ psutil ruamel-yaml ];
+}
+```
+
+## Usage
+
+```bash
+dripfetch
+```
+
+| Key | Action |
+| --- | --- |
+| `q` | Quit |
+| `Space` | Pause / resume rain |
+| Click | Select a box |
+| Arrows / `WASD` | Move the selected box (saved automatically) |
+| `Esc` | Deselect |
+
+### Commands
+
+| Command | Action |
+| --- | --- |
+| `dripfetch -c, --use-config NUMBER\|NAME\|PATH` | Run with a preset or YAML file for this session only |
+| `dripfetch --set-config NUMBER\|NAME\|PATH` | Save a preset or file as the active config |
+| `dripfetch --set-logo NAME` | Save a logo in the active config |
+| `dripfetch --list-configs` / `--list-logos` / `--list-boxes` | List presets, logos, or box types |
+| `dripfetch --print-logo NAME` | Print a logo |
+| `dripfetch --config-path` | Show the config path in use |
+| `dripfetch --init-config` | Create or restore the default config |
+| `dripfetch -v, --version` / `--version-raw` | Show the version |
+| `dripfetch -h, --help` | Show help |
+
+```bash
+dripfetch --use-config 2                  # try a preset
+dripfetch -c ./my-layout.yaml             # try your own file
+dripfetch --set-config moonlight_observatory
+```
+
+Presets are `01_neon_matrix`, `02_moonlight_observatory`, `03_ops_console`, `04_citrus_pop`, `05_arcade_white`, `06_ink_and_amber`, `07_arcade_cabinet`, and `0` for the default. A selector can be the number, full name, or short name.
+
+### Lower CPU usage
+
+The rain is the main cost. **Lower `rain.intensity` to use less CPU**; `0` disables rain and leaves the dashboard nearly idle. Around `20`–`60` suits a laptop on battery. Pausing with `Space` and shorter `lengths` also help.
+
+## Configuration
+
+The active config is `~/.config/dripfetch/config.yaml`. The packaged [`0_default.yaml`](src/dripfetch/assets/configs/0_default.yaml) documents every option. Moving a box writes its new position back to the file in use.
+
+```yaml
+background: "#080B12"
+keyboard:
+  layout: qwerty            # qwerty | azerty | qwertz
+rain:
+  collision: true
+  intensity: 60             # lower = less CPU
+  character: ["│", "┃", "╎"]
+  colors:  [[0.7, "#21F7A8"], [0.3, "#45B8FF"]]   # [probability, value], must sum to 1
+  speeds:  [[0.5, 30], [0.5, 50]]                 # ms per step, lower = faster
+  lengths: [[0.8, 6], [0.2, 14]]
+  effects: {acceleration: false, splash: false}
+boxes:
+  border: titled_single     # single | double | titled_single | titled_double | none
+  border_color: "#50FFC1"
+  text_color: "#D9E5F4"
+  accent_color: "#50FFC1"
+  padding: {horizontal: 2, vertical: 0}
+  items:
+    - type: logo
+      logo: arch2
+      position: {horizontal: -32, vertical: 0}
+    - type: clock
+      clock_size: small
+      show_date: true
+      position: {horizontal: 28, vertical: -7}
+    - type: text
+      title: NOTE
+      text: |
+        Dripfetch is running.
+      alignment: center
+      position: {horizontal: 28, vertical: 7}
+```
+
+Colors are `#RRGGBB` or `#RRGGBBAA`. Positions are cell offsets from the center (positive = right / down).
+
+### Box options
+
+| Type | Options |
+| --- | --- |
+| `logo` | `logo` (omit to detect your OS), `colors` for `$1`, `$2`, … markers |
+| `sysinfo` | `sections`: `system`, `display`, `hardware`, `disk`, `connectivity` (true/false) |
+| `clock` | `clock_size` small/medium/big, `clock_style` single/double, `clock_24h`, `show_seconds`, `show_am_pm`, `blink_colon`, `show_date` |
+| `calendar` | `starting_day`: monday, sunday, saturday |
+| `weather` | `location` or `latitude`/`longitude`, `units` celsius/fahrenheit (or metric/imperial), `days` 1–7. Uses Open-Meteo and needs internet. |
+| `net` | `width`, `height`, `interval`, `download_color`, `upload_color` |
+| `text` | `text` (string, block, or list), `alignment` left/center/right |
+
+Every box also accepts `title`, `border`, and `position`.
+
+## Gallery
+
+<table>
+  <tr>
+    <td><img src="docs/screenshots/01_neon_matrix.png" alt="Neon Matrix"><br><b>01 · Neon Matrix</b></td>
+    <td><img src="docs/screenshots/02_moonlight_observatory.png" alt="Moonlight Observatory"><br><b>02 · Moonlight Observatory</b></td>
+  </tr>
+  <tr>
+    <td><img src="docs/screenshots/03_ops_console.png" alt="Ops Console"><br><b>03 · Ops Console</b></td>
+    <td><img src="docs/screenshots/04_citrus_pop.png" alt="Citrus Pop"><br><b>04 · Citrus Pop</b></td>
+  </tr>
+  <tr>
+    <td><img src="docs/screenshots/05_arcade_white.png" alt="Arcade White"><br><b>05 · Arcade White</b></td>
+    <td><img src="docs/screenshots/06_ink_and_amber.png" alt="Ink and Amber"><br><b>06 · Ink and Amber</b></td>
+  </tr>
+  <tr>
+    <td><img src="docs/screenshots/07_arcade_cabinet.png" alt="Arcade Cabinet"><br><b>07 · Arcade Cabinet</b></td>
+    <td><img src="docs/screenshots/0_default.png" alt="Default layout"><br><b>0 · Default</b></td>
+  </tr>
+</table>
+
+## Project layout
+
+```
+src/dripfetch/
+├── app/      cli.py (arguments), app.py (main loop), config.py (YAML + validation), terminal.py (renderer)
+├── box/      base, manager, layout, placement, border, colors, registry, validation
+│   └── types/  one module per box type; helper/ holds their support code
+├── rain/     manager, spawning, physics, rendering, colors, models, constants
+└── assets/   logos/*.txt and configs/*.yaml
+Formula/      Homebrew formula        packaging/arch/  AUR PKGBUILD
+```
+
+To add a box type, drop a module with one `BaseBox` subclass into `box/types/`. It is discovered automatically and the module name becomes its `type`. An optional `validate_config(cls, item, path)` classmethod validates its options.
+
+## License
+
+[MIT](LICENSE). Report vulnerabilities privately, see [SECURITY.md](SECURITY.md).

{dripfetch-0.2.2 → dripfetch-0.4.0}/pyproject.toml

@@ -1,14 +1,15 @@
 [build-system]
-requires = ["setuptools>=61"]
+requires = ["setuptools>=77.0.3"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "dripfetch"
-version = "0.2.2"
+version = "0.4.0"
 description = "A customizable terminal system information display with animated rain."
 readme = "README.md"
-requires-python = ">=3.12"
-license = { file = "LICENSE" }
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [
     { name = "Amir Shygun" },
 ]
@@ -21,7 +22,10 @@ classifiers = [
     "Operating System :: POSIX",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: System",
     "Topic :: Terminals",
 ]
@@ -31,6 +35,12 @@ dependencies = [
     "ruamel.yaml",
 ]
 
+[project.urls]
+Homepage = "https://github.com/a-shygun/dripfetch"
+Repository = "https://github.com/a-shygun/dripfetch"
+Issues = "https://github.com/a-shygun/dripfetch/issues"
+Security = "https://github.com/a-shygun/dripfetch/security"
+
 [project.scripts]
 dripfetch = "dripfetch.app.cli:main"
 
@@ -39,12 +49,12 @@ where = ["src"]
 
 [tool.setuptools.package-data]
 dripfetch = [
-    "default_config.yaml",
     "assets/logos/*.txt",
+    "assets/configs/*.yaml",
 ]
 
 [tool.ruff]
-target-version = "py312"
+target-version = "py310"
 line-length = 88
 src = ["src", "tests"]
 
@@ -53,4 +63,4 @@ select = ["E", "F", "I", "UP", "B", "SIM"]
 
 [tool.ruff.format]
 quote-style = "double"
-indent-style = "space"
+indent-style = "space"

dripfetch-0.4.0/src/dripfetch/app/app.py

@@ -0,0 +1,173 @@
+import curses
+import time
+from pathlib import Path
+
+from ..box import Border, Box, BoxColors
+from ..rain import Rain
+from .config import load_config, save_config
+from .terminal import Renderer, cleanup, parse_color, setup
+
+# How long to wait, after the last KEY_RESIZE event, before treating a
+# terminal resize as "finished" and doing one full clean redraw. While
+# events keep arriving faster than this, we hold on the placeholder
+# screen instead of trying to render every intermediate size.
+RESIZE_SETTLE = 0.5
+
+
+class App:
+    def __init__(self, config_path):
+        self.config_path = Path(config_path)
+        self.config = None
+        self.renderer = None
+        self.box = None
+        self.rain = None
+        self.paused = False
+        self.resizing = False
+        self.last_resize = 0.0
+        self.placeholder_colors = None
+
+    def initialize(self, stdscr):
+        self.config = load_config(self.config_path)
+        setup(stdscr)
+        background = parse_color(self.config.get("background", "#000000FF"))
+        self.renderer = Renderer(
+            stdscr,
+            background,
+        )
+        self.renderer.resize()
+        self.box = Box(
+            stdscr=stdscr,
+            config=self.config,
+            config_path=self.config_path,
+            renderer=self.renderer,
+            save_config=save_config,
+        )
+        self.rain = Rain(
+            stdscr=stdscr,
+            config=self.config,
+            box=self.box,
+            renderer=self.renderer,
+        )
+        self.placeholder_colors = BoxColors(self.config)
+
+    def handle_mouse(self):
+        try:
+            _, x, y, _, state = curses.getmouse()
+        except curses.error:
+            return
+        # See terminal.setup(): some terminals never emit BUTTON1_CLICKED,
+        # only PRESSED/RELEASED, so treat either as a selection click.
+        if state & (curses.BUTTON1_CLICKED | curses.BUTTON1_PRESSED):
+            self.box.handle_mouse(x, y)
+
+    def handle_key(self, key):
+        if key == ord("q"):
+            return False
+        if key == curses.KEY_RESIZE:
+            self._begin_resize()
+            return True
+        if key == curses.KEY_MOUSE:
+            self.handle_mouse()
+            return True
+        if key == ord(" "):
+            self.paused = not self.paused
+            if self.paused:
+                self.rain.pause()
+            else:
+                self.rain.resume()
+            return True
+        self.box.handle_key(key)
+        return True
+
+    def _begin_resize(self):
+        if not self.resizing:
+            self.resizing = True
+            # Don't stomp on a user-initiated pause (spacebar): only
+            # freeze the rain ourselves if it wasn't already paused, and
+            # only resume it ourselves in _finish_resize if we're the
+            # ones who paused it.
+            if not self.paused:
+                self.rain.pause()
+            self.renderer.invalidate()
+        self.last_resize = time.monotonic()
+
+    def _finish_resize(self):
+        self.resizing = False
+        if not self.paused:
+            self.rain.resume()
+        self.box.resize()
+        self.rain.resize()
+        # See Renderer.invalidate(): curses' resizeterm() can flush its
+        # own output after ours, silently corrupting whichever cells
+        # never get an explicit draw() call. Force one full repaint here
+        # so we're not trusting stale assumptions about what the
+        # terminal currently shows.
+        self.renderer.invalidate()
+
+    def _draw_resize_placeholder(self):
+        self.renderer.begin()
+        width, height = self.renderer.width, self.renderer.height
+
+        label = "(resizing)"
+        dimensions = f"{width} x {height}"
+        inner_width = max(len(label), len(dimensions))
+        box_width = inner_width + 4
+        box_height = 4
+
+        x = max(0, (width - box_width) // 2)
+        y = max(0, (height - box_height) // 2)
+
+        Border("single").draw(
+            self.renderer,
+            x,
+            y,
+            box_width,
+            box_height,
+            self.placeholder_colors.border,
+        )
+        self.renderer.draw(
+            x + (box_width - len(label)) // 2,
+            y + 1,
+            label,
+            self.placeholder_colors.text,
+        )
+        self.renderer.draw(
+            x + (box_width - len(dimensions)) // 2,
+            y + 2,
+            dimensions,
+            self.placeholder_colors.text,
+        )
+
+        self.renderer.end()
+
+    def update(self):
+        if self.resizing:
+            if time.monotonic() - self.last_resize < RESIZE_SETTLE:
+                self._draw_resize_placeholder()
+                return
+            self._finish_resize()
+
+        resized = self.renderer.begin()
+        if resized:
+            self.box.resize()
+            self.rain.resize()
+        if not self.paused:
+            self.rain.update()
+        self.box.update()
+        self.rain.draw()
+        self.box.draw()
+        self.renderer.end()
+
+    def run(self, stdscr):
+        try:
+            self.initialize(stdscr)
+            stdscr.nodelay(True)
+            stdscr.timeout(10)
+            while self.handle_key(stdscr.getch()):
+                self.update()
+        finally:
+            if self.box:
+                self.box.close()
+            if self.rain:
+                self.rain.close()
+            cleanup()