Updated docs

.github/workflows/deploy-docs.yaml

@@ -0,0 +1,56 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - dev
+  pull_request:
+    branches:
+      - dev
+    # Review gh actions docs if you want to further define triggers, paths, etc
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on
+
+jobs:
+  build:
+    name: Build Docusaurus
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Install dependencies
+        run: npm install
+        working-directory: ./docs_v2
+      - name: Build website
+        run: npm run build
+        working-directory: ./docs_v2
+
+      - name: Upload Build Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./docs_v2/build
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    if: github.ref == 'refs/heads/dev'
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write # to deploy to Pages
+      id-token: write # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

CNAME

@@ -0,0 +1 @@
+docs.live.rbg.tum.de

docs_v2/.gitignore

@@ -0,0 +1,22 @@
+w# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+.vercel

docs_v2/README.md

@@ -0,0 +1,90 @@
+# GoCast Docs
+
+Contains the new docs for GoCast.
+
+A prototype can be found [here](https://tumlive-docs.pages.dev/).
+
+## Getting started
+
+To start the development server, run:
+
+```bash
+npm run dev
+```
+
+To build the project site **for production**, run:
+
+```bash
+npm run build
+```
+
+> The static files are generated in the `build` folder.
+
+To start the production server, run:
+
+```bash
+npm run start
+```
+
+## How to add a new page
+
+To add a new page, create a new markdown file in the `docs` directory. The file should have the following structure:
+
+```markdown
+---
+title: Page Title
+---
+
+# Page Title
+
+Page content goes here.
+```
+
+The `title` field in the front matter is used to generate the page title in the sidebar.
+
+## How to add a new section
+
+To add a new section, create a new directory in the `docs` directory. Inside the directory, create a markdown file for each page in the section. The directory should have an `index.md` file with the following structure:
+
+```markdown
+---
+title: Section Title
+---
+
+# Section Title
+
+Section description goes here.
+```
+
+The `title` field in the front matter is used to generate the section title in the sidebar.
+
+## How to add a new sidebar item
+
+To add a new sidebar item, edit the `sidebar.json` file in the `data` directory. The file should have the following structure:
+
+```json
+[
+  {
+    "title": "Section Title",
+    "children": [
+      {
+        "title": "Page Title",
+        "slug": "page-slug"
+      }
+    ]
+  }
+]
+```
+
+The `title` field is used to generate the section title in the sidebar. The `children` field is an array of sidebar items. Each sidebar item should have a `title` field and a `slug` field. The `title` field is used to generate the page title in the sidebar. The `slug` field is used to generate the page URL.
+
+## More information
+
+For more information, see the official Docusaurus docs [here](https://docusaurus.io/docs).
+
+
+
+## Credit
+
+https://docusaurus.io \
+https://github.com/facebook/docusaurus

docs_v2/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

docs_v2/blog/changelogs/v1.2.26.md

@@ -0,0 +1,38 @@
+---
+title: "V1.2.26"
+date: 2023-04-23T08:20:06+02:00
+draft: false
+summary: "This release contains the feature of downloads from the Edge servers and the use of MediaMTX for selfstreams. It also contains some bugfixes."
+tags: [feature, bugfix, misc]
+---
+
+Changes in this release:
+
+## Features
+
+- [allow mp4 downloads from HLS Edge server](https://github.com/joschahenningsen/TUM-Live/pull/931) by [@joschahenningsen](https://github.com/joschahenningsen)
+  - Video files are now downloaded from the edge server instead of pulling the mp4 file from the mass storage.
+    This step helps us get rid of the dependence of video files in the mass storage, thus saving 50% disk space.
+    The long term goal is to only store HLS segments and discard the mp4 files after they have been converted to a HLS stream.
+- [Use MediaMTX for Selfstreams](https://github.com/joschahenningsen/TUM-Live/pull/994) by [@joschahenningsen](https://github.com/joschahenningsen)
+  - Selfstreams are now delivered to the worker using [MediaMTX](https://github.com/aler9/mediamtx).
+    This package has proven to be more reliable and much more actively maintained than nginx with the rtmp module.
+  - MediaMTX is now also embedded in the docker container of the worker. This allows easier deployment and self-streaming to any worker.
+
+---
+
+## Bugfixes
+
+- [Fix chat replay message scrolling](https://github.com/joschahenningsen/TUM-Live/pull/996) by [@MatthiasReumann](https://github.com/MatthiasReumann)
+  - When watching a video on demand with the chat following the stream times, the messages automatically scrolled to were offset
+    by a bit and thus out of the visible area. This is now fixed.
+- [Fix Firefox file drop](https://github.com/joschahenningsen/TUM-Live/pull/999) by [@MatthiasReumann](https://github.com/MatthiasReumann)
+  - Dropping files as lecture attatchments did not work in Firefox. This is now fixed.
+- [Fix skip silence button fadeout](https://github.com/joschahenningsen/TUM-Live/pull/995) by [@MatthiasReumann](https://github.com/MatthiasReumann)
+  - The skip silence button would not fade out when the video was silent. This is now fixed.
+
+---
+
+## Misc
+
+- [Update Node.js to v20](https://github.com/joschahenningsen/TUM-Live/pull/1003)

docs_v2/blog/changelogs/v1.2.27.md

@@ -0,0 +1,12 @@
+---
+title: "V1.2.27"
+date: 2023-04-24T20:56:06+02:00
+draft: false
+summary: "This release contains one small bugfix."
+tags: [bugfix]
+---
+
+This release contains one small bugfix.
+
+- [fix edge server tests and log import](https://github.com/joschahenningsen/TUM-Live/commit/04aa8ca42e32cd9684ee815e445902125981b5c5) by [@joschahenningsen](https://github.com/joschahenningsen)
+  - This fixes an issue with the latest deployment where the wrong log package was imported in the Edge submodule.

docs_v2/blog/changelogs/v1.4.18.md

@@ -0,0 +1,19 @@
+---
+title: "V1.4.18"
+date: 2024-05-06T20:56:06+02:00
+draft: false
+summary: "This release contains a few bug fixes and improvements. It also contains some new features and changes."
+tags: [bugfix, feature]
+---
+
+This release contains a few bug fixes and improvements.
+It also contains some new features and changes.
+
+Bugfixes:
+- Fixed a [bug](https://github.com/TUM-Dev/gocast/pull/1324) where the chat stops working after a too long message
+- Fixed a [bug](https://github.com/TUM-Dev/gocast/pull/1350) where the `watched` state of a VoD wasn't detected correctly
+- Fixed a [bug](https://github.com/TUM-Dev/gocast/pull/1340) where private VoDs were still listed publicly
+- [Skip silence button](https://github.com/TUM-Dev/gocast/pull/1326) not shown if you seek into the silence
+
+Features:
+- You can now select, that the [beta mode](https://github.com/TUM-Dev/gocast/pull/1328) is your default mode

docs_v2/docs/features/LectureHallStreams.md

@@ -0,0 +1,23 @@
+---
+title: "Stream from your Lecture Hall"
+sidebar_position: 1
+description: "Automatic Broadcasting and Recording of Auditoriums"
+---
+
+## Automatic Broadcasting and Recording of Auditoriums
+
+With GoCast, you can easily stream your lectures to the internet. This allows students to follow the lecture from home
+or on the go. If you wish so, a recording of the lecture is also available for later viewing.
+
+For this purpose, we have installed Streaming Media Processors (SMPs) in many lecture halls at TUM. These devices are
+capable of capturing the video and audio of the lecture and sending it to our servers for broadcasting.
+
+For a guide on how to stream from a lecture hall, please refer to the [Lecture Hall Streaming Guide](/docs/usage/lecturehall-streaming.md).
+
+---
+
+# Self-Streaming using OBS, Zoom or other Software
+
+You can also stream your lectures yourself with any streaming software you like. We recommend OBS for this purpose.
+
+For instructions on how to self-stream, please refer to the [Self-Streaming Guide](/docs/usage/self-streaming.md).

docs_v2/docs/features/VideoOnDemand.md

@@ -0,0 +1,13 @@
+---
+title: "Video On Demand"
+sidebar_position: 2
+description: "Upload videos to the server and stream them to the students."
+---
+
+# Video On Demand
+
+Video On Demand (VoD) is a feature that allows you to upload videos to the server and stream them to the students. This
+feature is useful for hosting videos that you want to share with your students.
+
+You can also record your live classes and get them automatically uploaded to the server. This way, students who missed
+the live class can watch the recording later.

docs_v2/docs/features/_category_.json

@@ -0,0 +1,9 @@
+{
+    "label": "Features",
+    "position": 2,
+    "link": {
+      "type": "generated-index",
+      "description": "Learn about the features of GoCast."
+    }
+  }
+

docs_v2/docs/features/_index.md

@@ -0,0 +1 @@
+awdawd

docs_v2/docs/intro.md

@@ -0,0 +1,38 @@
+---
+sidebar_position: 1
+---
+
+# GoCast
+
+Deliver live events and recordings like it's the 21st century. - Privacy friendly, self-hosted and open-source.
+
+![test](/img/showcase-01.png#showcase)
+
+GoCast is a fully self-hosted platform for live-streaming and recording of lectures, in use at the Technical University of Munich as **[TUM-Live](https://live.rbg.tum.de)**.
+
+## Quick facts
+
+GoCast is
+
+- **Widely used** at the Technical University of Munich and handles thousands of hours of video every semester for more than 150 courses and 15.000 Students.
+- **Open-source** and licensed under the [MIT license](https://github.com/joschahenningsen/TUM-Live/blob/dev/LICENSE).
+- **Self-hosted**: You have full control over your data and can run GoCast on your own servers.
+
+## Features
+
+For a detailed list of features, refer to the [features section](/docs/features/LectureHallStreams/).
+
+- Fully automatic Live-Streaming from Auditoriums based on lecture schedules.
+- Self-service interface for lecturers to schedule and manage their videos.
+- Automated import of lectures and enrollment of students from CAMPUSonline.
+- Self-streaming via OBS, Zoom, etc.
+- Automatic recording of live-streams.
+- Video on demand uploads.
+- Automatic post-processing of recordings.
+  - Detects silence in videos and makes them skip-able.
+  - Transcribes videos and makes them searchable.
+  - Generates Thumbnails.
+- Live Chat for listeners to ask questions.
+  - Polls can be created by lecturers.
+  - Questions can be upvoted by listeners.
+  - Questions can be marked as answered or hidden.

docs_v2/docs/selfhosting/_category_.json

@@ -0,0 +1,9 @@
+{
+    "label": "Selfhosting",
+    "position": 4,
+    "link": {
+      "type": "generated-index",
+      "description": "Selfhost GoCast on your network."
+    }
+  }
+