This is a list of commands for the SuperSweetBot as info for broadcasters and mods…! Stuff specific for you upper users are highlighted in pink.

-----------------------------------------------------
# Configuration
-----------------------------------------------------

Configuration of the Super Sweet Toolset is handled via the command !sweetconf. The general format of a command is:

  !sweetconf <key> <value>

Example:

  !sweetconf sweetpridelevel mod

To see the value of a key, use:

  !sweetconf <key>

## Currently supported keys & values

| Key               | Possible values               | Initial default |
|-------------------|-------------------------------|-----------------|
| sweetpridelevel   | creator, mod, vip, sub, user  | creator         |
| sweeteffectslevel | creator, mod, vip, sub, user  | creator         |
| cleardonelevel    | creator, mod, vip, sub        | creator         |
| tidytasklistlevel | creator, mod, vip, sub        | mod             |
| tasklistmgmtlevel | creator, mod                  | creator         |
| preservedonecount | on, off                       | on              |
| tasklistvariant   | full, taskonly                | full            |
| timercontrollevel | creator, mod                  | creator         |
| botverbositylevel | regular, reduced, veryreduced | regular         |
| widgetconfiglevel | creator, mod                  | creator         |
| ourdonelevel      | creator, mod, vip, sub, user  | user            |

## Note: a user level value always includes all values above

Example: if you set a level to "user", this automatically includes "sub", "vip", "mod" and "creator".

## Explanation: sweetpridelevel

This option configures who is allowed to execute "!sweetpride".

## Explanation: sweeteffectslevel

This option configures who is allowed to execute various "seasonal" commands that are available for a limited time. 
Watch the occasional announcements in the main chat for details!

## Explanation: cleardonelevel

This option configures who is allowed to execute "!cleardone".

## Explanation: tidytasklistlevel

This option configures who is allowed to execute "!tidytasklist".

## Explanation: tasklistmgmtlevel

This option configures who is allowed to execute "!countold" and "!clearold".

## Explanation: botverbositylevel

Slightly changes the verbosity of some bot responses (e.g. by shortening task names or displaying slightly shorter messages).

## Explanation: preservedonecount

By default, the task list remembers the numbers of all done tasks in the header (e.g. "Done 5/10"), even if some of the done tasks have been removed with the command "!cleardone" (this way, you can clean up the board during the stream, while still knowing the final number of tasks in the end). 
To discard the stored number of tasks, either run "!clearall" (also removes all tasks from the board) or "!resetcount" (leaves the tasks on the board and sets the stored numbers to what is currently visible on the board).

If you want to turn off this behaviour, you can do so by typing "!sweetconf preservedonecount off".
Once you did this, the number of tasks shown in the header will always reflect what is currently visible on the list.
Example: there are 2 done tasks of 5 total ("2/5"), and you run "!cleardone". The two done tasks are removed and the header now displays "0/3".

## Explanation: tasklistvariant

- To only allow commands for regular tasks (!sweet, !task, !done, !rename, !remove), set to "taskonly". This will disallow the !pomo command.
- To allow all commands, set to "full" (this is the default).
- All administrative commands like !cleardone, !clearall etc. are always active.

## Explanation: timercontrollevel

Configures who is allowed to execute the commands "!timer" and "!timerpomo"

## Explanation: widgetconfiglevel

Configures who is allowed to execute the commands "!colorscheme" and "!transparency"

## Explanation: ourdonelevel

Configures who is allowed to execute the command "!ourdone"

-----------------------------------------------------
# Super Sweet Task List: Widget Control
-----------------------------------------------------

🎨  Remotely change widget styles
You can change the style (color scheme + transparency) of active widgets via chat commands. 

Use this to:
Make changes if your streaming software does not offer a different solution (e.g. Twitch Studio)
Put style change commands on your Stream Deck
Make "color change redeems" for your viewers

Short summary
Try these commands while your widgets are visible:

!colorscheme next
!colorscheme previous
!transparency on
!transparency off

All details below ⬇️ 

# Remotely change widget styles

| Command              | Effect                                  | User level |
| -------------------- | --------------------------------------- | ---------- |
| !colorscheme         | Change color scheme of active widgets   | Creator    |
| !transparency        | Change transparency of active widgets   | Creator    |
| !tweakstyle          | Tweak styles of active widgets          | Creator    |

🌟  Details: !colorscheme
Move to next / previous color scheme
!colorscheme next
!colorscheme previous

Choose specific color scheme
!colorscheme matcha

(See below for a list of available color scheme names)

Choose random color scheme (same scheme for all widgets)
!colorscheme random

Choose random scheme (potentially different scheme for all widgets)
!colorscheme mixedrandom

Move to next of given selection of schemes
!colorscheme nextof muted-pink lavender purple

