> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/how-to-guides/workflows-for-instructors/configuring-student-applications/video-library.md).

# Video library

## Publish videos to the Video Library

<mark style="color:$primary;">**Outcome**</mark>\
You upload course videos to the Video Library and embed them in a `README.md` so students can watch them in the browser.

<mark style="color:$primary;">**Before you start**</mark>

* The Video Library is enabled at the organisation level and at the space level. For enablement, see [Administration › Space management](/administration/space-management.md).
* You hold the Space Administrator role on the course space (only Space Administrators can access the Video Library).
* You have the video file(s) ready to upload.

The Video Library is a Nuvolos-managed storage option specifically for video content. Once a video is uploaded, you can embed it in any `README.md` in the space - students with access to that space see the embedded video and play it in the browser. For the conceptual model, capabilities, and quota details, see [Reference › File Storage](/reference/file-system-and-storage.md).

### **Upload a video**

{% stepper %}
{% step %}
Navigate to the Master Instance of your course.
{% endstep %}

{% step %}
In the Files view, upload the video file as you would any other file. Common video formats are recognised automatically.
{% endstep %}

{% step %}
After upload, Nuvolos offers two options: **keep the file on the file system** or **remove the file and store only in the Video Library**.
{% endstep %}

{% step %}
Choose **remove the file** unless you have a specific reason to keep a copy on the file system - video files consume file-system quota, and the Video Library is the storage-efficient option.
{% endstep %}

{% step %}
The upload to the streaming provider begins automatically. Processing may take up to 30 minutes for a one-hour video.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
The embed code is available as soon as the upload completes - you do not need to wait for processing to finish before embedding. The video may not yet play, but the link is already there.
{% endhint %}

### **Get the embed code**

{% stepper %}
{% step %}
Navigate to the Video Library menu in the space.
{% endstep %}

{% step %}
Find the video in the library.
{% endstep %}

{% step %}
Choose the **embed code format**: fixed size (for tabular layouts where space is constrained) or responsive (for full-width embedding that adapts to the browser).
{% endstep %}

{% step %}
Copy the embed code to the clipboard.
{% endstep %}
{% endstepper %}

### **Embed in a `README.md`**

{% stepper %}
{% step %}
Open the `README.md` file you want to embed the video in (or create one with **+ NEW**).
{% endstep %}

{% step %}
Open the file in **EDIT** mode via the ... Actions menu.
{% endstep %}

{% step %}
Make sure you are in the side-by-side editor mode - embedding does not work in WYSIWYG mode. Toggle modes via the control in the bottom right corner.
{% endstep %}

{% step %}
Paste the embed code where you want the video to appear.
{% endstep %}

{% step %}
Save the file.
{% endstep %}
{% endstepper %}

When you save, the video renders in the preview pane. Once you distribute the `README.md` to student instances, the video appears in the rendered README on the space overview.

#### Reusing one video across multiple READMEs

A single video in the library can be embedded into any number of README.md files at no additional storage cost. To update a video in multiple places, change the underlying video in the library - every README that embeds it automatically shows the new version. To add a recording to an existing course mid-term, paste the embed code into the relevant README, distribute, and students see the update within seconds.

{% hint style="info" %}
Embed codes are origin-locked - the streaming provider only plays back videos when embedded on Nuvolos. Embed codes copied to a third-party site will not play. This prevents unauthorised reuse of your video content.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuvolos.com/how-to-guides/workflows-for-instructors/configuring-student-applications/video-library.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.