πFeed User Guide

πFeed is single-purpose microblogging software for people who want a quiet, fast, self-owned timeline. It is deliberately small — which means you have real control over it.

Home Feed

Your Home feed is a chronological stream of posts from:

  • People you follow
  • Your own posts
  • @mentions directed at you

It is intentionally simple. There is no algorithm, no engagement score, no infinite scroll bait. Just the people you chose to hear from.

Circles

Circles are topic-based groups for conversations you do not want to pollute your home feed with. Examples:

  • A circle for your local neighborhood
  • A circle for a specific game, band, or hobby
  • A private circle for your family

Anyone can create a circle. Each circle has its own RSS feed, so you can subscribe to it in a reader if you prefer.

Feeds

Feeds are automated sources of content — blogs, news sites, YouTube channels, podcasts, or any RSS/Atom source.

  • Add a feed URL on the Feeds page
  • Subscribe to feeds you want to see in your home timeline
  • Unsubscribe anytime without affecting other users

Have a favorite YouTube channel? Add its feed and then everyone on the instance can watch and talk about it.

Cards

A card is a small praise or greeting for someone — a thank-you, a congratulations, a happy birthday, a merry Christmas, a get-well wish. Pick an occasion, an emoji for the art, and write up to 500 characters about why you're sending it. The card appears in the feed where a post would.

  • Start one from the 💌 Card button above the composer, from anyone's profile, or from /card. You can also press Ctrl+K and type "card".
  • The recipient is free text, shown exactly as you type it — "Mom", "the whole team", or a username. Leave it blank and the greeting stands on its own ("Happy anniversary!"). If the text matches someone's username, the card also lands in their home feed.
  • The art is an emoji: pick one of the suggestions or type your own (type : to complete a shortcode, like :tada:).
  • A card can carry one photo, shown between the art and the greeting. Choose a file or paste one; click it to open it full-size in the lightbox like any other image.
  • Replies become notes. Anyone who answers a card has their reply signed onto the bottom of the card itself, alternating sides, so the exchange travels together and can be screenshotted as a memento. Only direct replies sign the card — answers to those answers stay in the thread, where every reply is still an ordinary post you can reach, react to, and reply to.
  • Cards are posts like any other: people can react to them or share them, and you can edit or delete yours later.

Your Agency

Unlike big platforms, πFeed does not try to keep you scrolling. It gives you tools to curate your own experience:

  • Make your own circles. Set the tone. Invite the conversation you want.
  • Add and subscribe to feeds you think are awesome. Build a timeline that is genuinely useful to you.
  • Post publicly or privately. The "Public" checkbox is per-post. Unchecked means followers only.
  • Follow (or unfollow) people. Your home feed is yours to shape.

Keyboard Shortcuts

  • j / k or ↓ / ↑ — scroll and focus between posts
  • Ctrl+K — open the command palette to jump to Home, users, circles, or feeds
  • Ctrl+Enter — submit any text box instantly
  • @ then Tab — autocomplete usernames

Privacy & Tips

  • Public posts are visible to anyone on the internet, including anonymous visitors.
  • Private posts (Public unchecked) are visible only to your logged-in followers.
  • Reactions are public — anyone can see who reacted with what emoji.
  • Contact your instance admin for password resets or lost token assistance.

πFeed is small software. That is the point. — Back to Home