![](https://i.imgur.com/NrG6YTv.png)

Secret Santa is *the* bot for hosting Secret Santas on Discord.

Use `/setup` to get started.

## Features

* ✅ Easy to set up. Using `/setup` you are guided through all the possible configurations.
* 🙂 Easy to use. Participants can do everything by using buttons. No need to explain any commands.
* ✉️ Anonymous communication between a Santa and their giftee (the one receiving their gift).
* 🔍 Moderation. Have participants rewrite their provided information, or kick them from the event.
* 👪 Raffle pools. Create separate groups to have a raffle among the people in each group.
* 🤝 Raffle manipulation. Force/prevent two people pulling the other's name in the raffle.
* ♻️ Adaptive. Allows you to swap Santas, or to insert a participant inbetween a Santa-giftee pair.
* 🕒 Supports latecomers. These can be assigned to each other or replace a Santa who has left.
* 📊 Insights. View the Santa-giftee pairs, or generate an entire spreadsheet with all the information.
* ⚙️ Highly configurable. From how gifts are submitted to how they are shown, you decide.
* 📝 Logging. Get notified when someone joins the event, or has submitted their gift.
* 🔐 Privacy. All data is encrypted and deleted 30 days after the Secret Santa has ended.

![](https://i.imgur.com/6OLoBtJ.png)

## Admin commands

### Running the event

* `/create` Create an event.
* `/setup` Start setting up an event. Automatically creates an event if it doesn't exist yet.
* `/start` Start the event.
* `/reset` Reset the event, allowing you to redo the raffle.
* `/end` End the event
* `/destroy` Destroy the event, and with that all data from the database.

### Pools

* `/pool create/delete/edit/etc` Manage pools with these commands.

### Participant info

* `/list` Get a list of all your participants, or one of many filtered list, like who has yet to submit a gift.
* `/info` Get information on a specific participant, like who their Santa is.
* `/peek` Get a layout of your participants, showing who has who as their Santa.
* `/spreadsheet` Generate a spreadsheet with information on all participants.

### Participant actions

* `/ban` Ban the participant from the event (not from the server).
* `/dm` DM a participant using the bot.
* `/latecomers insert` Insert a latecomer in-between a Santa-giftee pair.
* `/latecomers assign` Assign a group of latecomers to each other
* `/manipulate force/deny` Force/deny a Santa-giftee pair to occur in the raffle.
* `/swap` Swap the giftees (and optionally Santas) of two participants.

### Configurations

* `/word` Set the word to use for Santa. For example: Host a Secret Valentine instead!
* `/role` Set the role that is automatically given to server members who join.
* `/welcome` Set the message shown to new participants
* `/letter-required` Require participants to write something about themselves for their Santa to work with.
* `/submit-type` Set how gifts are submitted. Online, by address, both, or neither?
* `/latecomers allow` Whether latecomers are allowed to join.
* `/reveal channel` Set the channel where the gifts will be revealed, or have them appear in DMs instead.
* `/reveal what` What to reveal in a reveal channel. Only the text, the attachments, or both?
* `/reveal names` Whether to reveal the names right as the gift is received.
* `/logs select` Select the events to be logged in a set channel.
* `/logs ping` Set which event logs should ping a set role.

Secret Santa

Host Secret Santas in your server! Write a letter for your Santa, make/buy something for your giftee. Supports anonymous communication.

Voter pour Secret Santa

Tu veux nous soutenir ?