In this tutorial, I'm going to walk you through building a streaming API using Golang. Don't worry, its surprisingly easy to build a robust streaming server, especially if we utilize one of the more modern protocols: HLS. What is HLS? HTTP Live Streaming is an HTTP-Based adaptive bitrate streaming communications protocol developed by Apple. https://en.wikipedia.org/wiki/HTTP_Live_Streaming HLS allows us to serve large media files as many smaller text files that are broken up into ~10-second increments. By breaking them up in this way, our user's client-side app only needs to buffer 10 seconds in advance, which saves them a lot of potential bandwidth and allows the song to start playing much faster. Using , we can easily convert mp3 files to the 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. Data files typically contain ~10 seconds of audio and are served one-at-a-time at the client's request. FFmpeg Getting Started - Format Some Media Download a sample .mp3: http://www.hubharp.com/web_sound/BachGavotteShort.mp3 Install . If you are on a Mac: FFmpeg brew install ffmpeg 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 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 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: Copy the following code into main.go: main ( ) { songsDir = port = http.Handle( , addHeaders(http.FileServer(http.Dir(songsDir))))
	fmt.Printf( , port)
	log.Printf( , songsDir, port) log.Fatal(http.ListenAndServe(fmt.Sprintf( , port), ))
} { {
		w.Header().Set( , )
		h.ServeHTTP(w, r)
	}
} package import "fmt" "log" "net/http" func main () // configure the songs directory name and port const "songs" const 8080 // add a handler for the song files "/" "Starting server on %v\n" "Serving %s on HTTP port: %v\n" // serve and log errors ":%v" 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) "Access-Control-Allow-Origin" "*" Now run your server: go run main.go Your server is live! Test your music play by using a 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: http://localhost:8080/bachgavotteshort/outputlist.m3u8 This article was first seen at on Qvault Thanks for reading! Good luck with your media project! Lane Wagner on Twitter: @wagslane Subscribe to Qvault Articles: https://qvault.io Lane on Dev.to: wagslane

Apple

Twitter

How Percolate Queries in Elasticsearch Make Alerting a Breeze

How To Cache Images in an Expo Managed React Native App 

Learn to code on Boot.dev

Nominated for 2022 - HackerNoon Contributor of the Year - Algorithms

Nominated for 2022 - HackerNoon Contributor of the Year - Mathematics

Nominated for 2022 - HackerNoon Contributor of the Year - Cryptography

Nominated for Coding Guru of 2022

Nominated for 2022 - HackerNoon Contributor of the Year - Github

Nominated for 2022 - HackerNoon Contributor of the Year - Online Education

Nominated for 2022 - HackerNoon Contributor of the Year - Job Hunting

Nominated for Super Career Strategist of 2022

Too Long; Didn't Read

Make resilience your competitive advantage

Building a Media Streaming Server Using Go And HLS Protocol

Building a Media Streaming Server Using Go And HLS Protocol

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

Every Developer Should Learn to Give Up Sooner

104 Stories To Learn About Go

The Noonification: How to Use React to Replace useEffect (12/31/2022)

3 Golang Pitfalls Every Developer Needs to Know

207 Stories To Learn About Golang

Every Developer Should Learn to Give Up Sooner

104 Stories To Learn About Go

The Noonification: How to Use React to Replace useEffect (12/31/2022)

3 Golang Pitfalls Every Developer Needs to Know

207 Stories To Learn About Golang

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps