bs_post: Make a post on Bluesky Social
In bskyr: Interact with 'Bluesky' Social

bs_post

R Documentation

Make a post on Bluesky Social

Description

Make a post on Bluesky Social

Usage

bs_post(
  text,
  images,
  images_alt,
  video,
  video_alt,
  langs,
  reply,
  quote,
  embed = TRUE,
  emoji = TRUE,
  max_tries,
  created_at = bs_created_at(),
  user = get_bluesky_user(),
  pass = get_bluesky_pass(),
  auth = bs_auth(user, pass),
  clean = TRUE
)

Arguments

`text`	Text of post
`images`	Character vector of paths to images to attach to post
`images_alt`	Character vector of alt text for images. Must be same length as `images` if used.
`video`	Character vector of path for up to one video to attach to post
`video_alt`	Character vector, length one, of alt text for video, if used.
`langs`	Character vector of languages in BCP-47 format
`reply`	Character vector with link to the parent post to reply to
`quote`	Character vector with link to a post to quote
`embed`	Logical. Default is `TRUE`. Should a link card be embedded?
`emoji`	Logical. Default is `TRUE`. Should `⁠:emoji:⁠` style references be converted?
`max_tries`	Integer, >= 2. Number of times to retry the request if the first fails.
`created_at`	Character, length 1 of the form "%Y-%m-%dT%H:%M:%OS6Z". Time to assign to a record. Default is `bs_created_at()`.
`user`	Character. User name to log in with. Defaults to `get_bluesky_user()`.
`pass`	Character. App password to log in with. Defaults to `get_bluesky_pass()`.
`auth`	Authentication information. Defaults to `bs_auth(user, pass)`.
`clean`	Logical. Should output be cleaned into a `tibble`? Default: `TRUE`.

Value

a tibble::tibble of post information

Emoji parsing

⁠:emoji:⁠ parsing is not a formally supported Bluesky feature. This package converts usages of this kind by identifying text within :s, here "emoji" and then matches them to the emoji package's list of emoji names. All supported emoji names and corresponding images can be seen with emoji::emoji_name. This feature was introduced in v0.2.0.

Embedding

Embedding is a feature that allows for a link card to be created when a URL or other media to be added as a preview to the post. This feature was introduced in v0.2.0.

Embeds are processed as follows:

If is.list(embed), it is assumed to be an embed object. These should be created with bs_new_embed_external(), unless you are certain of the structure.
If is.character(embed), it is assumed to be a URL. The function will use the open graph protocol to try to infer the embed from the URL.
If isTRUE(embed), the default, it tries to infer the embed from the text.
First, if a Tenor Gif link is found in the text, it will be embedded.
Second, if a URL is found in the text, it will be embedded. Only the first URL found will be embedded.
If isFALSE(embed) or it does match an earlier condidtion, no embed is created and the post is sent as is.

Lexicon references

feed/post.json (2024-11-29) repo/createRecord.json (2023-10-02)

Function introduced

v0.0.1 (2023-10-02)

Examples


bs_post('Test post from R CMD Check for r package `bskyr`
via @bskyr.bsky.social (https://christophertkenny.com/bskyr/)')
bs_post('Test self-reply from r package `bskyr`
via @bskyr.bsky.social (https://christophertkenny.com/bskyr/)',
  reply = 'https://bsky.app/profile/bskyr.bsky.social/post/3kexwuoyqj32g'
)
bs_post('Test quoting from r package `bskyr`
via @bskyr.bsky.social (https://christophertkenny.com/bskyr/)',
  quote = 'https://bsky.app/profile/bskyr.bsky.social/post/3kf24wd6cmb2a'
)
bs_post('Test quote and reply from r package `bskyr`
via @bskyr.bsky.social (https://christophertkenny.com/bskyr/)',
  reply = 'https://bsky.app/profile/bskyr.bsky.social/post/3kexwuoyqj32g',
  quote = 'https://bsky.app/profile/bskyr.bsky.social/post/3kf24wd6cmb2a'
)

bs_post('Test quote with :emoji: and :fire: and :confetti_ball: from r package
  `bskyr` via @bskyr.bsky.social (https://christophertkenny.com/bskyr/)')

bs_post(text = 'Testing images and aspect ratios from R',
  images = fs::path_package('bskyr', 'man/figures/logo.png'),
  images_alt = 'hexagonal logo of the R package bskyr, with the text "bskyr" on a cloud')

bs_post(text = 'testing sending videos from R',
  video = fs::path_package('bskyr', 'man/figures/pkgs.mp4'),
  video_alt = 'a carousel of package logos, all hexagonal')

bskyr documentation built on June 8, 2025, 10:33 a.m.