initial commit

.gitignore

@@ -0,0 +1,14 @@
+*.acn
+*.acr
+*.alg
+*.aux
+*.glg
+*.glo
+*.gls
+*.glsdefs
+*.ist
+*.log
+*.out
+*.pdf
+*.gz
+*.toc

.vscode/settings.json

@@ -0,0 +1,2 @@
+{
+}

Atem Mini.tex

@@ -0,0 +1 @@
+\chapter{Atem Mini}

Glossar.tex

@@ -0,0 +1,78 @@
+\newglossaryentry{Lautheit}{
+	name={Lautheit},
+	description={Lautheit ist eine Größe welche die von Menschen empfundene Lautstärke eines Signals abbilden soll. Damit unterscheidet sie sich vom Peak-Wert, welcher den Maximalwert eines Signals angibt. Pegelanzeigen zeigen in der Regeln den \Gls{Peak}-Wert an und eignen sich damit nur bedingt für eine Aussage über die Lautheit.\\Die Lautheit wird meistens in \textit{LU} (\textit{\textbf{L}oudness \textbf{U}nits}) angegeben, häufig auch in Bezug auf den maximal möglichen Wert (\textit{\textbf{F}ull \textbf{S}cale}-Wert): \textit{LUFS}},
+	see={Peak}
+}
+
+\newglossaryentry{Peak}{
+	name={Peak},
+	description={Der Peak-Wert bezeichnet den Spitzenwert eines (Audio)-Signals. Mit dem Peak-Wert lassen sich nur bedingt Aussagen über die Lautheit machen}
+	,see={TruePeak,Lautheit}
+}
+
+\newglossaryentry{TruePeak}{
+	name={True-Peak},
+	description={},
+	see={Peak}
+}
+
+\newglossaryentry{VST-Plugin}{
+	name={VST-Plugin},
+	description={VST steht für Virtual Studio Technology und ist eine Programmierschnittstelle für Audio-Plugins}
+}
+
+\newglossaryentry{SDI}{
+	name={SDI},
+	description={SDI, kurz für Serial Digital Interface, ist eine serielle Übertragungsschnittstelle für digitale Videosignale über Koaxialkabel oder Lichtwellenleiter. Es ermöglicht im Gegensatz zu HDMI Kabellängen von bis zu 100 Metern (über Koaxialkabel)}
+}
+
+\newglossaryentry{NDI}{
+	name={NDI},
+	description={NDI, kurz für Network Device Interface, ist eine Spezifikationen zur Übertragung digitaler Videosignale über ein Computernetzwerk}
+}
+
+\newglossaryentry{PTZ-Kamera}{
+	name={PTZ-Kamera},
+	description={Eine PTZ-Kamera ist eine Kamera, deren \textbf{P}an, \textbf{T}ilt und \textbf{Z}oom ferngesteuert werden kann}
+}
+
+\newglossaryentry{FoH_full}{
+	name={Front of House},
+	description={\textit{Front of House} bezeichnet den Ort, an dem sich bei einer Veranstaltung die Ton-, Video- und Lichttechnik befindet}
+}
+
+\newglossaryentry{FoH}{
+	name={FoH},
+	description={Abkürzung für \Gls{FoH_full}},
+	see={FoH_full}
+}
+
+\newglossaryentry{PoE_full}{
+	name={Power over Ethernet},
+	description={Power over Ethernet bezeichnet das Verfahren, elektronische Geräte über das Ethernet-Kabel mit Strom zu versorgen. Dies ermöglicht den Anschluss eines Gerätes ohne zusätzliche Stromversorgung. Dies wird zum Beispiel häufig für WLAN-Access-Points verwendet}
+}
+
+\newglossaryentry{PoE}{
+	name={PoE},
+	description={Abkürzung für \Gls{PoE_full}},
+	see={PoE_full}
+}
+
+\newglossaryentry{OBS} {
+	name={OBS},
+	description={Open Broadcaster Software ist eine Videomischsoftware, mit welcher Bild-, Video- und Audiosignale live zusammengesetzt und gemischt werden können}
+}
+
+\newglossaryentry{Visca} {
+	name={Visca},
+	description={Das Visca-Protokoll ist ein von Sony entwickeltets Protokoll, zur Kommunikation mit Videokameras}
+}
+
+\newglossaryentry{stinger} {
+	name={Stinger-Transition},
+	description={Stinger-Transitions sind eine Möglichkeit in \Gls{OBS}, einen Übergang zwischen zwei Szenen zu gestalten. Hierbei wird eine Videodatei über das eigentliche Bild gelegt und nach einer vorher definierten Zeit zur neuen Szene gewechselt. Durch transparente Anteile in der Videodatei sind weiche Übergänge möglich},
+	see={OBS}
+}
+
+\setglossarystyle{altlist}
+\printglossary

