AIGC Vault X Video Service

Local helper service for AIGC Vault. It resolves X/Twitter status URLs with yt-dlp, downloads MP4 files to the user's machine, and exposes local file URLs for the browser extension.

Install

brew install node yt-dlp ffmpeg
npm install -g aigc-vault-x-video-service

Start

aigc-vault-x-video-service

The default service URL is:

http://127.0.0.1:8899

The default download directory is:

~/Movies/AIGC-Vault-X-Videos

Auto-start on macOS

aigc-vault-x-video-service --install

Remove auto-start:

aigc-vault-x-video-service --uninstall

Options

aigc-vault-x-video-service --host 127.0.0.1 --port 8899
aigc-vault-x-video-service --download-dir ~/Movies/AIGC-Vault-X-Videos

If you want another computer on the same network to access this service, start it with a LAN host such as:

aigc-vault-x-video-service --host 0.0.0.0

Then set the AIGC Vault extension service URL to that computer's LAN address, for example:

http://192.168.1.23:8899

API

GET /health

Returns service status.

POST /resolve-x-video

Body:

{
  "url": "https://x.com/user/status/123",
  "download": true
}

Response:

{
  "success": true,
  "videoUrl": "http://127.0.0.1:8899/files/123.mp4",
  "filePath": "/Users/name/Movies/AIGC-Vault-X-Videos/123.mp4",
  "fileName": "123.mp4"
}

Only x.com / twitter.com status URLs are accepted.

Notes

This service uses:

yt-dlp --cookies-from-browser chrome -S "res,ext:mp4:m4a" --merge-output-format mp4

Chrome may ask for macOS Keychain permission when yt-dlp reads browser cookies. Enter the Mac login password and allow access.