Bluesky → XMPP Gateway

Bluesky posts straight into your Jabber client

Beta
DE EN
What is this?

This gateway connects Bluesky with XMPP (Jabber): you subscribe to accounts, hashtags or text patterns and receive the matching posts as chat messages in your XMPP client — no browser, no app. Everything is controlled by chat: you send the bot short commands.

AccountsPosts of specific Bluesky accounts
HashtagsCombinations with excluded tags
Text patternsRegular expression on the post text
FiltersHide images, text, videos, labels (e.g. NSFW)
Quick start
1

Add the bot as a contact

Add anything@bluesky.yerl.org to your contacts. Use any name instead of anything. Every name is a separate feed with its own subscriptions, filters and colour — handy to keep topics apart (e.g. news@bluesky.yerl.org, cats@bluesky.yerl.org).

2

Subscribe to something

Send s @handle.bsky.social or just a profile URL from Bluesky. The bot answers subscribed.

3

Help and status

help lists all commands, l your subscriptions, status the delivery state.

Commands are not case-sensitive (except the pattern of rs). For unknown input the bot answers: unknown command. send help for help.
Commands at a glance
s[+] <handle>Subscribe to an account
u[+] <handle>Unsubscribe from an account
ts[+] <tag>,<tag>,-<tag>Subscribe to a hashtag combination
tu[+] <tag>,<tag>Unsubscribe from a hashtag combination
rs[+] <regex>Subscribe to posts whose text matches the pattern
ru[+] <regex>Unsubscribe from a pattern
rnu <n>Unsubscribe from the pattern with number n in l
lList all subscriptions
https://bsky.app/profile/…Subscribe to an account by Bluesky URL
show_part [<part>,…]Deliver these parts of a post again (without an argument all of them)
hide_part <part>,…Stop delivering these parts of a post
reset_partDeliver all parts again (the default)
show_label [<label>,…]Also deliver posts with these labels (without an argument all of them)
hide_label <label>,…Do not deliver posts with these labels
reset_labelBack to the label default
pause / unpauseStop / resume delivery
statusDelivery state, quota usage, label and part settings
color <0–256>Choose the bot's avatar colour
helpThe bot's command list

Commands with _ also work with -, e.g. show-label or reset-part.

The [+] after s, u, ts, tu, rs, ru means: also comments (replies) — see below.

Subscribing

Accounts

s @spiegel.de — the @ is optional, and so is the profile URL https://bsky.app/profile/spiegel.de. Unsubscribe with u @spiegel.de.

Hashtags

ts cute,cat delivers posts that contain all the given tags (here cute and cat). Exclude tags with -: ts warcraft,-nsfw delivers posts with warcraft but without nsfw. At least one tag without - is required. The # is optional, case does not matter.

Every combination is its own subscription: ts cute,cat and ts cute,seal are two subscriptions. Unsubscribe with tu cute,cat (any - tags you give are ignored then).

Text patterns (regular expressions)

rs \bvulkan\w* delivers every post whose text matches the pattern, case-insensitively (PCRE syntax). The pattern must be on one line, not empty, must not match every post, and at most 200 characters long. Patterns that take too long to evaluate do not match.

Unsubscribe with ru <the same pattern> or with rnu 1, where the number is shown by l.

Including comments: the +

By default you only get root posts, no replies. With + comments come too: s+ @handle, ts+ warcraft, rs+ vulkan. Repeating the command without + switches the subscription back to posts only. l lists both groups separately.

Filters: what is shown

Hide parts of a post: show_part / hide_part / reset_part

textText of the post (also the title of a link card)
imageImages
videoVideos
cardLink card: title and URL of the preview card of a shared link. card drops the whole card; title and URL of the card are also dropped by text, the card image also by image
linkLink to the post (the last message). A URL in the post text belongs to the text (text)
The parts of a post and the name that controls each
A) Post with link card
┌───────────────────────┐
│ Text                  │  <- text
│ ┌───────────────────┐ │
│ │ card image        │ │  <- card + image
│ │ title             │ │  <- card + text
│ │ example.org       │ │  <- card
│ └───────────────────┘ │
└───────────────────────┘

