hassiexx /
disgo
A fast and modular Discord API library in Go over REST and Websockets [WIP]
19/100 healthArchived
GoApache-2.0#api#discord#discord-api#go
⑂ 0 forks◯ 0 issuesUpdated Jan 28, 2023
Loading repository data…
disgoorg / repository
disgo
A modular Golang Discord API Wrapper
#discord#discord-api#discord-bot#discord-rpc#discord-voice#go
Live repository statistics
★ 587Stars
⑂ 71Forks
◯ 14Open issues
◉ 587Watchers
83/100
OPENREPOHUB HEALTH SIGNAL
Strong signals
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
100
Community adoption25% weight
53
Maintenance state20% weight
85
License clarity10% weight
100
Project information10% weight
75
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
DisGo
DisGo is a Discord API wrapper written in Golang aimed to be consistent, modular, customizable and higher level than other Discord API wrappers.
Summary
- Stability
- Features
- Missing Features
- Getting Started
- Documentation
- Examples
- Other interesting Projects to look at
- Other Golang Discord Libraries
- Troubleshooting
- Contributing
- License
Stability
The public API of DisGo is mostly stable at this point in time. Smaller breaking changes can happen before the v1 is released.
After v1 is released breaking changes may only happen if the Discord API requires them. They tend to break their released API versions now and then. In general for every new Discord API version the major version of DisGo should be increased and with that breaking changes between non-major versions should be held to a minimum.
Features
- Full Rest API coverage
- Gateway
- Sharding
- HTTP Interactions
- Application Commands
- Message Components
- Modals
- Stage Instance
- Guild Template
- Sticker
- RateLimit
- Webhook
- OAuth2
- Threads
- Guild Scheduled Event
- Voice
- DAVE (E2EE)
Missing Features
Getting Started
Installing
$ go get github.com/disgoorg/disgo
Building a DisGo Instance
Build a bot client to interact with the Discord API
package main
import (
"context"
"os"
"os/signal"
"syscall"
"github.com/disgoorg/disgo"
"github.com/disgoorg/disgo/bot"
"github.com/disgoorg/disgo/events"
"github.com/disgoorg/disgo/gateway"
)
func main() {
client, err := disgo.New("token",
// set gateway options
bot.WithGatewayConfigOpts(
// set enabled intents
gateway.WithIntents(
gateway.IntentGuilds,
gateway.IntentGuildMessages,
gateway.IntentDirectMessages,
),
),
// add event listeners
bot.WithEventListenerFunc(func(e *events.MessageCreate) {
// event code here
}),
)
if err != nil {
panic(err)
}
// connect to the gateway
if err = client.OpenGateway(context.TODO()); err != nil {
panic(err)
}
s := make(chan os.Signal, 1)
signal.Notify(s, syscall.SIGINT, syscall.SIGTERM)
<-s
}
Full Ping Pong Example
A full Ping Pong example can also be found here
Logging
DisGo uses slog for logging.
Documentation
Documentation is wip and can be found under
GitHub Wiki is currently under construction. We appreciate help here.
Examples
You can find examples here
There is also a bot template with commands & db here
or in these projects:
Libraries for DisGo
- disgomd is a command utility library that uses struct based approach
Other interesting Projects to look at
Lavalink
Is a standalone audio sending node based on Lavaplayer and JDA-Audio. Which allows for sending audio without it ever reaching any of your shards. Lavalink can be used in combination with DisGolink for music Bots
Being used in production by FredBoat, Dyno, LewdBot, and more.
DisGolink
Is a Lavalink-Client which can be used to communicate with Lavalink to play/search tracks
Other Golang Discord Libraries
Troubleshooting
For help feel free to open an issue or reach out on Discord
Contributing
Contributions are welcomed but for bigger changes we recommend first reaching out via Discord or create an issue to discuss your problems, intentions and ideas.
License
Distributed under the . See LICENSE for more information.
Supported by Jetbrains
ALGORITHMICALLY RELATED
Similar Open-Source Projects
Selected from shared topics, language and repository description—not editorial ratings.
★ 2