slipstream/disagreement
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
disagreement/docs/presence.md
Slipstreamm 9237d12a24 docs(imports): Update import paths in documentation examples 
Adjust examples to reflect the new top-level exposure of classes and enums, such as `Client`, `Permissions`, `Embed`, and `Button`, making imports simpler.
2025-06-14 18:44:04 -06:00

1.1 KiB
Raw Blame History

Updating Presence

The Client.change_presence method allows you to update the bot's status and displayed activity. Pass an :class:~disagreement.models.Activity (such as :class:~disagreement.models.Game or :class:~disagreement.models.Streaming) to describe what your bot is doing.

Status Strings

  • online – show the bot as online
  • idle – mark the bot as away
  • dnd – do not disturb
  • invisible – appear offline

Activity Types

An activity dictionary must include a name and a type field. The type value corresponds to Discord's activity types:

Type Meaning
0 Playing
1 Streaming
2 Listening
3 Watching
4 Custom
5 Competing

Example using the provided activity classes:

from disagreement import Game

await client.change_presence(status="idle", activity=Game("with Discord"))

You can also specify a streaming URL:

from disagreement import Streaming

await client.change_presence(status="online", activity=Streaming("My Stream", "https://twitch.tv/someone"))