reCamera Video Streamer 🎥

Powered by Seeedstudio's reCamera & Raspberry Pi

A powerful RTSP video streaming solution that combines the capabilities of reCamera with an intuitive web interface. Built on GStreamer and Gradio, this project provides a seamless way to view and manage your reCamera stream.

⚡ Key Features

• 🎮 Real-time RTSP streaming
• 🖥️ Clean web interface powered by Gradio
• 📊 Live FPS monitoring
• 🤖 OpenAI GPT-OSS analysis button below each camera stream
• 🧠 Switch between Hailo-8L and reCamera inference sources with the UI dropdown
• 📡 Device info panel is collapsible, surfacing a quick summary and full metrics grid
• 🔄 Automatic reconnection
• 🌐 Network-wide accessibility
• 🚀 Low-latency streaming
• 💻 Cross-platform compatibility

🛠️ Prerequisites

• Python 3.7+
• GStreamer and plugins
• Raspberry Pi (recommended)
• reCamera device

📦 Installation

# Clone the repository
git clone https://github.com/Hey-Salad/recamera-streamer.git
cd recamera-streamer

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\\Scripts\\activate

# Install dependencies
pip install -r requirements.txt

# Install GStreamer plugins (Ubuntu/Debian)
sudo apt-get update
sudo apt-get install -y \\
    gstreamer1.0-tools \\
    gstreamer1.0-plugins-base \\
    gstreamer1.0-plugins-good \\
    gstreamer1.0-plugins-bad \\
    gstreamer1.0-plugins-ugly \\
    gstreamer1.0-libav

🚀 Quick Start

1. Connect your reCamera to your network
2. Update the RTSP URL if needed in streamer.py
3. Run the streamer:

python streamer.py

4. Open your browser and navigate to:
   • Local: http://localhost:7860
   • Network: http://[YOUR_PI_IP]:7860

🔧 Configuration

The default configuration works with reCamera's standard settings:

• RTSP URL: rtsp://admin:admin@192.168.42.1:554/live
• Port: 7860
• Video Format: H.264

Frontend (.env)

VITE_WS_URL=ws://localhost:9200/ws
VITE_API_URL=http://localhost:9200
VITE_GPT_BACKEND_URL=http://localhost:5000

Leaving these values empty lets the UI derive the backend host from the current page, which is handy when the React app and backend run on the same host (e.g., local dev or Cloudflare Pages).

GPT Backend (.env)

Use the Hugging Face-powered GPT-OSS service located at /home/admin/heysalad-gpt-oss-kiosk-backend. Launch the Flask app before clicking the OpenAI analysis button.

cd /home/admin/heysalad-gpt-oss-kiosk-backend
source venv/bin/activate
python heysalad_backend.py

Set VITE_GPT_BACKEND_URL to wherever heysalad_backend.py listens (default http://localhost:5000) so the UI can hit /api/ai/recommendation.

📱 Accessing the Stream

• Local Network: http://[YOUR_PI_IP]:7860
• Same Device: http://localhost:7860
• Public Access: Use the provided share link (if enabled)

🛟 Troubleshooting

1. No Video Stream:

   • Verify reCamera is powered on
   • Check network connectivity
   • Confirm RTSP URL and credentials

2. Performance Issues:

   • Reduce network latency
   • Check CPU usage
   • Verify GStreamer installation

📚 Technical Details

Built using:

• GStreamer: Media pipeline
• Gradio: Web interface
• Python: Core logic
• OpenH264: Video decoding

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to your branch
5. Create a Pull Request

❤️ Support

If you find this project useful, consider:

📫 Contact

• Website: heysalad.io
• Email: hello@heysalad.io

📄 License

Copyright (C) 2025-2026 HeySalad Inc.

Licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). See LICENSE and NOTICE. If you run a modified version of this software to provide a network service, the AGPL requires you to offer its users the corresponding source code. Versions published before this change remain under their previous licence.

---

Made with ❤️ by HeySalad