Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/itsjunetime/smcurser

SMServer tui client written in rust
https://github.com/itsjunetime/smcurser

Last synced: about 1 month ago
JSON representation

SMServer tui client written in rust

Awesome Lists containing this project

README

        

# SMCurser

A tui client for [SMServer](https://github.com/iandwelker/smserver), written in Rust using the [tui-rs framework](https://github.com/fdehau/tui-rs). This is a rewrite of [SMServer_receiver](https://github.com/iandwelker/smserver_receiver), but using Rust, fixing a lot of issues, and adding a lot of features.

![The main view of SMCurser](promo.png)
SMCurser running on my desktop

## Features
- Browse and send texts and files from iMessage, all from your terminal
- Send tapbacks, delete conversations and texts, compose new conversations, and more
- SMCurser displays typing indicators from (and sends typing indicators to) other parties in real time
- Ability to create and use custom colorschemes
- Extremely fast and low memory usage
- Optional configuration file for persistent customization
- Many more goodies to significantly increase quality and ease of use

## Planned future features
- Ability to specify websocket/API subdirectory to connect to if running SMServer over a proxy
- Have something else you'd like added? File an issue or PR and I'll take a look at it :)

## To Build and Install
You can download a fairly up-to-date version of SMCurser from the `Releases` section of this repository. However, it may not have all the latest features and updates, so I'd recommend building it from source with the following steps:

First, install the official rust toolchain. If you don't know how to do this, visit [rustup.rs](https://rustup.rs) and follow the instructions there.

Once you've got that completely installed, do the following:
```sh
git clone https://github.com/iandwelker/smcurser.git
cd smcurser
git submodule update --init --recursive
cargo build --release
```

The compiled binary will reside at `./target/release/smcurser`

## To run
First, get a copy of [SMServer](https://github.com/iandwelker/smserver) and start that running. \
Then, if youre on linux or macOS, run:
```sh
smcurser --host ""
```

Or, if you're on Windows, run:
```sh
smcurser.exe --host ""
```