Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

Termchat

A lightweight, real-time terminal-based chat application built with Go and Bubble Tea.

✨ Features

  • πŸ” Secure Authentication - User accounts with encrypted sessions
  • πŸ‘₯ Friend System - Add friends and manage friend requests
  • πŸ’¬ Real-time Chat - WebSocket-powered instant messaging
  • πŸ“Ž File Sharing - Upload and download files in chat rooms
  • πŸ”’ Privacy-First - Ephemeral rooms and messages (deleted when empty)
  • 🎨 Beautiful TUI - Clean terminal interface with Bubble Tea

πŸš€ Quick Install

One-Liner (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/AlNaheyan/termchat/main/install.sh | sh

Manual Install

macOS:

# Intel Mac
curl -L https://github.com/AlNaheyan/termchat/releases/latest/download/termchat-macos-amd64 -o termchat
# Apple Silicon Mac
curl -L https://github.com/AlNaheyan/termchat/releases/latest/download/termchat-macos-arm64 -o termchat
chmod +x termchat
sudo mv termchat /usr/local/bin/

Linux:

curl -L https://github.com/AlNaheyan/termchat/releases/latest/download/termchat-linux-amd64 -o termchat
chmod +x termchat
sudo mv termchat /usr/local/bin/

Windows: Download termchat-windows-amd64.exe and add to PATH.

πŸ’‘ Usage

Start Chatting

# Join a room
termchat myroom
# Or create your own room name
termchat secret-project-chat

Commands

In Chat:

  • /upload <filepath> - Upload a file
  • /download <filename> - Download a file
  • /leave - Exit the room

Example:

> /upload ~/Documents/report.pdf
Uploading report.pdf...
βœ“ Uploaded: report.pdf
πŸ“Ž alice uploaded: report.pdf (2.4 MB)
> /download report.pdf
βœ“ Downloaded: report.pdf β†’ /Users/you/Downloads/report.pdf

About

Lightweight terminal-based chat

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /