search

UTD-CRSS / exploreapollo-audio

Audio Processing Server for exploreapollo.org
MIT License
2 stars 3 forks source link

readme

audio.exploreapollo.org

Audio Processing Server for exploreapollo.org

Exposes an audio stream to be consumed by the client.

Dev Setup

  1. Install Go:
    sudo add-apt-repository ppa:ubuntu-lxc/lxd-stable
    sudo apt-get update
    sudo apt-get install golang

  2. Create Go workspace & clone repository
    mkdir $HOME/exploreapollo-audio
    export GOPATH=$HOME/work (this can be anywhere, maybe add this to ~/.bashrc)
    mkdir $GOPATH/src/github.com/UTD-CRSS
    cd $GOPATH/src/github.com/UTD-CRSS
    git clone https://github.com/UTD-CRSS/exploreapollo-audio
    mv exploreapollo-audio audio.exploreapollo.org
    cd audio.exploreapollo.org
    cp sample-config.json config.json

  3. Install psql driver && compile project
    go get github.com/lib/pq
    go install github.com/UTD-CRSS/exploreapollo-audio/audio

    to run server just: go run main.go

Parameters

Parameter Domain Description
mission INT Apollo mission of interest
channels []INT Channels of interest (comma separated)
format m4a, ogg streaming format
start INT64 Mission Elapsed Time, in milliseconds
duration INT64 duration of desired audio beginning at time start, in milliseconds

Example Query Url

http://audio.exploreapollo.org/stream?mission=11&channels=14,18,24&start=369300000&duration=600000&format=m4a

returns an m4a stream of Apollo 11 channels 14, 18, and 24 starting at MET 369300000 (this is equivalent to MET 102:35:00) and lasting 600000 milliseconds (10 minutes).

Heroku deployment

The Heroku application is set to deploy the master branch. The branch must be manually deployed through the Heroku console to view new changes.

The server uses the following buildpacks, which must be installed via the Heroku console for deployment:

The file Aptfile is used by heroku-buildpack-apt to obtain additional dependencies.