Skip to content

Commit 402b4cb

Browse files
authored
Update README.md
1 parent becfdc1 commit 402b4cb

1 file changed

Lines changed: 67 additions & 1 deletion

File tree

README.md

Lines changed: 67 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,67 @@
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

Comments
 (0)