{% extends "main.html" %} {% block content %}
v{{ config.extra.revvlink_version }} — Now Available on PyPI

RevvLink

v4 Lavalink
411 Tests Passing
3.10+ Python
MIT License

Music in 30 Seconds

From zero to streaming music in your Discord bot with just a few lines of code.

bot.py
Python
# 1. Connect your Lavalink node
import revvlink

async def setup_hook(self) -> None:
    nodes = [revvlink.Node(uri="http://localhost:2333", password="youshallnotpass")]
    await revvlink.Pool.connect(nodes=nodes, client=self)

# 2. Search and play a track
async def play(ctx, *, query: str) -> None:
    player: revvlink.Player = await ctx.author.voice.channel.connect(cls=revvlink.Player)

    tracks: revvlink.Search = await revvlink.Playable.search(query)
    await player.queue.put_wait(tracks[0])

    if not player.playing:
        await player.play(player.queue.get())

Built for Scale

Every feature is designed with production workloads in mind.

Elite Performance

Fully async architecture handles thousands of concurrent players with minimal overhead using efficient asyncio patterns.

Self-Healing Pool

Automatic node failover and session recovery. If a node drops, your music keeps playing seamlessly on another node.

Regional Load Balancing

Intelligent penalty-based node selection routes players to the best Lavalink node based on latency and load.

Precision Filters

Professional-grade audio manipulation — Bass Boost, Nightcore, Timescale, 15-band EQ with millisecond precision.

Intelligent AutoPlay

Recommendation engine fetches related tracks automatically, keeping queues flowing without any user input.

Strictly Typed

Full Pyright strict compliance. Every class, method, and parameter is typed — your IDE will always guide you correctly.

AI-Ready (Context 7)

Built-in support for Context 7 means AI can read our docs perfectly, helping you build bots faster and smoother than ever.

How It Works

RevvLink sits between your Discord bot and one or more Lavalink servers, managing connections, players, and audio routing automatically.

Voice Channel LavaLink Node 1 LavaLink Node 3 RevvLink Wrapper Music Bot Handshake on initialization LavaLink Pool Asia Region US Region S-America Region Africa Region LavaLink Node 2 LavaLink Node 4 Handshakeonstartup join / play command Createsa Playerinstance Player LFU Cache YouTube YT Music Spotify Apple Music SoundCloud Deezer Twitch Bandcamp Direct URL Yandex Music VK Music Music Sources - Queue System- Filters System- DAVE Protocol- State Management - Penalty Based Node Balancing- Auto Node Shifter- Silent Node Reconnecting Event Driven Handshake

Ready to Build?

Join developers building the next generation of Discord music bots with RevvLink.

pip install revvlink
{{ page.content }}
{% endblock %}