# Bluesky## Features

What the Bluesky bridge can do

| Direction            | Feature                                            |
|----------------------|----------------------------------------------------|
| Matrix -> Bluesky | Direct messages with text and media                |
| Bluesky -> Matrix | Direct messages with text and media                |
| Bluesky -> Matrix | Profile and display name sync                      |
| Misc                 | Login with handle and app-specific password        |
| Misc                 | Automatic portal creation for recent and new chats |

## Usage

This page shows you how to set up the Bluesky bridge using Cinny client app (available as an add-on component), so that you can receive and send messages between a Bluesky PDS and Matrix rooms.

### Invite the bot to a management room

First, please start a chat with `@blueskybot:your-server.com` to create a management room.

**Make sure to replace `your-server.com` with your actual “base domain”.** Setting `your-server.com` or `example.com` does not work on your server!

![Invitation dialog to create a management room](https://etke.cc/help/bridges/mautrix-bluesky/images/1.webp)

When the bot joins to the created room, it sends confirmation messages to the room as below. If they are visible, bot successfully joined the management room. It works as expected.

![Confirmation message on the room](https://etke.cc/help/bridges/mautrix-bluesky/images/2.webp)

### Authentication

To bridge a Bluesky PDS over Matrix, you need to authenticate the bridge’s bot for Bluesky.

To conduct authentication, please follow the steps below.

1. Send `login` to the bridge bot
2. Send your Bluesky PDS domain. You are probably using `bsky.social`, unless you are self-hosting your own PDS.
3. Send your Bluesky account’s email or handle (handle is username, like `username.bsky.social`, or, in case of self-hosted PDS, a custom domain you use)
4. Send your Bluesky account’s password (if you are using 2FA, and we strongly recommend doing so, create an app-specific password)

![Sending the handle for logging in](https://etke.cc/help/bridges/mautrix-bluesky/images/3.webp)

After logging in, the bridge will create portal rooms for recent chats. Portal rooms for other chats will be created as you receive messages.

### Useful commands

If you send a message `help` to the room, available commands are output as a message like below:

![The output returned after sending help](https://etke.cc/help/bridges/mautrix-bluesky/images/4.webp)

Here is a couple of useful commands:

- `search <query>`: Search for users on the remote network
- `start-chat [login ID] <identifier>`: Start a direct chat with the given user


---
* [llms.txt](https://etke.cc/llms.txt): full site index in markdown