Feature request: support video media upload when posting

[tmac33]

Summary

Please add support for publishing tweets with video media (e.g. MP4) from the CLI.

Current limitation

twitter post currently accepts text only, so automation pipelines cannot publish short videos.

Expected capability

• Post text + video in one command
• Support common options like:
  • --file (single video)
  • --alt-text (optional)
• Handle upload progress and clear error messages for processing failures

Suggested implementation

• Use X media upload flow (INIT/APPEND/FINALIZE + STATUS polling for async video processing)
• Return tweet id / URL on success

Why this matters

Many users run scheduled content pipelines and currently must fall back to browser automation for video posts. Native video upload in twitter-cli would greatly improve reliability and developer experience.

Thanks for considering this feature!

[jackwener]

waiting for stable of project

[neoromantic]

I mean, first we'd love to be able to post images :)

[jackwener]

Thanks for the feature request! 🎉

We just shipped image upload support in the latest release — post, reply, and quote commands now accept --image / -i (up to 4 images, JPEG/PNG/GIF/WebP).

twitter post "Hello!" --image photo.jpg
twitter post "Gallery" -i a.png -i b.jpg

The underlying upload infrastructure (INIT → APPEND → FINALIZE via upload.twitter.com) is already in place. Video upload would additionally need:

• Async processing with STATUS polling after FINALIZE
• Larger file size limits (512 MB for video vs 5 MB for images)
• media_category=tweet_video in the INIT call

This is on the roadmap — the hardest part (the upload pipeline) is done. Will keep this issue open to track video support specifically.