THE BLACKCAT Vimeo Agent Studio

# THE BLACKCAT Vimeo Agent Studio

## Purpose

Paste a list of Dropbox share links -> press one button -> the videos get
imported into Vimeo. No duplicates: every link already uploaded is skipped.

## How it works

The dashboard (`studios/vimeo-agent-studio/`, port 8774) wraps the proven
engine that stays in its original workspace (NOT moved, NOT modified):

```text
/Users/pabloscandoglierro/Documents/Codex/2026-05-07/tengo-un-listado-de-links-de/
  vimeo_dropbox_uploader.py   the engine
  vimeo_upload_state.json     upload history / dedupe state
  guardar_token_vimeo.sh      one-time token setup into the Keychain
```

- **Pull uploads**: Vimeo downloads each video straight from Dropbox. The
  files never pass through this Mac.
- **Dedupe**: the state file records every processed link; re-running a list
  skips what is already uploaded ("ya estaban").
- **Auth**: the Vimeo token lives in the macOS Keychain (service
  `vimeo-dropbox-uploader`, account `vimeo-access-token`). If it is missing,
  run `guardar_token_vimeo.sh` once in the workspace.

Do not commit tokens, Dropbox URLs, Vimeo state files, or private upload
manifests into this portal repo.

## Launch

```bash
scripts/open-vimeo-agent-studio.command
```

Then open `http://127.0.0.1:8774`.

## Usage

1. Paste the Dropbox links (one per line), or drag a `.txt` list onto the
   dropzone. Only `www.dropbox.com` links ending in `.mp4` / `.mov`.
2. Press **"Subir a Vimeo (N videos)"**.
3. Watch the progress: each video logs UPLOADED / SKIP / FAILED.
4. "Subidas recientes" shows the history with direct Vimeo links.

Advanced (collapsed): dry run (simulate without uploading), retry failed,
limit. The CLI flow (`subir_videos_a_vimeo.sh` in the workspace) still works
for terminal use.

## Vimeo Privacy Defaults

The engine creates pull uploads with conservative privacy defaults:

```text
view: nobody
embed: private
comments: nobody
download: false
```

Change those defaults only deliberately in the source uploader.