B) Post with image(s) or video
┌───────────────────────┐
│ Text                  │  <- text
│ ┌───────────────────┐ │
│ │ image 1-4 / video │ │  <- image or video
│ └───────────────────┘ │
└───────────────────────┘

post link: always last  <- link
What arrives with which hide_part
                            A) Link card                     B) Image/video
hide_part                 | Text Title+URL Card image Link | Text Media     Link
---------------------------------------------------------------------------------
(nothing)                 | ok   ok        ok         ok   | ok   ok        ok
text                      | --   --        ok         ok   | --   ok        ok
image                     | ok   ok        --         ok   | ok   -- images ok
video                     | ok   ok        ok         ok   | ok   -- video  ok
card                      | ok   --        --         ok   | ok   ok        ok
link                      | ok   ok        ok         --   | ok   ok        --
text,card                 | --   --        --         ok   | --   ok        ok
image,video               | ok   ok        --         ok   | ok   -- both   ok
card,text                 | --   --        --         ok   | --   ok        ok
text,image,video,card,link| --   --        --         --   | --   --        --

ok = delivered, -- = suppressed

Labels: show_label / hide_label / reset_label

Authors can label their own posts. By default, posts with the labels porn, sexual, nudity and graphic-media are not delivered (gore is the old name of graphic-media).

Control and appearance
pauseStop delivery of this feed. Posts missed meanwhile are not delivered later.
unpauseResume delivery
statusShows whether delivery is active (pause, errors or quota), your quota usage and the label setting
lLists accounts, hashtag combinations and patterns (with the number for rnu)
color <0–256>Colour of the bot avatar in a 256-colour scheme. 256 is the Bluesky original (default). Useful to tell several bot contacts apart. A pause shows in the bot's presence status.

All settings apply per bot address, that is per feed.

Limits

So that an overly broad subscription does not flood your client, there is a quota of matches per time window: per feed (one bot address) and per user over all feeds. The defaults are 1000 posts per hour per feed and 10000 per hour over all feeds. At its end, help shows the limits that actually apply; status shows your usage.

When a limit is reached you get one message per window ("limit reached … Further posts are skipped until …"). After that, further matches are skipped until the end of the window (the full hour, UTC). A match counts even if your filter hides all its messages.

Your data and clean-up

Only your subscriptions and settings per bot address are stored, and the time of your last activity.

Removing the bot from your contacts

If you remove the bot from your roster, all your data for this bot address is deleted. Before that the bot sends you all the commands needed to restore it. To restore, add the bot again and send the lines one by one. If there was nothing to restore, the bot stays silent.

Automatic clean-up

Examples

📰 Receive news

  1. Add the bot contact: news@bluesky.yerl.org
  2. s @spiegel.de
  3. s @cnn.com
  4. hide_part image,video — text only, no images or videos

🐱 Cute animal pictures

  1. Add the bot contact: cuteanimals@bluesky.yerl.org
  2. ts cute,cat
  3. ts cute,seal
  4. hide_part text,card — images and videos only, no text

🎮 A topic with discussion, without spam

  1. Add the bot contact: games@bluesky.yerl.org
  2. ts+ warcraft,-nsfw — posts and comments, without nsfw
  3. rs+ \bvulkan\w* — everything that mentions Vulkan
  4. l — check, rnu 1 — remove a pattern again
FAQ and limitations
The bot does not answer.
Check that you added the bot as a contact and accepted the request. Try status. If it says "disabled", use unpause.
I get no posts with images or certain content.
Check with status which labels and which parts are hidden (default for labels: porn, sexual, nudity, graphic-media; parts: none). reset_part and reset_label restore the defaults.
I get no replies (comments).
Replies need the +, e.g. s+ @handle.
Reposts are missing.
Reposts are not supported. They are only referenced in the Bluesky firehose, not contained in it.
A renamed or deactivated account cannot be unsubscribed.
This is a known limitation. If unsure which handle applies, l helps. When in doubt, ask in the support room.
How do I get my data back after deletion?
From the message the bot sent before deleting — see Your data.
Screenshots
Mobile view
Mobile
Desktop view
Desktop
Avatar icons
Avatar colours
Support
Join the group chat

XMPP room: bluesky@conference.sucksass.de