sonolink

SonoLink

A high-performance Lavalink v4 wrapper for Python, inspired by WaveLink.

Features

Full Lavalink v4+ REST API support
Built on msgspec for rapid serialization and strict type validation
Optional curl_cffi for faster networking
Async-first and Basedpyright strict-compliant
Multi-library native support for discord.py, py-cord, disnake, and nextcord

Documentation

The full documentation is available at https://sonolink.readthedocs.io/en/latest. It includes guides on getting started, Lavalink setup and moving from other libraries, as well as a comprehensive API reference.

Examples may be found in the examples directory.

Installation

[!NOTE] A virtual environment 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)
One of the following discord libraries with the [voice] extra:
- discord.py 2.7+
- py-cord 2.8+
- disnake 2.12+
- nextcord 3.1.1+

Install

Stable (recommended):

pip install -U sonolink # basic
pip install -U "sonolink[speed]" # optional speed improvements

Development (latest from GitHub):

pip install -U "sonolink @ git+https://github.com/sonolink/sonolink" # basic
pip install -U "sonolink[speed] @ git+https://github.com/sonolink/sonolink" # optional speed improvements

[!TIP] On Linux/macOS use python3 -m pip, on Windows use py -3 -m pip if pip isn't on your PATH.

Contributors

This project wouldn't be possible without the dedication and support of our contributors.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sonolink-1.3.0.tar.gz (77.8 kB view details)

Uploaded Jul 20, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sonolink-1.3.0-py3-none-any.whl (149.1 kB view details)

Uploaded Jul 20, 2026 Python 3

File details

Details for the file sonolink-1.3.0.tar.gz.

File metadata

Download URL: sonolink-1.3.0.tar.gz
Upload date: Jul 20, 2026
Size: 77.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for sonolink-1.3.0.tar.gz
Algorithm	Hash digest
SHA256	`6c7980e4f9cb703fc836e7800241eb8d362f2a0dbb0d1c0a0d43918c424f296e`
MD5	`cbdc9ebe2c1a848eaf2304aa620b742a`
BLAKE2b-256	`d805660c8c05a14e27534b067277ab6e8a2e78718e3dfd8723c5174affc195ec`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sonolink-1.3.0.tar.gz:

Publisher: release.yml on sonolink/sonolink

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sonolink-1.3.0.tar.gz
- Subject digest: 6c7980e4f9cb703fc836e7800241eb8d362f2a0dbb0d1c0a0d43918c424f296e
- Sigstore transparency entry: 2207071964
- Sigstore integration time: Jul 20, 2026
Source repository:
- Permalink: sonolink/sonolink@f1993b9b5317ff2482399f99df77799699d79150
- Branch / Tag: refs/tags/v1.3.0
- Owner: https://github.com/sonolink
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f1993b9b5317ff2482399f99df77799699d79150
- Trigger Event: release