Clone
1
Upload Guide
Omarchy-Big-PC edited this page 2026-08-28 14:49:54 +01:00

Upload Guide

The Upload panel (bottom of the page) adds recordings from your browser.

Rules

  • Filenames must be HH.MM.SS.mp4 or HH.MM.SS.avi, e.g. 09.28.36.mp4. 8.28.36.mp4 also works; it is padded to 08.28.36.mp4 automatically.
  • MP4 files go into the playable archive (media-mp4) and appear on the timeline immediately.
  • AVI files go into the source folder (media), matching where the recorder keeps originals. Run the Encoding menu afterwards to make them playable.
  • Files land under the date selected in the top-right dropdown. Pick the date first.
  • Duplicate timestamps are rejected with HTTP 409. Existing recordings are never overwritten.

Bulk upload

Drag a whole batch of files onto the panel or select many in the file dialog. Up to three files upload in parallel, each with its own progress bar. Failed files stay in the queue for retry; successful ones are cleared when the whole batch finishes.

API

For scripts and agents:

curl -X POST "http://127.0.0.1:8765/api/upload?date=20260827&filename=09.28.36.mp4" \
  --data-binary @clip.mp4

Responses: 200 {"ok": true, "file": "20260827/09.28.36.mp4"}, 400 for a bad name/date, 409 if that timestamp already exists, 413 over 2 GiB.