Logo for Starboard


Rated 4.4 by 9 users
1 upvotes in January
Starboard is an advanced and highly customizable discord bot, the easiest way to archive funny messages.

About Starboard

Starboard is an advanced, reliable, and highly customizable starboard bot, which I’ve been working on for a while now, mostly for use on personal servers. When it turned out better than I imagined, I open-sourced it and posted it to both lists. I hope you find this code and bot useful.

This documentation gives you a quick start to using the bot. If you see a problem, please let me know, either by using the bots suggest command or joining the support server. My discord username is @Circuit#5585.

Useful Links

Click here for a demonstration

Invite Starboard to your server

Join the support server

Starboard Documentation/Wiki

Starboard’s Features

  • Supports multiple starboards
  • AutoStar Channels (media channels)
  • Supports multiple normal and custom emojis for each starboard
  • Leveling, rank, and leaderboard
  • Starboard moderation, such as:
    • Freezing a message, preventing the points from updating on it
    • Forcing a message, so it’s on the starboard no matter what
    • Trashing a message, in case a bad message gets on the starboard
  • Advanced customization, giving you complete control over the bot

If you have any suggestions or found any bugs, please create an issue.

Quick Setup

Note: Don’t actually type out < > [ ] when I give you commands to run. Replace [p] with the actual bot prefix. channel means type “channel”, where as <channel> means replace “<channel>” with the name of the channel.

  1. Invite the bot to your server
  2. Create a channel for the bot (name it something like #starboard).
  3. Type [p]starboards add <channel> ("<channel>" is the name of the channel you just created)
  4. Type [p]starboards <channel> to view all the settings for this starboard!

The starboard is now good to go, but you might want to change more settings (like the number of reactions needed). A complete list of setting in the wiki.

Self Hosting

These directions are for self-hosting the bot. If you just want a working bot, you can invite it to your server instead.

  • Clone the repo by running git clone https://github.com/CircuitsBots/Starboard.git in the command line.
  • Make a copy of bot_config.py.example, and rename it to bot_config.py.
    • Update the settings to your liking. If you need help with this, you can join the support server.
  • Create a file called .env, and inside it put TOKEN="your token"
  • Run python bot.py to run the bot!


If you see a bug or possible improvement and want to help out, you can fork this repostory, make the edits, and then create a pull request. Make sure to look at the guidelines in CONTRIBUTING.md. I really appreciate any help that you can give.

Bot Lists

Discord Bots
Bots for Discord
Discord Boats

Check out the home page for the full Discord Bot List.


Prefix: sb! (customizable)
Servers: 11.3k
Users: 5.91m
Created by: Circuit#5585
Short link: discord.ly/starboard