meowmeowcatcam README

The project's README from github.com/catherpiee/meowmeowcatcam. As one markdown file: README.md.

Gesture Meme Detector

Turn the camera on, make some gestures listed below to have the cat meme pop up next to you!

It will show up as:

Gestures

# Gesture How to trigger
1 Fingers Together (muehehe) Both hands up, index fingers only, tips touching
2 Devastated cat Both hands up, above the top of your head
3 Crash out Cat Both hands up beside your face, not above your head
4 Fist One hand, all four fingers curled
5 Rockstar Thumb + pinky out
6 Shhh Index finger only, tip resting on your mouth
7 One Finger Up Index finger only, held away from your face
8 Kidnap cat Any hand shape sitting where your face just was
9 i HAVE NO MONIES One open palm, all fingers extended, away from your face
10 Side Eye Just turn your head
11 Default Nothing in particular, hands down
12 Judgy cat while munching on food Look down slightly sideways
13 Huh Open your mouth and be shocked
14 O I I.A I SPIN SPIN SPIN

Meme images live in memes/. A couple of gestures pick randomly between multiple images.

Running it — desktop (Python)

Requires Python 3 and a webcam.

Easiest way: just double click Launch Gesture Meme.command. First run takes a minute to set itself up (installs everything automatically), then launches straight away. Every run after that is instant.

First time opening it: macOS will warn "cannot be opened because it is from an unidentified developer" — this is normal for any downloaded script, not specific to this one. Right-click the file → Open → click Open in the dialog that appears. You only need to do this once.

Or manually, if you prefer Terminal:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 gesture_meme.py

Press q or Esc in the Camera window to quit.

Running it — browser

No install needed, but the webcam API requires serving over HTTP (opening index.html directly as a file:// URL will not get camera permission). From this folder:

python3 -m http.server 8000

Then open http://localhost:8000 and allow camera access. Models load from Google's hosted MediaPipe CDN at runtime, so nothing local is needed for the browser version.

Live debug HUD

The Camera window always shows a small readout in the top-left corner:

gesture: sideEyeCat
yaw: +18.4 deg  (side-eye thr +/-15.0)

Useful for tuning the detection thresholds at the top of gesture_meme.py / app.js if a gesture is triggering too easily or not easily enough for your setup/lighting.

Project layout

gesture_meme.py   desktop version (OpenCV + MediaPipe Python tasks API)
app.js            browser version (MediaPipe tasks-vision WASM)
index.html        browser UI shell
memes/            meme images (+ one video, unused for now)
models/           MediaPipe .task model files used by the desktop version
requirements.txt  Python dependencies

meowmeowcatcam (catherpiee/meowmeowcatcam)

Searching Database…

256 ·GitHub
Meowmeowcatcam
Что это?Детектор жестов-мемов для веб-камеры: он следит за жестами рук и движениями головы через камеру и в реальном времени показывает подходящий мем с котом рядом с вашим живым видео.
Это десктопное приложение или то, что работает в браузере?И то и другое — есть десктопная версия на Python, запускаемая двойным щелчком по .command-файлу, и простая браузерная версия (index.html + app.js), которая использует API веб-камеры напрямую, без установки.
Как это запустить?Для десктопа просто дважды щёлкните «Launch Gesture Meme.command» — первый запуск всё установит автоматически, а каждый следующий стартует мгновенно. Для браузерной версии раздавайте папку по HTTP и откройте index.html, затем разрешите доступ к камере.
Нужен ли установленный Python или что-то ещё?Десктопной версии нужны Python 3 и веб-камера; браузерной версии ничего локального не нужно, поскольку модели отслеживания рук загружаются на лету с CDN MediaPipe, размещённого Google.
Есть подводные камни при первом открытии?На macOS первый запуск предупредит, что файл «нельзя открыть, так как он от неустановленного разработчика», — щёлкните по файлу правой кнопкой, выберите «Открыть» и подтвердите; это нужно сделать один раз. Браузерная версия также не получит доступ к камере, если открыть index.html напрямую как file:// URL — её нужно раздавать по HTTP.
Это работает только на macOS?Десктопный лаунчер — это скрипт .command для macOS с характерными для macOS предупреждениями о неустановленном разработчике, так что он сделан для macOS; браузерная версия должна работать на любой системе с веб-камерой и поддержкой камеры в браузере.
Какие жесты он распознаёт?Всего 14 жестов: от положений пальцев вроде «Fist», «Rockstar» (большой палец + мизинец) и «Shhh» до движений головы/лица вроде «Side Eye», «Huh» и вращающегося жеста «O I I.A I» — каждый запускает свой мем с котом.
Зачем нужен живой отладочный HUD?В окне Camera в левом верхнем углу всегда показана небольшая сводка, чтобы вы могли настроить пороги распознавания в gesturememe.py или app.js, если жест срабатывает слишком легко или недостаточно легко при вашем освещении и настройке.
Можно подставить свои мемы?Да, картинки мемов лежат в папке memes/, и некоторые жесты случайно выбирают между несколькими картинками для этого жеста.
Как закрыть десктопное приложение?Нажмите q или Esc, когда окно Camera в фокусе.
What are similar projects?itsgiving, freemocap, barehands, window-sweaters, Deep-Live-Cam, camera-to-blender, revpdf-release, facefusion
Which topics is it in?meme, gesture-control, webcam, camera, face-detection, fun, interactive, image, macos-app, app, computer-vision, html
Creator
catherpiee
Size
15.9 MB
Stars
256
Updated
CommitAug 29
Age
2mo
Commits · 90 Days