Skip to content
HostApplePublic

About

Kinda cool ig

Resources

Stars

16 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ•ถ๏ธ OpticFlow โ€” High Precision Vision & Hand FX Studio

Real-time computer vision studio featuring dynamic hand selection masks, gesture-controlled effect engines, Exponential Moving Average (EMA) keypoint smoothing, and a 3D aviator sunglasses face-mesh tracking engine built with OpenCV and MediaPipe.

Python OpenCV MediaPipe


โœจ Core Features

  • ๐ŸŽฏ Sub-Pixel Keypoint Smoothing: Implements Exponential Moving Average (EMA) filtering across landmark tracks to eliminate micro-jitter without adding frame latency.
  • ๐Ÿ•ถ๏ธ 3D Sunglasses Engine: Procedurally renders aviator-style sunglasses with dynamic scaling, specular glare lines, rotational tracking, and smooth snap-to-eyes alignment using MediaPipe FaceMesh.
  • โœ‹ Dynamic Selection Masking:
    • 2-Finger Circle: Pinch thumb and index to create an adjustable circular effect lens.
    • 4-Finger Bounding Box: Bring both hands into frame to dynamically target rectangular regions with HUD reticles.
  • โœŠ Hold-to-Trigger Fist Gestures: Integrated radial progress ring around palm centroids for seamless effect switching without touch input.
  • ๐ŸŽจ 9 Real-Time Image Processing Filters:
    • Invert, Thermal Map, Cyber Edges, 8-Bit Pixelate, Retro Sepia, Soft Blur, RGB Glitch, Night Vision, and 3D Sunglasses.
  • ๐Ÿ–ฅ๏ธ Minimal Dark-Glass HUD: Semi-transparent HUD overlay displaying real-time FPS, active menu state, and control guides.

๐Ÿ› ๏ธ Prerequisites & Setup

1. Requirements

  • Python 3.8 or higher
  • Webcam / Video Capture Device

2. Install Dependencies

Install OpenCV, NumPy, and MediaPipe using pip:

pip install opencv-python numpy mediapipe

๐ŸŽฎ OpticFlow Quick Reference Sheet

โŒจ๏ธ Keyboard Shortcuts

  • [1] - [9] : Direct Switch to Effects 1โ€“9
  • [F] : Toggle Fullscreen Mode
  • [Q] : Quit Application

โœ‹ Hand & Facial Gestures

  • Pinch (Thumb + Index Tip) : Drag/position 3D Sunglasses or spawn a circular FX lens
  • 2 Hands (4 Fingertips Out) : Draw a rectangular HUD bounding box with corner brackets
  • Hold 1 Fist (0.85 sec) : Cycle to NEXT effect
  • Hold 2 Fists (0.85 sec) : Cycle to PREVIOUS effect
  • Look into Camera : Auto-snap 3D Sunglasses onto eyes (when face is visible)

๐ŸŒ Socials:

Discord Instagram YouTube email

๐Ÿ’ป Tech Stack:

C C++ JavaScript HTML5 Windows Terminal PowerShell Python AWS Cloudflare .Net Flutter Express.js Flask NodeJS NPM Next JS WebGL Firebase Supabase Adobe Illustrator Adobe Photoshop Adobe Lightroom Adobe Premiere Pro Blender Canva Figma

๐Ÿ“Š GitHub Stats:

Star History Chart



โœ๏ธ Random Dev Quote

About

Kinda cool ig

Resources

Stars

16 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages