Skip to content

programmerbeast2004/SIGN_BRIDGE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🀟 SignBridge: Making Gestures Accessible

Team GIF

Bridging Communication Gaps with Real-Time Gesture Translation

Live Site Download EXE

✨ At a Glance

Category Details
Purpose Real-time sign language translation for video calls
Tech Stack Python, TensorFlow/MediaPipe, OBS, JavaScript,
Deployment Standalone EXE + OBS Virtual Camera
Key Features Gesture recognition, dynamic overlays, TTS
Team 4 developers (see below)

🌟 Why SignBridge?

"Because every gesture deserves to be seen and heard."

We solve three critical challenges in virtual communication:

1-πŸ‘οΈ Visibility Issues - Clear text overlays that stay visible for all participants
2-πŸ”„ Platform Fragmentation - Works with any video conferencing tool via OBS Virtual Cam
3-⏱️ Real-Time Lag - Instant gesture-to-text translation with <200ms latency


Technical Deep Dive
---

🌐 Website Preview

Website Preview

πŸ‘₯ Meet The Team

Name Role Contributions LinkedIn
Arjit Core Developer β€’ Webcam/OBS pipeline
β€’ TTS integration
β€’ Cross-platform testing
LinkedIn
Apoorv ML Engineer β€’ EXE packaging
β€’ Model training
β€’ Performance optimization
LinkedIn
Ishita UI/UX Designer β€’ Website development
β€’ Branding
β€’ EXE download portal
LinkedIn
Sree QA & Docs β€’ Testing
β€’ Documentation
β€’ OBS scene templates
LinkedIn

πŸ–ΌοΈ Preview Exe

Preview 1 Preview 2

πŸš€ Getting Started

πŸ’Ώ Installation (For Users)

  1. Download πŸ‘‰ SignBridgePro_Setup.exe
  2. Install OBS Studio + Virtual Camera plugin
  3. Run SignBridge and follow the setup wizard

πŸ”§ Manual Build (For Developers)

This section is for developers who want to build, modify, or contribute to SignBridgePro locally. It includes complete details of the build pipeline, folder structure, and troubleshooting tips.


πŸ“ Project Structure

1.Model Working logic/
β”œβ”€β”€ model/                              # Trained model files
β”‚   β”œβ”€β”€ label_map.npy
β”‚   └── sign_model.h5
β”œβ”€β”€ test_sequence/                      # Folder for test input sequences
β”œβ”€β”€ generate_test_sequence.py           # Creates test image sequences
β”œβ”€β”€ predict_from_images.py              # Predicts from static image folders
β”œβ”€β”€ requirements.txt                    # Model-specific dependencies
β”œβ”€β”€ SETUP.txt                           # Setup or instructions (optional)
β”œβ”€β”€ simulate_sequence_video.py          # Simulates sign input from video
β”œβ”€β”€ test_model.py                       # Model evaluation or testing script
└── train_model.ipynb                   # Notebook to train the sign recognition model
2.exe logic formation/
β”œβ”€β”€ assets/                             # App icons and visuals
β”‚   └── signBridge_icon.ico
β”œβ”€β”€ build/                              # Auto-generated temp files during PyInstaller build
β”‚   └── SignBridgePro/
β”œβ”€β”€ dependencies/                       # System-level dependencies
β”‚   └── VC_redist.x64.exe               # Required for running EXE on Windows
β”œβ”€β”€ dist/                               # Final build artifacts
β”‚   └── caption_output.txt              # Output from real-time translations
β”œβ”€β”€ installers/                         # OBS installers for virtual camera support
β”‚   β”œβ”€β”€ OBS-Studio-31.1.1-Windows-x64-installer.exe
β”‚   └── OBS-VirtualCam2.0.4-installer.exe
β”œβ”€β”€ model/                              # ML model and label mappings
β”‚   β”œβ”€β”€ label_map.npy
β”‚   └── sign_model.h5
β”œβ”€β”€ build_exe.bat                       # Script to generate EXE from Python
β”œβ”€β”€ create_installer.bat                # Script to generate Windows installer
β”œβ”€β”€ LICENSE.TXT
β”œβ”€β”€ main.py                             # Main Python script for real-time translation
β”œβ”€β”€ README.md
β”œβ”€β”€ requirements.txt                    # Python dependencies
β”œβ”€β”€ settings.json                       # App config (e.g., voice toggle, overlay path)
β”œβ”€β”€ SignBridgePro.spec                  # Auto-generated PyInstaller config
└── simple_installer.nsi               # NSIS script for installer creation
3.Website Code/
β”œβ”€β”€ .gitignore                        # Git ignore rules
β”œβ”€β”€ apoorv.jpg                        # Project asset
β”œβ”€β”€ arijit.jpg                        # Project asset
β”œβ”€β”€ GitHub_logo.png                   # GitHub icon
β”œβ”€β”€ hand.jpg                          # Hand icon
β”œβ”€β”€ Hocurx_ppt.pdf                    # Presentation
β”œβ”€β”€ image.png                         # Web graphic
β”œβ”€β”€ index.html                        # Main HTML entry point
β”œβ”€β”€ ishita.jpg                        # Project asset
β”œβ”€β”€ linkedin_logo.png                 # LinkedIn icon
β”œβ”€β”€ logo_sb.jpg                       # Project logo
β”œβ”€β”€ package.json                      # Node.js dependencies
β”œβ”€β”€ package-lock.json                 # Exact dependency tree
β”œβ”€β”€ script.js                         # Frontend JavaScript
β”œβ”€β”€ server.js                         # Backend (Node.js) script
β”œβ”€β”€ sree.jpg                          # Project asset
β”œβ”€β”€ styles.css                        # Custom styling
└── .bolt/                            # Tool or config folder (purpose-defined)

πŸ› οΈ Build Process Explained

1. πŸ” Clone & Setup the Project

git clone https://github.com/your-repo/SignBridge.git
cd SignBridge
pip install -r requirements.txt

2. βš™οΈ Generate Executable

build_exe.bat
This does the following:
1. Generates SignBridgePro.spec
2. Creates build/SignBridgePro/ folder (temp build files)
3. Creates dist/ folder with final .exe and dependencies

3. πŸ“¦ Create Windows Installer

create_installer.bat
This uses simple_installer.nsi with NSIS to:
1. Bundle the .exe from dist/
2. Include dependencies (OBS, VirtualCam, VC_redist)
3. Generate SignBridgePro_Setup.exe

πŸ’‘ Pro Tips for Smooth Setup

βœ… First-Time Setup

  1. Install NSIS from: https://nsis.sourceforge.io/
  2. Install OBS Studio + Virtual Camera Plugin
  3. If EXE gives DLL errors β†’ run VC_redist.x64.exe from dependencies/

πŸ› Debugging Builds

  1. Check build/warn-SignBridgePro.txt if the build fails
  2. Ensure all necessary files are present in the dist/ folder
  3. OBS might lock files β€” close OBS before running build_exe.bat

πŸ›  Customizing the Installer

Edit the simple_installer.nsi script to:

  1. Change the default installation directory
  2. Add uninstall shortcut or registry entries
  3. Embed a license agreement, changelog, or version notes