blueskysocial is a Python library for managing social media posts and images. It provides a Client class for interacting with social media platforms, as well as classes for representing posts and images.
To install blueskysocial, you can use pip:
pip install blueskysocialfrom blueskysocial import Client, Post, Image
client = Client()
client.authenticate(user_name, password)
image = Image('path/to/image.jpg', alt_text='This is an image.')
post = Post('Hello, world!, This is my first post.', with_attachments=[image])
client.post(post)from blueskysocial import Client, Post, Image
client = Client()
client.authenticate(user_name, password)
image = Image('path/to/image.jpg', alt_text='This is an image.')
post = Post('Hello, world!, This is my first post.', with_attachments=[image])
second_post = Post('Another Post')
client.post_thread([post,second_post])As of version 1.5.0, embedding video in your post is supported. Currently video can only be embedded from a local file. Please note, that when embedding a video in a post, it may take several minutes for Bluesky to process your video, during which a video frame with "Video Not Found" will appear in your post.
The following video formats are supported
- mp4
- mpeg
- webm
- mov
from blueskysocial import Client, Post, Video
client = Client()
client.authenticate(user_name, password)
video = Video('path/to/video.mov')
post = Post('Video Post', with_attachments=video)
client.post(post)Bluesky counts URL characters towards the 300 character limit. The solution to this is to format your links. blueskysocial supports markdown link formatting. If you format your post text in the following fashion
from blueskysocial import Client, Post
client = Client()
client.authenticate(user_name, password)
post = Post('Hello, world!, This is my first post. But with a link. [Click here](http://really.long.url.here)'),
clinet.post(post)Your post text will be "Hello, world!, This is my first post. But with a link. Click here", with the words "Click here" being a link. In this fashion, only the characters in "Click here" count towards the limit
Webcards are the small preview images of a linked website that appear at the bottom of the posts and also serve as links. You can embed a webcard with the following syntax
from blueskysocial import Client, Post, WebCard
client = Client()
client.authenticate(user_name, password)
webcard = WebCard("http://url_to_link_to.com/article")
post = Post('Check out this article!', with_attachments=webcard)
clinet.post(post)Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
blueskysocial is licensed under the MIT License. See LICENSE for more information.