(Golang) Go bindings for Discord
Find a file
2025-05-14 06:51:38 +09:00
.github Update Go version in CI (#1147) 2022-04-01 17:55:27 +03:00
docs fix: typo in modal example and getting started (#1443) 2023-09-04 21:42:02 +03:00
examples chore(examples/voice_receive): update versions in go.mod and go.sum (#1537) 2024-07-07 22:04:27 +03:00
tools/cmd/eventhandlers Remove type checks for handlers, it's done implicitly in the handlerForInterface call. (#305) 2016-12-29 09:58:51 -08:00
.gitignore Slash commands (#856) 2021-02-28 21:54:02 -05:00
.golangci.yml CI (#1076) 2022-02-16 16:24:17 +03:00
.travis.yml Update Go version in CI (#1147) 2022-04-01 17:55:27 +03:00
components.go Add Entitlements / SKUs (#1552) 2024-12-08 17:16:00 +10:00
CONTRIBUTING.md feat: add contributing.md 2022-08-01 18:50:50 +03:00
discord.go feat(*): bump version to 0.28.1 2024-04-01 16:28:16 +03:00
discord_test.go chore(tests): fix typo (#1520) 2024-05-14 15:33:16 +03:00
endpoints.go feat: add guild member banners (#1592) 2025-03-17 12:22:05 +03:00
event.go Revert "feat(structs#Session): made sessionID and sequence fields public" 2022-02-27 18:11:50 +03:00
eventhandlers.go feat: add SubscriptionDelete event (#1607) 2025-03-17 16:07:22 +03:00
events.go feat: add SubscriptionDelete event (#1607) 2025-03-17 16:07:22 +03:00
go.mod Update unmarshal function to wrap ErrJSONUnmarshal and return specific error message. Requires at least Go 1.13. (#924) 2021-05-14 22:30:27 -04:00
go.sum Update unmarshal function to wrap ErrJSONUnmarshal and return specific error message. Requires at least Go 1.13. (#924) 2021-05-14 22:30:27 -04:00
interactions.go Add Entitlements / SKUs (#1552) 2024-12-08 17:16:00 +10:00
interactions_test.go implement interaction request signing verification 2021-01-13 17:43:43 +00:00
LICENSE Rename GoDiscord to Discordgo in LICENSE (develop) 2016-05-17 09:45:25 -04:00
locales.go feat(locales): add spanish LATAM (#1496) 2024-02-26 14:03:17 +03:00
logging.go fix typo in InviteTargetEmbeddedApplication and in some comments (#1211) 2022-07-29 18:42:40 +03:00
message.go feat(Message): add MessageSnapshots (#1604) 2025-03-04 13:13:56 +03:00
message_test.go feat(MessageReference): add Type (#1595) 2025-03-04 12:44:35 +03:00
mkdocs.yml Some website contented added :) 2016-04-26 14:48:06 -05:00
oauth2.go Add Invite Create/Delete (#1105) 2022-02-26 00:13:27 +03:00
oauth2_test.go fixed small typo in oauth2_test.go 2018-04-21 21:55:51 -04:00
ratelimit.go Slash commands (#856) 2021-02-28 21:54:02 -05:00
ratelimit_test.go Correct header in rate limit test 2021-01-20 19:48:09 -05:00
README.md edit README.md 2025-05-14 06:51:38 +09:00
restapi.go Add Entitlements / SKUs (#1552) 2024-12-08 17:16:00 +10:00
restapi_test.go feat(UserGuilds)!: support with_counts parameter (#1500) 2024-03-15 18:22:29 +03:00
state.go feat(ChannelUpdate): add BeforeUpdate (#1539) 2024-07-07 22:13:33 +03:00
structs.go feat(User): add DisplayName method (#1609) 2025-04-13 16:55:15 +03:00
structs_test.go feat(User): add DisplayName method (#1609) 2025-04-13 16:55:15 +03:00
user.go feat(User): add DisplayName method (#1609) 2025-04-13 16:55:15 +03:00
user_test.go feat(User): add DisplayName method (#1609) 2025-04-13 16:55:15 +03:00
util.go Add size parameters to IconURL and BannerURL (#1301) 2023-01-18 01:59:00 +03:00
util_test.go Adding millisecond precision to SnowflakeTimestamp utility (#732) 2020-06-16 23:43:34 -04:00
voice.go fix(voice): session id deadlock on open (#1408) 2023-08-13 07:06:50 +03:00
webhook.go feat(interactions): implement Attachments field (#1392) 2023-12-30 07:24:00 +03:00
wsapi.go feat(Session): Add GatewayWriteStruct function (#1409) 2024-07-07 22:20:55 +03:00

DiscordMuffin forked from DiscordGo

Go Reference Go Report Card CI Discord Gophers Discord API

DiscordGo logo

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.

go get github.com/bwmarrin/discordgo

Usage

Import the package into your project.

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.

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.

  • Go Reference
  • 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.

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.