bwmarrin /discordgo

(Golang) Go bindings for Discord

★ 6,001⑂ 934👁 53⑃ 931● 704▤ 31
GoBSD-3-ClauseCreated 2015-11-01
Download: DiscordGo v0.29.0DiscordGo-0.29.0 ↓0.29.02025-05-24
+0
Daily
6,001
stars
934
forks
53
watchers
931
prs
704
issues
31
releases

README

DiscordGo

    



DiscordGo is a Go package that provides low level 
bindings to the Discord chat client API. DiscordGo 
has nearly complete support for all of the Discord API endpoints, websocket
interface, and voice interface.

If you would like to help the DiscordGo package please use 
this link
to add the official DiscordGo test bot dgo to your server. This provides 
indispensable help to this project.

 See dgVoice package for an example of
additional voice helper functions and features for DiscordGo.

 See dca for an experimental stand alone
tool that wraps ffmpeg to create opus encoded audio appropriate for use with
Discord (and DiscordGo).

For help with this package or general Go discussion, please join the Discord 
Gophers chat server.

 Getting Started

 Installing

This assumes you already have a working Go environment, if not please see
this page first.

go get will always pull the latest tagged release from the master branch.

sh
go get github.com/bwmarrin/discordgo


 Usage

Import the package into your project.

go
import "github.com/bwmarrin/discordgo"


Construct a new Discord client which can be used to access the variety of 
Discord API functions and to set callback functions for Discord events.

go
discord, err := discordgo.New("Bot " + "authentication token")


See Documentation and Examples below for more detailed information.


 Documentation

NOTICE: This library and the Discord API are unfinished.
Because of that there may be major changes to library in the future.

The DiscordGo code is fairly well documented at this point and is currently
the only documentation available. Go reference (below) presents that information in a nice format.

-  
- Hand crafted documentation coming eventually.


 Examples

Below is a list of examples and other projects using DiscordGo.  Please submit 
an issue if you would like your project added or removed from this list. 

- DiscordGo Examples - A collection of example programs written with DiscordGo
- Awesome DiscordGo - A curated list of high quality projects using DiscordGo

 Troubleshooting
For help with common problems please reference the 
Troubleshooting 
section of the project wiki.


 Contributing
Contributions are very welcomed, however please follow the below guidelines.

- First open an issue describing the bug or enhancement so it can be
discussed.  
- Try to match current naming conventions as closely as possible.  
- This package is intended to be a low level direct mapping of the Discord API, 
so please avoid adding enhancements outside of that scope without first 
discussing it.
- Create a Pull Request with your changes against the master branch.


 List of Discord APIs

See this chart for a feature 
comparison and list of other Discord API libraries.

 Special Thanks

Chris Rhodes - For the DiscordGo logo and tons of PRs.

Top issues

Discussions

Latest release

DiscordGo v0.29.0 v0.29.0 2025-05-24
What's Changed
 Breaking changes
 Added banner parameter to UserUpdate https://github.com/bwmarrin/discordgo/pull/1509
 Type of Activity.ApplicationID was changed to json.Number https://github.com/bwmarrin/discordgo/pull/1513
 AuditLogChangeKeyPulibUpdatesChannelID was renamed to AuditLogChangeKeyPublicUpdatesChannelID https://github.com/bwmarrin/discordgo/pull/1574


 New features
 User apps https://github.com/bwmarrin/discordgo/pull/1511
 Polls https://github.com/bwmarrin/discordgo/pull/1525
 Components V2 https://github.com/bwmarrin/discordgo/pull/1616
 Entitlements / SKUs https:

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON