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,
--partpicks the post:--part 0is the first,--part 1the 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. It asks Buzzmark for an upload link for the file's name.
2. It sends the file's bytes to that link, which is good for one file and 55 minutes.
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
- Commands and flags
Each Buzzmark tool is a command: `buzzmark schedule-post` runs the schedule_post tool, and `buzzmark tools` lists them all.
- Answers and exit codes
The Buzzmark CLI answers JSON on stdout. An error is JSON on stderr with a code and a message, and the exit code says what kind, so a script or an agent can branch on it.
- Pictures and video
A Buzz takes JPG, PNG, WebP or GIF pictures up to 10 MB and MP4 or MOV video up to 1 GB, and a video always goes out on its own.
- Templates, collections and media
Library holds what you reuse: Templates to start a post from, Hooks for its first line, Collections for anything you keep, Media for your pictures, and Written by Buzz.