All commands must have valid prefix or mention Niles, i.e.
|display||Display the calendar|
|update||Update the calendar|
|create||Create new events|
|delete||Delete existing events|
|clean||Delete Discord messages in channel|
|id||Set Google Calendar ID|
|setup||Get setup instructions|
|invite||Generate Niles bot invite link|
|prefix||Change the Niles bot prefix|
|displayoptions||Change the calendar display/formatting options|
|admin||Restrict the usage of Niles to a specific server role|
|help||Get this list of commands in Discord|
|stats||Display Niles bot statistics|
@niles display to display your calendar. This commmand will only work after setup, i.e. after a valid calendar ID and timezone have been given.
You can only use
display in one channel in any one server. Niles will attempt to continually update this one calendar every 5 minutes.
@niles update to force update your calendar. This can force update after you have created new events, changed display options or other settings. After using
update Niles will continue to update this calendar every 5 minutes.
@niles create to add new events to your calendar. This command takes whatever input you give to it and uses the default Google Calendar interpreter. The form of use is
!create <event for Google to parse>.
A reliable way of using this is
!create <event name> on <event day> from <start time> to <end time>, i.e.
create Among Us on Friday from 5pm to 11pm
- Numerical date formats supported:
- MM DD YY
- M D YY
- YYYY MM DD
- Textual date formats are supported in English only e.g.
September 4 2020
- Multi-day events can be created with keywords “ - “ or “ to “ etc… e.g.
01/30/2020 - 05/30/2020
There is no way to change it and no plans to add middleware to convert it (Natural Language Processing is out of the scope of Niles)
Niles will automatically update the calendar, delete the creation messages and confirmation messages.
Important: The ‘native’ Google parser will read the event times in the timezone that your Google Calendar is set to. If you are having issues with incorrect times being registered with
create, we recommend ensuring that your Google Calendar and Niles share the same timezone.
For complicated, recurring or multi-day events, these can be created using this parser, but we recommend just creating the events in the Google Calendar Web UI, where possible.
!delete <event_name> or
@niles delete <event name> to delete an event from your Calendar. The
<event_name> should be exactly what it is named in your calendar. Note that when deleting events using this method, Niles does not currently handle events with the same name, and will delete the latest event.
We recommend deleting events in the Google Calendar Web UI, where possible.
@niles next to display the next upcoming event within the set days to display.
!clean <number of messages to clean> or
@niles clean <number of messages to clean> to tidy up your calendar channel etc. prior to or after posting your calendar.
Due to Discord limitations, Niles cannot clean messages older than 14 days.
!id <google_calendar_id> or
@niles id <google_calendar_id> to add or change the Google Calendar associated with your Discord Server. This must be a valid calendar ID, from the ‘Settings and Sharing’>’Integrate’ section of the Calendar you want to use.
Niles must have access to your calendar. You can only use one Google Calendar per server.
!tz <timezone> or
@niles tz <timezone> to add or change the timezone associated with your Discord Server.
This can be done using
@niles validate to check for any errors with the timezone, calendar ID, calendar fetching or permissions.
@niles calname to rename the CALENDAR link name to something else
@niles auth to set up authorization with OAuth2 or to switch back to service account
@niles channel to set a channel to be the default channel for all calendar updates and postings with subcommands
@niles setup to display a summary of the setup steps for getting started with Niles.
@niles display to generate an invite link to add Niles to a server.
!prefix <new_prefix> or
@niles prefix <new_prefix> to change the prefix for the server. i.e.
@niles prefix ?!. Niles would then respond to
You can also use
@niles prefix to find out what the prefix has been changed to if you forget.
For details on display options, refer to Configuration/Display Options.
!admin <role> or
@niles admin <role> to restrict the usage of Niles to people with the role. i.e.
!admin scheduler or
!admin captain. The
<role> is case sensitive.
Important: Make sure you have the role that you are about to restrict the usage of Niles to. You can only restrict the usage to one role.
@niles help to get a list of the available commands and a summary of what they do.
@niles stats display a list of usage statistics about the Niles bot.
@niles ping - pong!