HowToOperate.JSON

{
  "content": "## How To Operate xPub\n\n### Publisher Tab\n\n1.  **Select Project Context**: Use the `Show`, `Sequence`, and `Shot` dropdowns to locate your work.\n\n2.  **Browse Renders**: Available renders for the selected shot will appear. Expand the user, then the render name to see specific versions.\n\n3.  **Understand Status Icons**:\n    -   **Publish Status** (First dot, left):\n        -   🟢 **Green**: Published and the destination size is correct or larger.\n        -   🔴 **Red**: Published, but the destination is smaller than the source (potential issue).\n        -   🔵 **Blue**: Ready to publish (has data, but not yet published).\n        -   ⚪ **Grey**: Source folder is empty (0 KB).\n    -   **Frame Status** (Second dot, right):\n        -   🟢 **Teal**: Frame count matches the shot's range.\n        -   🟣 **Magenta**: Frame count does not match.\n        -   ⚪ **Grey**: No frame range data to check against.\n\n4.  **Select & Comment**: Select one or more version folders you wish to publish. You must add a comment in the text box below.\n\n5.  **Publish**: The `Publish` button will activate. Click it to start the process.\n\n6.  **Use Options**:\n    -   `⚠️ Clear Source`: Check this to **MOVE** files instead of copying. The source directory will be deleted after a successful publish.\n    -   **Log Browser (▲/▼)**: Click the arrow buttons to cycle through the publish history for the selected shot.\n\n---\n\n### Archiver Tab (Admin Only)\n\nThis tab performs destructive delete operations and is restricted to admin users.\n\n1.  **Select a Sequence**: Use the `Show` and `Sequence` dropdowns.\n\n2.  **Choose Data Source**: Select `WIP` to analyze working files or `FINAL` to analyze published files.\n\n3.  **Analyze Shots**: Select one or more shots in the tree to view their contents. This will update the summary icons.\n\n4.  **Review Summary Icons**: The icons next to the `Sequence` dropdown summarize the data status for the *selected shot(s)*:\n    -   🔴 **Red**: Predominantly small or empty files.\n    -   🟡 **Yellow**: Predominantly old data.\n    -   🟢 **Green**: Predominantly recent, valid data.\n\n5.  **Set Archive Filters**:\n    -   `Threshold`: Keeps this many of the newest versions. Older versions are targeted for deletion.\n    -   `Max Age`: If enabled, this rule **overrides** the threshold. It targets *any* version older than the specified number of days for deletion, even if it's one of the newest.\n\n6.  **Archive**: Add a comment and click `Archive` to permanently delete the contents of the targeted version folders."
}