{"id":13410213,"url":"https://github.com/disgoorg/disgo","last_synced_at":"2026-06-07T11:01:40.429Z","repository":{"id":37010615,"uuid":"344581288","full_name":"disgoorg/disgo","owner":"disgoorg","description":"A modular Golang Discord API Wrapper","archived":false,"fork":false,"pushed_at":"2025-05-02T23:32:39.000Z","size":3997,"stargazers_count":388,"open_issues_count":12,"forks_count":41,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-12T05:39:58.173Z","etag":null,"topics":["discord","discord-api","discord-bot","discord-rpc","discord-voice","go","golang","hacktoberfest","oauth2","rpc","voice","webhook"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/disgoorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-03-04T19:07:52.000Z","updated_at":"2025-05-07T15:42:46.000Z","dependencies_parsed_at":"2023-10-15T09:20:20.362Z","dependency_job_id":"d69d3aa0-c470-4ae9-8e08-b2963d086ec9","html_url":"https://github.com/disgoorg/disgo","commit_stats":{"total_commits":1522,"total_committers":38,"mean_commits":40.05263157894737,"dds":0.3199737187910644,"last_synced_commit":"3bdb88c4ff66182018d09ef89dab0f04bd44db08"},"previous_names":[],"tags_count":136,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disgoorg%2Fdisgo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disgoorg%2Fdisgo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disgoorg%2Fdisgo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disgoorg%2Fdisgo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/disgoorg","download_url":"https://codeload.github.com/disgoorg/disgo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254160259,"owners_count":22024568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","discord-api","discord-bot","discord-rpc","discord-voice","go","golang","hacktoberfest","oauth2","rpc","voice","webhook"],"created_at":"2024-07-30T20:01:05.578Z","updated_at":"2026-01-07T01:15:16.055Z","avatar_url":"https://github.com/disgoorg.png","language":"Go","funding_links":[],"categories":["Libraries"],"sub_categories":["Go"],"readme":"[![Go Reference](https://pkg.go.dev/badge/github.com/disgoorg/disgo.svg)](https://pkg.go.dev/github.com/disgoorg/disgo)\n[![Go Report](https://goreportcard.com/badge/github.com/disgoorg/disgo)](https://goreportcard.com/report/github.com/disgoorg/disgo)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/disgoorg/disgo)](https://golang.org/doc/devel/release.html)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/disgoorg/disgo/blob/master/LICENSE)\n[![DisGo Version](https://img.shields.io/github/v/tag/disgoorg/disgo?label=release)](https://github.com/disgoorg/disgo/releases/latest)\n[![DisGo Discord](https://discord.com/api/guilds/817327181659111454/widget.png)](https://discord.gg/TewhTfDpvW)\n\n\u003cimg align=\"right\" src=\"/.github/discord_gopher.png\" width=192 alt=\"discord gopher\"\u003e\n\n# DisGo\n\nDisGo is a [Discord](https://discord.com) API wrapper written in [Golang](https://golang.org/) aimed to be consistent, modular, customizable and higher level than other Discord API wrappers.\n\n## Summary\n\n1. [Stability](#stability)\n2. [Features](#features)\n3. [Missing Features](#missing-features)\n4. [Getting Started](#getting-started)\n5. [Documentation](#documentation)\n6. [Examples](#examples)\n7. [Other interesting Projects to look at](#other-interesting-projects-to-look-at)\n8. [Other Golang Discord Libraries](#other-golang-discord-libraries)\n9. [Troubleshooting](#troubleshooting)\n10. [Contributing](#contributing)\n11. [License](#license)\n\n### Stability\nThe public API of DisGo is mostly stable at this point in time. Smaller breaking changes can happen before the v1 is released. \n\nAfter 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. \n\n### Features\n\n* Full Rest API coverage\n* [Gateway](https://discord.com/developers/docs/topics/gateway)\n* [Sharding](https://discord.com/developers/docs/topics/gateway#sharding)\n* [HTTP Interactions](https://discord.com/developers/docs/interactions/slash-commands#receiving-an-interaction)\n* [Application Commands](https://discord.com/developers/docs/interactions/application-commands)\n* [Message Components](https://discord.com/developers/docs/interactions/message-components)\n* [Modals](https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-modal)\n* [Stage Instance](https://discord.com/developers/docs/resources/stage-instance)\n* [Guild Template](https://discord.com/developers/docs/resources/guild-template)\n* [Sticker](https://discord.com/developers/docs/resources/sticker)\n* [RateLimit](https://discord.com/developers/docs/topics/rate-limits)\n* [Webhook](https://discord.com/developers/docs/resources/webhook)\n* [OAuth2](https://discord.com/developers/docs/topics/oauth2)\n* [Threads](https://discord.com/developers/docs/topics/threads)\n* [Guild Scheduled Event](https://discord.com/developers/docs/resources/guild-scheduled-event)\n* [Voice](https://discord.com/developers/docs/topics/voice-connections)\n\n### Missing Features\n\n* [RPC](https://discord.com/developers/docs/topics/rpc) (https://github.com/disgoorg/disgo/pull/170)\n\n## Getting Started\n\n### Installing\n\n```sh\n$ go get github.com/disgoorg/disgo\n```\n\n### Building a DisGo Instance\n\nBuild a bot client to interact with the Discord API\n```go\npackage main\n\nimport (\n\t\"context\"\n\t\"os\"\n\t\"os/signal\"\n\t\"syscall\"\n\n\t\"github.com/disgoorg/disgo\"\n\t\"github.com/disgoorg/disgo/bot\"\n\t\"github.com/disgoorg/disgo/events\"\n\t\"github.com/disgoorg/disgo/gateway\"\n)\n\nfunc main() {\n\tclient, err := disgo.New(\"token\",\n\t\t// set gateway options\n\t\tbot.WithGatewayConfigOpts(\n\t\t\t// set enabled intents\n\t\t\tgateway.WithIntents(\n\t\t\t\tgateway.IntentGuilds,\n\t\t\t\tgateway.IntentGuildMessages,\n\t\t\t\tgateway.IntentDirectMessages,\n\t\t\t),\n\t\t),\n\t\t// add event listeners\n\t\tbot.WithEventListenerFunc(func(e *events.MessageCreate) {\n\t\t\t// event code here\n\t\t}),\n\t)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\t// connect to the gateway\n\tif err = client.OpenGateway(context.TODO()); err != nil {\n\t\tpanic(err)\n\t}\n\n\ts := make(chan os.Signal, 1)\n\tsignal.Notify(s, syscall.SIGINT, syscall.SIGTERM)\n\t\u003c-s\n}\n```\n\n### Full Ping Pong Example\n\nA full Ping Pong example can also be found [here](https://github.com/disgoorg/disgo/blob/master/_examples/ping_pong/example.go)\n\n### Logging\n\nDisGo uses [slog](https://pkg.go.dev/log/slog) for logging.\n\n## Documentation\n\nDocumentation is wip and can be found under\n\n* [![Go Reference](https://pkg.go.dev/badge/github.com/disgoorg/disgo.svg)](https://pkg.go.dev/github.com/disgoorg/disgo)\n* [![Discord Documentation](https://img.shields.io/badge/Discord%20Documentation-blue.svg)](https://discord.com/developers/docs)\n\nGitHub Wiki is currently under construction. We appreciate help here.\n\n## Examples\n\nYou can find examples [here](https://github.com/disgoorg/disgo/tree/master/_examples)\n\nThere is also a bot template with commands \u0026 db [here](https://github.com/disgoorg/bot-template)\n\nor in these projects:\n\n* [DisGo-Butler](https://github.com/disgoorg/disgo-butler)\n* [Reddit-Discord-Bot](https://github.com/TopiSenpai/Reddit-Discord-Bot)\n* [Kitsune-Bot](https://github.com/TopiSenpai/Kitsune-Bot)\n* [KittyBot](https://github.com/KittyBot-Org/KittyBotGo)\n\n## Libraries for DisGo\n\n* [disgomd](https://github.com/eminarican/disgomd) is a command utility library that uses struct based approach\n\n\n## Other interesting Projects to look at\n\n### [Lavalink](https://github.com/freyacodes/Lavalink)\n\nIs a standalone audio sending node based on [Lavaplayer](https://github.com/sedmelluq/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](https://github.com/disgoorg/disgolink) for music Bots\n\nBeing used in production by FredBoat, Dyno, LewdBot, and more.\n\n### [DisGolink](https://github.com/disgoorg/disgolink)\n\nIs a [Lavalink-Client](https://github.com/freyacodes/Lavalink) which can be used to communicate with Lavalink to play/search tracks\n\n## Other Golang Discord Libraries\n\n* [discordgo](https://github.com/bwmarrin/discordgo)\n* [disgord](https://github.com/andersfylling/disgord)\n* [arikawa](https://github.com/diamondburned/arikawa)\n* [corde](https://github.com/Karitham/corde)\n\n## Troubleshooting\n\nFor help feel free to open an issue or reach out on [Discord](https://discord.gg/TewhTfDpvW)\n\n## Contributing\n\nContributions are welcomed but for bigger changes we recommend first reaching out via [Discord](https://discord.gg/TewhTfDpvW) or create an issue to discuss your problems, intentions and ideas.\n\n## License\n\nDistributed under the [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/disgoorg/disgo/blob/master/LICENSE). See LICENSE for more information.\n\n## Supported by Jetbrains\n\n\u003ca href=\"https://www.jetbrains.com/community/opensource\" target=\"_blank\" title=\"Jetbrain Open Source Community Support\"\u003e\u003cimg src=\"https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png\" alt=\"Jetbrain Open Source Community Support\" width=\"400px\"\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdisgoorg%2Fdisgo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdisgoorg%2Fdisgo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdisgoorg%2Fdisgo/lists"}