https://github.com/niles-bot/niles

Niles - a Discord bot for interfacing with Google Calendar
https://github.com/niles-bot/niles

bot calendar discord discord-bot google-calendar

Last synced: 4 months ago
JSON representation

Niles - a Discord bot for interfacing with Google Calendar

• Host: GitHub
• URL: https://github.com/niles-bot/niles
• Owner: niles-bot
• License: mit
• Created: 2017-06-03T10:48:36.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2023-03-16T23:33:58.000Z (over 2 years ago)
• Last Synced: 2025-06-03T02:58:06.448Z (4 months ago)
• Topics: bot, calendar, discord, discord-bot, google-calendar
• Language: JavaScript
• Homepage: http://nilesbot.com
• Size: 2.12 MB
• Stars: 62
• Watchers: 5
• Forks: 22
• Open Issues: 22
• Metadata Files:
  • Readme: readme.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Support: .github/SUPPORT.md

Awesome Lists containing this project

README

          
# Niles Discord Bot

[![Codacy](https://img.shields.io/codacy/grade/42ad70ef7e0842da99a2176d5684e0a3)](https://www.codacy.com/gh/niles-bot/niles/dashboard)

[![codebeat](https://codebeat.co/badges/e8acc280-9217-4e06-8085-79bc31f8f45c)](https://codebeat.co/projects/github-com-niles-bot-niles-main)

[![docker-ci](https://img.shields.io/github/workflow/status/niles-bot/niles/docker-ci)](https://hub.docker.com/r/nilesbot/niles)

[![bot](https://img.shields.io/website?label=bot&url=https%3A%2F%2Fstatus.nilesbot.com)](https://niles.betteruptime.com)

[![Crowdin](https://badges.crowdin.net/niles/localized.svg)](https://crowdin.com/project/niles)

[![discord](https://img.shields.io/badge/discord-join-blue)](https://discord.gg/jNyntBn)

![node-current](https://img.shields.io/node/v/discord.js)

A [Discord](https://discord.com/) bot for using [Google Calendar](https://calendar.google.com) to manage events.

Targeted towards eSports event scheduling (scrims, PCWs).

![example](https://i.imgur.com/3yYK4QB.png)

## Getting Started

[Invite the hosted bot to your Discord here](https://discord.com/oauth2/authorize?permissions=97344&scope=bot&client_id=320434122344366082).

Join the [Niles Discord server](https://discord.gg/jNyntBn) for support, bug reporting and feature requests.

Visit the Niles [website](https://nilesbot.com/) or [setup guide](https://nilesbot.com/start) for more detailed use and setup descriptions.

If you wanted to host your own version or similar, these instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

### Prerequisites

* [Node.js](https://nodejs.org/) - v16 or higher

### Installing

Setup your Discord app on the [Discord developers website](https://discord.com/developers/applications/me).

Note: To add a development bot to your Discord server, visit https://discord.com/api/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot&permissions=97344 replacing your app id in the URL.

Set up a [Google Service Account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount).

For more information on setting up a Google Service Account, [see here](https://github.com/yuhong90/node-google-calendar/wiki#setup-service-accounts).

Alternative, set up [OAuth2 Credentials](https://support.google.com/cloud/answer/6158849).

Create your own `secrets.json` file in `/config`, using the appropriate values, making sure you also place a copy of your Google Service Account JSON security file somewhere and referencing in `secrets`.

To run and connect your bot

```

npm install

npm run

```

## Built With

* [Discord.js](https://github.com/discordjs/discord.js) - NodeJS library for interfacing with the Discord API

* [googleapis](https://www.npmjs.com/package/googleapis) - Google APIs Node.js Client

## License

This project is licensed under the MIT License