Case 2.0: Add cabling

.gitignore

@@ -1 +1,2 @@
 /site
+orig/

docs/assets/voctocat.svg

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="100"
+   height="100"
+   viewBox="0 0 26.458318 26.458333"
+   version="1.1"
+   sodipodi:docname="voctocat.svg"
+   inkscape:version="0.92.1 r">
+   <style>
+      path { fill: black; }
+      @media (prefers-color-scheme: dark) { path { fill: white; } }
+   </style>
+   <path
+      d="M 13.228772,0.30234532 C 6.0691486,0.30234532 0.26458395,6.10691 0.26458395,13.267323 A 12.964978,12.964978 0 0 0 1.1118578,17.862438 C 1.3017821,17.365207 1.5196676,16.879844 1.7942668,16.424026 1.9340722,16.191896 2.0878581,15.966888 2.1904701,15.717085 2.2933458,15.46649 2.3408269,15.183714 2.2622191,14.924942 2.2173761,14.77775 2.1329652,14.644803 2.041696,14.521352 1.9501631,14.397374 1.8499251,14.280254 1.7665694,14.150736 1.5544871,13.821798 1.4571509,13.41689 1.5122817,13.029655 c 0.055395,-0.387763 0.2643115,-0.754423 0.5792695,-0.98708 0.280666,-0.207333 0.6351916,-0.300714 0.9854966,-0.287524 a 1.7568007,1.7568007 0 0 1 0.3455569,0.04748 c 0.4526531,0.109998 0.852022,0.393037 1.1482512,0.751784 0.3671872,0.445795 0.5829625,1.009765 0.6357193,1.584813 0.053284,0.575049 -0.052757,1.160649 -0.2748629,1.693493 -0.3983136,0.954898 -1.1506253,1.725674 -1.5647659,2.673714 -0.3381711,0.774469 -0.4352436,1.638098 -0.3890813,2.482206 0.00633,0.0786 0.016883,0.156688 0.023741,0.235295 a 12.964978,12.964978 0 0 0 3.6193788,3.180442 17.628677,17.628677 0 0 1 -0.1287265,-2.11027 c 0.00184,-0.561333 0.030335,-1.121082 0.084411,-1.675029 C 6.2355962,20.384214 5.9259139,20.109878 5.7061819,19.760892 5.3152541,19.139153 5.2413947,18.352286 5.4023029,17.635586 c 0.1609082,-0.716702 0.5407569,-1.369567 0.997103,-1.944879 0.7528393,-0.948304 1.7362257,-1.715651 2.83515,-2.223699 -0.031654,-0.04352 -0.063308,-0.0881 -0.089689,-0.125561 C 8.7402212,12.686472 8.5012335,11.931786 8.4432007,11.163911 8.3841165,10.387331 8.5065088,9.609695 8.557947,8.8328528 8.5948734,8.2910402 8.5969902,7.7487012 8.6286443,7.2066251 8.6655707,6.5796108 8.7420714,5.9518051 8.9180158,5.3490588 8.981853,5.1306459 9.0599316,4.9124965 9.1839095,4.7212532 A 1.4006925,1.4006925 0 0 1 9.7782155,4.2058195 C 10.05176,4.0976681 10.289429,4.0744551 10.553741,4.1187705 c 0.22105,0.047481 0.425482,0.1569516 0.604593,0.295438 0.179372,0.1376952 0.334214,0.3041429 0.480614,0.4766575 a 7.2975815,7.2975815 0 0 1 1.037725,1.6159402 3.5711064,3.5711064 0 0 1 1.092065,0 7.2865025,7.2865025 0 0 1 1.038254,-1.6162038 C 14.953129,4.718088 15.108496,4.5516403 15.287607,4.4136814 15.46698,4.2754586 15.671148,4.1657246 15.892463,4.1187709 a 1.2680092,1.2680092 0 0 1 0.780009,0.087049 1.4022752,1.4022752 0 0 1 0.594305,0.5170164 c 0.123979,0.1907158 0.202058,0.40781 0.265894,0.6264868 0.175681,0.6027462 0.252178,1.2305519 0.289107,1.8570386 0.03166,0.5423399 0.03429,1.0862616 0.07122,1.6275471 0.05144,0.7771065 0.174888,1.5536852 0.116065,2.3300022 a 4.8549426,4.8549426 0 0 1 -0.703775,2.178064 c -0.03166,0.05012 -0.07017,0.09575 -0.102876,0.145081 0.246374,0.2775 0.597997,0.513324 0.89792,0.614089 a 1.9556938,1.9556938 0 0 0 1.048277,0.04273 1.6504958,1.6504958 0 0 0 0.533898,-0.226327 1.2529736,1.2529736 0 0 0 0.396995,-0.417834 c 0.118703,-0.208389 0.166184,-0.448433 0.192563,-0.687157 0.06726,-0.608813 0,-1.223957 -0.05012,-1.834353 -0.03429,-0.396203 -0.06198,-0.799265 0.0269,-1.1870281 0.06015,-0.2624642 0.177792,-0.5191263 0.374575,-0.7024558 A 1.1057821,1.1057821 0 0 1 21.088206,8.835488 1.3120611,1.3120611 0 0 1 21.618412,8.806466 c 0.379849,0.055401 0.735429,0.2727525 0.947512,0.5921948 0.120548,0.1814838 0.193881,0.3911921 0.237932,0.6048572 0.04378,0.213665 0.05988,0.431286 0.07174,0.648908 0.04115,0.76049 0.03957,1.522034 0.01847,2.283578 -0.01767,0.664735 -0.05539,1.347936 -0.321289,1.957277 -0.341864,0.782117 -1.03034,1.365872 -1.773946,1.785289 a 7.0517349,7.0517349 0 0 1 -1.586925,0.648907 c 0.481933,1.538388 0.732792,3.240586 0.732792,4.967051 a 17.59887,17.59887 0 0 1 -0.134527,2.12557 12.964451,12.964451 0 0 0 6.383571,-11.152254 C 26.192959,6.1071738 20.388395,0.30287299 13.228772,0.30287299 Z M 9.6027982,16.283956 v 1.482994 a 1.8799879,1.8799879 0 0 1 1.0833608,0.362438 1.7378083,1.7378083 0 0 1 0.556057,0.680563 c 0.12134,0.270378 0.166183,0.575841 0.116064,0.867849 a 1.4930169,1.4930169 0 0 1 -0.33184,0.707996 1.6468029,1.6468029 0 0 1 -0.635718,0.457929 1.7383359,1.7383359 0 0 1 -0.7879238,0.122131 V 24.69708 L 17.364903,20.488408 9.6025338,16.283693 Z"
+      id="path2"
+      inkscape:connector-curvature="0"
+      style="stroke-width:0.2637839" />
+</svg>

