Help & Tutorials

Back to Index


Written by
Travis Bernard
Help Articles > Archiver: Record your stream       Streaming

Archiver: Record your stream

Written by
Travis Bernard

Creek includes an archiver that automatically records your live stream, and can publish the shows on your website.

Requirements

You'll need these components:

  1. Creek (with your show schedule already built)
  2. An Icecast or Shoutcast stream (Icecast preferred)
  3. S3 file storage — Archives are placed in your own S3 file storage account. (S3 is like Dropbox for websites.)

Demo

Check out BFF.fm - Best Frequencies Forever, a nonprofit station in San Francisco. Head over to their shows, and take a look at past broadcasts for each show. The archive recordings are attached as audio players.

How does it work?

  1. The stream archiver connects to your stream and save audio data, without modification, to a temporary location on a Creek server.
  2. Once a show is done, it closes out its audio file, and moves on to creating a new archive file for the next show.
  3. It uploads the audio files to your S3 file storage.
  4. It also adds these files to Media.
  5. Finally, it publishes the file by adding it to a broadcast. It needs to attach each archived audio file to a broadcast, so it will either create a broadcast for that airtime and show (if there isn't one already), or attach the archive to an existing broadcast. Though, if the broadcast was hidden as a draft, it will not un-hide the broadcast.

Features and options

  • Automatic broadcasts: By default, the archiver will create broadcasts automatically.

    • Per-show: Control Panel > Shows > Edit a show > See archiver checkboxes
    • Globally: Control Panel > Settings > Stream
  • Hide archives: Archives for this show are recorded, but they are not shown on the public website (on any of the broadcasts for this show).

    • Per-show: Control Panel > Shows > Edit a show > Hide archives
  • Disable/enable per show: You can disable or enable archiving for each show. This is good for shows that don't need recordings — like overnight automation or prerecorded shows.

    • Per-show: Control Panel > Shows > Edit a show > Disable archives
Keep in mind that if you disable the archives for a show, then the archiver will simply not record that show. However, this does not affect any attached media or audio recordings — those will still be shown on the public website.

Error handling and reliability

Archiving need several systems to connect between your station and Creek's archiver. Because of this, there are a few problems that you may encounter.

  1. Drop-outs: Your stream server, or the Creek archiver server, can lose a network connection, causing a temporary gap in the archive.

    • When the stream drops out for more than 10 seconds, Creek will end the file and create a new one once a connection is resumed. The parts of the stream are then labeled Part 1, Part 2, etc.

    • Creek's audio player (seen on web pages) will automatically connect the segments by playing them one after the other. If the user plays Part 1, it will continue to Part 2.

  2. Time-offset: The archiver is offset by a few seconds, because of a few variables:

    • There is normally a 1-10 second delay between your studio audio board and the stream server. You can observe this by just listening to your stream while broadcasting.

    • Your own studio clock may be different than Creek's clock, which is set to GMT time +/- 2 seconds.

comments powered by Disqus