diff --git a/docs/assets/voctocat.svg b/docs/assets/voctocat.svg new file mode 100644 index 0000000..a4c9e54 --- /dev/null +++ b/docs/assets/voctocat.svg @@ -0,0 +1,21 @@ + + + + + \ No newline at end of file diff --git a/docs/case2.0/buildup.md b/docs/case2.0/buildup.md new file mode 100644 index 0000000..9d96c17 --- /dev/null +++ b/docs/case2.0/buildup.md @@ -0,0 +1,5 @@ +--- +title: Buildup Plan +--- + +See \ No newline at end of file diff --git a/docs/case2.0/img/lectern-audio-comp.jpeg b/docs/case2.0/img/lectern-audio-comp.jpeg new file mode 100644 index 0000000..f5b1c28 Binary files /dev/null and b/docs/case2.0/img/lectern-audio-comp.jpeg differ diff --git a/docs/case2.0/img/lectern-tray-stoppers-comp.jpeg b/docs/case2.0/img/lectern-tray-stoppers-comp.jpeg new file mode 100644 index 0000000..8d672fc Binary files /dev/null and b/docs/case2.0/img/lectern-tray-stoppers-comp.jpeg differ diff --git a/docs/case2.0/img/lectern-tray-stoppers_hands-comp.jpeg b/docs/case2.0/img/lectern-tray-stoppers_hands-comp.jpeg new file mode 100644 index 0000000..7e3d67a Binary files /dev/null and b/docs/case2.0/img/lectern-tray-stoppers_hands-comp.jpeg differ diff --git a/docs/case2.0/overview.md b/docs/case2.0/overview.md new file mode 100644 index 0000000..b15987d --- /dev/null +++ b/docs/case2.0/overview.md @@ -0,0 +1,6 @@ +--- +title: Overview +order: 0 +--- + +See \ No newline at end of file diff --git a/docs/case2.0/tips-and-tricks.md b/docs/case2.0/tips-and-tricks.md new file mode 100644 index 0000000..8e382c0 --- /dev/null +++ b/docs/case2.0/tips-and-tricks.md @@ -0,0 +1,40 @@ +--- +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 +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) diff --git a/docs/checklists/avtech-daily.md b/docs/checklists/avtech-daily.md new file mode 100644 index 0000000..2c04265 --- /dev/null +++ b/docs/checklists/avtech-daily.md @@ -0,0 +1,5 @@ +--- +title: "A/V-Tech: Daily Stage Bootup" +--- + +See: \ No newline at end of file diff --git a/docs/checklists/avtech-talk.md b/docs/checklists/avtech-talk.md new file mode 100644 index 0000000..d71d90d --- /dev/null +++ b/docs/checklists/avtech-talk.md @@ -0,0 +1,5 @@ +--- +title: "A/V-Tech: Talk Checklist" +--- + +See: \ No newline at end of file diff --git a/docs/checklists/camera.md b/docs/checklists/camera.md new file mode 100644 index 0000000..46a40cb --- /dev/null +++ b/docs/checklists/camera.md @@ -0,0 +1,5 @@ +--- +title: Camera Angel +--- + +TODO diff --git a/docs/checklists/mixer.md b/docs/checklists/mixer.md new file mode 100644 index 0000000..2a0c74b --- /dev/null +++ b/docs/checklists/mixer.md @@ -0,0 +1,5 @@ +--- +title: Video Mixer Angel +--- + +TODO diff --git a/docs/faq.md b/docs/faq.md new file mode 100644 index 0000000..f66d761 --- /dev/null +++ b/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. diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..a640b2d --- /dev/null +++ b/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 diff --git a/docs/tracker/checking.md b/docs/tracker/checking.md new file mode 100644 index 0000000..f638617 --- /dev/null +++ b/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). diff --git a/docs/tracker/cutting.md b/docs/tracker/cutting.md new file mode 100644 index 0000000..b55ad84 --- /dev/null +++ b/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). diff --git a/docs/tracker/index.md b/docs/tracker/index.md new file mode 100644 index 0000000..6be7929 --- /dev/null +++ b/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 +``` diff --git a/docs/tracker/setup.md b/docs/tracker/setup.md new file mode 100644 index 0000000..63543c9 --- /dev/null +++ b/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). diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..eb605d0 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,45 @@ +site_name: c3voc Handbook +repo_url: https://git.hamburg.ccc.de/jtbx/c3voc-docs +copyright: CC BY 4.0 +markdown_extensions: + - smarty + +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 +# 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