asciinema-upload(1)

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.

Takes a local asciicast file and uploads it to an asciinema server (either asciinema.org or a self-hosted server), returning a recording URL which can be shared publicly.

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)