.. image:: https://raw.githubusercontent.com/PythonistaGuild/Wavelink/master/logo.png
.. image:: https://img.shields.io/badge/Python-3.10%20%7C%203.11-blue.svg
:target: https://www.python.org
.. image:: https://img.shields.io/github/license/EvieePy/Wavelink.svg
:target: LICENSE
.. image:: https://img.shields.io/discord/490948346773635102?color=%237289DA&label=Pythonista&logo=discord&logoColor=white
:target: https://discord.gg/RAKc3HF
.. image:: https://img.shields.io/pypi/dm/Wavelink?color=black
:target: https://pypi.org/project/Wavelink
:alt: PyPI - Downloads
.. image:: https://img.shields.io/maintenance/yes/2023?color=pink&style=for-the-badge
:target: https://github.com/PythonistaGuild/Wavelink/commits/main
:alt: Maintenance
Wavelink is a robust and powerful Lavalink wrapper for `Nextcord <https://github.com/nextcord/nextcord>`_.
Wavelink features a fully asynchronous API that's intuitive and easy to use with built in Spotify Support and Node Pool Balancing.
This is a Fork of `WaveLink <https://github.com/PythonistaGuild/Wavelink>`_ which was modified to allow it to run on Nextcord.
**Features:**
- Fully Asynchronous
- Auto-Play and Looping (With the inbuilt Queue system)
- Spotify Support
- Node Balancing and Fail-over
- Supports Lavalink 3.7+
Documentation
---------------------------
`Official Documentation <https://wavelink.readthedocs.io/en/latest/index.html>`_
Support
---------------------------
For support using WaveLink, please join the official `support server
<https://discord.gg/RAKc3HF>`_ on `Discord <https://discordapp.com/>`_.
.. image:: https://discordapp.com/api/guilds/490948346773635102/widget.png?style=banner2
:target: https://discord.gg/RAKc3HF
Installation
---------------------------
The following commands are currently the valid ways of installing WaveLink.
**WaveLink 2 requires Python 3.10+**
**Windows**
.. code:: sh
py -3.10 -m pip install -U Wavelink
**Linux**
.. code:: sh
python3.10 -m pip install -U Wavelink
Getting Started
----------------------------
**See also:** `Examples <https://github.com/PythonistaGuild/Wavelink/tree/main/examples>`_
.. code:: py
import nextcord
import wavelink
from nextcord.ext import commands
intents = nextcord.intents.all()
client = nextcord.Client()
bot = commands.Bot(command_prefix="?", intents=intents)
@bot.event
async def on_ready():
print(f'Logged in {self.user} | {self.user.id}')
bot.loop.create_task(on_node())
async def setup_hook():
# Wavelink 2.0 has made connecting Nodes easier... Simply create each Node
# and pass it to NodePool.connect with the client/bot.
node: wavelink.Node = wavelink.Node(uri='http://localhost:2333', password='youshallnotpass')
await wavelink.NodePool.connect(client=self, nodes=[node])
@bot.slash_command()
async def play(interaction : nextcord.Interaction, search : str):
"""Simple play command."""
query = await wavelink.YoutubeTrack.search(search, return_first=True)
destination = interaction.user.voice.channel
if not interaction.guild.voice_client:
vc: wavelink.Player = await destination.connect(cls=wavelink.Player)
elif interaction.guild.voice_client:
vc: wavelink.Player = interaction.guild.voice_client
await vc.play(query)
@bot.slash_command()
async def disconnect(interaction : nextcord.Interaction):
"""Simple disconnect command.
This command assumes there is a currently connected Player.
"""
vc: wavelink.Player = interaction.guild.voice_client
await vc.disconnect()
Lavalink Installation
---------------------
Head to the official `Lavalink repo <https://github.com/freyacodes/Lavalink>`_ and give it a star!
- Create a folder for storing Lavalink.jar and related files/folders.
- Copy and paste the example `application.yml <https://github.com/freyacodes/Lavalink#server-configuration>`_ to ``application.yml`` in the folder we created earlier. You can open the yml in Notepad or any simple text editor.
- Change your password in the ``application.yml`` and store it in a config for your bot.
- Set local to true in the ``application.yml`` if you wish to use ``wavelink.LocalTrack`` for local machine search options... Otherwise ignore.
- Save and exit.
- Install `Java 17(Windows) <https://download.oracle.com/java/17/latest/jdk-17_windows-x64_bin.exe>`_ or **Java 13+** on the machine you are running.
- Download `Lavalink.jar <https://ci.fredboat.com/viewLog.html?buildId=lastSuccessful&buildTypeId=Lavalink_Build&tab=artifacts&guest=1>`_ and place it in the folder created earlier.
- Open a cmd prompt or terminal and change directory ``cd`` into the folder we made earlier.
- Run: ``java -jar Lavalink.jar``
If you are having any problems installing Lavalink, please join the official Discord Server listed above for help.
Raw data
{
"_id": null,
"home_page": "https://github.com/Zyb3rWolfi/Wavelinkcord",
"name": "WavelinkCord",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "",
"author": "Zyb3rWolfi",
"author_email": "Zyb3rWolfi <Zyb3rWolfi@proton.me>",
"download_url": "https://files.pythonhosted.org/packages/1d/27/2346a093fa58597c24919325b22b3cbfc92493ab465215fbc021d13c5d6a/WaveLinkCord-2.2.1.tar.gz",
"platform": null,
"description": ".. image:: https://raw.githubusercontent.com/PythonistaGuild/Wavelink/master/logo.png\r\n\r\n\r\n.. image:: https://img.shields.io/badge/Python-3.10%20%7C%203.11-blue.svg\r\n :target: https://www.python.org\r\n\r\n\r\n.. image:: https://img.shields.io/github/license/EvieePy/Wavelink.svg\r\n :target: LICENSE\r\n\r\n\r\n.. image:: https://img.shields.io/discord/490948346773635102?color=%237289DA&label=Pythonista&logo=discord&logoColor=white\r\n :target: https://discord.gg/RAKc3HF\r\n\r\n\r\n.. image:: https://img.shields.io/pypi/dm/Wavelink?color=black\r\n :target: https://pypi.org/project/Wavelink\r\n :alt: PyPI - Downloads\r\n\r\n\r\n.. image:: https://img.shields.io/maintenance/yes/2023?color=pink&style=for-the-badge\r\n :target: https://github.com/PythonistaGuild/Wavelink/commits/main\r\n :alt: Maintenance\r\n\r\n\r\n\r\nWavelink is a robust and powerful Lavalink wrapper for `Nextcord <https://github.com/nextcord/nextcord>`_.\r\nWavelink features a fully asynchronous API that's intuitive and easy to use with built in Spotify Support and Node Pool Balancing.\r\nThis is a Fork of `WaveLink <https://github.com/PythonistaGuild/Wavelink>`_ which was modified to allow it to run on Nextcord.\r\n\r\n\r\n**Features:**\r\n\r\n- Fully Asynchronous\r\n- Auto-Play and Looping (With the inbuilt Queue system)\r\n- Spotify Support\r\n- Node Balancing and Fail-over\r\n- Supports Lavalink 3.7+\r\n\r\n\r\nDocumentation\r\n---------------------------\r\n`Official Documentation <https://wavelink.readthedocs.io/en/latest/index.html>`_\r\n\r\nSupport\r\n---------------------------\r\nFor support using WaveLink, please join the official `support server\r\n<https://discord.gg/RAKc3HF>`_ on `Discord <https://discordapp.com/>`_.\r\n\r\n.. image:: https://discordapp.com/api/guilds/490948346773635102/widget.png?style=banner2\r\n :target: https://discord.gg/RAKc3HF\r\n\r\n\r\nInstallation\r\n---------------------------\r\nThe following commands are currently the valid ways of installing WaveLink.\r\n\r\n**WaveLink 2 requires Python 3.10+**\r\n\r\n**Windows**\r\n\r\n.. code:: sh\r\n\r\n py -3.10 -m pip install -U Wavelink\r\n\r\n**Linux**\r\n\r\n.. code:: sh\r\n\r\n python3.10 -m pip install -U Wavelink\r\n\r\nGetting Started\r\n----------------------------\r\n\r\n**See also:** `Examples <https://github.com/PythonistaGuild/Wavelink/tree/main/examples>`_\r\n\r\n.. code:: py\r\n\r\n import nextcord\r\n import wavelink\r\n from nextcord.ext import commands\r\n\r\n intents = nextcord.intents.all()\r\n client = nextcord.Client()\r\n bot = commands.Bot(command_prefix=\"?\", intents=intents)\r\n\r\n @bot.event\r\n async def on_ready():\r\n print(f'Logged in {self.user} | {self.user.id}')\r\n bot.loop.create_task(on_node())\r\n\r\n async def setup_hook():\r\n # Wavelink 2.0 has made connecting Nodes easier... Simply create each Node\r\n # and pass it to NodePool.connect with the client/bot.\r\n node: wavelink.Node = wavelink.Node(uri='http://localhost:2333', password='youshallnotpass')\r\n await wavelink.NodePool.connect(client=self, nodes=[node])\r\n\r\n @bot.slash_command()\r\n async def play(interaction : nextcord.Interaction, search : str):\r\n \"\"\"Simple play command.\"\"\"\r\n\r\n query = await wavelink.YoutubeTrack.search(search, return_first=True)\r\n\r\n destination = interaction.user.voice.channel\r\n\r\n if not interaction.guild.voice_client:\r\n vc: wavelink.Player = await destination.connect(cls=wavelink.Player)\r\n elif interaction.guild.voice_client:\r\n vc: wavelink.Player = interaction.guild.voice_client\r\n \r\n await vc.play(query)\r\n\r\n\r\n @bot.slash_command()\r\n async def disconnect(interaction : nextcord.Interaction):\r\n \"\"\"Simple disconnect command.\r\n\r\n This command assumes there is a currently connected Player.\r\n \"\"\"\r\n vc: wavelink.Player = interaction.guild.voice_client\r\n await vc.disconnect()\r\n\r\n\r\nLavalink Installation\r\n---------------------\r\n\r\nHead to the official `Lavalink repo <https://github.com/freyacodes/Lavalink>`_ and give it a star!\r\n\r\n- Create a folder for storing Lavalink.jar and related files/folders.\r\n- Copy and paste the example `application.yml <https://github.com/freyacodes/Lavalink#server-configuration>`_ to ``application.yml`` in the folder we created earlier. You can open the yml in Notepad or any simple text editor.\r\n- Change your password in the ``application.yml`` and store it in a config for your bot.\r\n- Set local to true in the ``application.yml`` if you wish to use ``wavelink.LocalTrack`` for local machine search options... Otherwise ignore.\r\n- Save and exit.\r\n- Install `Java 17(Windows) <https://download.oracle.com/java/17/latest/jdk-17_windows-x64_bin.exe>`_ or **Java 13+** on the machine you are running.\r\n- Download `Lavalink.jar <https://ci.fredboat.com/viewLog.html?buildId=lastSuccessful&buildTypeId=Lavalink_Build&tab=artifacts&guest=1>`_ and place it in the folder created earlier.\r\n- Open a cmd prompt or terminal and change directory ``cd`` into the folder we made earlier.\r\n- Run: ``java -jar Lavalink.jar``\r\n\r\nIf you are having any problems installing Lavalink, please join the official Discord Server listed above for help.\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A robust and powerful Lavalink wrapper for Nextcord",
"version": "2.2.1",
"project_urls": {
"Homepage": "https://github.com/PythonistaGuild/Wavelink"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2ca7bd872cfb7439e50bd95c9b472e538137f8c32530dd53fbe163144547fe8e",
"md5": "e1a685054d26e38cd53195701e28d156",
"sha256": "283c313e009c25c49099fb526a57bc986b5660d081f4cf09623ae273e3d6bfe4"
},
"downloads": -1,
"filename": "WaveLinkCord-2.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e1a685054d26e38cd53195701e28d156",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 41303,
"upload_time": "2023-04-12T16:09:27",
"upload_time_iso_8601": "2023-04-12T16:09:27.704420Z",
"url": "https://files.pythonhosted.org/packages/2c/a7/bd872cfb7439e50bd95c9b472e538137f8c32530dd53fbe163144547fe8e/WaveLinkCord-2.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1d272346a093fa58597c24919325b22b3cbfc92493ab465215fbc021d13c5d6a",
"md5": "365989f35b495b7ff9b2143f0cb3bce8",
"sha256": "c671ff2b3cbb4784a9bf9c54f5582556187d7ced04a0e0d8f7794eda36d304f8"
},
"downloads": -1,
"filename": "WaveLinkCord-2.2.1.tar.gz",
"has_sig": false,
"md5_digest": "365989f35b495b7ff9b2143f0cb3bce8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 29606,
"upload_time": "2023-04-12T16:09:30",
"upload_time_iso_8601": "2023-04-12T16:09:30.118499Z",
"url": "https://files.pythonhosted.org/packages/1d/27/2346a093fa58597c24919325b22b3cbfc92493ab465215fbc021d13c5d6a/WaveLinkCord-2.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-12 16:09:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Zyb3rWolfi",
"github_project": "Wavelinkcord",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "aiohttp",
"specs": [
[
"<",
"4"
],
[
">=",
"3.7.4"
]
]
},
{
"name": "yarl",
"specs": [
[
"~=",
"1.8.2"
]
]
}
],
"lcname": "wavelinkcord"
}
JSON
