Skip to content

itcodehery/Project_Catport

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Catport Banner


🐾 Catport

A modern terminal-based file live sharing utility with file viewing capabilities


Features

  • Syntax Highlighting Powered by syntect, Catport makes your code easier to read and navigate.

  • Real-time Live Share Instantly share files via WebSockets using axum. Perfect for walkthroughs, code reviews, or lightweight pair programming.

  • File Change Tracking With notify, Catport streams file changes live to connected viewers.

  • Terminal-first Experience Simple, intuitive, and fast—just like cat, but supercharged.


Cat → Bat → Catport

  • cat – View text files.
  • bat – Adds syntax highlighting and paging.
  • catport – Adds real-time collaborative viewing over the internet.

Installation

# Clone the repo
git clone https://github.com/yourusername/catport.git
cd catport

# Build with Cargo
cargo build --release

# Run it
./target/release/catport <command> <file>

Commands

Catport provides three main commands:

View

View a file locally with syntax highlighting.

catport view src/main.rs

Share

Share a file over WebSocket for others to view in real time.

catport share src/lib.rs

This will print a shareable link that others can use to connect.

Connect

Connect to a shared file session and track updates live.

catport connect http://localhost:3000/share/<id>

Built With

  • Rust – safe, fast, and concurrent
  • Axum – for WebSocket-powered sharing
  • Syntect – syntax highlighting
  • Notify – file watching

Roadmap

  • [✅] Finishing Implementation for Viewing and Syntax Highlighting
  • [✅] Finishing Implementations for Sharing
  • Finishing Implementation for Connecting via Terminal
  • Global Installation Implementation (PATH)
  • Two-way collaborative editing
  • Role-based permissions for viewers
  • Editor/IDE plugins

Contributing

I'm building Catport as an open-source community project. Contributions are welcome!

  1. Fork the repo
  2. Create a feature branch
  3. Commit your changes
  4. Push and open a Pull Request

Check out the Issues page for things to work on.


Catportfrom viewing, to highlighting, to sharing.


About

A modern terminal-based file live sharing utility with file viewing capabilities

Topics

Resources

Stars

Watchers

Forks

Languages