Kabel.tex

@@ -0,0 +1,33 @@
+\chapter{Verkabelung}
+	\section{SDI}
+		Alle Videostrecken wurden mit \Gls{SDI}-Koaxial-Kabeln durchgeführt, da die einige der Strecken zu lang für eine zuverlässige HDMI-Verbindung sind. Im Computer ist hierfür eine \textit{Blackmagic Design DeckLink Duo 2} verbaut. Diese bietet 4 Bidirektionale 3G-\Gls{SDI}-Anschlüsse und einen Sync-Eingang; dieser wird allerdings nicht benutzt.
+
+		Es sind folgende Kabelstrecken installiert:
+		\begin{table}[h]
+			\caption{Belegung der \Gls{SDI}-Capture-Karte \textit{Blackmagic Design DeckLink Duo 2}}
+			\centering
+			
+			\begin{tabular}{ccl}
+				\toprule
+				Anschluss & Konfiguration & Bezeichnung \\
+				\midrule
+				Sync & - & nicht verwendet \\
+				1 & Eingang & \Gls{PTZ-Kamera} \\
+				2 & Eingang & Leitung Altarraum \\
+				3 & Eingang & Patchfeld \Gls{FoH} \\
+				4 & Ausgang & Beamer Gemeindesaal \\
+				\bottomrule
+			\end{tabular}
+		\end{table}
+
+		Die PTZ-Kamera ist fest angeschlossen, ebenso der Beamer. Die Leitung in den Altarraum endet hinter dem Leimbinder am Flügel wo noch einige restliche Meter Kabel aufgewickelt sind. Der dritte Anschluss ist an das Patchfeld im Rack angeschlossen. Diese beiden freien Leitungen sind für weitere Videoquellen gedacht, die bedarfsorientiert genutzt werden können. Hierzu gibt es auch noch ein weiteres, loses \Gls{SDI}-Kabel und Verbinder umd bestehende Kabel zu verlängern.
+
+	\section{Netzwerk}
+		Das \Gls{FoH} ist über einen einzelne Gigabit Leitung an das Netzwerk und somit auch an das Internet angeschlossen. Der Haupt-Switch befindet sich unter der Treppe im Kindergarten. Von hieraus liegen 4 Leitungen auf die Bühne in die Theke des Jugendcafes. An einen dieser Ports ist ein weiteres Kabel angeschlossen, welches auf den Speicher und dann entlang der wandseitigen Lampen im Gemeindesaal führt bis in das Rack. Dort befindet sich ein 8-Fach Switch, welcher die verschiedenen Geräten verbindet.
+
+		Da der Haupt-Switch \Gls{PoE} zur Verfügung stellt, ist keine zusätzliche Stromversorgung des Technik-Switches notwendig. Ebenfalls wird innerhalb der beiden vierer Gruppen \Gls{PoE} weitergeleitet. Ebenfalls wird die \Gls{PTZ-Kamera} über \Gls{PoE} mit Strom versorgt.
+
+		Desweiteren ist der Streamingrechner an den Switch angeschlossen.
+
+	\section{Tontechnik}
+		

Kameras.tex

