A versatile LavaLink wrapper for Discord.py
Project description
A robust and powerful Lavalink wrapper for discord.py@rewrite!
Documentation
Support
For support using WaveLink, please join the official support server on Discord.
Installation
The following commands are currently the valid ways of installing WaveLink.
WaveLink requires Python 3.6+
Windows
py -3.6 -m pip install Wavelink
Linux
python3.6 -m pip install Wavelink
Getting Started
A quick and easy bot example:
import discord
import wavelink
from discord.ext import commands
class Bot(commands.Bot):
def __init__(self):
super(Bot, self).__init__(command_prefix=['audio ', 'wave ','aw '])
self.add_cog(Music(self))
async def on_ready(self):
print(f'Logged in as {self.user.name} | {self.user.id}')
class Music:
def __init__(self, bot):
self.bot = bot
if not hasattr(bot, 'wavelink'):
self.bot.wavelink = wavelink.Client(self.bot)
self.bot.loop.create_task(self.start_nodes())
async def start_nodes(self):
await self.bot.wait_until_ready()
# Initiate our nodes. For this example we will use one server.
# Region should be a discord.py guild.region e.g sydney or us_central (Though this is not technically required)
await self.bot.wavelink.initiate_node(host='0.0.0.0',
port=80,
rest_uri='http://0.0.0.0:2333',
password='youshallnotpass',
identifier='TEST',
region='us_central')
@commands.command(name='connect')
async def connect_(self, ctx, *, channel: discord.VoiceChannel=None):
if not channel:
try:
channel = ctx.author.voice.channel
except AttributeError:
raise discord.DiscordException('No channel to join. Please either specify a valid channel or join one.')
player = self.bot.wavelink.get_player(ctx.guild.id)
await ctx.send(f'Connecting to **`{channel.name}`**')
await player.connect(channel.id)
@commands.command()
async def play(self, ctx, *, query: str):
tracks = await self.bot.wavelink.get_tracks(f'ytsearch:{query}')
if not tracks:
return await ctx.send('Could not find any songs with that query.')
player = self.bot.wavelink.get_player(ctx.guild.id)
if not player.is_connected:
await ctx.invoke(self.connect_)
await ctx.send(f'Added {str(tracks[0])} to the queue.')
await player.play(tracks[0])
bot = Bot()
bot.run('TOKEN')
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
wavelink-0.1.90.tar.gz
(13.5 kB
view details)
Built Distribution
wavelink-0.1.90-py3-none-any.whl
(18.6 kB
view details)
File details
Details for the file wavelink-0.1.90.tar.gz
.
File metadata
- Download URL: wavelink-0.1.90.tar.gz
- Upload date:
- Size: 13.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0b4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 44c2de6bcc1ba136fa576dcf2ab60bda278d86ada596ece9ca0f6b971b4accdb |
|
MD5 | ee683c0d0ac3545eb677a10b7c686e2b |
|
BLAKE2b-256 | 739c5ea2e484889718310100202108f109f844974f266967f26a1d71592d67c0 |
File details
Details for the file wavelink-0.1.90-py3-none-any.whl
.
File metadata
- Download URL: wavelink-0.1.90-py3-none-any.whl
- Upload date:
- Size: 18.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0b4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e65595be949d1e20c4770d51d31f517d27473603d24c2ed84f3030e01787375d |
|
MD5 | 99d8224ef909038dea293cc3d937991e |
|
BLAKE2b-256 | f78fc3c4622d60bd5abe71efa2687572ac87360998861c7bd402ada7940bb9bc |