You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Rapptz 307392ff19 on_status event now has the old game ID and old status as parameters. 9 years ago
discord on_status event now has the old game ID and old status as parameters. 9 years ago
docs on_status event now has the old game ID and old status as parameters. 9 years ago
examples Add new_member.py example to showcase messaging new members. 9 years ago
.gitignore Add support for logging. 10 years ago
LICENSE Rename project from pydiscord to discord.py 10 years ago
MANIFEST.in Properly set requirements of ws4py and requests. 10 years ago
README.md Add some badges to the README. 9 years ago
requirements.txt Properly set requirements of ws4py and requests. 10 years ago
setup.py Properly set requirements of ws4py and requests. 10 years ago

README.md

discord.py

PyPI PyPI PyPI

discord.py is an API wrapper for Discord written in Python.

This was written to allow easier writing of bots or chat logs.

Installing

Installing is pretty easy.

pip install discord.py

Will install the latest 'stable' version of the library.

If you want to install the development version of the library, then do the following:

pip install git+https://github.com/Rapptz/discord.py@develop

Note that this requires git to be installed.

This module is alpha!

The discord API is constantly changing and the wrapper API is as well. There will be no effort to keep backwards compatibility.

I recommend that you follow the discussion in the unofficial Discord API discord channel and update your installation periodically through pip install --upgrade discord.py.

Quick Example

import discord

client = discord.Client()
client.login('email', 'password')

@client.event
def on_message(message):
    if message.content.startswith('!hello'):
        client.send_message(message.channel, 'Hello was received!')

@client.event
def on_ready():
    print('Logged in as')
    print(client.user.name)
    print(client.user.id)
    print('------')

client.run()

You can find examples in the examples directory.

Requirements

  • Python 2.7+ or Python 3.3+.
  • ws4py library
  • requests library

Usually pip will handle these for you.