Change only a specific widget
Prefix any command with one of: tasklist, timer, infopanels

Example:

!colorscheme timer winter-night

🌟 Command !transparency
Turn transparency on / off
!transparency on
!transparency off

Change only a specific widget
Prefix command with one of: tasklist, timer, infopanels

Example:

!transparency infopanels on

🌟 Command !tweakstyle
Disable corner rounding / drop shadow
!tweakstyle rounding off / !tweakstyle dropshadow off
!tweakstyle rounding on / !tweakstyle dropshadow on

(setting "rounding" has no effect on timer)

Change only a specific widget
Prefix command with one of: tasklist, timer, infopanels

Example:

!tweakstyle infopanels rounding off

💡  List of possible color schemes
white-veil
black-veil
muted-pink
secondary
tertiary
lavender
coffee
purple
matcha
cerulean
pumpkin
gold
winter-night
white-glass
black-glass
celebration
vintage-pride
night-drive
peachy
purple-velvet
green-velvet
red-velvet
dark-roast
caramel-latte

💡 Allow these commands for moderators
Run this command once to give your moderators access to all of the above commands:

!sweetconf widgetconfiglevel mod

-----------------------------------------------------
# Super Sweet Task List: Basic Commands
-----------------------------------------------------

| Command               | Effect                                          | User level |
| --------------------  | ----------------------------------------        | ---------- |
| !sweet                | Prints help                                     | Everybody  | 
| !task New Task        | Creates active task "New Task"                  | Everybody  |
| !task                 | Shows current task                              | Everybody  | 
| !done                 | Marks current task as done                      | Everybody  |
| !done next            | Marks current task as done & starts next        | Everybody  |
| !done all             | Marks all tasks done including current          | Everybody  |
| !rename Other Task    | Renames active task to "Other Task"             | Everybody  |
| !remove               | Removes active task                             | Everybody  |
| !randomtask           | Creates a tiny, positive task                   | Everybody  |
| !ask task @someuser   | Queries the task of user "someuser"             | Everybody  |
| !mydone               | Shows number of done tasks for user             | Everybody  |
| !remove               | Removes active task                             | Everybody  |
| !remove all           | Removes all tasks                               | Everybody  |       
| !now Tidy up          | Creates task on Task List                       | Everybody  |
| !later Prepare dinner | Creates task in backlog                         | Everybody  |
| !backlog              | Shows contents of backlog                       | Everybody  |
| !now                  | Gets your next task or task from last stream    | Everybody  |
| !now 1                | Puts first task from backlog on Task List       | Everybody  |
| !backlog help         | Displays help message for backlog               | Everybody  |
| !remove 1             | Remove first backlog task                       | Everybody  |
| !display 1            | Shows full name of first backlog task           | Everybody  |
| !backlog clear        | Removes all tasks from backlog                  | Everybody  |
| !now next             | Gets next task from backlog                     | Everybody  |
| !now skip             | Switches out current task for next one          | Everybody  |
| !now raffle           | Gets random task from backlog                   | Everybody  |
| !soon Tidy up         | Creates task at front of backlog                | Everybody  |
| !sweetbacklog         | Short summary of backlog feature                | Everybody  |
| !clearuser @someuser  | Removes all tasks created by "someuser"         | Moderator  |
| !cleardone            | Removes all "done" tasks                        | Creator    |
| !tidytasklist         | Moves all "done" tasks to the top               | Moderator  |
| !countold 5           | Counts tasks older than 5 days                  | Creator    |
| !clearold 5           | Removes tasks older than 5 days                 | Creator    |
| !clearall             | Removes all tasks                               | Creator    |
| !resetcount           | Resets task count in list header                | Creator    |

Create multiple tasks in the backlog at the same time by separating them with a semicolon ";":

!later Tidy up; Groceries; Dinner
!soon Tidy up; Groceries; Dinner
!task Tidy up; Groceries; Dinner

Changing multiple tasks in the backlog at the same time:

!done 2; 3; 7
!remove 2; 3; 7

You can also include the active task in these commands via the index "0":

!done 0; 2
This marks both your active task & your 2nd backlog task as done

-----------------------------------------------------
# Super Sweet Task List: Pomo Commands for "small timers" on the task list
-----------------------------------------------------

