|
1 | | -# Chrome-WebSocket-Proxy-for-OBS |
| 1 | +# OBS Chrome WebSocket Extension |
| 2 | + |
| 3 | +This Chrome extension monitors WebSocket traffic and forwards it to OBS (Open Broadcaster Software), bridging web applications and OBS for real-time interaction and updates. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +- Monitor WebSocket traffic in Chrome |
| 8 | +- Forward WebSocket messages to OBS |
| 9 | +- Connect to OBS WebSocket server |
| 10 | +- User-friendly popup interface |
| 11 | +- Configurable settings |
| 12 | + |
| 13 | +## Installation |
| 14 | + |
| 15 | +1. Clone this repository or download the source code. |
| 16 | +2. Open Chrome and navigate to `chrome://extensions/`. |
| 17 | +3. Enable "Developer mode" in the top right corner. |
| 18 | +4. Click "Load unpacked" and select the directory containing the extension files. |
| 19 | + |
| 20 | +## Usage |
| 21 | + |
| 22 | +1. Click the extension icon in Chrome to open the popup interface. |
| 23 | +2. Use "Connect Chrome WS" to start monitoring WebSocket traffic. |
| 24 | +3. Use "Connect to OBS" to establish a connection with your OBS WebSocket server. |
| 25 | +4. The popup displays connection status and message statistics. |
| 26 | + |
| 27 | +## Configuration |
| 28 | + |
| 29 | +1. Right-click the extension icon and select "Options". |
| 30 | +2. Set the OBS WebSocket server URL and password. |
| 31 | +3. Click "Save Settings" to apply changes. |
| 32 | + |
| 33 | +## Files Overview |
| 34 | + |
| 35 | +- `manifest.json`: Extension configuration |
| 36 | +- `background.js`: Main extension logic |
| 37 | +- `popup.html` and `popup.js`: User interface and functionality |
| 38 | +- `options.html` and `options.js`: Settings page and functionality |
| 39 | + |
| 40 | +## Development |
| 41 | + |
| 42 | +To modify or extend the extension: |
| 43 | + |
| 44 | +1. Edit relevant files (e.g., `background.js` for core logic, `popup.js` for UI interactions). |
| 45 | +2. Reload the extension in Chrome to apply changes. |
| 46 | +3. Use Chrome's developer tools for debugging. |
| 47 | + |
| 48 | +## License |
| 49 | + |
| 50 | +This project is licensed under the GNU Lesser General Public License v2.1. |
| 51 | + |
| 52 | +## Contributing |
| 53 | + |
| 54 | +Contributions are welcome! Please feel free to submit a Pull Request. |
| 55 | + |
| 56 | +## Support |
| 57 | + |
| 58 | +If you encounter issues or have questions, please file an issue on the GitHub repository. |
| 59 | + |
| 60 | +## Acknowledgements |
| 61 | + |
| 62 | +- [OBS Studio](https://obsproject.com/) for providing a robust platform for live streaming. |
| 63 | +- [OBS WebSocket](https://github.com/obsproject/obs-websocket) for enabling WebSocket control of OBS. |
| 64 | + |
| 65 | +## Disclaimer |
| 66 | + |
| 67 | +This project is not officially affiliated with OBS Studio or its WebSocket plugin. Use it at your own risk. |
0 commit comments