hikari-wave 0.2.0a1

Voice module for `hikari`-based Discord bots

A lightweight, native voice implementation for hikari-based Discord bots

Latest: 0.2.0a1  |  Python: 3.10+

Overview

hikari-wave is a standalone voice module for hikari that provides direct voice gateway communication without requiring external backends like Lavalink.

It is designed to be:

• Simple to use
• Fully asynchronous
• Native to hikari's architecture

No separate software. No complex setup. Just voice.

Features

• Native Discord voice gateway implementation
• Clean, async-first API
• Strong typing and documentation throughout
• Supplemental voice events for better control and UX

Installation

pip install hikari-wave

Ensure FFmpeg is installed and available in your system PATH.

Quick Start

Create a basic voice client bot:

import hikari

bot = hikari.GatewayBot("TOKEN")
client = hikariwave.VoiceClient(bot)

bot.run()

Connect to voice when a member joins:

@bot.listen(hikariwave.MemberJoinVoiceEvent)
async def on_join(event):
    await voice.connect(event.guild_id, event.channel_id)

Play audio:

@bot.listen(hikariwave.MemberJoinVoiceEvent)
async def on_join(event):
    connection = await voice.connect(event.guild_id, event.channel_id)
    source = FileAudioSource("test.mp3")

    await connection.player.play(source)

That's it.

Status

• Voice connect / disconnect
• Audio playback
• Move, reconnect, resume
• Player utilities (queue, shuffle, next/previous)
• Audio Sources:
  • Files
  • URLs
  • In-memory buffers
  • Media sites (YouTube, SoundCloud, etc.) (planned)
• Discord DAVE (planned)

Documentation

Full documentation is available at: https://hikari-wave.wildevstudios.net/

Contributing

Bug reports and feature requests are welcome via GitHub Issues. Clear reproduction steps and context are appreciated.

License

MIT License © 2025 WilDev Studios