ttyms — Terminal Microsoft Teams Client

A secure, fast terminal UI client for Microsoft Teams messaging, built in Rust with ratatui.

Features

• 1:1 and group chat messaging — browse all your Teams chats, read messages, and reply
• Teams & Channels — browse joined teams, navigate channels, read and post channel messages
• Reactions — view message reactions (👍❤️😂😮😢😡) and react with keyboard shortcut
• Presence — see online status of contacts, set your own presence (Available, Busy, DND, Away)
• Unread indicators — unread message counts per chat, total unread badge in header
• Rich text rendering — bold, italic, code, and links rendered with terminal formatting
• Beautiful TUI — clean terminal interface with tabbed views, panels, color-coded messages
• Secure by design — tokens stored in OS credential manager, sensitive data zeroized in memory
• Auto-refresh — messages update automatically every 15 seconds with terminal bell for new messages
• Vim-style navigation — use j/k or arrow keys to navigate

Screenshots

┌─────────────────────────────────────────────────────────────────┐
│ ◆ TTYMS │ 1:Chats (3)  2:Teams │ 🟢 John Doe                  │
├───────────────────┬─────────────────────────────────────────────┤
│ Chats             │ Project Discussion                          │
│                   │─────────────────────────────────────────────│
│ ▸ 🟢 Alice (2)   │ Alice Smith                       10:30    │
│   Hey team, the…  │   Hey team, the deployment went well!      │
│                   │   👍 2  ❤️ 1                                │
│   🔴 Bob          │                                             │
│   Can you review… │ Bob Johnson                       10:32    │
│                   │   Great news! Any issues?                  │
│   Dev Team        │                                             │
│   Meeting at 3pm  │ You                               10:33    │
│                   │   Nope, all smooth!                 ◀      │
│                   │─────────────────────────────────────────────│
│                   │ Message                                     │
│                   │ > Great work everyone!                      │
├───────────────────┴─────────────────────────────────────────────┤
│ 1/2 View │ Tab Panel │ n New │ e React │ p Status │ q Quit     │
└─────────────────────────────────────────────────────────────────┘

Prerequisites

• Microsoft 365 account with Teams access
• Azure AD app registration (see setup below)

Installation

Homebrew (macOS / Linux)

brew install davidkaya/tap/ttyms

Cargo (all platforms)

cargo install ttyms

Arch Linux (AUR)

# Using an AUR helper (e.g., yay, paru)
yay -S ttyms      # stable release from crates.io
yay -S ttyms-git  # latest from git

From source

git clone https://github.com/davidkaya/ttyms.git
cd ttyms
cargo build --release
# Binary at target/release/ttyms

Setup

1. Register an Azure AD Application

1. Go to Azure Portal → Microsoft Entra ID → App registrations
2. Click New registration
3. Set:
   • Name: ttyms (or any name)
   • Supported account types: Accounts in any organizational directory (for multi-tenant)
   • Redirect URI: leave blank
4. Click Register
5. Go to Authentication:
   • Enable Allow public client flows → Save
   • Click Add a platform → Mobile and desktop applications
   • Under custom redirect URIs, add: http://localhost → Save
6. Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions:
   • User.Read
   • User.ReadBasic.All
   • Chat.ReadWrite
   • ChatMessage.Read
   • ChatMessage.Send
   • Presence.Read
   • Presence.ReadWrite
   • Team.ReadBasic.All
   • Channel.ReadBasic.All
   • ChannelMessage.Read.All
   • ChannelMessage.Send
7. Copy the Application (client) ID

2. Configure ttyms

Run the app once to generate the config file:

cargo run

Edit the config file (location shown in the output):

• Windows: %APPDATA%\ttyms\config.toml
• macOS: ~/Library/Application Support/ttyms/config.toml
• Linux: ~/.config/ttyms/config.toml

Set your client_id:

client_id = "your-application-client-id-here"
tenant_id = "common"

3. Run

cargo run

On first run, you'll be prompted to sign in using the device code flow.

Authentication Options

Device Code Flow (default) — displays a code, you sign in via browser:

cargo run

PKCE Browser Flow — browser opens automatically, redirects to localhost:

cargo run -- --pkce

Usage

Views

Keyboard Shortcuts (Chats)

Keyboard Shortcuts (Teams)

Reaction Picker

When a message is selected (s key), press e to open the reaction picker:

• ←/→ to choose emoji: 👍 ❤️ 😂 😮 😢 😡
• Enter to react
• Esc to cancel

Presence Picker

Press p to set your status:

• ↑/↓ to select: 🟢 Available, 🔴 Busy, ⛔ DND, 🟡 Away, ⚫ Offline
• Enter to set
• Esc to cancel

CLI Options

ttyms --help     # Show help
ttyms --pkce     # Use PKCE browser flow instead of device code
ttyms --logout   # Clear stored credentials securely

Security

Building

# Debug build
cargo build

# Release build (optimized)
cargo build --release

License

MIT