> For the complete documentation index, see [llms.txt](https://info.picturesup.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://info.picturesup.app/library.md). # Library and uploads The Library holds every file the studio has: one folder per production, a small Studio drive for brand assets, templates and music, and collections that gather files from anywhere. Every file is encrypted before it is stored, previews are made on the server, and uploads pick up where they left off. ![The Library](https://2219266317-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3d0MFWUa7VoBOdFAsEhL%2Fuploads%2FcTQeB0WdRL6dEwiKY1uG%2Flibrary.a4c36392.png?alt=media) *Productions, the Studio drive and collections, with the tree on the left.* ### How it is organized * **Productions.** Each production gets six folders the first time an admin or editor opens its Media: Frames, Stills, Audio, Picture Reviews, Picture Finals and Paperwork. Add your own with "New folder". * **Studio.** Folders that are not tied to a production. Make them with "New folder" at the top level. * **Collections.** A set of files from anywhere, with a cover and a description. They are made from a file's menu under Add to collection, then "New collection…". A production's Media tab is the same view, limited to that production. ![A production's Media tab](https://2219266317-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3d0MFWUa7VoBOdFAsEhL%2Fuploads%2FRO8P8T6rAjlwDhH8rMtM%2Fproduction-media.b8f960db.png?alt=media) *The six starting folders, with the inspector on the right.* Switch between grid and list, and sort by name, date added, size, type or status. In the grid, each tile takes the file's own shape, from vertical to wide, so a phone clip looks like one. Click a file to select it, ⌘-click to add more, Shift-click for a range. Enter opens, F2 renames, ⌫ moves to the trash. ### Uploading 1. Open the folder and choose "Upload", or drag files from the desktop onto the folder, the content area or a tile in the tree. 2. Files upload in 64 MB pieces, two at a time, up to 150 GB each. The Uploads row in the sidebar and the tray show progress. 3. If the connection drops, the upload retries on its own after 1, 5 and 15 minutes, and resumes from where it stopped. After that it waits for you: choose "Retry". After a reload, choose the same file again and it carries on. Files of 5 GB and over ask how to make the preview first: on the server, or upload the original only and make a preview later with "Regenerate preview". ### Versions Drop a new file onto an existing card, or choose "Upload new version", and it stacks as v2, v3 and so on. The card shows the version badge. Open comments from the previous version carry forward, marked "from v1", and any approval resets so the new version is reviewed again. "Versions" in the menu or the inspector switches between them, and "Make current" picks which one is current. ### Every file has a state | State | What it means | | ------------------------------------------------------- | ------------------------------------------------------------------------------ | | Uploading N% | Still arriving. Resumable. | | Waiting for preview, Processing preview N% | In the queue. Files in an active review link go first. | | Ready, Needs review, Approved, Changes requested, Final | Playable. The review states come from the [viewer](/library/viewer.md). | | Original only | Video or audio with no preview. It downloads but will not play in the browser. | | No preview | The preview failed. The card says why and offers "Regenerate preview". | Previews are made on the server, one at a time: for video, H.264 previews at 1080p, 720p and 540p (never larger than the source), each small enough to stream; a still up to 1600 px for images; an AAC file and a waveform for audio. Documents have no preview and open in a new tab. The player plays 1080p unless you pick another size, or the original, from the quality menu under it; the choice sticks on that device. The Details panel lists every preview size with its weight. ### The file menu Right-click a file, or choose "More" in the inspector: * Open, Share, Download (Proxy or Original) * Rename, Move, New folder with selection, Edit metadata (description, camera, reel, scene, take, tags, notes) * Add to collection, Upload new version, Versions * Set thumbnail (pick a frame or an image), Regenerate preview, Copy * Move to trash Folders have Open, Share, Rename, Move, New folder inside, Upload files here and Move to trash. ### The inspector The panel on the right shows what is selected: the preview, type, size, duration, resolution and codec, who uploaded it and when, the open comments, metadata and tags. Its Versions tab lists the stack, and Activity shows the last 40 things that happened to the file. ### Trash Moving to the trash is reversible. Trash in the tree lists everything with where it was and a "Restore" button. Only admins can "Delete forever", one item at a time, and nothing is ever deleted on a schedule. ### Processing health ![Processing health](https://2219266317-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3d0MFWUa7VoBOdFAsEhL%2Fuploads%2FxhD0OscKnGkbgheFQUri%2Fprocessing.8f01ee1e.png?alt=media) *What is waiting, what failed and why.* Processing health, at the bottom of the tree, shows what is waiting, what is processing, what failed in the last seven days with the reason and a "Retry now" or "Regenerate" button, the queue in order, and the median time per hour of footage on the server. ### Good to know * Admins and editors change the Library. Viewers look. Crew see only the folders of their own productions, no Studio drive and no trash. * "Download all" exists on share pages, and downloads files one by one rather than as a zip. * Share links are made from the file or folder menu, the inspector, or the Share button at the top. See [Sharing links](/library/sharing.md). * Pictures Up Drive, the Mac app that mounts the Library in Finder and makes previews there, is mentioned in a few places but is not part of this build yet. --- # 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://info.picturesup.app/library.md?ask=&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.