README.md

📜About KairosBot

KairosBot is a discord bot made by Eden#2972 for people in different timezones to communicate anything about time seamlessly.

🚀Getting started

You can either use the public version of KairosBot or host your own kairos bot here. If you are using the public version, skip to the How the bot works section.

🤖Hosting your own KairosBot

✅ Requirements

1. A discord bot token (Guide)
2. NodeJs v16.6.0+

🏃‍♂️ Hosting

Setting up:

git clone https://github.com/Eden4897/KairosBot.git
cd KairosBot
npm i

Config:

1. Create config.json in src
2. Paste this in config.json and fill in the TOKEN and CLIENT-ID:

{
  "TOKEN": "DISCORD-BOT-TOKEN",
  "CLIENT_ID": "DISCORD-APPLICATION-CLIENT-ID"
}

Building and running:

npm i typescript -g
npm run deploy
npm run launch

❓How the bot works

If you have set your timezone and enabled automatic timestring detection and translation, the bot will automatically reply to any message that it detects a timestring in with the timestamp. It can also recognise and translate multiple timestrings in a single message. Here are examples of timestrings:

12:00
9:34 pm
07:34AM tmr
2:47 8 days ago
09:51pm 7 days later
11:58 ytd\

Heres an example use case:

📝Commands

key: [] is required and () is optional

/settimezone [timezone]

Configures your timezone

/gettimezone (@user)

Gets the timezone of a given user (defaults to yourself)

/gettimezonetime [timezone]

Gets the local time of a given timezone

/getusertime [@user]

Gets the local time of a given user

/timestamp (hour) (min) (am_pm) (date) (month) (year) (date_format) (timezone) (include_raw)

Creates a timestamp according to the data you provide

/enable

Enables automatic timestring detection and translation

/disable

Disables automatic timestring detection and translation

/help

Sends you some help

/timestrings

shows you examples of timestrings

/ping

Replies with "Pong" and the latency

🔗Misc

• Join the support server here,
• and upvote the bot here!