ispooge-live/app/resources/templates/md/pages/doc-operations.md

{:layout :page :title "Doc: operations" :page-index 4006 :navbar? false :generated-at 1539652323 :last-modified 1539652313 }

Vodcast Origin Operations

These are literal instructions, in time difficult parts can be replaced with scripts.

It's worth understanding each of these commands, tho, and examining the script by using cat scripts/thescript.sh before running it... it should be understood before too long.

Add a page

Assume you want to create a page A from the ispooge.com-v2 directory.

• touch md-pages/A.md
• Edit the page with your editor... nano in CLI, Bluefish in X.

From here we can fall back to Cryogen documentation.

Create a new playlist

Playlists are created in two parts. The playlist-Random post and optionally by the video post having the playlist-Random tag combined with a filter of same name in config.edn--creating a filtered playlist for rss readers.

+- md
   +- posts
      +- DATE-video-TITLE-ID.md
      +- DATE-playlist-NAME.md
   videos
   +- TITLE-ID.mp4
   playlists
   +- NAME-ID.json

From here, these are just pages.

Create a new video

Creating a new video is accomplished by copying it and a cover image to the $ISPOOGE_MEDIA/videos directory and running the following scripts from the ispooge.com-v2 directory.

Assuming you have files MyVideo.mp4 and MyVideo.jpg:

• mkdir A.hls - directories can end in dot extensions, no worries
• cd A.hls
• ../../../tinydatacenter/ispooge.com-v2/scripts/segment-video.sh ../A.mp4 - will take time relative to length of video
• ls -la - you should see out.m3u8 and out0.ts listed.
• cd ../../../tinydatacenter/ispooge.com-v2
• scripts/make-video-page.sh A > md-pages/video-A.md

The video page has in the EDN header

{:layout :video
 :tags ["video" "playlist-Random"]
}

Create a web app

Adding a new webapp is like adding a web page, but also involves adding a script and interacts with the page DOM.

The DOM is generated by Selmer and the path of least resistance to access the DOM is via headers with deterministic ID values generated, and then replacing the node or accessing siblings for input data.

Since our source file is a Markdown file with an EDN header, we can include script by specifying the path in a template. We should start by creating a template with the same name as the page, starting with the template we usually use (eg. :page).

Reading data from a table

The code below will set a known ID onto a data table immediately following a known header.

We can inspect the code of some generated pages and find the pattern of element names for H1 headers is to lowercase the name and replace spaces with underscores. From there, we can find the next element of type table and then assign it an ID. We can then operate on the new element in any way that we wish.

function HACK_identifyData () {
  var el = document.getElementById('roles_by_project');
  while( el && el.nodeName.toLowerCase() != 'table') {
    el = el.nextSibling;
  }
  if (el) {
    el.setAttribute('id', 'roles_by_project_data');
  }
}
HACK_identifyData();

That's it... see the Add a page section for more details.

Import a video from YouTube

Importing a video from YouTube is accomplished by using a tool to download the video file and a thumbnail. Currently it's done at the Playlist level and downloads all videos. Starting in the ispooge.com-v2 directory:

• cd $ISPOOGE_MEDIA/videos
• scripts/../../../tinydatacenter/ispooge.com-v2/scripts/download-video.sh VideoId
• ls -l -- note the name of the file, Title_of_Video-VideoId.mp4
• Follow the steps from to in Create a video for the rest.

Start a live stream

Assuming you are familiar with LiveStreaming to YouTube or Twitch and use OBS, this setup should be pretty familiar. As of now the archiving and posting does not happen manually, but can be accomplished by recorded within OBS and following the process to create a new video.

If you are doing a simple local stream, you configure OBS to push to the URL

rtmp://$RASPI_IP/ispoogedaily_local` with sream key `ispoogedaily`.

Relay a live stream to YouTube, Twitch, FB Live, Periscope, etc

This is a one time setup for YouTube Live in the simplest case, or can be changed before a broadcast to change providers or use the Event system with a custom stream key for the event. From the ispooge.com-v2 directory:

• cd ../rtmp-proxy-docker
• Edit nginx.conf to include your credentials in the ispoogedaily_live section, configuring desired upstream providers.
• ./build.sh
• ./stop-proxy.sh ; ./start-proxy.sh to restart the proxy with new config
• Ensure that OBS is pushing to ispoogedaily_live.

Use RasPi OMX Hardware Transcoding

You can safely run multiple transcoding streams via the OMX hardware. I use three and am experimenting with the best settings. Using a custom compiled ffmpeg you can get substantial speedups in video processing.