feat: implement auto-sizing feature for banners and enhance CLI with paste support

- Added auto-sizing functionality based on terminal dimensions.
- Updated CLI to support clipboard pasting in text input fields.
- Improved rendering stability for multiple effects in banners.
- Updated documentation to reflect new features and changes.
- Bump version to 2.2.3.

Author: programmersd21

.github/workflows/release-binaries.yml

@@ -65,32 +65,60 @@ jobs:
         run: |
           printf 'from bangen.app import main\nif __name__=="__main__": main()\n' > _entry.py
 
+          # Extract dependencies from pyproject.toml and generate --collect-all flags
+          COLLECT_ALL_FLAGS=$(python3 - <<'PYTHON_SCRIPT'
+          import tomllib
+          
+          # Package name to module name mapping
+          pkg_to_module = {
+              "Pillow": "PIL",
+              "pyfiglet": "pyfiglet",
+              "pyperclip": "pyperclip",
+              "rich": "rich",
+              "typer": "typer",
+          }
+          
+          with open("pyproject.toml", "rb") as f:
+              config = tomllib.load(f)
+              deps = config["project"]["dependencies"]
+          
+          # Extract package names and convert to module names
+          modules = ["bangen"]  # Always include bangen
+          for dep in deps:
+              # Handle dependencies like "pyfiglet>=1.0" -> extract "pyfiglet"
+              pkg_name = dep.split(">=")[0].split("==")[0].split("<=")[0].split("<")[0].split(">")[0]
+              module_name = pkg_to_module.get(pkg_name, pkg_name)
+              modules.append(module_name)
+          
+          # Generate --collect-all flags
+          flags = " ".join([f"--collect-all {m}" for m in modules])
+          print(flags)
+          PYTHON_SCRIPT
+          )
+
           docker run --rm \
             -u $(id -u):$(id -g) \
             -e HOME=/tmp \
             -e PIP_NO_CACHE_DIR=1 \
             -v "${{ github.workspace }}:/workspace" \
             -w /workspace \
             ghcr.io/yt-dlp/manylinux2014_x86_64-shared \
-            bash -c '
+            bash -c "
               set -euo pipefail
               py3.13 -m pip install -U pip wheel pyinstaller --no-cache-dir
-              py3.13 -m pip install ".[all]" --no-cache-dir
+              py3.13 -m pip install \".[all]\" --no-cache-dir
 
               py3.13 -m PyInstaller --onefile --noconfirm --strip --noupx \
                 --name bangen \
                 --distpath dist \
                 --workpath build \
-                --collect-all bangen \
-                --collect-all pyfiglet \
-                --collect-all rich \
-                --collect-all PIL \
-                --collect-all typer \
+                $COLLECT_ALL_FLAGS \
                 --optimize 2 \
                 _entry.py
 
               strings dist/bangen | grep GLIBC_ | sort -V | uniq
-            '
+            "
+          
 
       - run: |
           mkdir -p release
@@ -135,7 +163,39 @@ jobs:
         shell: bash
         run: |
           printf 'from bangen.app import main\nif __name__=="__main__": main()\n' > _entry.py
-          python -m PyInstaller --onefile --noconfirm --noupx --name bangen --distpath dist --workpath build --optimize 2 _entry.py
+          
+          # Extract dependencies from pyproject.toml and generate --collect-all flags
+          COLLECT_ALL_FLAGS=$(python3 - <<'PYTHON_SCRIPT'
+          import tomllib
+          
+          # Package name to module name mapping
+          pkg_to_module = {
+              "Pillow": "PIL",
+              "pyfiglet": "pyfiglet",
+              "pyperclip": "pyperclip",
+              "rich": "rich",
+              "typer": "typer",
+          }
+          
+          with open("pyproject.toml", "rb") as f:
+              config = tomllib.load(f)
+              deps = config["project"]["dependencies"]
+          
+          # Extract package names and convert to module names
+          modules = ["bangen"]  # Always include bangen
+          for dep in deps:
+              # Handle dependencies like "pyfiglet>=1.0" -> extract "pyfiglet"
+              pkg_name = dep.split(">=")[0].split("==")[0].split("<=")[0].split("<")[0].split(">")[0]
+              module_name = pkg_to_module.get(pkg_name, pkg_name)
+              modules.append(module_name)
+          
+          # Generate --collect-all flags
+          flags = " ".join([f"--collect-all {m}" for m in modules])
+          print(flags)
+          PYTHON_SCRIPT
+          )
+          
+          python -m PyInstaller --onefile --noconfirm --noupx --name bangen --distpath dist --workpath build $COLLECT_ALL_FLAGS --optimize 2 _entry.py
 
       - name: Package
         shell: bash

CHANGELOG.md

@@ -1,6 +1,26 @@
 # Changelog
 
+## [2.2.3]
+
+### Added
+- `pyperclip` dependency for improved clipboard paste support in TUI text input boxes
+- GitHub Actions workflow now dynamically extracts dependencies from `pyproject.toml` instead of hardcoding them for PyInstaller builds
+
+### Changed
+- Auto-sizing is now **enabled by default** — use `--no-auto-size` to disable it
+- Auto-sizing no longer requires the `--auto-size` flag to activate; default behavior now includes automatic terminal-based sizing
+- Text input fields in export and preset dialogs now support full cursor movement with arrow keys (← →)
+- Text input now supports mid-string character insertion and deletion instead of append-only editing
+- Paste operations in text boxes now insert at the current cursor position instead of appending to the end
+
+### Fixed
+- Text cursor now displays at the actual insertion point in input fields
+- Backspace in text boxes now removes the character at the cursor position instead of always removing the last character
+
 ## [2.2.2]
+
+### Changed
+
 - Temporal effects (`fade_in`, `wipe`, `stagger`) now perform continuous looping animations instead of stopping after initial transition
 
 ## [2.2.1]

README.md

@@ -40,6 +40,7 @@ Built for terminal art, title cards, intros, and animated text that still feels
 
 - Live split-screen TUI with export modal
 - Static and animated banner rendering
+- Auto-sizing based on terminal and text dimensions
 - Transparent `PNG` and animated transparent `GIF` export
 - Plain `TXT` export with exact ASCII output
 - CLI export progress with percentage, elapsed time, ETA, and status text
@@ -123,13 +124,19 @@ Controls:
 - `↑↓` navigate fields and effects
 - `←→` adjust font or numeric settings
 - `Enter` edit or toggle the selected field
+- `Ctrl+V` paste from clipboard (in text input fields)
+- `a` toggle auto-size info display (shows terminal-relative sizing)
 - `l` load a saved preset or load from a custom preset file
 - `e` open the export dialog
 - `s` save the current preset
 - `q` quit
 
 The effect selector is windowed, so you can move through the full library without overflowing the controls panel.
 
+**Text Input:** All text input boxes (text, path, gradient) now support pasting from your clipboard using `Ctrl+V`, making it easier to work with long or complex values.
+
+**Auto-Size Info:** Press `a` to toggle a display of the calculated banner sizing in relation to your terminal dimensions. Shows: text dimensions, calculated canvas size, scale factor, and padding.
+
 ### Export Dialog 📦
 
 Press `e` inside the TUI to open the exporter.
@@ -180,13 +187,40 @@ bangen "HELLO" --effect wave --effect glow --export-gif banner.gif --gif-duratio
 
 CLI exports show a live progress bar with percentage, elapsed time, ETA, and the current export stage.
 
+#### Auto-Size
+
+Auto-sizing is **enabled by default**. It automatically adjusts banner width/height based on terminal and text dimensions for optimal rendering and exports.
+
+Disable auto-sizing if needed:
+
+```bash
+bangen "HELLO" --no-auto-size
+bangen "HELLO" --no-auto-size --export-txt banner.txt
+```
+
+Enable it explicitly (already default):
+
+```bash
+bangen "HELLO" --auto-size
+bangen "HELLO" --auto-size --export-gif banner.gif --gif-duration 3 --gif-fps 20
+```
+
+**Auto-Size Features:**
+- Enabled by default (use `--no-auto-size` to disable)
+- Analyzes your current terminal dimensions
+- Calculates optimal canvas width and height
+- Applies intelligent scaling (maintains aspect ratio)
+- Shows sizing info: `Text: WxH | Canvas: WxH | Scale: Sx | Padding: (X,Y)`
+- Works with all export formats (`GIF`, `PNG`, `TXT`)
+- Ensures exports are properly sized relative to the rendering environment
+
 ## Releases 📦
 
 GitHub Actions builds standalone binaries for `Windows`, `macOS`, and `Linux` and uploads them to the matching GitHub release.
 
 - asset names follow the project version from `pyproject.toml`
 - release files include the platform in the filename
-- the release workflow expects a tag matching the project version, for example `v2.2.2`
+- the release workflow expects a tag matching the project version, for example `v2.2.3`
 - release builds explicitly bundle the TUI package, effect modules, `pyfiglet` font assets, Rich, and Pillow runtime pieces so the standalone app works outside a Python environment
 
 #### Screensaver