@@ -0,0 +1,11 @@
+\chapter{Kameras}
+	\section{PTZ}
+		\subsection{Stromversorgung}
+
+		\subsection{Parposition}
+			Damit sich während der Nichtbenutzung der Kamera möglichst wenig Staub auf der Linse ablagert, fährt die Kamera beim Schließen von OBS eine Parkposition an, in welcher sie senkrecht nach unten schaut.
+
+			Hierzu ist im \Gls{OBS}-Plugin \textit{Advanced Scene Switcher} ein Makro hinterlegt, welches beim Schließen von OBS ausgeführt wird. Es wird eine Exe ausgeführt, welche einen \Gls{Visca}-Befehl an die \Gls{PTZ-Kamera} sendet.
+
+			Das Programm ist ein Python-Skript, welches als Standalaone-Exe kompiliert wurde. Über das Modul \textit{visca-over-ip} kann mit \Glsplural{PTZ-Kamera} kommuniziert werden. Vor dem erstellen der Exe-Datei muss die IP-Adresse angepasst werden.
+	\section{Sony A6000}

Software.tex

@@ -0,0 +1,14 @@
+\chapter{Software}
+	\section{OBS}
+		Über \Gls{OBS} werden die verschiedenen Videosignale gemischt, aufgenommen und an YouTube geschickt.
+	
+		\subsection{Plugins}
+	\section{PPT NDI}
+		Alle Text-Einblendungen werden mit PowerPoint erstellt. Eine Vorlage befindet sich im Google-Drive Verzeichnis.
+
+		PPT NDI läd eine PowerPoint-Präsentation und spielt diese über \Gls{NDI} aus. Dieses \Gls{NDI}-Signal lässt sich wiederrum in \Gls{OBS} einbinden. Dies hat den Vorteil, dass kein Extra-Bildschirm freigehalten werden muss, auf dem PowerPoint läuft und abgefilmt wird.
+
+		Die Shortcuts, um die Folien zu wechseln, sind auf dem Streamdeck programmiert.
+	\section{Youlean-Loudness-Meter}
+		\textit{Youlean-Loudness-Meter} ist ein \Gls{VST-Plugin}, welches die \Gls{Lautheit} eines Audiosignals plottet
+	\section{PTZOptics-Control Pane}

Streamdeck.tex

@@ -0,0 +1,31 @@
+\chapter{Streamdeck}
+	Das \textit{Elgato Streamdeck} ist eine programmierbare Makrotastatur mit 15 Displaytasten. Mithilfe der zugehörige Software von Elgato kann man eine maßgeschneiderte Makrotastatur erstellen, welche mit vielen Programmen direkt kommunizieren kann.
+
+	Das verbaute Streamdeck wird allerdings mit der drittanbieter Software \textit{Bitfocus Companion} betrieben. Diese bietet ähnliche Funktionen, ist aber eher für Rundfunkanwendungen konzipiert. Es lassen sich ebenfalls viele Programme durch Netzwerkprotokolle direkt einbinden.
+
+	Das Interface bildet 100 aufeinanderfolgende Seiten ab, zwischen denen auf- und abgeblättert oder umhergesprungen werden kann.
+
+	Programmiert sind unter anderem Seiten, um:
+	\begin{itemize}
+		\item Programme zu starten
+		\item Stream und Aufnahme zu starten und beenden
+		\item Szenen in \Gls{OBS} zu wechseln
+		\item PTZ-Presets abzurufen
+		\item Einblendungen zu steuern
+		\item die \Gls{PTZ-Kamera} fernzusteuern
+		\item PTZ-Preset abzuspeichern
+		\item Atem-Mischer fern zu steuern
+	\end{itemize}
+
+	\section{Einrichtung}
+		Die komplette Einrichtung der Companion-Software erfolgt im Browser. Durch einen Klick auf das Symbol im Benachrichtigungsfelder der Taskleiste öffnet sich ein Fenster, mit welchem die Konfigurationsseite im Browser öffnen lässt (\textit{Launch GUI}).
+
+		Dort kann nun sowohl die Belegung der einzelnen Buttons, als auch die Konfiguration der geladenen Modulen angepasst werden.
+
+	\section{Konfiguration}
+		\subsection{PTZ}
+			Companion ermöglicht eine direkte Steuerung der \Gls{PTZ-Kamera} über das \textit{\Gls{Visca}-Protokoll}. Die Buttons, welche die verschiedenen PTZ-Presets abrufen, haben zwei Befehle hinterlegt:
+			\begin{enumerate}
+				\item PTZ-Preset abrufen: Dies sendet einen \Gls{Visca}-Befehl an die Kamera, um das entsprechende Preset anzufahren.
+				\item Szenen-Wechsel in \Gls{OBS}: In \Gls{OBS} zu der Szene wechseln, welche dem Preset entspricht. Hierdurch wird die \Gls{stinger} ausgelöst.
+			\end{enumerate}

