Keine Beschreibung

Chris Rhodes 457b03f66e Fix deadlock because I'm dumb. vor 9 Jahren
examples 6fa99712ef Finish converting large switch statement into a map of functions. vor 9 Jahren
.travis.yml 2d634bc612 Reduce number of tests by removing go tip tests. vor 9 Jahren
LICENSE bc323b57a1 Initial commit vor 9 Jahren
README.md 8fad18a2b0 Update README.md vor 9 Jahren
discord.go 457b03f66e Fix deadlock because I'm dumb. vor 9 Jahren
discord_test.go 2b4b19cfd8 Fixed some test comment wording. vor 9 Jahren
endpoints.go 0ea10a300b Merge branch 'develop' into guilds vor 9 Jahren
events.go 79247272ff Handler updates, no backwards incompatible API changes. vor 9 Jahren
message.go 9b8e880744 Optimized some structs to reduce their runtime size. vor 9 Jahren
restapi.go e0010ab0ba Add limit and offset to GuildMembers, closes #105 vor 9 Jahren
restapi_test.go ad1d0fac60 Tiny bit more test. vor 9 Jahren
state.go 4895ace11d Return state errors. Because we're good citizens. vor 9 Jahren
structs.go 79247272ff Handler updates, no backwards incompatible API changes. vor 9 Jahren
util.go a08dde4262 Support zlib compression. vor 9 Jahren
voice.go f832d3da4a Fix so opusSender exits better on close, closes #123 vor 9 Jahren
wsapi.go 457b03f66e Fix deadlock because I'm dumb. vor 9 Jahren

README.md

Discordgo

GoDoc Go report Build Status

Discordgo is a Go package that provides low level bindings to the Discord chat client API.

  • See dgVoice for experimental voice support.

Join #go_discordgo Discord chat channel for support.

Getting Started

Installing

Discordgo has been tested to compile on Debian 8 (Go 1.3.3), FreeBSD 10 (Go 1.5.1), and Windows 7 (Go 1.5.2).

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

$ 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("username", "password")

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 functions, constants, and structures.

The Discordgo code is fairly well documented at this point and is currently the only documentation available. Both GoDoc and GoWalker (below) present that information in a nice format.

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

  • Basic - New A basic example using the easy New() helper function
  • Basic - API A basic example using the low level API functions.
  • Bruxism A chat bot for YouTube and Discord
  • GoGerard A modern bot for Discord
  • Digo A pluggable bot for your Discord server

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.
  • Fork the develop branch and make your changes.
  • 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 develop branch.

List of Discord APIs

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