Simple media streamer written in Go.
Go
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
fileutils
public
templates
webserver
.gitignore
CHANGELOG.md
README.md
media_streamer.go

README.md

Media Streamer (Go Implementation)

A simple music server using written in Go. This is more or less a port of the Ruby version of this application. I suspect it hardly counts as idiomatic Go. I also suspect that it currently doesn't fully utilize Go's capabilities. While the Ruby version was made to scratch an itch, this implementation is just for fun.

Go Setup

Here's some instructions to get you started with Go. This is my first attempt at anything more serious than a "Hello World" program in Go. As such I ran into some confusion getting this project set up correctly. If you've already got a working Go environment you can safely ignore this. If you're like me and new to the language and its conventions you probably should read this. There's instructions online here but I found them to be not only unclear, but they were also in a format that forced me to tease out the relevant details (i.e., they were written as prose, not a list of instructions). Here's how I eventually got everything set up:

Windows 7

Some specifics may be different on older or newer versions of Windows.

  • Install Go from the .msi installer. You can download it as a Zip archive, but why would you do that?
  • Create a directory for your projects if you haven't already. I keep all my projects in a folder directory Projects in my Documents directory. In my case it's C:\Users\Sean\Documents\Projects.
  • Create a directory specifically for your Go projects. In my case it's C:\Users\Sean\Documents\Projects\go.
  • Create the following directories in your Go projects directory: bin, pkg, and src. src is where our Go project source files will reside.
  • Add the GOPATH environment variable to your user environment variables.
    • In the start menu right click the "Computer" menu item and then click "Properties".
    • Click "Advanced system settings" on the left (it should be the last option in the list).
    • Click "Environment Variables".
    • Under "User variables for username" click "New...".
    • Make the variable name be "GOPATH".
    • Make the variable value be the path to your Go projects directory. In my case it's C:\Users\Sean\Documents\Projects\go.
    • Keep clicking "OK" until you can't click it any more.
    • If you have any open command prompts you will need to close them and re-open them for the changes to take effect.
    • In the command prompt test it out with echo %GOPATH%.
  • cd into your %GOPATH%/src directory and create a folder for your project(s).
  • Create directories in your project directory for each package you are making for your project.
  • Add the source files for each package.

To be clear: the second and third steps are mostly just my opinion.

OSX Lion

Some specifics may be different depending on your environment.

  • Install Go from the .pkg installer.
  • Create a directory for your Go projects if you haven't already. I keep mine ~/go.
  • Create the following directories in your Go projects directory: bin, pkg, and src. src is where our Go project source files will reside.
  • Add the GOPATH environment variable to your user environment variables. This will depend on your shell. Add the following to your .bashrc file (or if you're using ZSH your .zshrc file): GOPATH=$HOME/go
  • Source the changes with source .bashrc (or source .zshrc) in the terminal.
  • Make sure it's working with echo $GOPATH.
  • cd into your $GOPATH/src directory directory and create a folder for your project(s).
  • Create directories in your project directory for each package you are making for your project.
  • Add the source files for each package.

Linux

More on this later... but it's probably pretty close to OSX.

Installation

$ cd $GOPATH/src (%GOPATH%\src on Windows)
$ git clone git@github.com:seaneshbaugh/media_streamer_go.git media_streamer_go
$ cd media_streamer_go/webserver
$ go build webserver.go

Usage

$ $GOPATH/src/media_streamer_go/media_streamer (%GOPATH%\src\media_streamer_go\media_streamer.exe on Windows)

Options

  • -d, Sets the "public" directory for the server. This is the directory from which static assets will be delivered. The default is ./public.
  • -p, Sets the port the server will listen on. The default is 4568.
  • -m, Sets the "media" directory for the server. This is the directory where the server will look for music files. The default is /Users/seshbaugh/Music/iTunes/iTunes Media/. You will definitely need to change this before building.

Notes

Many thanks to Alexis Robert whose simple Go webserver gave me a working example to start from.