https://github.com/alexanderepstein/termchat
Chat through the terminal with hack.chat
https://github.com/alexanderepstein/termchat
chat chat-client curses terminal
Last synced: 3 months ago
JSON representation
Chat through the terminal with hack.chat
- Host: GitHub
- URL: https://github.com/alexanderepstein/termchat
- Owner: alexanderepstein
- License: mit
- Created: 2017-10-22T19:34:17.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-09-25T18:51:19.000Z (about 2 years ago)
- Last Synced: 2025-07-03T23:02:48.779Z (3 months ago)
- Topics: chat, chat-client, curses, terminal
- Language: Python
- Size: 22.5 KB
- Stars: 43
- Watchers: 2
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# termchat
#### Chat through the terminal with hack.chat
[](https://pypi.python.org/pypi/cryptowatch) []()
## Usage
[](https://postimg.org/image/1qej263k23/)
```bash
usage: termchat [-h] [-r ROOM] [-n NICK] [-v]
Chat through the terminal with hack.chat
optional arguments:
-h, --help show this help message and exit
-r ROOM, --room ROOM Choose the name of the chatroom to enter
-n NICK, --nick NICK Set the username for others to see
-v, --version Display the current version of tchat
```
## Install
```bash
pip3 install termchat
```
## What's Special
There are a few things that is awesome about this project and [hack.chat](hack.chat) in general the first is they are both open source!
* Open source is love.
* [hack.chat](hack.chat) already never holds onto these chats unlike other services such as Skype as soon as all parties leave the chat all chat history is never again obtainable
* No one needs to sign up for an account, which is always a plus!
* Can be used from the terminal, so no web browser is necessary!
* By utilizing a client to interact with hack.chat we can add things like encryption (soon to come)
* Python and the curses interface go together like two peas in a pod
## Dependencies
* Python 3
* websocket-client
## Todo
- [ ] Add end to end encryption
- [ ] Check for an active connection status before starting the application
- [ ] Check if message went through and the ip hasn't been rate limited
- [ ] If user has left add a message to the chat from System with this info
## Special Thanks
#### Hack.chat
Without the hack.chat [project](https://github.com/AndrewBelt/hack.chat) by [AndrewBelt](https://github.com/AndrewBelt) deployed [here](hack.chat) this project would have been a lot more complicated as most of the heavy lifting is done by it.
#### Hackchat Chatbot Library
The Hchat.py file was largely based on [this project](https://github.com/gkbrk/hackchat/blob/master/hackchat.py) by [gkbrk](https://github.com/gkbrk) which was modified so that it could be used without the need for a bot.
#### Interface
The interface in this project was largely based on [this project](https://github.com/mathiasbc/slacky) by [mathiasbc](https://github.com/mathiasbc) which was modified to integrate with the hackchat library rather than the slack client.
##### Check out these projects because without them this would not have been possible :tada:
## Donate
If this project helped you in any way and you feel like supporting me
[](https://venmo.com/AlexanderEpstein)
[](https://cash.me/$AlexEpstein)
###### BTC: 1PSVVs6EnhdRGhUFb6Dz6EGWKKyHe3xACe
###### ETH: 0x585c4e1aa22d9Cc92d1a6b3fAe0c4a5274b5a884
###### LTC: Lf3SDjkck7iqy5TGn3wqzNvf5LL97JNhGk
## License
MIT License
Copyright (c) 2017 Alex Epstein
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.