Metadata-Version: 2.4
Name: sonolink
Version: 1.0.0
Summary: A high-performance Lavalink v4 wrapper for Python, inspired by WaveLink.
Author: vmphase, Soheab, DA-344 (aka Developer Anonymous)
Maintainer: vmphase, DA-344 (aka Developer Anonymous), Soheab
License: MIT
Project-URL: Repository, https://github.com/sonolink/sonolink
Keywords: lavalink,wavelink,fork,sonolink,discord.py,discord,music,audio,bot,library,python,asyncio,pycord,py-cord,disnake
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE.txt
Requires-Dist: aiohttp<4,>=3.11.0
Requires-Dist: msgspec<1,>=0.20.0
Requires-Dist: typing_extensions>=4.0.0
Requires-Dist: packaging<27.0,>=26.0
Provides-Extra: speed
Requires-Dist: curl-cffi<1,>=0.14.0; extra == "speed"
Provides-Extra: docs
Requires-Dist: sphinx>=9.1.0; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: sphinx-autobuild>=2024.10.3; extra == "docs"
Requires-Dist: py-cord[voice]<3,>=2.8.0rc1; extra == "docs"
Requires-Dist: disnake<3,>=2.12; extra == "docs"
Dynamic: license-file

<div align="center">

![SonoLink](https://raw.githubusercontent.com/sonolink/sonolink/main/docs/_static/images/banner.png)

**SonoLink** is a high-performance Lavalink v4 wrapper for Python, inspired by [WaveLink](https://github.com/PythonistaGuild/Wavelink).

[Documentation](https://sonolink.readthedocs.io/en/latest) · [Discord](https://discord.gg/tPHVWBPedt) · [Migration from WaveLink](https://sonolink.readthedocs.io/en/latest/guides/migrating-from-wavelink.html)



[![PyPI](https://img.shields.io/pypi/v/sonolink)](https://pypi.org/project/sonolink)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org)
[![License](https://img.shields.io/github/license/sonolink/sonolink)](LICENSE)
[![Lavalink](https://img.shields.io/badge/lavalink-4.x-orange)](https://lavalink.dev)
[![Discord](https://img.shields.io/discord/1471146455002775624?label=discord)](https://discord.gg/tPHVWBPedt)

</div>

---

## Features

- Full Lavalink v4+ REST API support
- Built on [msgspec](https://github.com/jcrist/msgspec) for rapid serialization and strict type validation
- Optional [curl_cffi](https://github.com/lexiforest/curl_cffi) for faster networking
- Drop-in familiarity for Wavelink users — [migration guide included](https://sonolink.readthedocs.io/en/latest/guides/migrating-from-wavelink.html)
- Async-first and [Basedpyright](https://docs.basedpyright.com/latest/) strict-compliant
- Built-in support for [discord.py](https://github.com/Rapptz/discord.py), [pycord](https://github.com/Pycord-Development/pycord), and [disnake](https://github.com/DisnakeDev/disnake)

## Installation

> [!NOTE]
> A [virtual environment](https://docs.python.org/3/library/venv.html) is recommended, especially on Linux where the system Python may restrict package installations.
> 
### Requirements:
- Python 3.12 or higher
- A running Lavalink 4.x server ([guide on setup](https://sonolink.readthedocs.io/en/latest/guides/lavalink-setup.html))
- Any of the supported libraries:
  - [discord.py](https://pypi.org/project/discord.py)[voice] 2.7+
  - [py-cord](https://pypi.org/project/py-cord)[voice] 2.8+
  - [disnake](https://pypi.org/project/disnake)[voice] 2.12+

To install the stable version from PyPI:
```sh
# Linux/macOS
python3 -m pip install -U sonolink

# Windows
py -3 -m pip install -U sonolink
```

To install with optional speed improvements:
```sh
# Linux/macOS
python3 -m pip install -U "sonolink[speed]"

# Windows
py -3 -m pip install -U "sonolink[speed]"
```

<br>

<p align="center">
	<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" />
</p>

<p align="center">
        <i><code>&copy 2026 <a href="https://github.com/sonolink">SonoLink Development Team</a></code></i>
</p>
