> 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/reference/file-system-and-storage/video-library.md).

# Video library

The Video Library is a storage option specifically for video content, separate from the Nuvolos file system. Videos uploaded to the library are stored as streams that can be embedded into `README.md` files anywhere in the space. This page documents what the Video Library is and how it is provisioned. For step-by-step instructions on uploading and embedding videos, see \[How-to › For Instructors › Configure course tools and resources]\(link to 3.1).

### What the Video Library stores

The Video Library is dedicated video storage with its own quota, separate from your space's file system quota. Three properties distinguish it from storing video files in `/files`:

* **Streaming, not download** - videos are played as streams in the browser. Recipients watch the video directly without downloading the file.
* **One upload, many embeds** - a single video can be embedded into any number of `README.md` files at no additional storage cost. Distributing a README that contains a video embed code does not duplicate the video.
* **Origin-locked playback** - the streaming provider only plays back videos when they are embedded on Nuvolos. Embed codes copied to a third-party site will not play.

### Storage quota

Each space has a Video Library quota measured in **hours of video content**. The default quota is **60 hours per space**. The quota is independent of the file system quota - uploading a video to the Video Library does not consume file system storage.

{% hint style="info" %}
To request a quota change, contact Nuvolos support.
{% endhint %}

### Subscription and enablement

The Video Library is an optional service. Availability depends on:

* **Organisation subscription** - the Video Library must be included in the organisation's subscription. If it is not, contact your organisation manager to request a subscription upgrade.
* **Space-level enablement** - once available at the organisation level, a Space Administrator must enable it for each space. This is a one-time action per space.

To enable per-space, the Space Administrator navigates to **Project Configuration** and selects the **Enable** option for the Video Library. For administrative procedures, see [Administration › Space management](/administration/space-management.md).

### Embed code options

Once a video is uploaded, the Video Library generates two forms of embed code:

* **Fixed size** - the video has a fixed width and height. Useful in interactive documents where space is limited or videos are embedded in a tabular layout.
* **Responsive** - the video uses the maximum available width in the surrounding document and adapts to browser resizing.

Both forms work the same way once pasted into a `README.md` file. The choice is layout-driven.

### Where to find the embed codes

Only Space Administrators can access the Video Library menu and retrieve embed codes. If you are not a Space Administrator, ask one to share the embed code with you.

### Editor mode for embedding

Pasting a video embed code into a `README.md` only works in the side-by-side editor mode, not the WYSIWYG mode. Toggle between editor modes via the control in the bottom right corner of the editor.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.nuvolos.com/reference/file-system-and-storage/video-library.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.