0.3.1 — 2023-03-02
This patch release applies some minor fixes, while correcting documentation errors and adjusting some organisaation in the repository.
Thanks to the following for their contributions:
- [repo] Repo: Update issue templates (@FelixMcFelix) c:eedab8f
- [docs] Chore: Fix README.md CI badge (#161) (@FelixMcFelix) c:d6c82f5
- [input] Input: Fix read position after seek restart (#154) (@JamesDSource) c:39a6f69
- [docs] Docs: Fix wrong docstring for Track::volume (#152) (@btoschek) c:a2f55b7
- [docs] Events: Fix typo in docs for VoiceData (#142) (@tazz4843) c:dc53087
0.3.0 — 2022-07-22 — Chaffinch
Abundant and ever-curious, chaffinches are a vibrant and welcome visitor in these spring and summer months.
Making a quick and colourful splash, this breaking release mainly bumps our own dependencies and support for Discord libraries without any sweeping changes -- while adding generic support for any future rust-based Discord library. However, we have now removed support for the v0.2 series of the Tokio runtime.
Thanks to the following for their contributions:
- Tokio v0.2 support has been removed in parity with other Discord libraries -- users must now migrate to v1.x.x.
- Deprecated events (
ClientConnect
,DriverConnectFailed
,DriverReconnectFailed
andSsrcKnown
) have been removed. ClientConnect
must now be detected using VoiceStateUpdate messages from your main gateway library of choice.- The remainder should be replaced with
DriverDisconnect
, andDriverConnect
/DriverReconnect
- [queue] driver, queue: return track handle when adding an
Input
to the queue (#116) (@vaporox) c:bacf681 - [gateway] Gateway: Generic Shard and Twilight v0.8 Support (#109) (@FelixMcFelix) c:b4ce845
- [gateway] Gateway: Add generics to
Call
methods. (#102) (@FelixMcFelix) c:8dedf3b - [docs] Events: Document format of
VoiceData
. (#114) (@FelixMcFelix) c:806a422
- [deps] Chore: Update to twilight 0.12 (@FelixMcFelix) c:865c75f
- [deps] Chore: Update to serenity 0.11 (@FelixMcFelix) c:a85a1f0
- [deps] Update twilight support to twilight 0.11 (#132) (@Erk-) c:69339e8
- [deps] Deps: Update to Audiopus v0.3.0-rc.0 (#125) (@FelixMcFelix) c:4eb95d4
- [deps] Deps: Bump dependencies and document bumped MSRV (#119) (@GnomedDev) c:98f0d02
- [deps] Gateway: Twilight v0.10 support (#117) (@FelixMcFelix) c:fac6664
- [deps] Gateway: Twilight v0.9 support (#110) (@FelixMcFelix) c:0730a00
- [gateway] Gateway: Remove lifetime from Serenity setup trait (#103) (@FelixMcFelix) c:12c76a9
- [deps] Deps: Bump streamcatcher version -> 1.0 (#93) (@tktcorporation) c:67ad7c9
- [docs] Chore: Update link to lavalink-basic-bot.rs (#135) (@wlcx) c:f9b7e76
- [deps] Chore: Pin flume version to prevent MSRV breakage. (@FelixMcFelix) c:312457e
- [deps] Chore: Bump MSRV to 1.51.0 (@FelixMcFelix) c:05c6762
- [examples] Examples: support new Serenity Intents init (@FelixMcFelix) c:d3a40fe
- [examples] Examples: Fix serenity-next cache accesses (#99) (@FelixMcFelix) c:f1ed41e
- [driver] Driver: Prevent panic when decrypting undersized RTP packets (#122) (@FelixMcFelix) c:8791805
- [driver] Driver: Remove spin_sleep in
Mixer::march_deadline
(#124) (@GnomedDev) c:e3476e7 - [driver] Driver, Gateway: Remove tokio 0.2 support (#118) (@GnomedDev) c:f2cd8a0
- [events] Events: Remove deprecated events. (#115) (@FelixMcFelix) c:ac20764
0.2.2 — 2022-02-13
This patch release makes it easier to create new ChildContainer
s, and deprecates the ClientConnect
event. Users should instead make use of SpeakingStateUpdate
events and Discord gateway events.
Thanks to the following for their contributions:
- [events] Events: Deprecate
ClientConnect
(#112) (@FelixMcFelix) c:c464fcc
- [docs] Docs: fix ClientConnect to recommend
SpeakingStateUpdate
(@FelixMcFelix) c:652ec1f - [repo] Chore: Fix typo in CHANGELOG.md (#111) (@reiyw) c:2feadc7
0.2.1 — 2022-01-05
This patch release adds support for the yt-dlp
fork of youtube-dl
, and fixes track events to correctly fire events when multiple timed handlers are present on a track.
Thanks to the following for their contributions:
- [docs] Docs: added documentation for
yt-dlp
feature (#106) (@Lunarmagpie) c:73323e5 - [input] Input: Allows yt-dlp usage as another youtube-dl fork (#90) (@Miezhiko) c:6fcb196
- [docs] Examples: Fix unmatched quotation mark in comment. (#101) (@lajp) c:62ecfe6
- [events] Events: fix handling of multiple timed events on a single track (#96) (@FelixMcFelix) c:e25cc14
0.2.0 — 2021-08-17 — Magpie
Magpies are a common sight year-round; strong, intelligent, industrious, and loyal.
Taking after the humble magpie, this breaking release makes API changes favouring extensibility, patching some of the API rough spots, and adding resilience to some additional classes of failure.
Thanks to the following for their contributions:
- References to
songbird::{opus, Bitrate};
should now usesongbird::driver::{opus, Bitrate};
. - Custom
Inputs
(i.e.,Reader::Extension
/ExtensionSeek
) now need to implementinput::reader::MediaSource
rather than justRead
and/orSeek
. - Sources which do not support seeking should have an
unreachable!()
function body or always return an error, asMediaSource::is_seekable()
is used to gate support. - Many event handler types in
songbird::EventContext
have changed to unitenum
s, rather thanstruct
variants. - New body types are included in
songbird::events::context_data::*
. Config
structs have been made non-exhaustive; they should be initialised viaConfig::default()
.- Channel join operations may now timeout after a default 10s—which should be handled.
- Errors returned when joining a channel will now inform you whether you should try to
leave
a channel before rejoining. - Youtube-dl variants of
songbird::input::error::Error
have had their case altered fromDL
->Dl
. TrackState
sent from the driver are no longer boxed objects.DriverDisconnect
events have been introduced, which cover all disconnect events. As a result,DriverConnectFailed
andDriverReconnectFailed
are deprecated.- Tokio 0.2 support is deprecated. Related features will be removed as of Songbird 0.3.
- [driver] Driver: Automate (re)connection logic (#81) (@FelixMcFelix) c:210e3ae
- [input] Input: Add separate YouTube title and channel to Metadata (#75) (@vilgotf) c:edcd39a
- [input] Input: Implement StdError for DcaError, input::Error (#73) (@vilgotf) c:e1fc041
- [gateway] Gateway: Add debug logging around shard handling (@FelixMcFelix) c:b3caf05
- [gateway] Gateway: Add connection timeout, add
Config
to gateway. (#51) (@FelixMcFelix) c:d303e0a
- [deps] Deps: Bump async-tungstenite version -> 0.14 (@FelixMcFelix) c:47e20d6
- [docs] Chore: Update Lavalink URLs (@FelixMcFelix) c:3efe756
- [deps] Deps: Bump twilight versions -> [0.5, 0.7) (#87) (@vilgotf) c:91d7542
- [tracks] Tracks: Remove box around TrackState (#84) (@vilgotf) c:91d7542
- [deps] Deps: Bump twilight versions -> 0.5 (#79) (@vilgotf) c:d2bb277
- [input] Input, Driver: Make error messages more idiomatic (#74) (@vilgotf) c:a96f033
- [docs] Chore: Rewrite update pathway. (@FelixMcFelix) c:8000da6
- [deps] Deps: Bump DiscoRTP version -> 0.4 (@FelixMcFelix) c:7fc971a
- [deps] Deps: Bump twilight versions -> 0.4 (@FelixMcFelix) c:fc94ddb
- [deps] Deps: Bump xsalsa20poly1305 version -> 0.7 (@FelixMcFelix) c:eb22443
- [input] Input: Change all Youtube-dl functions to take
AsRef<str>
(#70) (@clarity0) c:a1ba760 - [gateway] Chore: Adapt #60, #64 in line with other breaking changes. (@FelixMcFelix) c:63d53b2
- [input] Use symphonia::io::MediaSource for Reader extensions (#61) (@james7132) c:a86898c
- [input] Input: Rename YTDL error variants for Clippy (#55) (@FelixMcFelix) c:3c7f86d
- [events] Events: Break out and non-exhaust context body structs (#54) (@FelixMcFelix) c:e7af0ff
- [driver] Driver: Move
Bitrate
import out of crate root. (#53) (@FelixMcFelix) c:1eed9dd - [deps] Deps: Bump DiscoRTP version -> 0.3 (#52) (@FelixMcFelix) c:bc952d0
- [driver] Driver: Fix incorrect leave behaviour in Drop handler (@FelixMcFelix) c:dad48ca
- [benchmarks] Fix: Update Benchmark Imports (@FelixMcFelix) c:338a042
- [lint] Chore: Clippy fixes for new lints (@FelixMcFelix) c:a1c4f07
- [fmt] Chore: Repair formatting. (@FelixMcFelix) c:cd2ade9
- [fmt] Chore: Fix clippy warnings (useless clones). (@FelixMcFelix) c:21b8383
- [gateway] Gateway: Fix repeat joins on same channel from stalling (#47) (@FelixMcFelix) c:95dd19e
0.1.8 — 2021-07-01
This release patches a metadata parsing panic caused by Ogg files with negative start times.
Thanks to the following for their contributions:
0.1.7 — 2021-06-14
This release mainly patches an occasionally spinning task, due to a critical WebSocket read error.
Thanks to the following for their code contributions:
And special thanks to @jtscuba and @JellyWX for their efforts in reproducing, debugging and diagnosing the above issue.
- [driver] Driver: Fix for busy-wait in WS thread. (#78) (@FelixMcFelix) c:b925309
0.1.6 — 2021-04-11
This patch release fixes a driver crash on leaving a channel, adds a utility method for requesting the current channel ID, and limits a sub-dependency to ensure compatibility with Rust v1.48.0.
Thanks to the following for their contributions:
- [gateway] Gateway: Introduce Call::current_channel (#60) (@DoumanAsh) c:22214a0
- [deps] Deps: Prevent MSRV breakage via
spinning_top
(#64) (@FelixMcFelix) c:a88b185 - [driver] Driver: Fix crash on
.leave()
(#63) (@FelixMcFelix) c:24d8da6
0.1.5 — 2021-03-23
This patch release adds bugfixes for incorrect seeking in Restartable sources and resource usage of inactive Driver
s, as well as some utility methods and reduced logging.
Thanks to the following for their contributions:
- [gateway] Gateway: Allow connection info to be retrieved (#49) (@FelixMcFelix) c:db79940
- [misc] Repo: Organise and document processes and architecture (#43) (@FelixMcFelix) c:1fcc8c0
- [deps] Deps: Update async-tungstenite -> 0.13 (#50) (@FelixMcFelix) c:f230b41
- [driver] Driver: Reduce logging level in general (#48) (@FelixMcFelix) c:a3f86ad
- [driver] Prevent mixer thread from waking while inactive (#46) (@FelixMcFelix) c:a9b4cb7
- [input] Fix input source timestamp pre-input argument decimal formatting (#45) (@DasEtwas) c:c488ce3
- [examples] Break reference cycle in voice storage example (#44) (@FelixMcFelix) c:b9a926c
0.1.4 — 2021-02-10
This patch release updates introduces a new event type, to expose a driver's SSRC externally on connect.
Thanks to the following for their contributions:
- [events] Events: Add
SsrcKnown
event (@FelixMcFelix) c:f3f5242 - [misc] Chore: Add missing changelog notes for 0.1.3 (@FelixMcFelix) c:0e860dc
- [deps] Deps: Update async-tungstenite -> 0.12 (@FelixMcFelix) c:a40fac3
0.1.3 — 2021-02-04
This patch release corrects the process drop logic to cleanup all chained child processes, and for Input
s to be safe to drop in async contexts. Additionally, this adds backwards-compatibility for Tokio 0.2 in serenity-based bots.
Thanks to the following for their contributions:
- [deps] Chore + Deps: Add the
log
feature to tracing (@FelixMcFelix) c:1863d39 - [driver] Library: Add compatibility for legacy Tokio 0.2 (#40) (@FelixMcFelix) c:aaab975
- [input] Fix: hand off process killing to blocking thread, await all children. (@FelixMcFelix) c:b245309
0.1.2 — 2021-01-26
This patch release fixes a PID/zombie process leak affecting bots running on Linux/Mac, and prevents youtube-dl warnings from being converted into fatal errors.
This release also changes Songbird
managers to use DashMap internally, which should substantially speed up concurrent shard accesses to the central call registry.
Thanks to the following for their contributions:
- [gateway] Gateway: Move from RwLock to DashMap (@FelixMcFelix) c:a0e905a
- [misc] Chore: Categorise v0.1.1 commits (@FelixMcFelix) c:196d5be
- [driver] Input & Driver: Fix zombie processes on Unix (#39) (@FelixMcFelix) c:fe2282c
- [input] Fix: Prevent ytdl treating warnings as errors. (@FelixMcFelix) c:658fd83
0.1.1 — 2021-01-17
This is a short patch release, fixing some error message spam under network failures, adding some new convenience event classes, as well as making it easier to cancel many event handlers.
Thanks to the following for their contributions:
- [events] Events: Add Play/Pause events. (@FelixMcFelix) c:868c44c
- [events] Events: Add (re)connect success/fail events. (@FelixMcFelix) c:cb2398f
- [driver] Driver: Add ability to clear all global event handlers. (@FelixMcFelix) c:55b8e7f
- [driver] Driver: Fix noisy errors, UDP message send failure spam. (@FelixMcFelix) c:dcb6ad9
0.1.0 — 2021-01-08 — Robin
We're very excited to publish and announce the first release of Songbird, an async Rust voice library for Discord! It's been a long time coming, but all the hard work has paid off in bringing the first version of this library to completion.
Thanks to the following for their contributions:
Songbird is based heavily on serenity's voice
module, which has served as its base design, informed many of the design changes, and paved a lot of the API/protocol research needed.
We'd also like to thank all users who have contributed to this module in the past for laying the groundwork for Songbird:
- @Arcterus
- @acdenisSK
- @Elinvynia
- @Erk-
- @FelixMcFelix
- @Flat
- @ForsakenHarmony
- @ftriquet
- @hiratara
- @indiv0
- @JellyWX
- @Lakelezz
- @LikeLakers2
- @mendess
- @nickelc
- @nitsuga5124
- @perryprog
- @Prof-Bloodstone
- @Proximyst
- @Roughsketch
- @s0lst1ce
- @Sreyas-Sreelal
- @tarcieri
- @vivian
- [tracks] Tracks: Add TypeMap to Handles. (@FelixMcFelix) c:d42e09f
- [tracks] Tracks: Allow custom UUID setting (#33) (@peppizza) c:873458d
- [input] Input: Allow Restartable sources to be lazy (@FelixMcFelix) c:03ae0e7
- [driver] Driver, Input: Performance & Benchmarks (#27) (@FelixMcFelix) c:504b8df
- [input] Metadata: Add source_url and thumbnail fields (#28) (@saanuregh) c:700f20d
- [tracks] TrackHandle: add metadata field (#25) (@peppizza) c:57df3fe
- [tracks] TrackQueue: Add current_queue method (#16) (@peppizza) c:69acea8
- [tracks] TrackQueues: Convenience methods and extension (#7) (@FelixMcFelix) c:de65225
- [docs] Docs: Add a dependencies section in the README (#2) (@acdenisSK) c:047ce03
- [input] Offer youtube-dlc as an alternative to youtube-dl (#1) (@peppizza) c:6702520
- [misc] Attempt CI similar to serenity (@FelixMcFelix) c:c5ce107
- [misc] Add the ISC license (@acdenisSK) c:a778d24
- [examples] Move examples from the Serenity repository (@acdenisSK) c:f5bf54a
- [misc] Add a
.gitignore
file as songbird is in its own repository (@acdenisSK) c:ec7f5bc - [driver] Implement Songbird driver configuration (#1074) (@FelixMcFelix) c:8b7f388
- [docs] Document intents for Songbird (#1061) (@FelixMcFelix) c:38a55da
- [driver] Voice Rework -- Events, Track Queues (#806) (@FelixMcFelix) c:7e4392a
- [misc] Chore: Bump to published twilight. (@FelixMcFelix) c:7d767d2
- [misc] Chore: Bump to published serenity. (@FelixMcFelix) c:53ab9da
- [misc] Songbird: Tokio 1.0 (#36) (@FelixMcFelix) c:f05b741
- [docs] Docs: Warn about twilight task deadlock (@FelixMcFelix) c:c0d3cb3
- [misc] Deps: Patch flume. (@FelixMcFelix) c:2fc88a6
- [input] Input: Json parsing errors now contain the parsed text (#31) (@Maspenguin) c:8d6bd4f
- [driver] Driver, Tracks: Cleanup of leaky types (#20) (@FelixMcFelix) c:f222ce9
- [docs] Docs: Move to new intra-doc links, make events non-exhaustive. (#19) (@FelixMcFelix) c:94157b1
- [input] Input: Make restartable sources fully async. (#15) (@FelixMcFelix) c:2da5901
- [misc] Lint: Clippy warning cleanup (#8) (@peppizza) c:cb7d8cc
- [docs] Docs: describe
youtube-dlc
feature (@FelixMcFelix) c:45b1fb1 - [misc] Some updated links, move to current/next branches. (@FelixMcFelix) c:09da85b
- [misc] Remove mentions of versions to Serenity git dependencies (@acdenisSK) c:4a897a7
- [misc] Update
Cargo.toml
to reflect the separation of songbird from Serenity's repository (@acdenisSK) c:6724655 - [misc] Update versions for twilight and serenity-voice-model in songbird (#1075) (@FelixMcFelix) c:868785b
- [driver] Driver: Handle receiving large non-standard packets (#23) (@FelixMcFelix) c:9fdbcd7
- [misc] Fix: Remove serenity default features (#18) (@Maspenguin) c:1ada46d
- [driver] Fix: Use correct tokio features for driver-only mode (@FelixMcFelix) c:a9f8d6c
- [misc] CI round 2 (@FelixMcFelix) c:35d262d
- [examples] Fix links in the README regarding examples (@acdenisSK) c:4f5b767
- [driver] Handle Voice close codes, prevent Songbird spinning WS threads (#1068) (@FelixMcFelix) c:26c9c91