vanish_webcam README

项目的 README,来自 github.com/Nicovic17/vanish_webcam。合并为一个 markdown 文件:README.md。

☕ Buy me a coffee

If you like this project and want to support it, you can buy me a coffee through PayPal or Revolut.

VanishCam — webcam disappearance effects

Video is processed on your computer. It is neither recorded nor sent to a server. The preview window and virtual camera show only the video and effects, without overlaid menus, instructions, or text.

All packaged Windows EXEs require an active email license and Internet access. The first launch asks only for your license email, then binds it to this Windows device. Later launches remember the email but always check Firebase again. No password or email verification is requested. Only license/device/session data is sent; the webcam feed stays local. One running instance is allowed across editions.

The Python source launched with AVVIA_LOCALE.bat is the local development version: it starts without Firebase or a license check. Packaged EXEs retain the online license requirement. Until the server rules include a new effect, the licensed full EXE reports its session mode as full, so a valid license does not stop renewing while that effect runs.

Windows executables

Browse the shop for published downloads. To build from these sources, first copy license_config.example.json to the Git-ignored license_config.json and fill in the Firebase project ID and client API key. Then run BUILD_WINDOWS.bat. It creates four standalone EXEs in dist/:

Each EXE includes the models and assets needed for its modes. No separate Python installation is required to run it. Before opening the video, each EXE shows a camera preview: use +/- or keys 0–9 to choose the webcam, then press Use this webcam or Enter. Passing --camera N skips this screen.

Getting started

  1. Double-click AVVIA_LOCALE.bat.
  2. In the start menu, choose Normal Vanish, Naruto Vanish, Particles, Goku, or Itachi Uchiha Disappear with the mouse or keys 1 to 5.
  3. Choose your webcam in the preview, then confirm with the button or Enter. Goku then asks how long to hold the gesture to disappear or reappear: press Enter for the default 1 second, or type a positive decimal such as 0.5 or 0.1. A decimal comma (0,5) also works. Cancel stops the launch.
  4. Step out of the camera frame for 4 seconds while the empty background is captured.

Normal Vanish: Raise your index and middle fingers in a V sign. The dissolve starts as soon as the gesture is recognized and lasts about 3.6 seconds.

Particles: Make the same V sign as in Normal Vanish. Your silhouette breaks into small colored fragments that drift sideways as if carried by the wind. The effect lasts about 2.1 seconds. It captures your silhouette once when the effect starts to keep the video smooth.

Goku: After choosing the webcam, set the gesture hold time (default 1 second; decimals such as 0.5 and 0.1 are accepted). Hold your index and middle fingers straight and together against your forehead for the selected duration. Animated vertical comic-style lines run across your silhouette just before you teleport away and linger briefly afterward. To reappear, lower your hand, then repeat the gesture for the same selected duration. The return uses the reverse effect. If you break the pose, the countdown starts over. assets/teleport.MP3 plays on both disappearance and reappearance. The terminal shows the countdown for each gesture. The V and R keys are disabled in this mode: the gesture is the only way to disappear and reappear. No text is overlaid on the video.

Italiano: in modalita Goku, dopo la scelta della webcam compare una finestra per impostare il tempo di mantenimento del gesto per sparire o riapparire. Premi Invio per 1 secondo, oppure inserisci per esempio 0.5, 0.1 o 0,5. Il valore deve essere maggiore di zero. Continua conferma; Annulla o ESC chiudono l'avvio. Sparizione e riapparizione usano entrambe il tempo scelto.

Naruto Vanish: Bring your palms together in front of the webcam, with your fingers side by side rather than interlaced. Keep both hands visible. As soon as the gesture is recognized, you vanish in a cloud of smoke and a wooden log appears, falls, and remains visible until you press R. No microphone is needed. Naruto mode uses hand_landmarker.task to track both hands. assets/vanish.MP3 plays through your computer speakers when the disappearance starts, including when triggered with V. You can trigger it again after pressing R.

Itachi Uchiha Disappear: Touch both hands in front of the center of your chest, with both hands visible. Parts of your captured silhouette turn into individually flapping, cel-shaded crows that fly in curved paths. Larger crows cross the foreground, with brief ink edges, flight streaks and drifting feathers. A translucent blood-red ink texture covers the captured room during the transformation and remains while you are invisible. The supplied Sharingan eyes appear briefly at the top of the frame, then fade away. Release your hands, then touch them at your chest again to reappear as the crows converge and reconstruct your silhouette; the red background fades back to the real room. The transition lasts about 4 seconds in each direction. V previews the disappearance and R starts the animated return when you are back in frame. This mode uses the bundled hand landmarker and does not add audio. Adjust EFFECT_SECONDS and BODY_RELEASE_SECONDS in itachi_effect.py to tune its pacing.

