The Content UI provides viewing and sharing of videos uploaded to a Swarm bucket. Video Clipping, also known as Partial File Restore, is an additional feature available with Docker running on the Gateway server. Video clipping provides the ability to excerpt portions of the video and store them as new, standalone videos within Swarm.

Video Clipping Use Cases

• Sporting Event Analysis
  A sporting team uploads the hours-long recording of a recent game into Swarm. It requires key highlights (typically 2 minutes or less) to go to broadcasters, commercial sponsors, or coaches for further consumption. Rather than sending the entire (large) video file with timestamps, the video owner uses the Content UI to extract the relevant segments into small video clips, which are then sent out as needed.

• Targeted Post-Production
  A media company needs the special post-production work applied to a given scene or set of takes but avoids transmitting the full set of video (multiple GB) to the post-production shop. Instead, the required portion of the video, buffered with a few seconds of video before and after, is extracted into a smaller (measured in MB) clip and sent for processing.

• Presentation Highlights
  A professional organization uploads the full hour-long conference presentations into Swarm, then creates highlight excerpts to use on the website, on social media, and in marketing materials.

Installing Video Clipping

Video clipping is available on Gateway version 6.3 and later. The following instructions are for Gateway versions 6.3 to 7.7. For version 7.8 and later, the feature is installed with Gateway and requires Docker running on the Gateway server. See https://perifery.atlassian.net/wiki/spaces/public/pages/2443810147 for details regarding Docker and disregard the following installation steps.

For older Gateway versions, obtain the optional stand-alone package for video clipping and install it on Gateway servers with no additional configuration. In addition to the RPM tool, install the supporting framework for multimedia formats i.e. FFmpeg, which Swarm provides preconfigured within a Docker container.

1. Copy the package for video clipping to a server that is running Content Gateway. See https://perifery.atlassian.net/wiki/spaces/public/pages/2443810099 for more information about all the gateway server requirements.

   caringo-videoclipping-VERSION.noarch.rpm

2. If the server is running Content Gateway 6.0 or earlier, upgrade Gateway (version 6.1 and higher support drop-in features such as video clipping). See https://perifery.atlassian.net/wiki/spaces/public/pages/2443810147.

3. If Content UI is version 6.1 or earlier, upgrade it to support this feature. See https://perifery.atlassian.net/wiki/spaces/public/pages/2443810310.

4. Install the package. 

   dnf install caringo-videoclipping-VERSION.noarch.rpm

   The installation creates a “features.d” directory under /etc/caringo/cloudgateway/ where Gateway detects optional dynamic features.

5. Install multimedia support via FFmpeg. Swarm provides it preconfigured in a Docker container. 
   From an Internet-connected machine, 

   1. Check the Docker is installed.

      docker info

      If the Docker is not installed, install the Docker package and start the daemon. Check the status and enable it system-wide. See docs.docker.com/install/linux/docker-ce/centos/ for more information.

   2. Verify Docker by running a container test.

      docker run hello-world

   3. Load the provided container for FFmpeg.

      docker load < caringo-gateway-VERSION.feature.ffmpeg.via.docker.VERSION.x86_64

6. Gateway creates /var/spool/caringo/cloudgateway/features directory for spooling video clips. Gateway denies starting in absence of the directory.

7. In setting iptables rules, Docker closes external TCP access to port 80 (although ping and ssh still work). Explicitly open port 80 again for clients to access Gateway. 

   firewall-cmd --add-port=80/tcp --permanent firewall-cmd --reload systemctl restart docker

8. Repeat the above process on any remaining Content Gateway servers.

9. Restart the Gateway server(s).
   On reboot, Content Gateway detects the feature. On a page refresh, Content UI displays the clipping control for video content.

Creating a Clip

The Content UI adds the scissor 

Open

Open

Three ways to set the time span of the clip. Select a method based on the precision needed:

• Drag the green and red bars

• Select a bar and use the left and right arrow keys to move it frame by frame (supported in Chrome)

• Enter minute:second[:millisecond] values in the Start Time or End Time fields

The default format for Clip Name is {original-name}-{start}-{end}.{filetype} but it can be customized. The clip name dynamically reflects the selected start and end times unless the field contains a custom value. This becomes the object name after selecting Create Clip:

The tool writes the clip to the same bucket as the source video.

The following shows an example of a clip with the default name beside the original video.

Use the Share menu to distribute the new clip.

Open

Metadata for Clips

Open

The object is tagged with the following metadata on creation: