Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/lallassu/spinc

Spark In Console - Cisco (WebEx)Spark Client for Linux/MacOS
https://github.com/lallassu/spinc

chat-client cisco-spark golang webex webex-teams

Last synced: 14 days ago
JSON representation

Spark In Console - Cisco (WebEx)Spark Client for Linux/MacOS

Awesome Lists containing this project

README

        

# SPINC - Spark In Console
This is a Cisco Spark (now called WebEx) chat client for use in console. Written in GO that works in MacOS and Linux.

This client uses about 15MB RAM compared to the official client that uses 500MB - 1000MB RAM.
However, this client currently only support chats (not file-share, video-chat etc).

## Screenshots

The theme is possible to configure in spinc.theme file.
## Use
If you don't want to build form source. Just download "MacOS/spinc" (Mac) or "Linux/spinc" (Linux).

1. Configure "auth_token" in spinc.conf. This token is retrieved by logging in and get authorization token here: https://developer.webex.com/getting-started.html#authentication
2. ./spinc http://
3. Write /help in Spinc to view available commands and keyboard shortcuts.

If you don't have an external IP. Use a tunnel. If you decide to use ngrok there is a start script provided (spinc.sh). Spinc register webhooks to receive updates
hence it needs to open up an external port. In case you are behind a firewall you can use any type of tunnel service (or host your own).

Tunnels:
* https://github.com/mmatczuk/go-http-tunnel
* https://ngrok.com
* https://github.com/fatedier/frp
* https://localhost.run

### Paste in Linux
Linux, Unix (requires 'xclip' or 'xsel' command to be installed) in order to use "Ctrl-V" to paste text into input field.

## Configuration
- It's possible to configure which port to use for webhook callbacks. Default is 2601.
- Keyboard shortcuts are possible to configure in spinc.sh
- List of available keys: https://github.com/gdamore/tcell/blob/master/key.go

## Themes
- Default theme is a irssi look. Themes are read from "spinc.theme" file.
- Theme file is configured in spinc.conf
- Available colors: https://github.com/gdamore/tcell/blob/master/color.go (and pretty much all hexadecimal colors)

## Todo
- Logging to file
- Handle memberships update events
- Handle lock/unlock room events (room update event)

## License
MIT