├── .github
    ├── live-obs.png
    ├── sequence-diagram.png
    ├── stream-obs.png
    └── unconnected-browser.png
├── LICENSE
├── README.md
├── go.mod
├── go.sum
└── main.go


/.github/live-obs.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Sean-Der/OBS2Browser/c153bc3a717c5118d5a6e6edf9799aac94e3e216/.github/live-obs.png


--------------------------------------------------------------------------------
/.github/sequence-diagram.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Sean-Der/OBS2Browser/c153bc3a717c5118d5a6e6edf9799aac94e3e216/.github/sequence-diagram.png


--------------------------------------------------------------------------------
/.github/stream-obs.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Sean-Der/OBS2Browser/c153bc3a717c5118d5a6e6edf9799aac94e3e216/.github/stream-obs.png


--------------------------------------------------------------------------------
/.github/unconnected-browser.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Sean-Der/OBS2Browser/c153bc3a717c5118d5a6e6edf9799aac94e3e216/.github/unconnected-browser.png


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2023
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 6 | 
 7 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 8 | 
 9 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
10 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # OBS2Browser
 2 | 
 3 | OBS2Browser allows you to connect OBS directly to your web browser. Your audio/video goes
 4 | directly into your browser via P2P. This will reduce your stream delay and save on bandwidth costs!
 5 | On a properly configured local machine you can expect to see sub-100ms times.
 6 | 
 7 | To do this we use the newly added WHIP output in OBS. With WebRTC you can now have a low latency P2P broadcast in OBS.
 8 | 
 9 | If you want to do a 'one to many' broadcast [Broadcast Box](https://github.com/glimesh/broadcast-box) might be a better option.
10 | OBS2Browser can only support one viewer at a time, while Broadcast Box has no upper limit.
11 | 
12 | ## How it works
13 | 
14 | `OBS2Browser` facilitates the handshake between your browser and OBS. It exists just to transport two text messages.
15 | After this handshaking is done `OBS2Browser` is never used. All of the media is exchanged directly between OBS and your browser.
16 | 
17 | <img src="./.github/sequence-diagram.png">
18 | 
19 | To confirm this you can shut down `OBS2Browser` after the session has started. Your browser will continue to play frames from OBS.
20 | 
21 | ## How to use
22 | 
23 | ### Run `OBS2Browser`
24 | 
25 | Execute `go run github.com/sean-der/OBS2Browser@latest` by default it listens on port 80. You can change that by setting the environment variable `HTTP_ADDR`.
26 | 
27 | You should see a log line for the HTTP Server starting
28 | 
29 | ```
30 | 2023/08/15 14:51:24 Starting HTTP Server on :80
31 | ```
32 | 
33 | ### Open in your browser
34 | 
35 | Open [http://localhost](http://localhost) and press the `Connect` button.
36 | 
37 | <img src="./.github/unconnected-browser.png">
38 | 
39 | You will see a log in `OBS2Browser` that says the WebSocket has connected
40 | 
41 | ```
42 | 2023/08/15 14:52:00 WebSocket connected
43 | ```
44 | 
45 | ### Broadcast from OBS
46 | 
47 | Next configure OBS to the following
48 | 
49 | * **Service** - WHIP
50 | * **Server** - http://localhost/whip
51 | * **Bearer Token** - (None)
52 | 
53 | <img src="./.github/stream-obs.png">
54 | 
55 | 
56 | ### Enjoy!
57 | 
58 | Press `Start Streaming`
59 | 
60 | <img src="./.github/live-obs.png">
61 | 


--------------------------------------------------------------------------------
/go.mod:
--------------------------------------------------------------------------------
1 | module github.com/sean-der/OBS2Browser
2 | 
3 | go 1.20
4 | 
5 | require golang.org/x/net v0.14.0 // indirect
6 | 


--------------------------------------------------------------------------------
/go.sum:
--------------------------------------------------------------------------------
1 | golang.org/x/net v0.14.0 h1:BONx9s002vGdD9umnlX1Po8vOZmrgH34qlHcD1MfK14=
2 | golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI=
3 | 


--------------------------------------------------------------------------------
/main.go:
--------------------------------------------------------------------------------
  1 | package main
  2 | 
  3 | import (
  4 | 	"fmt"
  5 | 	"io"
  6 | 	"log"
  7 | 	"net/http"
  8 | 	"os"
  9 | 	"sync/atomic"
 10 | 
 11 | 	"golang.org/x/net/websocket"
 12 | )
 13 | 
 14 | func htmlHandler(w http.ResponseWriter, req *http.Request) {
 15 | 	fmt.Fprintf(w, `
 16 | <html>
 17 | <head>
 18 | 
 19 | </head>
 20 | 
 21 | <body>
 22 | 	<button onclick="connect()">Connect</button>
 23 | </body>
 24 | 
 25 | <script>
 26 | 	window.connect = () => {
 27 | 		document.body.innerHTML = ''
 28 | 		const url = `+"`"+`${window.location.protocol === 'http:' ? 'ws' : 'wss'}://${window.location.hostname}:${window.location.port}/websocket`+"`"+`
 29 | 		const ws = new WebSocket(url)
 30 | 
 31 | 		ws.onmessage = msg => {
 32 | 			const pc = new RTCPeerConnection()
 33 | 
 34 | 			pc.onicecandidate = event => {
 35 | 				if (event.candidate === null) {
 36 | 					ws.send(pc.currentLocalDescription.sdp)
 37 | 				}
 38 | 			}
 39 | 
 40 | 			let added = false
 41 | 			pc.ontrack = function (event) {
 42 | 				if (added) {
 43 | 					return
 44 | 				}
 45 | 				added = true
 46 | 
 47 | 				const el = document.createElement('video')
 48 | 				el.srcObject = event.streams[0]
 49 | 				el.autoplay = true
 50 | 				el.controls = true
 51 | 
 52 | 				document.body.appendChild(el)
 53 | 		  		event.track.onmute = function(event) {
 54 | 		  		  el.parentNode.removeChild(el)
 55 | 		  		}
 56 | 			}
 57 | 
 58 | 			pc.setRemoteDescription({sdp: msg.data, type: 'offer'})
 59 | 			pc.createAnswer().then(answer => {
 60 | 				pc.setLocalDescription(answer)
 61 | 			})
 62 | 		}
 63 | 	}
 64 | </script>
 65 | 
 66 | </html>
 67 | `)
 68 | }
 69 | 
 70 | var (
 71 | 	answerChan       chan string
 72 | 	currentWebsocket atomic.Value
 73 | 	nilWs            *websocket.Conn
 74 | )
 75 | 
 76 | func whipHandler(w http.ResponseWriter, req *http.Request) {
 77 | 	log.Println("Accepted WHIP Request")
 78 | 	offer, err := io.ReadAll(req.Body)
 79 | 	if err != nil {
 80 | 		w.WriteHeader(http.StatusInternalServerError)
 81 | 		panic(err)
 82 | 	}
 83 | 
 84 | 	ws, ok := currentWebsocket.Load().(*websocket.Conn)
 85 | 	if !ok || ws == nil {
 86 | 		w.WriteHeader(http.StatusInternalServerError)
 87 | 		panic("WHIP Offer received with no WebSocket client connected")
 88 | 	}
 89 | 
 90 | 	if err := websocket.Message.Send(ws, string(offer)); err != nil {
 91 | 		w.WriteHeader(http.StatusInternalServerError)
 92 | 		panic(err)
 93 | 	}
 94 | 
 95 | 	w.Header().Set("content-type", "application/sdp")
 96 | 	w.Header().Set("location", "/")
 97 | 	w.WriteHeader(http.StatusCreated)
 98 | 	fmt.Fprintf(w, <-answerChan)
 99 | }
100 | 
101 | func websocketHandler(ws *websocket.Conn) {
102 | 	log.Println("WebSocket connected")
103 | 	currentWebsocket.Store(ws)
104 | 
105 | 	for {
106 | 		var answer string
107 | 		if err := websocket.Message.Receive(ws, &answer); err != nil {
108 | 			break
109 | 		}
110 | 
111 | 		answerChan <- answer
112 | 	}
113 | 
114 | 	log.Println("WebSocket disconnected")
115 | 	currentWebsocket.Store(nilWs)
116 | }
117 | 
118 | func main() {
119 | 	currentWebsocket.Store(nilWs)
120 | 	answerChan = make(chan string)
121 | 
122 | 	http.HandleFunc("/", htmlHandler)
123 | 	http.HandleFunc("/whip", whipHandler)
124 | 	http.Handle("/websocket", websocket.Handler(func(ws *websocket.Conn) {
125 | 		websocketHandler(ws)
126 | 	}))
127 | 
128 | 	httpAddr := os.Getenv("HTTP_ADDR")
129 | 	if len(httpAddr) == 0 {
130 | 		httpAddr = ":80"
131 | 	}
132 | 
133 | 	log.Printf("Starting HTTP Server on %s", httpAddr)
134 | 	panic(http.ListenAndServe(httpAddr, nil))
135 | }
136 | 


--------------------------------------------------------------------------------