m1ngsama/TNT
1
0
Fork 0
mirror of https://github.com/m1ngsama/TNT.git synced 2025-12-24 10:51:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
TNT's Not Tunnel
117 commits 9 branches 0 tags 119 KiB
C 91.1%
Shell 5.7%
Makefile 3.2%
Find a file
m1ngsama 161fc904f3 Fix passwordless login and display alignment issues 
- Allow SSH_AUTH_METHOD_NONE for passwordless authentication
- Replace all \n with \r\n in TUI rendering for proper line breaks
- Fixes messages appearing misaligned on terminal
2025-11-24 17:01:08 +08:00
include Replace telnet with SSH and fix full-screen display 2025-11-24 16:48:14 +08:00
src Fix passwordless login and display alignment issues 2025-11-24 17:01:08 +08:00
.gitignore Initial commit 2025-07-01 09:00:00 +08:00
CHANGELOG.md Minor fixes 2025-11-24 16:07:00 +08:00
commits.txt Initial commit 2025-07-01 09:00:00 +08:00
fix_year.sh Initial commit 2025-07-01 09:00:00 +08:00
LICENSE Initial commit 2025-07-01 09:00:00 +08:00
Makefile Replace telnet with SSH and fix full-screen display 2025-11-24 16:48:14 +08:00
README.md Replace telnet with SSH and fix full-screen display 2025-11-24 16:48:14 +08:00

README.md

TNT

TNT's Not Tunnel - A lightweight terminal chat server written in C

License Language

Features

  • ✨ Vim-style operations - INSERT/NORMAL/COMMAND modes
  • 📜 Message history - Browse with j/k keys
  • 🕐 Full timestamps - Year-month-day hour:minute with timezone
  • 📖 Bilingual help - Press ? for Chinese/English help
  • 🌏 UTF-8 support - Full support for Chinese, Japanese, Korean
  • 📦 Single binary - Lightweight executable
  • 🔒 SSH access - Secure encrypted connections
  • 🖥️ Auto terminal detection - Adapts to your terminal size
  • 💾 Message persistence - All messages saved to log file
  • ⚡ Low resource usage - Minimal memory and CPU

Building

Dependencies:

  • libssh (required for SSH support)

Install dependencies:

# On macOS
brew install libssh

# On Ubuntu/Debian
sudo apt-get install libssh-dev

# On Fedora/RHEL
sudo dnf install libssh-devel

Build:

make

For debug build:

make debug

Running

./tnt

Connect from another terminal:

ssh -p 2222 localhost

The server will prompt for a password (any password is accepted) and then ask for your username.

Usage

Operating Modes

  • INSERT - Type and send messages (default)
  • NORMAL - Browse message history
  • COMMAND - Execute commands

Keyboard Shortcuts

INSERT Mode

  • ESC - Enter NORMAL mode
  • Enter - Send message
  • Backspace - Delete character
  • Ctrl+C - Exit

NORMAL Mode

  • i - Return to INSERT mode
  • : - Enter COMMAND mode
  • j - Scroll down (older messages)
  • k - Scroll up (newer messages)
  • g - Jump to top
  • G - Jump to bottom
  • ? - Show help
  • Ctrl+C - Exit

COMMAND Mode

  • Enter - Execute command
  • ESC - Cancel, return to NORMAL
  • Backspace - Delete character

Available Commands

  • list, users, who - Show online users
  • help, commands - Show available commands
  • clear, cls - Clear command output

Architecture

  • Network: Multi-threaded SSH server using libssh
  • TUI: ANSI escape sequences with automatic terminal size detection
  • Storage: Append-only log file
  • Concurrency: pthread + rwlock
  • Security: Encrypted SSH connections with host key authentication

Configuration

Set port via environment variable:

PORT=3333 ./tnt

Technical Details

  • Written in C11
  • POSIX-compliant
  • Thread-safe operations
  • Proper UTF-8 handling for CJK characters
  • Box-drawing characters for UI
  • SSH protocol with PTY support for terminal size detection
  • Dynamic window resize handling

Security

  • Encrypted connections: All traffic is encrypted via SSH
  • Host key authentication: RSA host key generated on first run
  • Password authentication: Currently accepts any password (customize for production)
  • Host key persistence: Stored in host_key file
  • No plaintext: Unlike telnet, all data is encrypted in transit

License

MIT License - see LICENSE file