@@ -271,6 +305,8 @@ banner.apply(build_effect("chromatic_aberration", config=cfg))
 banner.apply(build_effect("pulse", config=cfg))
 ```
 
+**Multiple Effects Stability:** When combining many effects (3+), the rendering engine now intelligently normalizes opacity and brightness values to prevent pixelation, noise, and visual artifacts. This ensures your stacked effects remain sharp and clear in both TUI preview and exports (GIF, PNG, TXT).
+
 Common style stacks:
 
 - `cyberpunk`: `glitch` + `chromatic_aberration` + `pulse`
@@ -363,9 +399,12 @@ bangen/
 
 ## Notes 📝
 
-- Animated exports look best when you keep effect stacks readable instead of maxing out distortion-heavy combinations.
+- Auto-sizing (`--auto-size` flag or `a` key in TUI) intelligently adjusts banner dimensions based on terminal size for optimal rendering and exports.
+- Animated exports are now rendered with optimized font sizing (11px) for sharp, crisp ASCII art without pixelation artifacts.
+- Animated exports look best when you keep effect stacks readable instead of maxing out distortion-heavy combinations. The rendering engine now handles complex effect stacks gracefully without artifacts.
 - Temporal effects such as `wipe` and `typewriter` are best previewed with `--animate` in the terminal before exporting.
 - `--screensaver` is designed for live terminal playback, not export generation.
+- Text input fields in dialogs support copy-paste via `Ctrl+V` for easier workflow.
 
 ## License 📄
 

bangen/__init__.py

@@ -2,5 +2,5 @@
 
 from __future__ import annotations
 
-__version__ = "2.2.2"
+__version__ = "2.2.3"
 __author__ = "programmersd21"

bangen/cli/parser.py

@@ -126,6 +126,13 @@ def main(
     no_border: Annotated[bool, typer.Option("--no-border")] = False,
     title: Annotated[str | None, typer.Option("--title")] = None,
     static: Annotated[bool, typer.Option("--static")] = False,
+    auto_size: Annotated[
+        bool,
+        typer.Option(
+            "--auto-size/--no-auto-size",
+            help="Enable/disable auto-sizing (enabled by default). Auto-adjust banner width/height based on terminal and text size.",
+        ),
+    ] = True,
 ) -> None:
     from bangen.cli.runner import run_cli
 
@@ -173,5 +180,6 @@ def main(
         no_border=no_border,
         title=title,
         static=static,
+        auto_size=auto_size,
     )
     run_cli(args)

bangen/cli/runner.py

@@ -25,6 +25,7 @@
 from bangen.gradients.gradient import Gradient
 from bangen.presets.manager import Preset, PresetManager
 from bangen.rendering.engine import DEFAULT_FONT, RenderEngine
+from bangen.rendering.sizing import calculate_auto_size, format_size_info
 
 
 def run_cli(args) -> None:
@@ -206,6 +207,17 @@ def run_cli(args) -> None:
     show_border = not args.no_border
     animate = args.animate and not args.static and bool(effects_list)
 
+    # ---- auto-size calculation ----------------------------------------
+    size_config = None
+    if args.auto_size:
+        try:
+            size_config = calculate_auto_size(banner)
+            console.print(f"[dim]{format_size_info(size_config, banner)}[/dim]")
+        except Exception as exc:
+            console.print(
+                f"[yellow]Warning:[/yellow] auto-size calculation failed — {exc}"
+            )
+
     if animate:
         t0 = time.monotonic()
         dur = args.animate_duration

bangen/export/gif.py

@@ -13,7 +13,7 @@
 
 MAX_GIF_FRAMES = 300
 _TRANSPARENT = (0, 0, 0, 0)
-_FONT_SIZE = 28
+_FONT_SIZE = 11
 _PADDING_X = 32
 _PADDING_Y = 32
 _PALETTE_SAMPLE_FRAMES = 12

bangen/export/png.py

@@ -16,7 +16,7 @@
 if TYPE_CHECKING:
     from bangen.rendering.banner import Banner
 
-_FONT_SIZE = 28
+_FONT_SIZE = 11
 
 
 def export_png(path: Path, banner: "Banner") -> None:

bangen/rendering/banner.py

@@ -76,23 +76,29 @@ def cell_style(
             )
 
         color = self._base_color(position)
-        opacity = 1.0
-        brightness = 1.0
+
+        # Collect individual effect contributions to prevent stacking artifacts
+        opacity_values = [1.0]
+        brightness_values = [1.0]
 
         for effect in self._effects:
-            brightness *= effect.brightness(
-                t,
-                row=row,
-                col=col,
-                char=char,
-                lines=lines,
+            brightness_values.append(
+                effect.brightness(
+                    t,
+                    row=row,
+                    col=col,
+                    char=char,
+                    lines=lines,
+                )
             )
-            opacity *= effect.opacity(
-                t,
-                row=row,
-                col=col,
-                char=char,
-                lines=lines,
+            opacity_values.append(
+                effect.opacity(
+                    t,
+                    row=row,
+                    col=col,
+                    char=char,
+                    lines=lines,
+                )
             )
             color = effect.colorize(
                 color,
@@ -103,6 +109,28 @@ def cell_style(
                 lines=lines,
             )
 
+        # Apply multiplicative blending but normalize for multiple effects
+        # to prevent over-darkening and pixelation
+        num_effects = len(self._effects)
+
+        # Use weighted blending: when multiple effects are active,
+        # nudge values toward 1.0 to keep details visible
+        opacity = 1.0
+        brightness = 1.0
+
+        for op_val in opacity_values:
+            opacity *= op_val
+
+        for br_val in brightness_values:
+            brightness *= br_val
+
+        if num_effects > 1:
+            # For multiple effects, apply a smoothing factor to prevent excessive darkening
+            # This preserves effect stacking while maintaining visibility
+            factor = 1.0 / (1.0 + (num_effects - 1) * 0.3)
+            opacity = opacity**factor
+            brightness = brightness**factor
+
         opacity = clamp(opacity)
         color = scale_color(color, max(0.0, brightness))