Bare.js HLS Proxy : HTTP Live Streaming Proxy for the Bare JS Runtime

Documentation

• please refer to the documentation for: Node.js HLS Proxy : HTTP Live Streaming Proxy for the Node JS Runtime
• please refer to notes that summarize command-line options that are not supported by the Bare JS Runtime

Roadblocks

• ~~bare-http1.request()~~
  • solution: issue proposes a one-line fix
  • fixed: in v4.2.1 by diff
• ~~bare-https.request()~~
  • solution: issue proposes a one-line fix
  • fixed: in v2.1.2 by diff
• ~~bare-tcp.Server.listen()~~
  • solution: issue proposes a trivial fix
  • workaround:
    • apply a downstream one-line fix both here and here…
      • old: server.listen(port,
      • new: server.listen(port, '0.0.0.0',
    • fixed: in v3.6.3 by diff
• ~~bare-http1.ServerResponse.writeHead()~~
  • solution: issue proposes a one-line fix
  • fixed: in v4.2.2 by diff
• ~~streamx.Stream.destroy()~~
  • example:

      const http = require('bare-http1')
    
      const url = 'http://httpbin.org/headers'
    
      const onresponse = (res) => {
        res.setEncoding('utf8')
        res.on('data', () => {})
        res.on('end', () => {
          console.log('request ended', res.statusCode, "\n")
          res.destroy()
          make_request()
        })
      }
    
      let remainder = 5
    
      const make_request = () => {
        if (remainder <= 0) return
        remainder--
    
        console.log('request started')
        http.request(url, onresponse).end()
      }
    
      make_request()

  • where:
    • res is an instance of bare-http1.IncomingMessage, which inherits from streamx.Stream
    • res.destroy === res.socket.destroy === streamx.Stream.destroy
  • workaround:
    • apply a downstream one-line fix by avoiding the redundant call to res.destroy() from the res.on('end') event listener
    • fixed: in v2.1.3 by diff
• ~~streamx.Pipeline.done()~~
  • workaround:
    • apply a downstream one-line fix here…

        response.on('error', () => {})

    • fixed: in v3.6.5 by diff

Installation and Usage: Globally

How to: Install:

npm install --global "@warren-bank/bare-hls-proxy"

How to: Run the server(s):

bare-hlsd <options>

Installation and Usage: Working with a Local git Repo

How to: Install:

git clone "https://github.com/warren-bank/bare-HLS-Proxy.git"
cd "bare-HLS-Proxy"
npm install

How to: Run the server(s):

# ----------------------------------------------------------------------
# If using a port number >= 1024 on Linux, or
# If using Windows:
# ----------------------------------------------------------------------
npm start [-- <options>]

# ----------------------------------------------------------------------
# https://www.w3.org/Daemon/User/Installation/PrivilegedPorts.html
#
# Linux considers port numbers < 1024 to be privileged.
# Use "sudo":
# ----------------------------------------------------------------------
npm run sudo [-- <options>]

Legal:

• copyright: Warren Bank
• license: GPL-2.0