peggleg/social-feed

Social Feed is a custom Home Assistant integration that pulls the latest posts from a Bluesky, Mastodon, or X profile and turns them into sensors you can display or automate around inside your smart home setup. Everything is configured through Home Assistant's normal settings screens, so there is no YAML file to write by hand. Setting up a feed means picking a platform from a dropdown, then entering the profile handle, such as an at-sign username, and for X, an API bearer token you get from developer.x.com. You add the integration once for each profile you want to follow, and each one creates its own sensor. An options screen lets you change how often it checks for new posts and how many recent posts it keeps around. The sensor even shows the profile's avatar as its picture. The three platforms behave a bit differently. Bluesky and Mastodon use public APIs that need no authentication at all, while X requires a bearer token because the README notes that X no longer offers a free way to read posts. Bluesky and Mastodon check for new posts every 5 minutes by default, while X checks only every 60 minutes. The README also warns that a small number of locked-down Mastodon servers require authentication for everything, so profiles hosted there will fail to set up with a connection error. Each sensor exposes attributes like the display name, the newest post's ID, URL, and timestamp, a running post count, and a list of recent posts with their text, likes, reposts, and replies. The README includes a sample Lovelace markdown card showing how to display the latest post directly on a dashboard. Installation works either through HACS as a custom repository or by manually copying the integration's folder into Home Assistant's custom_components directory. No software license is mentioned in the README.