{: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.

```text

+- 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

```clojure
{: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.