Learn to code by coding - try our free CS courses

Create a Golang Video Streaming Server Using HLS

In this tutorial, we’ll go step-by-step through building a video streaming API (which will work for music as well) in Go. Don’t worry, it’s surprisingly easy to build a robust media streaming server, especially if we utilize a modern communication protocol, HLS.

Take Action and Learn Go

Our ‘Go Mastery’ courses include 160+ interactive coding lessons to give you all the skills you need to become a successful Go developer.

What is HLS?

HTTP Live Streaming is an HTTP-Based adaptive bitrate streaming communications protocol developed by Apple.


HLS is a streaming protocol that allows large media files to be served as many smaller text files that are broken up into roughly ~10-second increments. By breaking them up, the user’s client-side application only needs to buffer ~10 seconds in advance. This saves the user a lot of potential bandwidth and allows songs or videos to start playback almost immediately.

Using FFmpeg, we can easily convert mp3 files to HLS format, which consists of multiple files. One of these files contains the metadata (.m3u8) and is served first. This metadata file tells the client where to get each data file, and what each data file contains. The data files have a .ts extension and typically contain ~10 seconds of audio and are served one-at-a-time at the client’s request.


Get Started – Format Some Media for your Server

Download a sample .mp3:


Install FFmpeg. If you are on a Mac:

brew install ffmpeg
Code language: Bash (bash)

Navigate to the directory of the mp3 file and run:

ffmpeg -i BachGavotteShort.mp3 -c:a libmp3lame -b:a 128k -map 0:0 -f segment -segment_time 10 -segment_list outputlist.m3u8 -segment_format mpegts output%03d.ts
Code language: Bash (bash)

This should result in three new files:

output000.ts output001.ts outputlist.m3u8

Congratulations! You are done with the hard part, you now have simple files that can be served over HTTP. Any modern client-side media library will know how to read HLS files.

Building the Streaming Server

As I eluded to above, HLS is very simple on the server-side. All we need to do is serve a path to the .m3u8 file, and make sure the .ts files are served from the same path. In traditional file server architecture, this just means that they need to be in the same directory.

Let’s set up our project with the following folder structure:

Screen Shot 2019 12 03 at 8.57.28 AM

Copy the following code into main.go:

package main import ( "fmt" "log" "net/http" ) func main() { // configure the songs directory name and port const songsDir = "songs" const port = 8080 // add a handler for the song files http.Handle("/", addHeaders(http.FileServer(http.Dir(songsDir)))) fmt.Printf("Starting server on %v\n", port) log.Printf("Serving %s on HTTP port: %v\n", songsDir, port) // serve and log errors log.Fatal(http.ListenAndServe(fmt.Sprintf(":%v", port), nil)) } // addHeaders will act as middleware to give us CORS support func addHeaders(h http.Handler) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Access-Control-Allow-Origin", "*") h.ServeHTTP(w, r) } }
Code language: Go (go)

Now run the server:

go run main.go
Code language: Bash (bash)

Your server is live! Test your code and listen to the music stream by using an HLS media client. You can find a free online client here: https://hls-js-latest.netlify.com/demo/

Simply paste your song’s URI and listen:


Have questions or feedback?

Follow and hit me up on Twitter @q_vault if you have any questions or comments. If I’ve made a mistake in the article, please let me know so I can get it corrected!

Related Articles