asciinema-upload(1)

asciinema-upload(1) — the upload bestie page 💅

okay so this is the General Commands Manual page for asciinema-upload(1) — literally the manual for sending your recording to an asciinema server. No gatekeeping, bestie: you have a local recording, it goes up, you get a shareable URL. iconic behavior. ✨

🌸 NAME 🌸

asciinema-upload — Upload a recording to an asciinema server.

💖 SYNOPSIS 💖

asciinema upload [-t|--title] [--description] [--visibility]
[--audio-url] [--server-url] [-q|--quiet] [-h|--help] <FILE>

🦋 DESCRIPTION 🦋

Upload a recording to an asciinema server. simple as that, fr fr.

It takes a local asciicast file and uploads it to an asciinema server — either asciinema.org or a self-hosted server — and gives you back a recording URL that can be shared publicly. main character energy: your terminal session, but on the internet. 💅

✨ OPTIONS ✨

• -t, --title=TITLE — Set a title for the recording that will be stored in the recording metadata and displayed to viewers. For example: --title "Installing Podman on Ubuntu". This option takes precedence over the "title" field from the recording file itself.
• --description=DESCRIPTION — Set a description for the recording. This description is displayed on the recording page and can include formatting, links, and code blocks. Useful for providing context, instructions, or documentation for viewers.
• --visibility=VISIBILITY — Set the visibility level for the recording. Public recordings appear in listings, search results and on your profile page. Unlisted recordings are accessible via a direct URL but don't appear in listings. Private recordings are only accessible to the owner.

[possible values: public, unlisted, private]

• --audio-url=URL — Specify the URL of an audio file (e.g., MP3/OGG) to synchronize with the terminal playback. When set, viewers can listen to audio commentary while watching the terminal. The audio URL is stored in the recording metadata and used by the player for synchronized playback. For example: --audio-url https://example.com/commentary.mp3
• --server-url=URL — Specify a custom asciinema server URL for uploading to self-hosted servers. Use the base server URL (e.g., https://asciinema.example.com). Can also be set via environment variable ASCIINEMA_SERVER_URL or config file option server.url. If no server URL is configured via this option, environment variable, or config file, you will be prompted to choose one (defaulting to asciinema.org), which will be saved as a default.
• -q, --quiet — Suppress diagnostic messages and progress indicators. Only error messages will be displayed.
• -h, --help — Print help (see a summary with '-h').
• <FILE> — The path to the asciicast recording file to upload, in a supported asciicast format (v1, v2, or v3).

---

✨ That's the whole page, bestie — footer tea: source tag upload, page asciinema-upload(1), and no date is printed in this footer. Mwah 💋