Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apurv-r/discord-together
An unofficial module that allows the use of the Discord's BETA feature, Party Games - like YouTube together or Poker Night.
https://github.com/apurv-r/discord-together
discord discord-activites discord-py discord-together youtube
Last synced: about 1 month ago
JSON representation
An unofficial module that allows the use of the Discord's BETA feature, Party Games - like YouTube together or Poker Night.
- Host: GitHub
- URL: https://github.com/apurv-r/discord-together
- Owner: apurv-r
- License: mit
- Created: 2021-06-03T15:02:00.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-07-28T11:05:08.000Z (over 2 years ago)
- Last Synced: 2024-08-09T22:51:08.974Z (5 months ago)
- Topics: discord, discord-activites, discord-py, discord-together, youtube
- Language: Python
- Homepage:
- Size: 1.05 MB
- Stars: 50
- Watchers: 2
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Discord Together
Discord has released a BETA feature that they call Discord Party Games or Activities, which allows members to play a large variety of games within a server voice channel. While this feature has officially only been provided to certain hand-picked servers, this module allows you to temporarily enable such features for your servers!
### Use the [docs for discord-together](https://docs.discord-together.ml/) for detailed usage guide.
As of the latest release, this BETA feature is only supported on web and updated PC app versions of Discord and is not supported on mobile.
# 🔩 Installation
## Install [discord-together](https://pypi.org/project/discord-together/)
```
pip install discord-together
```
#### Package dependencies only include [aiohttp](https://pypi.org/project/aiohttp/)
# 🔑 Features
- No specific API wrapper dependencies, works with discord.py and any of its forks
- Easy to use and lightweight
- Actively maintained and updated with latest activites
- Debug mode for invalid invites
# 💻 Code example
This is a simple example of code using this package (with discord.py 1.7.2) to create an invite for a YouTube Watch Together in the channel that the command invoker is currently in.
```py
from discord.ext import commands
from discord_together import DiscordTogether
client = commands.Bot(command_prefix="~")
@client.event
async def on_ready():
client.togetherControl = await DiscordTogether("BOT_TOKEN_HERE")
print('Bot is online!')
@client.command()
async def start(ctx):
link = await client.togetherControl.create_link(ctx.author.voice.channel.id, 'youtube')
await ctx.send(f"Click the blue link!\n{link}")
client.run("BOT_TOKEN_HERE")
```
View the **[docs](https://docs.discord-together.ml/)** for more detailed/advanced examples (like cogs) and explanations!
# 📷 Image
⚠️ Advisory Note:
At least one person needs to click on the BLUE LINK, not the 'Play' button, in order to start the activity! Once the activity is started, people can join by clicking 'Play'.
# 🚀 Others
**This package is under MIT license.** Appropriately tested PR's are more than welcome.
*Note: This package is not affiliated with Discord or YouTube.*
If you have any problems or enquiries, join the [discord-together Support Server](https://discord.gg/2fbyXn2hJV) or you can contact me personally on Discord: `Bxllistic#4444`.
This project was converted to support python from the npm package [discord-together](https://www.npmjs.com/package/discord-together)
## **Made with ❤ by Bxllistic**
Credits to [@RemyK888](https://github.com/RemyK888) for initial foundations