> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/assets/markdown.md).

# Proxy Generation and Complex Previews

When your assets are uploaded to Shade, our system generates H.264 proxies which you can view within the browser and app. Proxies are scaled to fit within 1080p (1920×1080, or 1080×1920 for vertical video); smaller videos keep their original size. Proxies are encoded for consistent quality, with a maximum bitrate of 6,000 kbps for video up to 30 fps, 8,000 kbps up to 60 fps, and 12,000 kbps above 60 fps. These proxies can be downloaded for team members that intend to work off of proxies instead of original files.

{% embed url="<https://youtu.be/VM_yEbNp9xM?si=7eXFajvmKuMbZOH0>" %}

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FQaNiQuZJcx92ruIb0klV%2FGenerateProxy.gif?alt=media&#x26;token=82074c47-6255-4296-9d85-18958215c43e" alt=""><figcaption></figcaption></figure>

### Previewing a LUT

When viewing a video, you can preview it with a color look-up table (LUT) applied:

1. Click the **Apply LUT** button in the player controls.
2. Select **Upload LUT…** and choose a `.cube` file from your computer.

To remove it, open the same menu and select **Clear LUT**. The LUT only changes your preview in the player. It doesn't change the file or its proxy, and other team members won't see it.

### FAQs

<details>

<summary>Do I have to wait for a proxy to be generated before someone can download my asset?</summary>

No. As soon as your file is uploaded, it becomes available to anyone else shared on to that file. You can comment, download, and review metadata while our proxy and AI jobs run in the background. Shade also generates preview images for your video which becomes scrubbable from the asset page as soon as it has processed.

</details>

<details>

<summary>Are proxies available through the ShadeFS mount?</summary>

No. The ShadeFS mount streams the raw file to you computer. The proxy file can be downloaded from the app and then uploaded back through the app or mount. This is useful for when you anticipate using the ShadeFS mount with poor internet connection. The original media can be relinked and you timeline can be exported once you have a stronger connection.

</details>

<details>

<summary>What file types do you support for proxy generation and previews?</summary>

All of our supported file types and capabilities can be found [here](https://shade.inc/file-support).

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/assets/markdown.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
