Skip to content

ploglabs/molly-terminal

Repository files navigation

molly

molly

Terminal-native realtime chat client for Discord.

Install

macOS

brew install ploglabs/tap/molly

Linux (deb/rpm/arch)

# Debian/Ubuntu
curl -LO https://github.com/ploglabs/molly-terminal/releases/latest/download/molly_$(curl -s https://api.github.com/repos/ploglabs/molly-terminal/releases/latest | grep tag_name | cut -d'"' -f4 | sed 's/^v//')_linux_amd64.deb
sudo dpkg -i molly_*_linux_amd64.deb

# Arch
yay -S molly-bin

# Fedora/RHEL
sudo rpm -i molly_*_linux_amd64.rpm

Windows

scoop bucket add ploglabs https://github.com/ploglabs/scoop-bucket
scoop install molly

Go

go install github.com/ploglabs/molly-terminal/cmd/molly@latest

Quick Start

molly

First run opens your browser for Discord auth, then you're in the chat. No config needed.

Keyboard Shortcuts

Key Action
Enter Send message / run command
Ctrl+C / Ctrl+Q Quit
Ctrl+B Toggle channels sidebar
Ctrl+Y Toggle users panel
Ctrl+L Jump to bottom
Ctrl+P / Ctrl+N Previous / next channel
Ctrl+W Delete word backwards
Ctrl+K Delete to end of line
Ctrl+U Clear input
Tab Complete @user or #channel
/ Scroll history
PgUp / PgDn Scroll half page

Slash Commands

Command Description
/help Show available commands
/join #channel Switch to a channel
/history Load older messages
/search <query> Search local history
/clear Clear chat view
/quit Exit

Config (optional)

Config file at ~/.config/molly/config.toml. Everything is pre-configured — only edit if needed.

[general]
username = "anon"          # overridden by Discord auth

[server]
websocket_url = "wss://molly.ploglabs.com:8443/ws"
webhook_url = "https://discord.com/api/webhooks/..."
relay_url = "https://molly.ploglabs.com:8443"

[auth]
enabled = true             # Discord OAuth2 login on first run
provider = "discord"

[ui]
theme = "default"          # default, dracula, solarized
history_limit = 100
image_protocol = "auto"    # auto, iterm2, kitty, none

Override any field via env vars (MOLLY_USERNAME, MOLLY_THEME, etc.).

Run locally

To run Molly Terminal locally, you also need to clone and set up the relay backend.

  1. First, set up the relay server:
git clone https://github.com/ploglabs/molly-discord-relay.git
cd molly-discord-relay
cp .env.example .env
# Edit .env with your Discord bot token and a strong API_KEY
make build
./bin/molly-discord-relay
  1. Then, set up the terminal client in a new terminal window:
git clone https://github.com/ploglabs/molly-terminal.git
cd molly-terminal
cp .env.example .env
# Edit .env to set MOLLY_RELAY_API_KEY to match the relay's API_KEY
make build          # → bin/molly
./bin/molly

Requires Go 1.21+.

Self-hosting

To point molly at your own Discord app, webhook, or relay instead of the hosted defaults, see docs/SELF_HOSTING.md.

License

Apache License 2.0

About

Terminal-native realtime chat client for Discord with keyboard shortcuts, slash commands, and a clean TUI

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors