WS281X Pattern Runner

Command-line LED pattern runner with live keyboard shortcuts and safe ASCII test mode.

Quick Start

sudo -n /home/blackmox/env/bin/python into.py --pattern 1 --chase-color 4 --speed 3 --frames 0

Donation and GitHub QR Codes

• Donation (Cash App): https://cash.app/$teerRight
• GitHub Profile: https://github.com/Drizztdowhateva
• Full page with QR codes: DONATION_AND_GITHUB_QR.md

Easy run (default)

sudo -n /home/blackmox/env/bin/python into.py --pattern 1 --chase-color 4 --speed 3 --frames 0

One-file runtime (install + save + run)

/home/blackmox/env/bin/python runtime.py -- --pattern 1 --chase-color 4 --speed 3 --frames 0

• Installs required runtime package(s)
• Saves pinned versions to requirements.txt
• For real hardware mode, run with sudo if needed:

sudo /home/blackmox/env/bin/python runtime.py -- --pattern 1 --chase-color 4 --speed 3 --frames 0

Optional detached mode (nohup only when switched on)

Use --nohup to run detached:

sudo /home/blackmox/env/bin/python runtime.py --skip-install --no-save --nohup -- --pattern 1 --chase-color 4 --speed 3 --frames 0

When --nohup is used, runtime prints onscreen cancel commands and writes a PID file (runtime_live.pid). Preferred cancel command:

kill $(cat runtime_live.pid)

Run (safe ASCII test mode)

/home/blackmox/env/bin/python into.py --test --pattern 1 --chase-color 4 --speed 3 --frames 20

New runtime features

• Optional Pi input response (digital/analog):

/home/blackmox/env/bin/python into.py --pi-input-mode digital --pi-input-pin 23

/home/blackmox/env/bin/python into.py --pi-input-mode analog --analog-path /sys/bus/iio/devices/iio:device0/in_voltage0_raw --analog-max 4095

• Brightness control:

/home/blackmox/env/bin/python into.py --brightness 128 --max-brightness 200

Runtime keys: + and - to adjust brightness.

• Timer options:

/home/blackmox/env/bin/python into.py --frames 600 --duration-seconds 30 --start-delay-seconds 2

• Optional headless JSON config:

/home/blackmox/env/bin/python into.py --headless --headless-config headless_settings.json

• Emergency-only panic mode (SOS in 3 repeating colors):

/home/blackmox/env/bin/python into.py --emergency-only

Command-line example output

Runtime shortcuts: 1 / 2 / 3 Switch pattern (1=Chase, 2=Random, 3=Bounce) p Cycle pattern (Chase -> Random -> Bounce) s Cycle speed (Slow -> Medium -> Fast) c Cycle color option for current pattern h Show this shortcuts help again q Quit Ctrl+C Quit Pattern: Chase | Speed: Fast | Color: Rainbow Pattern: Chase | Speed: Fast | Color: Rainbow Pattern: Random | Speed: Fast | Palette: Any RGB Pattern: Bounce | Speed: Fast | Color: Blue Pattern: Chase | Speed: Fast | Color: Rainbow Pattern: Random | Speed: Fast | Palette: Any RGB Pattern: Bounce | Speed: Fast | Color: Blue Pattern: Chase | Speed: Fast | Color: Rainbow Pattern: Bounce | Speed: Fast | Color: Blue Pattern: Random | Speed: Fast | Palette: Any RGB