git404hub

what is social-feed fr?

peggleg/social-feed — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5Setup · easy

tl;dr

Social Feed pulls the latest posts from a Bluesky, Mastodon, or X profile into Home Assistant sensors you can show on a dashboard or use in automations.

vibe map

mindmap
  root((social-feed))
    What it does
      Fetches latest posts
      One sensor per feed
      UI-based setup
      Shows avatar
    Tech stack
      Python
      Home Assistant
      HACS
    Platforms
      Bluesky
      Mastodon
      X
    Use cases
      Dashboard display
      Post automations
      Multi-profile tracking
    Audience
      Smart home users
      Social media followers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Show your own or someone else's latest Bluesky, Mastodon, or X post on a Home Assistant dashboard.

VIBE 2

Follow multiple social profiles at once, each getting its own sensor with post history and engagement counts.

VIBE 3

Trigger a Home Assistant automation whenever a followed profile posts something new.

VIBE 4

Build a Lovelace markdown card that displays a profile's avatar, latest post text, and timestamp.

what's the stack?

PythonHome AssistantHACS

how it stacks up fr

peggleg/social-feed0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

X profiles need a paid-tier bearer token from developer.x.com since X removed its free read access.

No license file or terms are mentioned in the README, so usage rights are unclear.

in plain english

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.

prompts (copy fr)

prompt 1
Walk me through setting up this integration to follow a Bluesky profile in Home Assistant.
prompt 2
Write a Lovelace card that shows the three most recent posts from a followed profile with like and repost counts.
prompt 3
Explain why X requires a bearer token in this integration while Bluesky and Mastodon do not.
prompt 4
Create a Home Assistant automation that sends a notification whenever a followed Mastodon account posts.

Frequently asked questions

what is social-feed fr?

Social Feed pulls the latest posts from a Bluesky, Mastodon, or X profile into Home Assistant sensors you can show on a dashboard or use in automations.

What language is social-feed written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

What license does social-feed use?

No license file or terms are mentioned in the README, so usage rights are unclear.

How hard is social-feed to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is social-feed for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.