| Command                 | Effect                                       | User level |   
|-------------------------|----------------------------------------------|------------|
| !sweetpomo              | Prints help                                  | Everybody  |
| !pomo                   | Shows current pomo / prints short help       | Everybody  |
| !pomo 9 My Timer        | Creates work timer of 9 min with             | Everybody  |
|                         |          title "My Timer"                    |            |
| !pomo 9/3 My Timer      | Creates timer of 9 min work, 3 min break     | Everybody  |
|                         |          with title "My Timer"               |            |
| !pomo 9/3/4 My Timer    | Creates timer of 9 min work, 3 min break,    | Everybody  |
|                         |          4 repeats with title "My Timer"     |            |
| !pomo pause             | Pauses running timer                         | Everybody  |
| !pomo continue          | Continues paused timer                       | Everybody  |
| !pomo finish            | Finishes timer early                         | Everybody  |
| !pomo cancel            | Cancels timer                                | Everybody  |
| !pomo +5                | Adds 5 minutes to current timer              | Everybody  |
| !pomo -5                | Subtracts 5 minutes from current timer       | Everybody  |
| !pomo rename Other name | Renames current timer to "Other name"        | Everybody  |
| !ask pomo @someuser     | Queries the pomo of "someuser"               | Everybody  |

-----------------------------------------------------
# Projects
-----------------------------------------------------

⚠️  This is an advanced feature! 
➡️ You will not need it when you are just starting out with Super Sweet Bot! 🙂

| Command               | Effect                                 |
| --------------------- | -------------------------------------- |
| !project Housework    | Switches to project                    |
|                       | (creates project if it does not exist) |
| !projects             | Lists all projects                     |
| !project help         | Help on projects                       |
| !project tutorial     | Tutorial on using projects             |
| !project remove       | Removes active project                 |
| !fullreset            | Removes all projects & tasks           |

| Command                   | Effect                                                |
| ------------------------- | ----------------------------------------------------- |
| !project rename New Name  | Renames active project                                |
| !addto Housework: Tidy up | Adds task to other project                            |
| !getfrom Housework        | Puts next task from given project into active project |
| !peek Housework           | Displays project tasks without switching              |

Quick project creation
Command: 
!project Housework: Tidy up; Empty dishwasher; Mop floor

Creates project (if it does not exist already)
Adds tasks
Switches to project

Command: 
!addto Housework: Tidy up; Empty dishwasher; Mop floor

Creates project (if it does not exist already)
Adds tasks
Does *not switch to project

Modifying Tasks in Other Projects
!done Housework: 1; 2
!remove Housework: 1; 2

-----------------------------------------------------
# Super Sweet Task List: Easter Eggs
-----------------------------------------------------

| Command                   | Effect                                   | User level |
| ------------------------- | ---------------------------------------- | ---------- |
| !sweetpride               | Try it! :-) (lasts for 5 minutes)        | Creator    | 
| !sweetpride 15            | Effect for 15 min (up to 480 min)        | Creator    |

# Configuration of sweetpride

Allow for moderators:
  !sweetconf sweetpridelevel mod

Allow for vips (also includes moderators):
  !sweetconf sweetpridelevel vip

Allow for subs (also includes vips & moderators):
  !sweetconf sweetpridelevel sub

Allow for everybody:
  !sweetconf sweetpridelevel user

Allow only for streamer / creator:
  !sweetconf sweetpridelevel creator

# Note

Only creator & mods are allowed to specify a duration with a command like "!sweetpride 15".

# More options

Less movement:
  !sweetpride mild
  !sweetpride mild 15

Pastel colors:
  !sweetpride pastel
  !sweetpride pastel 15

"Disability Pride" colors:
  !sweetpride disability
  !sweetpride disability 15

Original (bright!) colors:
  !sweetpride original
  !sweetpride original 15

Less movement for other variants:
  !sweetpride original mild 15
  !sweetpride vintage mild 15

Cancel a running SweetPride (only creator & mods):
  !sweetpride 0


------------------------------------------------------------------
SuperSweet Data Store:

➡️ If you are a Patreon of level "!Sweet" or above, Super Sweet Data Store will automatically be enabled in your stream. There is no setup required from your side.
➡️ This module of super_sweet_bot allows users to store tiny pieces of information about themselves, like their pronouns or favourite food.

Examples
--------

To store your own pronouns:

  !remember pronouns he/him

To query another person's pronouns:

  !ask pronouns @some_user_name
# Super Sweet Data Store: Commands


| Command                  | Effect                                 | User Level |
|--------------------------|----------------------------------------|------------|
| !memory                  | Prints help                            | Everybody  |
| !remember <key> <value>  | Sets <key> to <value> for oneself      | Everybody  |
| !ask <key>               | Gets value of <key> for oneself        | Everybody  |
| !ask <key> <user>        | Gets value of <key> for <user>         | Everybody  |
| !forget <key>            | Deletes <key> for oneself              | Everybody  |
| !forget all              | Deletes all keys for oneself           | Everybody  |
| !memory stats            | Prints statistics                      | Everybody  |
| !forgetuser <key> <user> | Deletes <key> for <user>               | Moderator  |
| !forgetuser all <user>   | Deletes all keys for <user>            | Moderator  |

Currently, the following keys are supported: pronouns, country, food, pet, astrology