Skip to content

Commit

Permalink
Merge pull request #57 from Not-Sarthak/patch-1
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
shaishav06 committed May 24, 2023
2 parents 0b94137 + aa86587 commit 8edabe0
Showing 1 changed file with 53 additions and 17 deletions.
70 changes: 53 additions & 17 deletions Discord Weather Bot/README.md
Original file line number Diff line number Diff line change
@@ -1,41 +1,77 @@
# Weather Bot
### Your Personal Weather Assistant for Discord

A discord weather bot that displays weather information of a given city.
<div align="center">
<img src="https://forthebadge.com/images/badges/built-with-love.svg" />
<img src="http://ForTheBadge.com/images/badges/made-with-python.svg" />
<img src="https://forthebadge.com/images/badges/open-source.svg" />
</div>

<p>
<img src="./img/preview.png" width="70%" />
</p>
It is an intelligent Discord bot that brings real-time weather information right to your server. With just a command, you can instantly retrieve accurate weather details for any city around the globe. Stay informed about temperature, humidity, wind speed, and more with beautiful visual displays. WeatherMate is your go-to companion for planning outings, staying prepared, and impressing your friends with up-to-the-minute weather data.

## Resources and APIs
## Features
- Command-based weather updates for any city
- Detailed forecasts and current conditions
- Interactive visualizations for better understanding
- Global coverage with accurate weather data
- Easy-to-use and customizable settings

## Resources and APIs:
- Python 3.9.9
- Python Discord.py module
- OpenWeatherMap API
- Discord API

## How to setup
## Usage
To use the Discord Weather Bot, follow these steps:

1. Create a discord bot [here](https://discordapp.com/developers/applications/me) and grab the token.
1. Invite the bot to your Discord server.
2. Configure the bot by providing necessary API keys and settings.
3. Use commands to interact with the bot and get weather information.

2. We are going to be using [OpenWeatherMap](https://openweathermap.org/api) API, which requires an API key, you can get one for free by simple logging in to their website.
## Installation
To run the Discord Weather Bot locally, follow these steps:

2. Open the **main.py** file and replace your `DISCORD_BOT_TOKEN` and `OPEN_WEATHER_MAP_API_KEY`.
1. Clone the repository:

```
git clone https://github.com/neelshah2409/Bot-Collection.git
```
2. Navigate to the "Discord Weather Bot" directory:
```
cd Bot-Collection/Discord%20Weather%20Bot
```
3. We are going to be using [OpenWeatherMap](https://openweathermap.org/api) API, which requires an API key. You can get one for free by simply logging in to their website.
4. Open the **main.py** file and replace your `DISCORD_BOT_TOKEN` and `OPEN_WEATHER_MAP_API_KEY`.

```py
token = 'DISCORD_BOT_TOKEN'
api_key = 'OPEN_WEATHER_MAP_API_KEY'
```

3. Before running the bot you will need to install all the requirements with this command:

5. Install the required dependencies:
```
pip install -r requirements.txt
```

4. Start the bot by having the cmd/terminal inside the bot folder and run the following command:

6. Configure the bot by providing the necessary API keys and settings. You can find the configuration file in the config directory.
7. Run the bot:
```
python3 main.py
python3 bot.py
```

5. You're done, enjoy your bot!
## Development

Want to contribute? Great!

Contributions to the Discord Weather Bot are welcome! To contribute, please follow these guidelines:

1. Fork the repository and create a new branch for your changes.
2. Make sure your code adheres to the project's code standards.
3. Submit a pull request to the main repository.

## Contributors
<a href = "https://github.com/Tanu-N-Prabhu/Python/graphs/contributors">
<img src = "https://contrib.rocks/image?repo = GitHub_username/repository_name"/>
</a>

## License
The project is licensed under the [MIT License](https://github.com/neelshah2409/Bot-Collection/blob/main/LICENSE).

0 comments on commit 8edabe0

Please sign in to comment.