at.meme-museum.meme Documentation (EN)

main record

A single meme asset (still image, animated image, or short video clip) in a user's library.

Record Key tid Timestamp-based ID

Properties

alt string Required

Accessibility alt text. Required, same convention as app.bsky.embed.images.

maxLength: 2000 bytesmaxGraphemes: 1000 graphemes

createdAt string datetime Required

An RFC 3339 formatted timestamp.

duration integer Optional

Video memes only: clip length in milliseconds, read client-side at upload time. Omitted when the browser couldn't decode metadata for the picked file.

minimum: 1

height integer Optional

No description available.

minimum: 1

image blob Optional

The asset, when this meme is an image. Exactly one of image/video is set -- a constraint Lexicon can't express, so it's enforced client-side. Neither is required here so that adding video didn't have to break records written before it existed.

maxSize: 8.0 MB

isAnimated boolean Optional

Image memes only: set client-side from frame-count inspection at upload time, since it isn't reliably inferable from mimetype alone. Not written for video, where it would be trivially true.

source ref #source Optional

No description available.

tags array of string Optional

No description available.

maxLength: 25 items

title string Optional

Short human label for the meme, distinct from alt text (e.g. "distracted boyfriend").

maxLength: 300 bytesmaxGraphemes: 100 graphemes

video blob Optional

The asset, when this meme is a video clip. Always mp4 regardless of what the user picked: the blob is the one Bluesky's video service transcodes and writes back to the PDS, and app.bsky.embed.video accepts nothing else.

maxSize: 100.0 MB

visibility string Optional

Soft signal only, not access control -- see docs/data-model.md.

maxLength: 64 bytes

Known values: public, unlisted

Default: public

width integer Optional

No description available.

minimum: 1

View raw schema

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "alt",
      "createdAt"
    ],
    "properties": {
      "alt": {
        "type": "string",
        "maxLength": 2000,
        "description": "Accessibility alt text. Required, same convention as app.bsky.embed.images.",
        "maxGraphemes": 1000
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 64
        },
        "maxLength": 25
      },
      "image": {
        "type": "blob",
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp",
          "image/gif"
        ],
        "maxSize": 8000000,
        "description": "The asset, when this meme is an image. Exactly one of image/video is set -- a constraint Lexicon can't express, so it's enforced client-side. Neither is required here so that adding video didn't have to break records written before it existed."
      },
      "title": {
        "type": "string",
        "maxLength": 300,
        "description": "Short human label for the meme, distinct from alt text (e.g. \"distracted boyfriend\").",
        "maxGraphemes": 100
      },
      "video": {
        "type": "blob",
        "accept": [
          "video/mp4"
        ],
        "maxSize": 100000000,
        "description": "The asset, when this meme is a video clip. Always mp4 regardless of what the user picked: the blob is the one Bluesky's video service transcodes and writes back to the PDS, and app.bsky.embed.video accepts nothing else."
      },
      "width": {
        "type": "integer",
        "minimum": 1
      },
      "height": {
        "type": "integer",
        "minimum": 1
      },
      "source": {
        "ref": "#source",
        "type": "ref"
      },
      "duration": {
        "type": "integer",
        "minimum": 1,
        "description": "Video memes only: clip length in milliseconds, read client-side at upload time. Omitted when the browser couldn't decode metadata for the picked file."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "isAnimated": {
        "type": "boolean",
        "description": "Image memes only: set client-side from frame-count inspection at upload time, since it isn't reliably inferable from mimetype alone. Not written for video, where it would be trivially true."
      },
      "visibility": {
        "type": "string",
        "default": "public",
        "maxLength": 64,
        "description": "Soft signal only, not access control -- see docs/data-model.md.",
        "knownValues": [
          "public",
          "unlisted"
        ]
      }
    }
  },
  "description": "A single meme asset (still image, animated image, or short video clip) in a user's library."
}

source object

Provenance/attribution for a meme, if known.

Properties

importedFrom string at-uri Optional

If copied in from another ATProto app's or user's collection, the original record's at-uri.

note string Optional

Free-text credit, e.g. "via @someone.bsky.social".

maxLength: 500 bytes

url string uri Optional

A webpage the image came from, if relevant.

View raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "A webpage the image came from, if relevant."
    },
    "note": {
      "type": "string",
      "maxLength": 500,
      "description": "Free-text credit, e.g. \"via @someone.bsky.social\"."
    },
    "importedFrom": {
      "type": "string",
      "format": "at-uri",
      "description": "If copied in from another ATProto app's or user's collection, the original record's at-uri."
    }
  },
  "description": "Provenance/attribution for a meme, if known."
}