Tootbot

Mastodon Publisher

Publish content to Mastodon. Use when you need to share updates, posts, or media.

Usage

Post one or more statuses to Mastodon

Post a new status to Mastodon with Bun:

bun {baseDir}/scripts/tootbot.js '{"status": "Hello, Mastodon!"}' '{"status": "Goodby, Mastodon!"}'

JSON fields

status

visibility

public

private

unlisted

direct

language

scheduledAt

quoteApprovalPolicy

public

followrs

nobody

media

{file, description}

{"file": "/path/to/foo.png", "description" : "Foo"}

• ^1

  status

  can be ommitted when one or

  --media-path

  parameters are present
• ^2 one or

  media

  objects must be present if

  status

  is ommitted
• ^2

  media.description

  is optional

Environment Variables

MASTODON_URL

https://mastodon.social

MASTODON_ACCESS_TOKEN

xAyBzC

Examples

• Post a new status

  bun {baseDir}/scripts/tootbot.js '{"status": "Hello, Mastodon"}'
  

  Read the output and summarize it for the user.

• Post a scheduled status

  bun {baseDir}/scripts/tootbot.js '{"status": "Hello, future!", "scheduledAt" : "2030-02-05T13:21:34.000Z"}'
  

  Read the output and summarize it for the user.

• Post a scheduled status with visibility, language, quote approval policy, and a single media attachment

  bun {baseDir}/scripts/tootbot.js <<EOF
  {
    "status" : "Dorood",
    "visibility" : "public",
    "language" : "fa",
    "scheduledAt" : "2029-02-03T15:30:45.123456789+03:30",
    "quoteApprovalPolicy" : "followers",
    "media" : [
      {
        "file" : "/path/to/media.png",
        "description" : "Nowrooz Pirooz"
      }
    ]
  }
  EOF
  

  Read the output and summarize it for the user.

• Post a new status with media multiple attachments

  bun {baseDir}/scripts/tootbot.js <<EOF
  {
    "status" : "Edsger W Dijkstra",
    "visibility" : "public",
    "language" : "fa",
    "scheduledAt" : "2029-02-03T15:30:45.123456789+03:30",
    "quoteApprovalPolicy" : "followers",
    "media" : [
      {
        "file" : "/path/to/dijkstra.png",
        "description" : "Portrait"
      },
      {
        "file" : "/path/to/signature.png",
        "description" : "Signature"
      }
    ]
  }
  EOF
  

• Post a new status with media attachments and no status text

  bun {baseDir}/scripts/tootbot.js <<EOF
  {
    "media" : [
      {
        "file" : "/path/to/flower-1.png",
        "description" : "White Rose"
      },
      {
        "file" : "/path/to/flower-2.png",
        "description" : "Red Rose"
      }
    ]
  }
  EOF
  

Notes

• Requires

  bun

  to be installed and available in the PATH.