This addition dispatches the currently available on_wavelink_inactive_player event when the Player has been inactive for x amount of played tracks. E.g. after 3 tracks if no real members (Members that aren't bots) have been in the channel, this event will fire.

PluginFilters

Added the PluginFilters filter class. This addition allows the setting of filters on Lavalink Plugins that support it.

Changes

Playable.search & wavelink.Pool.fetch_tracks

Added the optional node keyword-only argument; Allows passing a Node which will be used to search tracks. Defaults to None which uses the wavelink.Pool identical to previous versions.

Changelog

Feature/playable node and Inactive Channel Check by @EvieePy in #303
Fix/plugin filters by @EvieePy in #307

Full Changelog: v3.3.0...v3.4.0

Contributors

EvieePy

Assets 2

24 Apr 02:45

EvieePy

v3.3.0

ffcf13a

v3.3.0

Version 3.3.0

This release adds the populate keyword back to Player.play and has multiple small bug fixes.

Documentation:
https://wavelink.dev

Support:
Discord Server

Caution

You can no longer use a BETA version of Lavalink from version 3.1.0. Please upgrade your Lavalink to a stable version 4+.

Additions

Player.play:

populate and max_populate
_{Adds the populate and max_populate keyword-only arguments, which allows the auto queue to fetch and fill with recommended tracks based on the played track.}

Node.close:

eject
_{Adds the eject keyword argument, which when set to True will remove the Node from the Pool.}

Fixes

Bug in Queue not repeating a song when set to loop.
Bug in Node.close which wouldn't disconnect currently playing players correctly.
Bug in filters where some arguments were named incorrectly.
Bug in Queue where using put_wait while a get_wait was waiting for a track would result in all get_wait hanging.
Playlist.extras property now correctly sets the provided extras on each individual track.

QoL

Added typing_extensions to requirements.

Thanks

@jackra1n
@TrapDrap
@DanLCD

Contributors

DanLCD, jackra1n, and TrapDrap

Assets 2

04 Feb 10:26

EvieePy

v3.2.0

85c1aaf

v3.2.0

Version 3.2.0

This release adds two main additional features:

Documentation:
https://wavelink.dev

Support:
Discord Server

Caution

You can no longer use a BETA version of Lavalink from version 3.1.0. Please upgrade your Lavalink to a stable version 4+.

Additions

Events:

on_wavelink_inactive_player()
_{Called when the Players inactive_timeout expires. Useful for disconnecting the bot after a timeframe of no activity.}

Utils:

Playlist.extras
_{Similar to Playable.extras, but this applies Playable.extras to each track in the playlist and on the Playlist itself.}
Playable.raw_data
_{The raw payload received from lavalink. You can use this payload to re-build a track later.}

Changes

Queue (Redesign)
- ++ Queue.swap()
- ++ Queue.peek()
- ++ Queue.index()
- ++ Queue.remove()
- ! ! Queue.delete()
- ++ Queue.get_at()
- ++ Queue.put_at()
- ++ Queue.count
- ++ Queue.is_empty
- ++ Queue.loaded

The queue has been redesigned to be more friendly for wavelink use. Internally the queue now uses a list instead of a deque. QoL methods and properties have been added to make it easier to manage and use the queue. Please see the documentation for more information and special ways of using the queue. The queue is backwards compatible minus Queue.delete which is now not asynchronous.

QoL

Updated the yarl dependency for better support on Python 3.12+

Assets 2

10 Dec 17:31

EvieePy

v3.1.0

5f926ea

v3.1.0

Version 3.1.0

This release adds some QoL features that have been frequently requested, and adds support for plugin events.

Documentation:
https://wavelink.dev

Support:
Discord Server

Caution

You can no longer use a BETA version of Lavalink on this release. Please upgrade your Lavalink to a stable version 4+.

Additions

Playable:

Playable.extras
_{Updates to support userData field in Lavalink.}

Node:

Node.fetch_info
Node.fetch_stats
Node.fetch_version
Node.fetch_player_info
Node.fetch_players
_{All the above endpoints have been made public.}

Important

Node.fetch_player_info and Node.fetch_players are not the same as Node.get_player. Please read the documentation before using these endpoints for more details.

Payloads:

StatsResponsePayload
PlayerStatePayload
VoiceStatePayload
PlayerResponsePayload
GitResponsePayload
VersionResponsePayload
PluginResponsePayload
InfoResponsePayload
ExtraEventPayload
_{These payloads correspond to all the data received in the above endpoints, minus ExtraEventPayload which will be received in the on_wavelink_extra_event event.}

Events:

on_wavelink_extra_event
_{An event fired when an event that is unknown/unhandled by default is received, usually from Lavalink Plugins.}

Warning

Make sure you know the source of your event when using on_wavelink_extra_event. Lavalink does not provide this information by default.

Utils:

ExtrasNamespace
_{ExtrasNamespace is a container class that holds all the information sent to Lavalink via the userData field which can be set by passing a dict of str keys to Any value (Must be convertible to JSON) to Playable.extras. Please see documentation for more details.}

Changes

Internally Wavelink now sends a different payload to Lavalink when playing a track or skipping. This is inline with Lavalink changes. Please upgrade your Lavalink to a stable version 4+ if you are currently on a beta version.

Assets 2