Skip to content

thundertheidiot/bsky.el

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bsky.el

WIP bluesky client for Emacs

Terrible usage instructions

Out of date

Setup

  1. Evaluate all the buffers because this isn’t even a functional package yet
  2. Log in using (bsky-authenticate)

When your access token expires, you can use (bsky-refresh-authentication) to refresh using the refresh token.

Posting

The function (bsky-create-post) will create a new buffer for your post, write your text below the comment.

Calling (bsky-post-current-post) while in the buffer will make a post to bluesky.

Up to four images linked through org file links (\[[file\:file.png]\]) or the first org http(s) link embedded in the post, in that order. Only either images or the link can be embedded.

The link embed metadata is generated by the client, not the server. You can specify the title and the description in the org link name, like this:

[[https://example.com]][[Title:::Description]]

This would result in an embed that looks like this.

assets/link.png

Thumbnails are not supported (yet?).

Quote posts also don’t exist yet.

Reply

Calling (bsky-reply-to-current-post) in an org element with the uri and cid attributes set correctly should generate a post buffer, that has attributes for a parent and root post.

Posting this buffer should make a reply, embeds work as usual.

Viewing posts

The function (bsky-view-post-thread) fetches shows you the thread of the current post.

Searching (still manual)

The function (bsky-ui--show-posts) creates org elements for a list of posts.

The function (bsky-api--search) can be used to search for posts, check the function itself for the possible parameters.

TODOs

  • [-] Interface for searching (completing-read something?) (bsky-search)
  • [ ] Character count for post mode
  • [ ] Post long texts as a thread somehow?
  • [ ] View user profile and posts
  • [ ] Notifications
  • [ ] Timer for refresh auth
  • Post to buffer
    • Embed
      • [X] Images
      • [X] Quote
      • [ ] Link
    • [ ] Links
  • Buffer to post
    • Embed
      • [X] Image
      • [ ] Link (no idea how this should be represented)
      • [ ] Quote
    • [X] Links
    • [X] Hashtags
    • [X] Mentions

About

Very WIP Bluesky client for emacs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published