Messenger TUI

Terminal-based Matrix client for accessing Facebook Messenger via bridge.

Overview

This project connects to a self-hosted Matrix homeserver with a mautrix-facebook bridge, providing a lightweight TUI for messaging on Messenger without the heavy desktop/mobile apps.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        Your Server                          │
│   ┌─────────────────┐    ┌─────────────────────────────┐   │
│   │   Matrix Homeserver   │    │   mautrix-facebook bridge  │   │
│   │      (Conduit)       │◄──►│                             │   │
│   └─────────┬───────────┘    └──────────────┬────────────┘   │
│             │                               │                │
│             │          Facebook/Meta         │                │
│             │            Messenger          │                │
│             │              ◄────             │                │
│             │                               │                │
└─────────────┼───────────────────────────────┼────────────────┘
              │                               │
              ▼                               │
┌─────────────────────────────────────────────────────────────┐
│                      Your Laptop                            │
│   ┌─────────────────────────────────────────────────────┐  │
│   │                     WeeChat TUI                       │  │
│   │                   (This Client)                       │  │
│   └─────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Features

Text messaging
Group chats
Image/media receive
Image/media send
Notifications
Search

Prerequisites

WeeChat
Matrix account on self-hosted server
Server-side: Conduit + mautrix-facebook bridge

Setup

1. Install WeeChat

# macOS
brew install weechat

# Linux (Debian/Ubuntu)
sudo apt install weechat

# Linux (Arch)
sudo pacman -S weechat

2. Connect to Matrix homeserver

/weechat plugin load matrix
/set matrix.server.your_server_name.homeserver https://your-server.com
/plugin reload matrix

/matrix certs /path/to/ca-certificate.pem  # if self-signed
/matrix login your_username your_password

4. Bridge your Messenger account

On the server, configure mautrix-facebook and link your Facebook account.

Usage

Basic WeeChat Commands

Command	Description
`/buffer list`	List all joined rooms
`/join #room:server.com`	Join a room
`/query nick`	Open private chat
`Ctrl+P / Ctrl+N`	Switch buffers
`Ctrl+W then n`	Close buffer
`/set`	View/set options
`/help`	WeeChat help

Configuration

WeeChat Matrix Settings

/set matrix.server.default.homeserver "https://your-matrix-server.com"
/set plugins.var.dev矩阵.notify.enabled on
/set plugins.var.dev矩阵.notify.message on

Project Structure

messenger_tui/
├── README.md          # This file
├── .gitignore
├── config/            # WeeChat config snippets
│   └── weechat.conf
└── scripts/           # Helper scripts
    └── setup_weechat.sh

Known Limitations

Voice/video calls: Not supported via bridge
Read receipts: Partial support
Some rich media features may not work

4.6 KiB Raw Blame History