To start a mode without the menu:

local_app\AVVIA_LOCALE.bat --mode naruto
local_app\AVVIA_LOCALE.bat --mode normal
local_app\AVVIA_LOCALE.bat --mode particles
local_app\AVVIA_LOCALE.bat --mode goku
local_app\AVVIA_LOCALE.bat --mode itachi

Virtual camera and OBS

If OBS Studio is installed, the app automatically tries to open OBS Virtual Camera. The terminal shows the device name. Use AVVIA_VIRTUAL.bat to require a virtual camera. Select OBS Virtual Camera in the app that will receive the video. OBS's virtual camera must be stopped while this app is producing its output.

To use the effect in an OBS scene, run AVVIA_OBS.bat, add a Window Capture source, select Webcam - Anteprima, and then start the virtual camera from OBS. Alternatively, use Unity Capture as a separate virtual video source:

local_app\AVVIA_VIRTUAL.bat --virtual-backend unitycapture

OBS has only one virtual camera. Do not use it as both an OBS input and output at the same time. See the pyvirtualcam documentation.

Controls

The V and R keys are disabled in Goku mode.

You can change the camera, resolution, and maximum virtual-output FPS:

local_app\AVVIA_LOCALE.bat --camera 1 --width 1280 --height 720 --fps 30

To troubleshoot gesture recognition without adding text to the video, pass --gesture-debug. Diagnostic information appears only in the terminal.

Visual assets

The wooden log is an original illustration generated with ImageGen using the supplied image as a visual reference. Smoke is drawn in real time by naruto_effect.py so it follows the person's position and scales with the video. We also considered a CC0 smoke sprite sheet, but the procedural animation adapts better to dynamic positioning without an additional asset.

Goku mode uses the MediaPipe BlazeFace short-range model to estimate the forehead position and hand_landmarker.task to track the fingers. The teleport's visual trace is drawn in code, without anime frames.

vanish_webcam (Nicovic17/vanish_webcam)

正在搜索数据库…

这是什么?VanishCam 是一款桌面摄像头应用,可通过动漫风格的特效让你在镜头前消失再出现(包括鸣人式烟雾与木桩、悟空式瞬移、粒子消散,或简单淡出),由手势触发,所有处理都在你自己的电脑上完成。
这是可以导入的库,还是独立应用?这是一款独立的桌面应用,而不是库:你可以运行 Windows 的 EXE,或启动随附的 .bat 脚本,无需向代码库添加任何内容。
怎样才能让它运行起来?在 Windows 上,下载 VanishCam.exe 后双击即可(无需 Python)。若要改为从源码运行,双击 AVVIALOCALE.bat;如果需要虚拟摄像头输出,则使用 AVVIAVIRTUAL.bat 或 AVVIAOBS.bat。
运行前是否需要先安装 Python、OBS 或其他软件?运行 EXE 不需要安装 Python。只有当你想把输出作为虚拟摄像头送入 OBS 时,才需要 OBS Studio;粒子和悟空模式可能需要使用脚本,而不是已发布的 EXE。
在试用之前有哪些需要注意的地方?预先构建的 EXE 可能不包含粒子和悟空模式;OBS 只支持一个虚拟摄像头,因此无法同时将其既作为输入又作为输出;另外,手势姿势一旦中断,倒计时就会重置。
这只能在 Windows 上使用吗?开箱即用的版本是 Windows EXE,启动脚本也是 .bat 文件,因此它是为 Windows 设计的。
我的视频会离开我的电脑吗?不会,所有处理都在本地完成;不会录制或发送任何内容,输出画面只包含视频和特效,不会叠加任何文字。
一共有几种消失模式?它们是什么样的?共四种模式:普通消失(比出 V 字手势触发快速消散)、鸣人消失(双掌合十后身体在烟雾中消失,留下一根木桩)、粒子(人物轮廓碎裂成漂浮的彩色碎片)、悟空(手指按在额头上即可瞬移离开,并伴有漫画式的速度线)。
可以把它当作 Zoom 或 Discord 的摄像头使用吗?可以。该应用可输出到 OBS Virtual Camera 或 Unity Capture,你只需在任意视频通话应用中将其选为摄像头来源即可。
它如何判断我想要消失?它使用 MediaPipe 的 BlazeFace 模型和手部关键点跟踪器,识别每种模式对应的特定手指和手掌手势,从而代替按键操作。
烟雾和木桩的素材是取自鸣人动画吗?不是。木桩是原创的 AI 生成插图,烟雾则由应用自身的代码实时程序化绘制,并未使用动画画面。
作者
Nicovic17
大小
11.1 MB
星标
971
更新
提交Nov 06
时长
1个月
提交 · 90 天