SunriseSunsetBot

A Telegram bot that alerts you at sunrise and sunset, based on your location. Sunrise and sunset times are provided by the excellent JavaScript library SuncCalc.

How does it work?

1. Start the bot (the official registered bot on Telegram is @SunriseSunset_bot).

2. Send your location if you are using a mobile client, or send your coordinates if location messages are not supported by your client.

3. Every day at sunrise and sunset you will receive an alert message.

4. Use the /alerts command to manage your alert messages: you can choose to be alerted also at:

   • civil twilight begin/end
   • astronomical twilight begin/end
   • nautical twilight begin/end
   • golden hour begin/end
   • moonrise and moonset

   and you can choose to receive the notification in advance with respect to the actual event.

Got a problem? Found a bug? Send a /support message and get in touch with us!

Features

• Fast setup: send your location as a "location" message.
• Legacy clients support: send your coordinates as a simple text message.
• Easily change your location with a /change_location command.
• Easily configure your /alerts.
• Straight-forward support: send a message to the developers with the /support command.

Upcoming features

The following are in order of priority, from higher to lower. If you would like to contribute to this bot, these features are a good starting point!

• Possibility to send the name of the city instead of the coordinates.
• Support for multiple locations.

...and many more!

Internal TODOs

• Broadcast filtering (only send broadcast message to chat with RUNNING status).
• Banned chats list (banned chatIDs are ignored by the bot).

Contributions

Contributions are welcome. Feel free to send a pull request, but please note that any pull request containing any bot token will be rejected.

Thank you!