Skip to content

Latest commit

 

History

History
187 lines (143 loc) · 5.14 KB

README.md

File metadata and controls

187 lines (143 loc) · 5.14 KB
Raw

VoiceControlled-BackgroundChanger 🎥

A sophisticated Python application that revolutionizes your video call experience with real-time background replacement, voice control, AR effects, and audio visualization. Perfect for virtual meetings, content creation, and streaming.

🌟 Key Features

Background Management

  • Real-time Background Replacement: Seamless background switching during live video
  • Multiple Background Types:
    • Static image backgrounds
    • Video backgrounds
    • Blur effect
    • Portrait mode with depth effect
  • Voice Control: Change backgrounds using voice commands
    • "Next" - Switch to next background
    • "Previous" - Switch to previous background

AR Effects

  • Real-time Head Tracking: AR props follow your head movements
  • Customizable Props: Support for custom AR overlay elements
  • Size Controls: Adjust AR prop size in real-time
  • Position Tracking: Natural movement and positioning

Audio Features

  • Voice Command Recognition: Hands-free control
  • Real-time Audio Visualization: See your microphone input levels
  • Integrated Audio Processing: Clean audio recording capabilities

Recording & Output

  • High-Quality Recording: Combined audio/video recording
  • Screenshot Function: Capture moments instantly
  • Multiple Output Formats: Support for various video codecs
  • Customizable Quality: Adjustable recording parameters

🛠️ Technology Stack

  • Core Technologies:
    • Python 3.8+
    • OpenCV
    • MediaPipe
    • PyQt5
    • Speech Recognition
    • PyAudio
    • NumPy

🚀 Getting Started

Prerequisites

# Required software
- Python 3.8 or higher
- pip package manager
- Webcam
- Microphone

Installation

  1. Clone the repository:
git clone https://github.com/officialjwise/VoiceControlled-BackgroundChanger.git
cd VoiceControlled-BackgroundChanger
  1. Install dependencies:
pip install -r requirements.txt
  1. Set up project structure:
project_folder/
├── backgrounds/         # Background images (.jpg/.png)
├── video_backgrounds/   # Video files (.mp4/.avi)
├── ar_props/           # AR props (.png with transparency)
├── screenshots/        # Generated screenshots
├── recordings/         # Saved recordings
└── main.py            # Application entry point

Configuration

  1. Add background images to backgrounds/
  2. Add video files to video_backgrounds/
  3. Add AR props to ar_props/

Running the Application

python main.py

💡 Usage Guide

Basic Controls

  • Background Selection: Use dropdown menu or voice commands
  • AR Effects: Toggle button in control panel
  • Recording: Start/Stop button for video capture
  • Screenshots: Capture button for still images

Voice Commands

  • Say "Next" to switch to next background
  • Say "Previous" to return to previous background

Keyboard Shortcuts

  • Esc - Exit application
  • Space - Toggle AR effects
  • S - Take screenshot
  • R - Start/Stop recording

📂 Project Structure

src/
├── main.py                    # Entry point
├── background_handler.py      # Background processing
├── ar_effects.py             # AR implementation
├── audio_handler.py          # Audio processing
└── ui/                       # UI components
    ├── main_window.py
    ├── controls.py
    └── previews.py

🎯 Troubleshooting

Common Issues & Solutions

  1. Camera Access

    • Ensure no other applications are using the camera
    • Check camera permissions
    • Try restarting the application

  2. Voice Commands

    • Verify microphone permissions
    • Check internet connection
    • Speak clearly and maintain proper distance

  3. Video Playback

    • Ensure video codec compatibility (H.264 recommended)
    • Check video file integrity
    • Verify supported format (.mp4/.avi)

🤝 Contributing

We welcome contributions! See our Contributing Guidelines for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📝 License

This project is open source and available under the MIT License. See LICENSE file for details.

🙌 Acknowledgments

  • OpenCV Team: For computer vision capabilities
  • MediaPipe: For face detection and segmentation
  • PyQt: For the GUI framework
  • Python Community: For various helpful resources
  • All Contributors: Who help improve this project

📞 Contact & Support

✨ Future Plans

  • Additional voice commands
  • More AR effects
  • Custom background filters
  • Stream integration
  • Multi-language support
⌨️ with ❤️ by Official J-Wise 🚀

If you found this project helpful, please consider giving it a ⭐️!