GitHub - christopherkenny/bskyr: Interact with Bluesky Social (original) (raw)

bskyr

Lifecycle: stable Project Status: Active – The project has reached a stable, usable state and is being actively developed. Codecov test coverage R-CMD-check CRAN status bskyr status badge

bskyr provides an interface to the Bluesky Social API, allowing you to interact with Bluesky Social from R. To do this, we provide functions which match with the AT Protocol’s Lexicon, which is like using regular HTTP requests. Outputs from bskyr’s functions are primarilytibbles, allowing for easy analysis of the outputs from the API calls.

Installation

You can install the stable version of bskyr fromCRAN with:

install.packages('bskyr')

You can install the development version of bskyr fromGitHub with:

install.packages('pak')

pak::pak('christopherkenny/bskyr')

Posting with bskyr

First, load the package:

Text posts can be made as follows:

bs_post('text = Your text goes here.')

If you have images to include, up to four can be included with theimages argument:

bs_post( text = 'Your text goes here.', images = c('path/to/image1.jpg', 'path/to/image2.png') )

Alt text can be added to images with the images_alt argument:

bs_post( text = 'Your text goes here.', images = c('path/to/image1.jpg', 'path/to/image2.png'), images_alt = c('Alt text for image 1', 'Alt text for image 2') )

To quote or reply to a post, use the quote and/or reply argument, respectively. These can take the link of an existing post. You can quote and reply to the same post, if you want.

bs_post( text = 'Your text goes here.', quote = 'https://bsky.app/profile/chriskenny.bsky.social/post/3kepscxiljc22', reply = 'https://bsky.app/profile/chriskenny.bsky.social/post/3kepscxiljc22' )

See the reference for additional features, including likes withbs_like() and reposts with bs_repost().

Authentication

To authenticate, you first need to make an App Password. To do this, go to https://bsky.app/settings. Under “Advanced” click App passwords and then “Add App Password.”

Once you have a password, you need to run:

set_bluesky_user('YOUR-USERNAME.bsky.social') set_bluesky_pass('your-apps-pass-word')

If you want this to persist across sessions, set install = TRUE andr_env = file.path(Sys.getenv('HOME'), '.Renviron'). This will save your credentials in your R environment file.

Alternatively, you can set them manually usingusethis::edit_r_environ() and adding lines like so:

BLUESKY_APP_USER='YOUR-USERNAME.bsky.social'
BLUESKY_APP_PASS='your-apps-pass-word'