docs/case2.0/buildup.md

@@ -0,0 +1,102 @@
+---
+title: Buildup Plan
+---
+
+This guide will only cover the "physical" buildup and not how to apply the [configuration management](https://github.com/voc/cm/tree/master/bundlewrap).
+
+## Preparation
+Before you start carrying things around in the room, please determine the following things:
+
+- Where are the projector input and audio inputs located?
+- Where is the network uplink located?
+- Where are the emergency exits?
+- Where are power outlets?
+- Where is a good place for the FOH position (camera, FOH module and mixer laptop)?
+    * shall have a good view of the stage
+    * cables shall not create trip hazards in emergency exits
+
+## Buildup
+With these questions in mind, you can start distributing the eqipment.
+
+### Stage
+- Take the following items to the stage:
+    * lectern module
+    * 1 Schuko to TRUE1 cable
+    * 2 HDMI cables (one for projector, 3m for speaker laptop)
+    * 1 3m Cinch to 3.5mm jack cable
+    * speaker adapters crate/ bag
+    * battery charger crate
+    * microphone crate(s)
+- Place the lectern module somewhere convenient on its bottom or side (not on the back b/c of spilled drinks)
+- Connect to power and projector
+- Connect HDMI and 3.5mm jack cable and place on lectern
+- Start charging the first batch of batteries
+
+!!! info ""
+    Do not turn on microphones until a frequency scan was made
+
+### FOH/ Camera
+At small events we usually place the camera right next to the FOH and video mixer position so that the setup can be operated by a single person just in case.
+If we're sure that enough helpers are present, the camera can also be placed somewhere else.
+
+- Take the following items to the FOH position:
+    * FOH module
+    * 1 Schuko to TRUE1 cable + schuko extension cord, if needed
+    * Mixer laptop crate
+    * Headphones (DT 770)
+    * Encoder module
+    * 1 Schuko to C13 cable (aka "Kaltgerätekabel")
+    * 2 1.5m ethernet cables
+    * 1 2m SDI cable
+- Place the FOH module on a desk and the mixer laptop next to it
+- Connect FOH module to power (use extension cord, if needed)
+- Power the encoder from the FOH module, connect SDI and ethernet to FOH module
+    * FOH "SDI out" to Encoder "Slides"
+    * Ethernet to any "VOC" port
+- Place mixer laptop, connect power and ethernet to FOH module
+- If power supply is properly laid down, power up the FOH module, laptop and encoder
+- Load the default scene on the audio mixer
+
+For the camera:
+
+- Take the following items to the FOH position:
+    * Tripod
+    * Camera crate
+    * 1 2m HDMI cable
+    * 1 3-way power strip
+    * 2 XLR cables (long enough to reach FOH module)
+    * 1 SDI cable (long enough to reach FOH module)
+    * 1 ethernet cable (long enough to reach FOH module)
+- Setup tripod
+- Mount preview monitor on tripod
+- Place camera on tripod
+- Connect devices to power
+- Connect camera to preview monitor
+- Connect to FOH module with XLR (Aux 1+2) and ethernet (any "VOC" port)
+- Connect SDI to encoder ("Cam 1" input)
+
+### Cabling Between FOH and Stage
+To finish the setup, we need to connect the Lectern and FOH modules:
+
+- 1 SDI cable between lectern "Slides" output and FOH "SDI in"
+- 1 ethernet cable between lectern "trunk" port and FOH switch port 24
+
+The following steps are depending on the room:
+
+- Connect the **main mix** of the audio mixer at the FOH module with the audio input of the room using 2 XLR cables as well as DI boxes if needed
+- Connect to the house network:
+    * if a VOC VLAN exists: Connect a "VOC" port of the lectern module **or** the FOH module to the locations's network
+    * if no VOC VLAN exists:
+        + Connect a "public" port of the lectern module **or** the FOH module to the locations's network
+        + connect the router's "WAN" port to a "public" switch port on the FOH switch and any of the router's LAN ports to any "VOC" port on the FOH switch
+
+Also see the [cabling plan](cabling.md) for a detailed view of the signal paths.
+
+## Configuration
+To finish setting up the lecture room:
+
+- Test if internet is reachable
+- Apply the [configuration management](https://github.com/voc/cm/tree/master/bundlewrap)
+- Run a frequency scan using Shure Wireless Workbench
+- Assign frequencies
+- Check video and audio inputs, see [daily stage bootup](../checklists/avtech-daily.md)

docs/case2.0/cabling.md

@@ -0,0 +1,5 @@
+---
+title: Cabling
+---
+
+Simplified cabling diagram: ![](img/voc-case2_0-cabling.png)

docs/case2.0/index.md

@@ -0,0 +1,36 @@
+---
+title: Overview
+order: 0
+---
+
+![](img/voc-case2_0-pallet.jpeg){ align="right", width="250" }
+The lecture room set 2.0 aka. "Case 2.0" consists of two 120x60 cm [TRANSFlex](https://www.amptown-cases.de/en/product/transflex/) road cases on a standard EUR-pallet.
+
+As the picture shows: When both cases are topped on their short side, they fit perfectly inside the 120x80 cm outline of the pallet.
+The height is approx. 140 cm.
+
+During operation, an area of 2x 120x60cm with a height of approx. 80 cm is needed plus some space to store the pallet somewhere.
+
+The c3voc owns a total of 6 room setups called "Saal 1" to "Saal 6".
+Each case is marked with a unique identifier in the form of `$room.$case`, so e.g. `4.1` and `4.2` make the set for room/ hall 4.
+
+## Content
+The concept of the setup is to use pre-assembled module for things which are usually used together.
+These include the so called Lectern, FOH and Encoder modules and a euro crate containing everything that's associated to the camera position.
+
+### Case x.1
+The `.1` case contains accessories including:
+
+- tripod and camera crate (including preview monitor, power supply, etc.)
+- cable bridges and cable mats
+- power, XLR, SDI and HDMI cables
+- several accessory boxey
+
+### Case x.2
+The `.2` case contains the modules and other equipment:
+
+- lectern, FOH and encoder module
+- office crate
+- minion crate
+- microphones
+- ethernet cables

docs/case2.0/packing.md

@@ -0,0 +1,51 @@
+---
+title: Packing Guide
+---
+
+Packing the cases shouldn't be too complicated, but a few details need special attention.
+
+## Case x.1
+Compartments (from left to right):
+
+- **Power cables**: Schuko extension cords, power strips, schuko to TRUE1, schuko to C13, cable mats
+- **Accessories (back tower)**: Intercom crate, ethernet crate, audio and DI crate
+- **Accessories (front tower)**: Batteries and lucky cat crate, tape crate, embedder and converters crate
+- **Accessories (sorting box)**: Small adapters box
+- **Camera**: Tally crate, Mixer laptop crate, Camera crate
+- **XLR Cables**: Multiple XLR cables and Headphones (in a bag)
+- **Video Cables**: Multiple SDI and HDMI cables
+
+![](img/voc-case2_0-case_b-comp.jpeg) <!-- TODO: get a better image -->
+
+### Fitting the Tripod
+!!! info ""
+    Put all dampers (pan, tilt, counterweight) on zero and loosen the breaks before storing the tripod in the bag.
+    This way, everything can move to fit snugly.
+
+![](img/voc-case2_0-tripod-comp.jpg){ align="right", width="250" }
+The carrying bag of the new Sachter Ace M Mk II tripods got bigger than the old generation which means that the space in the case is quite tight.
+
+To make everything fit, place the tripod with the head to the right and carrying handle to the back (so it gets past the wooden compartment board).
+Otherwise the case lid may not close without forcing it.
+
+Please also take care of the remote control and place it on top and away from the front edge of the case so that it can't be jammed when closing the lid.
+There should be enough space between the legs of the tripod.
+
+### Fitting the Power Cables
+It's recommended to put the rubber cable mats in the compartment first, then the long cables and the power strips on top.
+
+
+## Case x.2
+Compartments (from left to right):
+
+- **FOH module** (bottom side to the left)
+- **Supplies**: c3lingo (currently only a placeholder) crate, office crate, minion crate, microphones crate
+- **ethernet compartment**: Multiple long ethernet cables
+- **Lectern module** (bottom side to the left)
+- **Encoder module** (bottom side to the left)
+
+<!-- TODO: get a picture showing the modules inside the case -->
+
+!!! info ""
+    Place all modules with the bottom to the left.
+    This way everything is "upright" when the case is loaded on the pallet.

docs/case2.0/tips-and-tricks.md

@@ -0,0 +1,46 @@
+---
+title: Tips and Tricks
+order: 99
+---
+
+Something's not working and you want to know how to fix it? Hopefully this page got you covered.
+
+## Preface
+!!! danger ""
+    As a general rule: **don't disassemble any of the modules, ever!** This also applies to experienced VOC people!
+
+Everything which needs to be accessed can be reached without violence, especially in the lectern module.
+
+## Lecture Module
+
+### No Signal at Projector
+- Try another HDMI cable
+- Try to use the projector without the lectern module
+- If nothing helps, you can extend the tray all the way and use different ports
+
+### No Audio from the Speaker Laptop
+- Turn on the correct audio source on the ATEM mini:
+    * 3.5mm jack: Turn on "MIC 1"
+    * HDMI audio: Turn on input 1 ("ON" button is shining red or "AFV" is enabled)
+- Other inputs should be off when not needed
+
+![](img/lectern-audio-comp.jpeg)
+
+### Noise/ Humming from the Speaker Laptop/ Lectern Module
+- Turn off the 3.5mm jack input "MIC 1" on the ATEM mini ![](img/lectern-audio-comp.jpeg)
+
+### Fully Extend the Tray
+The lectern module's tray has some cable ties as stoppers which prevent it to be fully extended.
+If the tray is pulled out too much, the cables to the I/O panel will probably get dislodged and **will cram up between rack tray and network switch**!
+So do not pull out the tray more than needed!
+
+In case you need to reach the additional ports (HDMI and secondary SDI) of the UpDownCross, you can get over the stoppers with these steps:
+
+- Pull tray out until stoppers are reached
+- Place your hands with 4 fingers below the tray and the thumb on top ![](img/lectern-tray-stoppers_hands-comp.jpeg)
+- Press up next to the cable tie stopper until it goes past the I/O panel below ![](img/lectern-tray-stoppers-comp.jpeg)
+
+## FOH Module
+
+### Audio Mixer Setup is Funny
+- Grab the default scene from [the c3voc wiki](https://c3voc.de/wiki/hardware_ah-cq18t), put in on a USB stick and load to the mixer

docs/checklists/avtech-daily.md

@@ -0,0 +1,5 @@
+---
+title: "A/V-Tech: Daily Stage Bootup"
+---
+
+See: <https://github.com/voc/checklists/blob/main/source/stage_bootup.pdf>

docs/checklists/avtech-talk.md

@@ -0,0 +1,5 @@
+---
+title: "A/V-Tech: Talk Checklist"
+---
+
+See: <https://github.com/voc/checklists/blob/main/source/talk.pdf>

docs/checklists/camera.md

@@ -0,0 +1,5 @@
+---
+title: Camera Angel
+---
+
+TODO

docs/checklists/mixer.md

@@ -0,0 +1,5 @@
+---
+title: Video Mixer Angel
+---
+
+TODO

docs/faq.md

@@ -0,0 +1,9 @@
+---
+title: FAQ
+---
+
+## I want to be a Camera/ Video Mixer Operator
+TODO: Come to the introduction meeting which will be announced in the Engelsystem of the event.
+
+## I Want to Help With Buildup
+TODO: Just come to an event and talk to us.

docs/index.md

@@ -0,0 +1,14 @@
+# Home
+
+Welcome to the [c3voc](https://c3voc.de) lecture hall operations handbook.
+
+This site is intended for our volunteers (angels) during daily operations, as well as people building up our lecture hall setup.
+
+## For A/V Angels
+TODO: We have checklists with the most important items from the [angel introduction](https://github.com/voc/angel-introduction) lecture.
+
+## For A/V Technicians
+TODO: Checklists
+
+## For Buildup
+TODO: Hall setup

docs/tracker/checking.md

@@ -0,0 +1,6 @@
+---
+title: "Tracker: Checking"
+order: 2
+---
+
+Please refer to [the wiki at c3tracker:checking](https://c3voc.de/wiki/c3tracker:checking) (for now).

docs/tracker/cutting.md

@@ -0,0 +1,6 @@
+---
+title: "Tracker: Cutting"
+order: 1
+---
+
+Please refer to [the wiki at c3tracker:cutting](https://c3voc.de/wiki/c3tracker:cutting) (for now).

docs/tracker/index.md

@@ -0,0 +1,38 @@
+---
+title: "Tracker: Overview"
+order: 0
+---
+
+The [CRS Ticket Trakcer](https://github.com/crs-tools/tracker) is the main tool which enables the c3voc to process so many videos during the duration of an event.
+It's a web-application at https://tracker.c3voc.de which is managing all tasks to record, cut, encode and release a talk based on the event's schedule in the [schedule.xml](https://c3voc.de/wiki/schedule) format.
+
+All automation at the c3voc is based on the schedule!
+
+## How to Help Us
+During an event, we may need help cutting and checking talks.
+How urgently help is needed depends on how many people from the team are present and how much help we get for operating the halls.
+
+There are two main kinds of help needed:
+
+- Help with normal cutting and checking: You need a laptop and some headphones
+- Help with broken talks: You need to know your way around in a video editor of your choice and ideally have experience in piecing together audio and video from different sources
+
+Usually only 0-10% of the recordings need manual editing becuase of a broken recording or becuase something was shown which shouldn't be released.
+As you may have guessed this work is quite labor-intensive and can take up to a few hours per talk to reach an state which can be released.
+
+## Tasks
+As mentioned before, we have a highly automated standard cutting workflow, but also a way to manually edit videos if needed.
+
+### Normal Cutting
+The normal process is mostly automated, but needs manual intervention to set the actual start and end of the talk.
+See the [cutting](cutting.md) and [checking](checking.md) pages for a detailed descrption what needs to be done.
+
+### Reparing Talks
+To repair a recording, you need to fetch the source files from where they are stored (depends on the event's specific setup) and do your magic in the video editor of your choice.
+Just make sure to render the output as 1920x1080px with 25 fps and no timecode track.
+
+Remove a timecode track with ffmpeg using:
+
+```shell
+ffmpeg -i inputfile.ext -c:a copy -c:v copy -write_tmcd 0 outfile.ext
+```

docs/tracker/setup.md

@@ -0,0 +1,5 @@
+---
+title: "Tracker: Setup"
+---
+
+Please refer to [the wiki at c3tracker:setup](https://c3voc.de/wiki/c3tracker:setup) (for now).

mkdocs.yml

@@ -0,0 +1,53 @@
+site_name: c3voc Handbook
+site_url: https://c3voc-docs.staging.jtbx.de
+repo_url: https://git.hamburg.ccc.de/jtbx/c3voc-docs
+copyright: CC BY 4.0
+markdown_extensions:
+  - smarty
+  - admonition
+  - attr_list
+
+theme:
+  name: shadcn
+  show_title: true
+  show_stargazers: false
+  pygments_style:
+    light: shadcn-light
+    dark: github-dark
+  icon: oui:documentation
+  #icon: assets/voctocat.svg
+  topbar_sections: false
+  show_datetime: false
+# theme:
+#   name: material
+#   features:
+#     - navigation.sections
+#     # - navigation.expand
+#     - navigation.path
+#     - navigation.indexes
+#   plugins:
+#     # - optimize # TODO: needs additional dependencies, see https://squidfunk.github.io/mkdocs-material/plugins/requirements/image-processing/
+#   palette:
+#     # Palette toggle for automatic mode
+#     - media: "(prefers-color-scheme)"
+#       toggle:
+#         icon: material/brightness-auto
+#         name: Switch to light mode
+
+#     # Palette toggle for light mode
+#     - media: "(prefers-color-scheme: light)"
+#       scheme: default
+#       toggle:
+#         icon: material/weather-sunny
+#         name: Switch to dark mode
+#       primary: blue-grey
+#       accent: blue-grey
+
+#     # Palette toggle for dark mode
+#     - media: "(prefers-color-scheme: dark)"
+#       scheme: slate
+#       toggle:
+#         icon: material/weather-night
+#         name: Switch to system preference
+#       primary: pink
+#       accent: pink