= Streaming website
---- dataentry project ----
name : streaming-website
project-owner :
git-url : https://github.com/voc/streaming-website
project-description : website to playout the video streams
project-owner : 
project-member : 
project-status : in production
----


== add a new conference

The streaming website is deployed on lb.***.c3voc.de 

To add another conference / mandator: clone the internal git on your machine 
  git clone git@c3voc.de:streaming-website.git
 
1. first check if the series already has a mandator folder and reuse the existing one – otherwise create a new folder below ''/configs/conferences/<slug>'' where the mandator slug normally should not contain any numbers for years, conference numbers, etc. so it can be reused next year without renaming it. 
  
2. copy the following files from the most recent conference and edit it to your needs

  * <del>config.php</del> config.json
  * <del>download.sh</del> no longer needed
  * main.less
    * if not main.less is provided, the default-theme will be used
    * if one is provided, it should ''@import "../../../assets/css/_structure.less";'' which will pull in all required basic styles
    * assets (images, fonts) can be placed inside the conference-folder or below it and can be referenced with a relative path (so a logo in ''/configs/conferences/<slug>/assets/logo.png'' can be referenced as ''url(assets/logo.png)'' from ''/configs/conferences/<slug>/main.less)''

3. commit and push you changes to `master`

4. call deploy.sh which will deploy to all lb-servers, clear their caches and fixes the file-permissions

See also: https://github.com/voc/streaming-website/blob/master/README.md#konfiguration


== now streaming banner on media.ccc.de

To highlight the live streams on media.ccc.de's start page, you simply create the conference in the admin interface. Of course the acronym has to be exactly same as in the streaming-website. Voctoweb queries the streaming-website API every 10? minutes.


== operation hints
You can add  ''?forceopen=yess'' to the stream websiteURL to see all open conferences e.g. http://streaming.media.ccc.de/fossgis/?forceopen=yess

The streaming-website downloads the relive index json file of the active conferences via cronjob.

The thumbnails are generated via crontab of user //downloader// on each lb-server.