{"id":28505425,"url":"https://github.com/kamalarnav04/stealthcam","last_synced_at":"2026-04-18T17:04:55.860Z","repository":{"id":297784413,"uuid":"997893071","full_name":"kamalarnav04/StealthCam","owner":"kamalarnav04","description":"StealthCam is a lightweight remote monitoring tool that turns your computer into a live surveillance device. It captures video and audio streams from your system and securely transmits them to your connected phone in real-time via a web interface.","archived":false,"fork":false,"pushed_at":"2025-06-07T13:07:16.000Z","size":191,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-07T13:27:43.733Z","etag":null,"topics":["javascript","nextjs","nodejs","security-tool","spy-camera","surveillance"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kamalarnav04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-07T12:21:36.000Z","updated_at":"2025-06-07T13:10:30.000Z","dependencies_parsed_at":"2025-06-07T13:38:08.539Z","dependency_job_id":null,"html_url":"https://github.com/kamalarnav04/StealthCam","commit_stats":null,"previous_names":["kamalarnav04/stealthcam"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kamalarnav04/StealthCam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamalarnav04%2FStealthCam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamalarnav04%2FStealthCam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamalarnav04%2FStealthCam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamalarnav04%2FStealthCam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kamalarnav04","download_url":"https://codeload.github.com/kamalarnav04/StealthCam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamalarnav04%2FStealthCam/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263556977,"owners_count":23480105,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","nextjs","nodejs","security-tool","spy-camera","surveillance"],"created_at":"2025-06-08T19:07:27.254Z","updated_at":"2026-04-18T17:04:55.817Z","avatar_url":"https://github.com/kamalarnav04.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StealthCam 🕵️‍♂️\n\n**StealthCam is a lightweight remote monitoring tool that turns your computer into a live surveillance device. It captures video and audio streams from your system and securely transmits them to your connected phone in real-time via a web interface.**\n\nPerfect for discrete monitoring, security purposes, or remote surveillance when you need to keep an eye on your space from anywhere.\n\n## 📸 Screenshot\n\n![StealthCam Interface](Screenshots/image.png)\n\n*StealthCam's computer client interface showing video preview, stream controls, and ghost mode functionality*\n\n## ✨ Key Features\n\n### 🎥 **Real-time Surveillance**\n- Live video and audio streaming from computer to mobile device\n- High-quality WebRTC streaming with minimal latency\n- Adaptive quality settings (Low/Medium/High) based on connection\n- Real-time peer-to-peer connection for maximum security\n\n### 🔐 **Security \u0026 Privacy**\n- JWT-based authentication system\n- Secure WebRTC connections with STUN servers\n- No data persistence - streams are not recorded or stored\n- Password-protected access to prevent unauthorized viewing\n\n### 📱 **Cross-Platform Access**\n- **Computer Client**: Acts as the surveillance camera (streams video/audio)\n- **Mobile Client**: Remote viewing device with touch controls\n- Responsive web interface works on any device with a browser\n- No app installation required\n\n### 👻 **Stealth Features**\n- **Ghost Mode**: Instantly black out the computer screen (ESC to exit)\n- Discrete interface that doesn't draw attention\n- Silent operation with minimal system footprint\n- Quick activation and deactivation controls\n\n### 🎛️ **Remote Controls**\n- Start/stop streaming remotely from mobile device\n- Request live feeds on-demand\n- Volume control and mute functionality\n- Fullscreen viewing for better monitoring\n- Real-time connection status indicators\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Node.js 18 or higher\n- Modern web browser with WebRTC support\n- Camera and microphone on the computer to monitor\n- Stable internet connection\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/stealthcam.git\n   cd stealthcam\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   # Copy the example environment file\n   cp .env.example .env.local\n   ```\n   \n   Update `.env.local` with your configuration:\n   ```env\n   JWT_SECRET=your-super-secret-jwt-key-here\n   NEXTAUTH_SECRET=your-nextauth-secret-here\n   NEXTAUTH_URL=http://localhost:3000\n   ```\n\n4. **Start the development server**\n   ```bash\n   npm run dev\n   ```\n\n5. **Access the application**\n   - Open `http://localhost:3000` in your browser\n   - Set up your surveillance system in minutes!\n\n## 📖 How to Use\n\n### Setting Up the Surveillance Computer\n\n1. **Login on the target computer**\n   - Open StealthCam in a web browser\n   - Create an account with username/password\n   - Select **\"Computer\"** as device type\n   - Grant camera and microphone permissions\n\n2. **Configure stream settings**\n   - Choose quality: Low (640x480), Medium (720p), or High (1080p)\n   - Test camera and microphone functionality\n   - Use **Ghost Mode** to hide the interface when needed\n\n3. **Start surveillance**\n   - Click \"Start Stream\" to begin broadcasting\n   - The computer is now ready for remote monitoring\n\n### Remote Monitoring from Mobile\n\n1. **Connect from your phone**\n   - Open the same URL on your mobile device\n   - Login with the same username/password\n   - Select **\"Mobile\"** as device type\n\n2. **View live feed**\n   - Tap \"Request Stream\" to connect to the surveillance feed\n   - Use touch controls for volume, mute, and fullscreen\n   - Monitor in real-time from anywhere\n\n### Stealth Operation\n\n- **Quick Hide**: Use the Ghost Mode button to instantly black out the computer screen\n- **Emergency Exit**: Press ESC key to exit Ghost Mode quickly\n- **Discrete Access**: Login appears as a normal web application\n- **Silent Running**: Minimal system impact during operation\n\n## 🛠️ Technology Stack\n\n- **Frontend**: Next.js 15, React 19, TypeScript\n- **Real-time**: Socket.IO, WebRTC for P2P streaming\n- **Authentication**: JWT tokens, bcryptjs encryption\n- **Styling**: Tailwind CSS with responsive design\n- **Streaming**: MediaStream API, RTCPeerConnection\n\n## 🏗️ Project Structure\n\n```\nstealthcam/\n├── src/\n│   ├── app/                # Next.js app router\n│   │   ├── api/           # Authentication APIs\n│   │   └── globals.css    # Global styling\n│   ├── components/        # React components\n│   │   ├── ComputerClient.tsx  # Surveillance computer interface\n│   │   ├── MobileClient.tsx    # Mobile viewing interface\n│   │   └── LoginForm.tsx       # Authentication form\n│   ├── contexts/          # React contexts\n│   │   ├── AuthContext.tsx     # Authentication state\n│   │   └── StreamContext.tsx   # Streaming state\n│   └── lib/               # Utility libraries\n│       ├── socket.ts      # Socket.IO configuration\n│       └── webrtc.ts      # WebRTC utilities\n├── public/                # Static assets\n└── package.json           # Project dependencies\n```\n\n## 🔒 Security Considerations\n\n### Authentication\n- All sessions are protected with JWT tokens\n- Passwords are hashed using bcryptjs\n- No sensitive data is stored permanently\n\n### Network Security\n- WebRTC provides encrypted P2P connections\n- Use HTTPS in production environments\n- STUN servers handle NAT traversal securely\n\n### Privacy\n- No video or audio data is recorded or stored\n- Streams are live-only and disappear when disconnected\n- No analytics or tracking implemented\n\n## 📋 System Requirements\n\n### Computer (Surveillance Device)\n- Modern web browser (Chrome, Firefox, Safari, Edge)\n- Working camera and microphone\n- Stable internet connection\n- Minimum 2GB RAM recommended\n\n### Mobile Device (Monitoring)\n- Any smartphone or tablet with a web browser\n- Internet connection (WiFi or cellular)\n- Modern browser with WebRTC support\n\n## 🚨 Legal Notice\n\n**Important**: This software is intended for legitimate surveillance and monitoring purposes only. Users are responsible for:\n\n- Complying with local privacy and surveillance laws\n- Obtaining proper consent when monitoring spaces with people\n- Using the software ethically and legally\n- Ensuring they have permission to monitor the location\n\nThe developers are not responsible for misuse of this software.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Development Setup\n```bash\n# Clone the repo\ngit clone https://github.com/yourusername/stealthcam.git\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n\n# Build for production\nnpm run build\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\nIf you encounter any issues or have questions:\n\n1. Check the [Issues](https://github.com/yourusername/stealthcam/issues) page\n2. Create a new issue with detailed information\n3. Include browser version, OS, and error messages\n\n## 🔄 Version History\n\n- **v0.1.0** - Initial release\n  - Basic streaming functionality\n  - Authentication system\n  - Ghost mode for stealth operation\n  - Mobile and computer clients\n\n---\n\n**⚠️ Use Responsibly**: StealthCam is a powerful surveillance tool. Always ensure you have proper authorization before monitoring any location or individuals.\n\n---\n\n## 🚀 Easy Hosting on Replit (No Local Setup Needed)\n\nYou can run **StealthCam** directly in the cloud using [Replit](https://replit.com) – no need to install anything or be on the same Wi-Fi network.\n\n### 👉 How to Run on Replit\n\n1. Go to [https://replit.com](https://replit.com) and log in or sign up.\n2. Click on the **\"Create Repl\"** button.\n3. Select **\"Import from GitHub\"** and paste this repo URL: https://github.com/kamalarnav04/StealthCam\n4. Once it imports, open the **Shell** tab and run: npm install\n5. Create a file named .env.local in the root folder\n6. Then start the development server\n7. Copy the temporary link shown in the Replit webview — you can now access StealthCam from anywhere 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamalarnav04%2Fstealthcam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamalarnav04%2Fstealthcam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamalarnav04%2Fstealthcam/lists"}