Metadata-Version: 2.1
Name: selfcord.py
Version: 1.0.0
Summary: A Discord API wrapper designed for selfbots!
Home-page: https://github.com/OmegaDevStudio/Selfcord
Author: Shell
License: MIT
Keywords: selfbot,discord,discordapi,discordwrapper
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp==3.8.5
Requires-Dist: aioconsole==0.3.3
Requires-Dist: websockets==10.1
Requires-Dist: ujson==5.7.0
Requires-Dist: aiofiles==0.8.0
Requires-Dist: requests==2.31.0
Requires-Dist: uvloop==0.17.0
Provides-Extra: voice
Requires-Dist: pynacl==1.5.0; extra == "voice"
Requires-Dist: opuslib==3.0.1; extra == "voice"
Provides-Extra: linux
Requires-Dist: uvloop==0.17.0; extra == "linux"
Provides-Extra: windows
Requires-Dist: winloop==0.1.0; extra == "windows"

<div align="center">
<h1 align="center">SELFCORD</h1>
<strong><i>A Powerful Library for Discord Selfbots</i></strong>
<br>
<br>
<a href="https://www.python.org/">
<img src="https://img.shields.io/badge/MADE%20WITH-PYTHON-red?logoColor=red&logo=Python&style=for-the-badge">
</a>
<a href="https://pypi.org/project/selfcord/">
<img src="https://img.shields.io/badge/version-1.0.0-blue?logo=adguard&style=for-the-badge">
</a>
<a href="https://github.com/OmegaDevStudio/Selfcord/wiki">
<img src="https://img.shields.io/badge/documentation-green?logo=gitbook&style=for-the-badge">
</a>
</div>

## NOTE
This is the rewrite repository and is currently not pushed to PyPI. I'm going to try get selfcord to it's previous working state or better before pushing to PyPI. Contribution welcome.

## Feautres
 - Modern Pythonic API using `async`/`await` syntax
 - Easy to use with an object oriented design
 - Optimised for both speed and memory
 - Prevents detection of user account automation
 - Clean Documentation
 - Community Support

## Installation
Python 3.10 or higher is required.
```
pip install selfcord.py
```

## Wiki

Read our [Wiki](https://github.com/Shell1010/Selfcord/wiki) in regards to documentation and getting started.

## Getting Started
A selfbot that responds to a message ("ping!") with another message ("pong").
```py
import selfcord

token = "insert token"
bot = selfcord.Bot()

@bot.on("ready")
async def ready(time):
    print(f"Connected To {bot.user.name}\n Startup took {time:0.2f} seconds")

@bot.on("message")
async def responder(message):
    if message.content == "ping!":
        await message.channel.send("pong!")

bot.run(token)
```
## Examples/Usage
### Message logger
In this snippet, If someone deletes messages in the server, it records details such as the server name, channel name, message content, and the author's name
```python
import selfcord

token = "insert token"
bot = selfcord.Bot(prefixes=["!", "?"])

@bot.on("ready")
async def ball(time):
    print(f"Connected To {bot.user}\n Startup took {time:0.2f} seconds")

@bot.on("message_delete")
async def message_logger(message):
    # DISCLAIMER: If message is not in bots cache only message id, channel id and guild id will be present
    if message.author != None:
        if message.author.id != bot.user.id:
            if message.guild != None: # If the message is in a guild
                await aprint(f"""MESSAGE LOGGED:
SERVER: {message.guild.name}
CHANNEL: {message.channel.name}
CONTENT:
{message.author}: {message.content}
""")
        else: # If the message is in a DM or Group chat
            await aprint(f"""MESSAGE LOGGED:
CHANNEL: {message.channel}
CONTENT:
{message.author}: {message.content}
            """)

bot.run(token)
```
### Purge command
In this snippet, you are able to delete certain amount of messages from a channel
```python
import selfcord

token = "insert token"
bot = selfcord.Bot(prefixes=["!", "?"])

@bot.on("ready")
async def ball(time):
    print(f"Connected To {bot.user}\n Startup took {time:0.2f} seconds")

@bot.cmd(description="Purges the channel", aliases=["wipe", "clear"])
async def purge(ctx, amount: int=None):
    await ctx.purge(amount)

bot.run(token)
```

### Deleted message sniper
In this snippet, you can retrieve the most recently deleted message.
```python
import selfcord

token = "insert token"
bot = selfcord.Bot(prefixes=["!", "?"])

@bot.on("ready")
async def ball(time):
    print(f"Connected To {bot.user}\n Startup took {time:0.2f} seconds")

@bot.cmd(description="Snipe", aliases=['s'])
async def snipe(ctx):
    await ctx.reply(f"{bot.user.deleted_messages[-1].author}: {bot.user.deleted_messages[-1]}")

bot.run(token)
```
### Captcha
[2Captcha](https://2captcha.com/?from=15127673) is the only captcha solving service supported currently.

## Some Useful Links
- [Documentation](https://github.com/Shell1010/Selfcord/wiki)
- [Other Documentation (messy)](https://github.com/Shell1010/Selfcord/tree/main/docs)
- [PyPi](https://pypi.org/project/selfcord.py/)
- [Official Discord Server](https://discord.gg/FCFnnBGzkg)
- [A simple selfbot designed to showcase the library's features](https://github.com/Shell1010/Aeterna-Selfbot)

## Contributing
Contributors are always Welcome
