This is a lightweight and low bandwidth CLI tool which can be used for group communication right from your terminal (isn't this cool ; ) )
Contributions are welcome for Hacktoberfest 2019 (Presented by DigitalOcean and DEV). Search for issues labeled Hacktoberfest
.
- Clone this project using the command
git clone https://github.com/Haider8/tmessage.git
- Setup your python3 virtual environment using this command
virtualenv -p python3 venv
- Switch to your venv using
source venv/bin/activate
- Now install the required dependencies by running
pip install .
- Now to run tmessage use
tmessage --user [YOUR USERNAME] --port [PORT (optional)] --server [YOUR BROKER IP OR URL (optional)] --dont-store (optional)
- By default, messages are stored in a SQLite database. To turn this feature off, simply use the
--dont-store
argument. - To test this you can open different terminal tabs.
-
If you don't want to create your own broker it's perfectly fine as tmessage is using a default broker
test.mosquitto.org
. Therefore, you can then run tmessage usingpython msg.py --user [YOUR USERNAME]
. -
If you happen to use this on a different port, it can be specified as -
tmessage --user [USERNAME] --port [PORT]
. If omitted, it defaults to 1883. -
This project uses an API for the authentication of users. Default API Url is this. If you want to use your own authentication API you can deploy our tmessage-api locally(for testing) or on some cloud (the default API is hosted on Heroku). Then, you can set that Url in
.env
file like thisTMESSAGE_API_URL=http://localhost:8080
orTMESSAGE_API_URL=<your-api-url>
.
- You can first fork tmessage and can then clone using command
git clone https://github.com/[YOUR USERNAME]/tmessage.git
- Please send PRs using new branch and not master
- Commit message should perfectly describe the code changes done by you
Would love to hear any suggestions, feedback, feature requests or any other issue