Skip to the page

Add a picture or video from your machine

`buzzmark upload <file>` adds a picture or video from the machine the CLI runs on to your Library, and to a draft when you name one with --post-id.

Buzzmark checks its type and size as the app does, and keeps its own copy.

Upload a file

Terminal

buzzmark upload launch.png --post-id 42
buzzmark upload menu.mp4
  • With --post-id, the file goes onto that draft and into your Library.
  • Without it, the file goes into your Library only.
  • In a thread, --part picks the post: --part 0 is the first, --part 1 the second.

It takes JPG, PNG, WebP, GIF, MP4 or MOV: pictures up to 10 MB, videos up to 200 MB. Another file is refused with the reason, and exit code 1.

The answer is JSON with Buzzmark's own link to the file and whether it's a picture or a video. With --post-id, it also says what a platform on that draft would refuse, such as a shape Instagram doesn't take. Pictures and video has each platform's rules.

What the command does

  1. 1. It asks Buzzmark for an upload link for the file's name.

  2. 2. It sends the file's bytes to that link, which is good for one file and 55 minutes.

  3. 3. It tells Buzzmark the upload is done, and Buzzmark checks the file and keeps it.

The file goes from your machine straight to Buzzmark's storage. An AI app that can read your files, such as Claude Code, uses the same 3 steps through the tools create_upload_link and add_uploaded_media.

Where to next