Pārlūkot izejas kodu

added vodcast operations doc

Harlan Iverson 7 gadi atpakaļ
vecāks
revīzija
c23f7f0b90

+ 2 - 0
README.md

@@ -52,6 +52,8 @@ this repository as well, so it can be built and used locally.
 
 Requires elbow grease but these are the actual repositories that power the websites. Contact me to book an appointment.
 
+Vodcast operations are documented in `ispooge.com-v2/doc/operations.md`
+
 # Contact
 
 * social @ harlanji d0t com or (four one f1ve).93 seven.7four67 - leave a message, I'll get back to you. call > email > text.

+ 66 - 0
ispooge.com-v2/doc/operations.md

@@ -0,0 +1,66 @@
+# 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.
+
+
+## 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`
+
+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`.

+ 2 - 2
ispooge.com-v2/scripts/download-playlist.sh

@@ -1,6 +1,6 @@
-PLAYLIST="PLD5lYPY-uZpq7x2zRIiULo2oZ-tWs2lPx"
-
+#!/bin/bash
 
+PLAYLIST=${1:"PLD5lYPY-uZpq7x2zRIiULo2oZ-tWs2lPx"}
 
 youtube-dl \
   --verbose \

+ 15 - 0
ispooge.com-v2/scripts/download-video.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+VIDEO=${1:"DwWvl0M"}
+
+
+youtube-dl \
+  --verbose \
+  --add-metadata \
+  --no-mark-watched \
+  --yes-playlist \
+  --write-all-thumbnails \
+  --all-subs \
+  --no-call-home \
+  --restrict-filenames \
+  "https://www.youtube.com/watch?v=$VIDEO"