https://github.com/ntvmb/cyclomonitor
Command-line tool and Discord bot which presents ATCF and Best Track data.
https://github.com/ntvmb/cyclomonitor
atcf cli cli-app discord discord-bot discord-py hurricane py-cord python3 tropical-cyclone typhoon weather
Last synced: 3 months ago
JSON representation
Command-line tool and Discord bot which presents ATCF and Best Track data.
- Host: GitHub
- URL: https://github.com/ntvmb/cyclomonitor
- Owner: ntvmb
- License: agpl-3.0
- Created: 2023-05-19T11:47:19.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2026-04-10T01:36:11.000Z (4 months ago)
- Last Synced: 2026-04-10T03:23:05.064Z (4 months ago)
- Topics: atcf, cli, cli-app, discord, discord-bot, discord-py, hurricane, py-cord, python3, tropical-cyclone, typhoon, weather
- Language: Python
- Homepage:
- Size: 284 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# CycloMonitor
Command-line tool and Discord bot which presents ATCF and Best Track data.
Dependencies:
* aiohttp (provided by py-cord)
* py-cord (Optional, for running the bot)
* tendo (Optional, for running the bot)
### Disclaimer
No party involved with CycloMonitor should make any claim that this program is intended to replace tropical cyclone advisories/warnings issued by your local RSMC or TCWC. If you need more detailed information than what is provided by the program, see your local RSMC or TCWC website for forecasts, potential land impacts, or other relevant information.
## Running interactively
Install the package:
```
pip install cyclomonitor
```
Start an interactive session:
`python3 -m cyclomonitor -i` or `python3 -m cyclomonitor.cli`
When running interactively, type `help` to see available commands.
## Running the bot
Install the package with everything needed to run the bot:
```
pip install cyclomonitor[bot]
```
If you cloned the GitHub repository, you might want to install the package in dev mode:
```
cd cyclomonitor
pip install -e .[bot]
```
Some Linux distributions may require you to [set up a virtual environment](https://docs.python.org/3/library/venv.html).
Until I get the project to use absolute paths, you'll probably want to create a separate directory to store its data:
```
mkdir cyclomonitor_temp
cd cyclomonitor_temp
```
To run the bot:
```
python3 -m cyclomonitor -b -t your.token.here
```
If you don't want to specify `-t` every time, paste your bot's token into a file called `TOKEN` in your working directory.
For full argument list: `python3 -m cyclomonitor -h` or run the module with no arguments.
Windows users: You might want to replace `python3` with `python`.
If you're using a virtual environment, ensure it is active before running the bot.
CycloMonitor logs to stdout by default. To log to a file, specify the parameter `-l LOGFILE`, where `LOGFILE` is the path to the log file.
## Configuring the bot
See CONFIGURATION.md for details.
Supports Python 3.8+, but Python 3.11+ is recommended.