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
| Name |
Description |
Type |
Example |
Required |
Default |
status |
The text content of the status |
string |
"Hello, World" |
yes^1 |
N/A |
visibility |
Sets the visibility of the posted status |
public or private or unlisted or direct |
"private" |
no |
"public" |
language |
ISO 639-1 language code for this status |
ISO-639-1 Language Code |
"en" |
no |
|
scheduledAt |
Datetime at which to schedule a status |
RFC3339 date time |
"2029-02-03T15:30:45.000Z" |
no |
|
quoteApprovalPolicy |
Sets who is allowed to quote the status |
public or followrs or nobody |
"nobody" |
no |
"public |
media |
Media to be attached to the status |
array of {file, description} objects |
{"file": "/path/to/foo.png", "description" : "Foo"} |
no^2 |
|
- ^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
| Name |
Description |
Example |
MASTODON_URL |
Your Mastodon instance URL |
https://mastodon.social |
MASTODON_ACCESS_TOKEN |
Your 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.
1---2name: mastodon-publisher3description: Publish content to Mastodon. Use when you need to post a Mastodon status.4---56# Mastodon Publisher78Publish content to Mastodon. Use when you need to share updates, posts, or media.910## Usage1112### Post one or more statuses to Mastodon1314Post a new status to Mastodon with Bun:1516```bash17bun {baseDir}/scripts/tootbot.js '{"status": "Hello, Mastodon!"}' '{"status": "Goodby, Mastodon!"}'18```1920JSON fields2122| Name | Description | Type | Example | Required | Default |23| --------------------- | ---------------------------------------- | ----------------------------------------------- | ----------------------------------------------------- | -------- | -------- |24| `status` | The text content of the status | string | "Hello, World" | yes^1 | N/A |25| `visibility` | Sets the visibility of the posted status | `public` or `private` or `unlisted` or `direct` | "private" | no | "public" |26| `language` | ISO 639-1 language code for this status | ISO-639-1 Language Code | "en" | no | |27| `scheduledAt` | Datetime at which to schedule a status | RFC3339 date time | "2029-02-03T15:30:45.000Z" | no | |28| `quoteApprovalPolicy` | Sets who is allowed to quote the status | `public` or `followrs` or `nobody` | "nobody" | no | "public |29| `media` | Media to be attached to the status | array of `{file, description}` objects | `{"file": "/path/to/foo.png", "description" : "Foo"}` | no^2 | |3031- ^1 `status` can be ommitted when one or `--media-path` parameters are present32- ^2 one or `media` objects must be present if `status` is ommitted33- ^2 `media.description` is optional3435Environment Variables3637| Name | Description | Example |38| ----------------------- | -------------------------- | ------------------------- |39| `MASTODON_URL` | Your Mastodon instance URL | `https://mastodon.social` |40| `MASTODON_ACCESS_TOKEN` | Your Mastodon access token | `xAyBzC` |4142## Examples4344- **Post a new status**4546 ```bash47 bun {baseDir}/scripts/tootbot.js '{"status": "Hello, Mastodon"}'48 ```4950 Read the output and summarize it for the user.5152- **Post a scheduled status**5354 ```bash55 bun {baseDir}/scripts/tootbot.js '{"status": "Hello, future!", "scheduledAt" : "2030-02-05T13:21:34.000Z"}'56 ```5758 Read the output and summarize it for the user.5960- **Post a scheduled status with visibility, language, quote approval policy, and a single media attachment**6162 ```bash63 bun {baseDir}/scripts/tootbot.js <<EOF64 {65 "status" : "Dorood",66 "visibility" : "public",67 "language" : "fa",68 "scheduledAt" : "2029-02-03T15:30:45.123456789+03:30",69 "quoteApprovalPolicy" : "followers",70 "media" : [71 {72 "file" : "/path/to/media.png",73 "description" : "Nowrooz Pirooz"74 }75 ]76 }77 EOF78 ```7980 Read the output and summarize it for the user.8182- **Post a new status with media multiple attachments**8384 ```bash85 bun {baseDir}/scripts/tootbot.js <<EOF86 {87 "status" : "Edsger W Dijkstra",88 "visibility" : "public",89 "language" : "fa",90 "scheduledAt" : "2029-02-03T15:30:45.123456789+03:30",91 "quoteApprovalPolicy" : "followers",92 "media" : [93 {94 "file" : "/path/to/dijkstra.png",95 "description" : "Portrait"96 },97 {98 "file" : "/path/to/signature.png",99 "description" : "Signature"100 }101 ]102 }103 EOF104 ```105106- **Post a new status with media attachments and no status text**107108 ```bash109 bun {baseDir}/scripts/tootbot.js <<EOF110 {111 "media" : [112 {113 "file" : "/path/to/flower-1.png",114 "description" : "White Rose"115 },116 {117 "file" : "/path/to/flower-2.png",118 "description" : "Red Rose"119 }120 ]121 }122 EOF123 ```124125## Notes126127- Requires `bun` to be installed and available in the PATH.
dvcrn