YouTube.tex

@@ -0,0 +1 @@
+\chapter{YouTube}

johannes-streaming-dokumentation.tex

@@ -0,0 +1,90 @@
+\documentclass[11pt, fleqn]{scrreprt}
+
+\usepackage[utf8]{inputenc} %support for german chars
+\usepackage[ngerman]{babel} %support for german chars
+\usepackage{icomma} %for german comma at decimal number
+\usepackage{multicol} %enables text in multiple columns
+% \usepackage{titling} %enables subtitle
+\usepackage{microtype} %final document is better to read
+%\usepackage[onehalfspacing]{setspace} %one-half line spacing
+\usepackage{booktabs} %tools for better tables
+\usepackage[thinlines]{easytable}
+\usepackage[paper=a4paper,top=2cm, bottom=2.5cm, left=2cm, right=2cm]{geometry} %dimensions like word
+\setlength{\parindent}{0pt}
+
+\usepackage{pdflscape}
+
+\usepackage{pgfplots} %plot functions etc
+\usepackage{graphicx} %insert graphics
+\usepackage{url} %make URLs more fancy
+
+\usepackage[hidelinks]{hyperref}
+
+\usepackage{pdfpages} % include pdf pages by \includepdf{}
+
+\usepackage{amsmath} % better math-stuff
+\usepackage{amssymb} % more math symbols
+\usepackage{float}
+
+\usepackage{csvsimple}
+
+\usepackage{ulem}
+\usepackage{cleveref}
+
+\usepackage{csquotes}
+
+\usepackage{pgfplotstable}
+
+\usepackage[acronym,toc]{glossaries}
+\makeglossaries
+
+\usepackage[justification=justified]{caption}
+\usepackage[justification=centering,singlelinecheck=false,labelsep=period]{caption}
+\addto\captionsngerman{\renewcommand{\figurename}{Bild}}
+
+\usepackage{siunitx}
+\sisetup{
+	locale = DE,
+	inter-unit-product = \text{}
+}
+\DeclareSIUnit\bar{bar}
+
+\pgfplotsset{compat=newest}
+
+% \newcommand{\subtitle}[1]{\posttitle{\par\end{center}\begin{center}\large#1\end{center}\vskip0.5em}} %enables subtitle
+
+\widowpenalty
+\clubpenalty
+
+% \titlehead{titlehead}
+\subject{Dokumentation}
+\title{Streaming-Setup in der Johanneskirche Bühl}
+\subtitle{Version 0.1}
+\author{Simon Ziegler}
+\date{Stand \today}
+\publishers{installiert von Jonas Borho \& Simon Ziegler}
+
+\newcommand{\rarrow}{$\rightarrow$ }
+\newcommand{\larrow}{$\leftarrow$ }
+\newcommand{\Rarrow}{$\Rightarrow$ }
+\newcommand{\Larrow}{$\Leftarrow$ }
+
+\KOMAoptions{numbers=noendperiod}
+
+
+\begin{document}
+	\maketitle
+
+	\newpage
+
+	\tableofcontents
+	\newpage
+
+	\input{Kabel}
+	\input{Streamdeck}
+	\input{Software}
+	\input{YouTube}
+	\input{Atem Mini}
+	\input{Kameras}
+	\input{Glossar}
+\end{document}