SparrowSparrow

Modules

Calendar

Your server's events in one place. Make an event and Sparrow posts a sign-up panel, reminds the people going, and keeps a calendar in your channels up to date. Members see every time in their own time zone and can add events to Google Calendar, Apple Calendar or Outlook.

Getting started

Open Community Tools, then Calendar, on the dashboard. On the Settings tab, set your server's time zone and the channel sign-up panels go in. Then make your first event with + Create, and post a calendar on the Posts tab.

Events

Each event can have:

  • A kind (Game night, Movie night, Tournament, Stream, Meeting, Party, Deadline or Event), which sets its color and ready-made cover. Pick your own color if you like.
  • A date and time in any time zone, or all day. Daylight saving is handled for you.
  • Repeat: every day, week, 2 weeks, month (the same date or the same weekday, like the 2nd Friday) or year, with an end date. Cancel just one date with Skip just this date.
  • Where: a voice channel or any location you type.
  • A cover: one of 12 ready-made covers with the event's name and date on it, the same 12 as moving covers (GIFs), or upload your own picture or GIF (1200×480 works best).
  • Hosts, shown on the panel. Empty means whoever made it.

Event managers can also make an event from Discord with /calendar create. It opens a form where you type the date like "Nov 14 7:30 PM" or "friday 8pm".

The event's panel

Pick a channel under Post the panel in and Sparrow posts the event there. Leave it empty and the event is only on the calendar.

  • The panel shows: the details and sign-ups, or Details only (the event's info and Add to calendar, no sign-up buttons). Details only is handy when you take sign-ups somewhere else, or just want people to know about it.
  • Post it: right away, a set time before the event (like 1 day before), or on a date and time you pick. Until then, the event is only on the calendar.
  • Ping when it's posted: roles, @here or @everyone, pinged once when the panel goes up.

Sign-ups

A panel with sign-ups has Going, Maybe and Can't go. Pressing your choice again takes you off the list. A repeating event has one panel that moves on to the next date by itself, and sign-ups start fresh for each date.

  • How many can go: when it's full, people go on a waitlist. When someone drops out, the first person waiting moves up and gets a DM.
  • Only for: pick roles. Members need one of them to sign up.
  • Sign-ups open and close at a time you pick, like a day before it starts, or open on a date and time. Until then, the buttons are grayed out.
  • Button names (Premium): call them anything, like Participating, Maybe and Not participating, for the whole server or one event.
  • Sign-up slots (Premium): named groups like Tank, Healer or DPS, each with its own button and number of places.
  • Participant role (Premium): given to everyone going, and taken back after the event.

Reminders and changes

  • Reminders: a DM to the people going before it starts, an hour before by default. Pick the times on the Settings tab or per event. 1 reminder free, up to 3 with Premium.
  • Starting now: a message in the event's channel when it starts, mentioning the people going, roles, @here or @everyone.
  • Plans change: when an event or one of its dates is cancelled, or the time changes, everyone signed up gets a DM. Their sign-up moves to the new time with the event.
  • Discussion thread: turn it on and the panel gets a thread to talk about the event. Sparrow posts there when plans change, and closes it when the event is over.

Managing events

On the dashboard, click any event to edit it, see who's going (and take someone off), cancel it or delete it. The Attendance view on the Events tab shows how many answered each way for any date, with search, and every event one member answered. In Discord, Event managers press ⚙️ Manage on an event's panel to see who's going, change the time, or cancel one date or the whole event.

Event managers are the roles and members you pick on the Settings tab. They can make and edit events, post calendars and approve suggestions, on the dashboard too. Admins always can. Only admins change Calendar settings.

Member suggestions

Turn on suggestions on the Suggestions tab and members can suggest an event with /calendar suggest. Each one goes to a review channel with Approve and Decline buttons, and shows on the dashboard, where you can change it first. The member gets a DM either way.

Calendar posts

A calendar post is a picture of your calendar in a channel. It updates by itself when events change, and comes back if someone deletes it. Make one on the Posts tab, with a live preview, or with /calendar post.

  • Views: Month, Week, 2 weeks, or a Coming up list.
  • Looks: 10 themes, like Night Sky, Autumn, Winter, Spooky and Festive, or Follow the season, which changes with the month. With Premium, upload your own picture.
  • Which events: all of them, only some kinds, and Discord's own events or not.
  • Birthdays: when Birthdays has Show on the Calendar on, members' birthdays show as all-day items, on every calendar post.

The buttons under a calendar post give each member their own private copy: another view, earlier or later, their own time zone, and an event menu to open any event and sign up. Staff with staff hours also get My hours, which adds their own hours to their copy only.

Discord's own events

  • Add Discord events automatically: events made with Discord's Events button show up on the calendar, including ones you already had, within a minute of turning it on. Changes to the name, time or picture follow, and events stay on the calendar after they end. Discord doesn't keep events that already ended, so those can't be brought in. Turn on Post a sign-up panel for each one and each gets a sign-up panel in your "Post sign-up panels in" channel, with a button to the Discord event.
  • Also make a Discord event: a switch on each event (or the default for new ones on the Settings tab). Members then see it in your server's Events list too. It needs a voice channel or a location.

Sparrow needs the Create Events permission to make Discord events, and Create Public Threads for discussion threads. The dashboard tells you if either is missing.

Add to calendar and the subscribe link

Every event's panel has Add to calendar: a Google Calendar or Outlook link for that date, or an .ics file for Apple Calendar and other apps. It also has a subscribe link for your whole calendar, which adds every event to the member's own calendar app and keeps it up to date. Google checks subscribed calendars every few hours, so changes show there a little later. Anyone with the link can see the events. Make a new link on the Settings tab and the old one stops working.

Calendar page

Share your calendar on the web. On the Settings tab, pick who can open the Calendar page: anyone with the link (no login), anyone with the link and a password you set (members can log in with Discord instead), or members only (they log in with Discord and Sparrow checks they're in your server). It shows the same calendar as the dashboard, day, week, month and agenda, with each event's details and Add to calendar. Nobody can change anything there, and it never shows who signed up.

The link is sparrowbot.net/calendar/ followed by your server id. With Premium, give it a custom name like sparrowbot.net/calendar/yourserver. The server id link keeps working too.

Free and Premium

Calendar is free, with 2 calendar posts, 20 upcoming events and 3 repeating ones. Premium raises those to 5, 500 and as many as you like, and adds your own calendar background, sign-up slots, participant roles, up to 3 reminders, your own button names and a custom name for your calendar page. See Premium.

Commands

/calendar showEveryone

See the server's calendar, only you see it: month, week, 2 weeks or a list, in your own time zone.

/calendar upcomingEveryone

What's coming up in the next 60 days, with sign-up links.

/calendar suggestEveryone

Suggest an event for staff to approve, when the server allows it.

/calendar createAdministrator, Manage Server, a Sparrow Master Role or an Event manager

Make an event from a form: title, when, how long, kind and description.

/calendar postAdministrator, Manage Server, a Sparrow Master Role or an Event manager

Post a calendar that keeps itself up to date.

Want an overview instead? See the Calendar module page → · See every command →