Skip to content
This repository was archived by the owner on Oct 17, 2023. It is now read-only.

irtsa-dev/PyDiscord

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

PyDiscord

The Discord API made for normal users put into python.



Import Notice

Discord frowns on what is called "self-bots" (please see here):

Automating normal user accounts (generally called "self-bots") outside of the OAuth2/bot API is forbidden, and can result in an account termination if found.

Instead, Discord does have support for what are "bots" (please see here):

Discord's API provides a separate type of user account dedicated to automation, called a bot account. Bot accounts can be created through the applications page, and are authenticated using a token (rather than a username and password)



As such, this has intentionally left out certain endpoints of the API so that you may only retrieve information from your own account. To access the information, you will need to authenticate using an email and password, along with 2FA if applicable to your account.

If you wish to write a Discord bot in python, a good source can be found here (you should check it out).

While I cannot deny the possibility that one can figure out or read up on the other endpoints as well in order to utilize them, I would personally advise against strong usage of them to avoid possible account termination.


Kindly, I ask to respect this and do not utilize for malicious intent.





Installation

With git GitHub:

git clone https://github.com/IrtsaDevelopment/PyDiscord.git






Usage

To import, you may use:

from PyDiscord.Client import Discord

Afterwhich, you would need to login (and verify if needed).

client = Discord()

client.login('account@testing.com', 'password')
# Login to discord.

client.verify(123456)
# Verifies if needed.
# You can utilize client.needAuthentication to check if this is required.
# Currently does not support backup codes from discord, only utilizing totp.

After login (and verification if needed), the following can be used:

client.getGuild(637283625251738321)
# Gets a guild given the ID.
# The current user must be a part of the guild.
# Returns Guild objects.

client.getCurrentGuilds()
# Gets a list of guilds the user is in.
# Returns a list of GuildSuperLimited objects.

client.getUser(123242428284345329)
# Gets a user given the ID.
# What gets returned depends on if you are friends with said person or share a guild.
# Will return your current user information if no ID is provided.

client.getFriends()
# Gets a list of users the current user is friends with.
# Returns a list of UserFriend objects.

client.getMessages(134253256372563345, limit = 50)
# Gets a list of messages from the given channel ID.
# The number of messages returned can be limited with the "limit" parameter which defaults to 50.
# Returns a list of Message objects.

About

The Discord API made for normal users put into python.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages