Skip to content

Releases: code-xon/sonora

🐛 Sonora v1.2.8 — Stability Patch & Team Update

06 Dec 09:12
@ramkrishna-dev ramkrishna-dev
v1.2.8
0f17c13

Choose a tag to compare

View all tags
🐛 Sonora v1.2.8 — Stability Patch & Team Update Latest
Latest

🐛 Sonora v1.2.8 — Stability Patch & Team Update

Release Type: Patch / Stable
Package: sonora
Owner: code-xon
Lead Developer: Ramkrishna
New Core Member: Manjunath (manjunathh-dev)
Contact: ramkrishna@code-xon.fun

🎉 Overview

Sonora v1.2.8 is a lightweight stability and polish patch built on top of the powerful v1.2.7 release. This update focuses on bug fixes, internal reliability improvements, developer experience refinements, and minor performance tuning.

This version also marks an important milestone for the project with the addition of a new core team member: Manjunath (manjunathh-dev) 🎉

As always, Sonora remains a pure Python library — no SaaS, no platform, no dashboards.

✅ What’s Fixed & Improved (v1.2.8 Patch)

🔧 Core Stability

  • Fixed rare async task cancellation leak during:

    • autoplay shutdown
    • node reconnects

  • Improved background task cleanup on:

    • player.destroy()
    • client.shutdown()

  • Fixed edge-case deadlock in smart queue reorder logic

🐛 Plugin System Fixes

  • Fixed plugin hot-reload crash under high load

  • Improved plugin dependency resolution error messages

  • Fixed permission scope mismatch in:

    • autoplay.read
    • filters.write

  • Improved plugin unload safety during snapshot restore

🎵 Autoplay & Queue Refinements

  • Fixed autoplay fallback not triggering in rare cold-start states
  • Improved smart shuffle randomness distribution
  • Reduced duplicate-track probability under rapid skip conditions
  • Improved skip-fatigue sensitivity tuning

⚡ Performance Micro-Optimizations

  • Reduced transient memory spikes during:

    • large queue imports
    • snapshot restore

  • Improved event dispatch batching under heavy playback load

🛡 Security Hardening

  • Strengthened validation on encrypted credential vault loading
  • Improved sandbox escape detection for plugins
  • Safer deserialization defaults for offline simulator packets

🧰 CLI Polish

  • Improved formatting for:

    • sonoractl doctor
    • sonoractl queue inspect

  • Added clearer status messages for:

    • snapshot save
    • snapshot restore

👋 Team Update

We’re excited to officially welcome:

✅ Manjunath (manjunathh-dev) — Core Contributor

Manjunath joins the project focusing on:

  • Core stability improvements
  • Developer tooling
  • Testing & CI hardening

Welcome to the code-xon & Sonora team! 🎉

📦 Installation / Upgrade

pip install -U sonora

🧭 Compatibility

  • Fully backward compatible with:

    • v1.2.7
    • v1.2.0
    • v1.1.x

  • No breaking API changes

  • Safe patch upgrade

✅ Final Guarantees

Sonora v1.2.8 is:
✔ Stable
✔ Patch-safe
✔ Backward compatible
✔ Performance-refined
✔ Security-hardened
✔ Plugin-safe
✔ Autoplay-proven
✔ Queue-intelligent
✔ CI-ready & production-ready

🙌 Acknowledgements

Thanks to:

  • All community testers
  • Plugin developers
  • Security reviewers
  • The Lavalink ecosystem
  • And a big welcome again to Manjunath (manjunathh-dev) 🚀

Sonora v1.2.8 is a clean refinement release — tightening the engine while keeping all the power of v1.2.7 intact. 🔥

Full Changelog: v1.2.7...v1.2.8

Assets 2
Loading

🚀 Sonora v1.2.7 — Advanced Power Release (v1.3.0 Backport + Performance Overdrive)

05 Dec 01:46
@ramkrishna-dev ramkrishna-dev
v1.2.7
5f4beba

Choose a tag to compare

View all tags
🚀 Sonora v1.2.7 — Advanced Power Release (v1.3.0 Backport + Performance Overdrive)

🚀 Sonora v1.2.7 — Advanced Power Release (v1.3.0 Backport + Performance Overdrive)

Release Type: Stable (Advanced / LTS-Grade)
Package: sonora
Owner: code-xon
Lead Developer: Ramkrishna
Contact: ramkrishna@code-xon.fun

🎉 Overview

Sonora v1.2.7 is the most powerful, secure, and performance-optimized release in the v1.x series. This version is a major backport release, bringing all planned v1.3.0 features directly into the v1.2.x line, along with multiple developer-experience and enterprise-grade enhancements.

This release is designed as a long-term powerhouse build for users who want:
✅ Maximum stability
✅ Maximum performance
✅ Advanced security
✅ Deep developer tooling

As always, Sonora remains a pure Python library — no platform behavior, no SaaS, no dashboards.

✅ Core Foundation (From v1.2.0 Stable)

🔌 Plugin System (Fully Stable)

  • Stable Plugin API v1

  • Safe lifecycle:

    • on_load
    • on_enable
    • on_disable
    • on_unload

  • Plugin sandboxing & crash isolation

  • Plugin dependency resolution

  • Version compatibility enforcement

  • Permission scopes:

    • track.read
    • track.modify
    • filters.write
    • autoplay.read

  • Signed plugin verification (optional)

  • Hot reload (dev mode)

  • Plugin permission firewall

🎛 Built-in Filter Plugins

  • BassBoost

  • Nightcore

  • Reverb

  • Equalizer Presets:

    • Rock
    • Pop
    • EDM
    • Classical

🧠 Smart Autoplay Engine (Stable)

  • Context-aware recommendations
  • Cold-start fallback playlists
  • Multi-strategy weighted scoring
  • Track / Queue / Infinite autoplay modes
  • Fully cancellable background tasks
  • Allowlist & denylist enforcement

🗂 Intelligent Queue System (Stable)

  • Session queue memory
  • Smart shuffle (anti-repeat)
  • Skip fatigue detection
  • Track lifespan scoring
  • Optional adaptive queue reordering
  • Queue heatmap analytics
  • Deterministic ordering guarantees

🆕 Backported from v1.3.0 → Now in v1.2.7

🔐 Enterprise-Grade Security

  • Encrypted Lavalink credential vault
  • AES-based secret storage
  • Autoplay source allowlist & denylist
  • Runtime exploit guardrails
  • Secure deserialization layer
  • Zero implicit network calls
  • Plugin execution firewall

🧰 Official High-Level SDKs

  • SonoraMusicBotSDK

    • High-level bot command wrappers
    • Automatic queue & filter binding
    • Smart autoplay bootstrap

  • SonoraVoiceSDK

    • Voice-only Lavalink control
    • Streaming-only mode
    • Data-only monitoring mode

💾 Session Snapshot & Restore

  • Full save & restore of:

    • Queue
    • Filters
    • Autoplay state
    • Playback history

  • Auto snapshot on crashes

  • Manual snapshot API

  • Restore after restart or redeploy

🧪 Offline Lavalink Protocol Simulator

  • Full fake node for offline development

  • CI & fuzz testing support

  • Packet replay engine

  • Fault injection:

    • Packet loss
    • Latency
    • Corrupted frames

🧠 Advanced Mocking Engine

  • Deterministic mocks for:

    • Nodes
    • Players
    • Queues
    • Autoplay engines

  • Scenario-based test generation

⚡ Performance Overdrive Mode (v1.2.7 Exclusive)

  • Lock-free async queue engine
  • Zero-copy payload routing
  • Ultra-fast track serialization
  • Adaptive backpressure control
  • Event fan-out parallelization
  • Jitter-based ultra-fast reconnects
  • CPU-aware node load balancing
  • Latency-aware routing
  • Automatic memory trimming
  • Reduced garbage-collection pressure

🧠 “Nice Features” for Developers

  • Built-in runtime performance profiler
  • JSON structured logging mode
  • Trace-level playback wiretap
  • Player decision introspection
  • Queue simulation sandbox
  • Developer diagnostics API
  • Playback timeline debugger
  • Reproducible playback replay engine
  • Plugin marketplace-ready API hooks (no storefront)

🧰 Expanded Enterprise CLI

  • sonoractl plugin list

  • sonoractl plugin enable

  • sonoractl plugin disable

  • sonoractl plugin info

  • sonoractl autoplay status

  • sonoractl autoplay strategy

  • sonoractl queue inspect

  • sonoractl doctor

  • sonoractl profile

  • sonoractl snapshot save

  • sonoractl snapshot restore

  • sonoractl node benchmark

  • sonoractl debug wiretap

🧪 Testing & Quality

  • 92%+ automated test coverage

  • Extreme stress testing:

    • 100k+ track queues
    • Autoplay storms
    • Multi-node failure cascades

  • Fuzz testing:

    • Protocol packets
    • Plugin configs

  • Memory leak detection

  • CPU pressure validation

  • Deterministic shuffle verification

  • Snapshot restore correctness proofs

📦 Installation

pip install -U sonora

🧭 Migration Notes

  • Fully backward compatible with:

    • v1.2.0
    • v1.1.x

  • No breaking Plugin API changes

  • All new security & SDK features are opt-in

  • Snapshot system is disabled by default

✅ Final Guarantees

Sonora v1.2.7 is:
✔ Pure Python
✔ Enterprise-grade
✔ Ultra-performant
✔ Secure by default
✔ Plugin-first
✔ Autoplay-stable
✔ Queue-intelligent
✔ Snapshot-enabled
✔ SDK-powered
✔ CI-ready & production-ready
✔ No SaaS
✔ No dashboards
✔ No platform behavior

🙌 Acknowledgements

Special thanks to:

  • All long-term beta testers
  • Security reviewers
  • SDK contributors
  • Plugin ecosystem developers
  • The Lavalink community
  • The code-xon community

Sonora v1.2.7 represents the most complete and powerful form of Sonora in the v1.x era — combining stability, intelligence, security, and performance into a single release. 🚀

Full Changelog: v1.2.0...v1.2.7

Loading

🚀Sonora v1.2.0-beta — Smart Autoplay & Intelligent Queue (Experimental)

05 Dec 00:55
@ramkrishna-dev ramkrishna-dev
v1.2.0-beta
cda916b

Choose a tag to compare

View all tags
🚀Sonora v1.2.0-beta — Smart Autoplay & Intelligent Queue (Experimental)

🚀 Sonora v1.2.0-beta — Smart Autoplay & Intelligent Queue (Experimental)
Release Type: Beta / Pre-Release
Package: sonora
Owner: code-xon
Lead Developer: Ramkrishna
Contact: ramkrishna@code-xon.fun

🔥 Overview

Sonora v1.2.0-beta introduces the next evolution of the library with the first implementation of Smart Autoplay and Intelligent Queue Systems, while fully preserving the production-stable Plugin System from v1.1.0.

This release is intended for:
✅ Test environments
✅ Advanced developers
✅ Staging deployments
⚠️ Not yet recommended for mission-critical production

All autoplay and queue intelligence features are clearly marked as EXPERIMENTAL (BETA).

✅ What’s Carried Forward (Stable from v1.1.0)

🔌 Plugin System (Production-Ready)

  • Stable Plugin API v1 (no breaking changes)

  • Safe plugin lifecycle:

    • on_load
    • on_enable
    • on_disable
    • on_unload

  • Plugin sandboxing & crash isolation

  • Dependency resolution & version enforcement

  • Permission scopes:

    • track.read
    • track.modify
    • filters.write
    • autoplay.read

🎛 Built-in Filter Plugins (Stable)

  • BassBoost

  • Nightcore

  • Reverb

  • Equalizer Presets:

    • Rock
    • Pop
    • EDM
    • Classical

🧰 CLI Plugin Tools

  • sonoractl plugin list
  • sonoractl plugin enable
  • sonoractl plugin disable
  • sonoractl plugin info

🛡 Plugin Security

  • Restricted imports
  • Optional signed plugin verification
  • Plugin memory safety checks
  • Infinite startup loop protection

🧠 New in v1.2.0-beta (Experimental Features)

🎵 Smart Autoplay Engine (BETA)

  • Automatic track fetching when the queue ends

  • Context-aware recommendations:

    • Similar artist
    • Similar genre
    • Popularity fallback

  • Cold-start fallback playlist system

  • Multi-strategy autoplay engine

  • Loop-aware autoplay modes:

    • Track loop
    • Queue loop
    • Infinite autoplay

🗂 Intelligent Queue System (BETA)

  • Session-based queue memory
  • Smart shuffle (prevents recent repeats)
  • Queue similarity scoring
  • Skip fatigue detection
  • Track lifespan scoring
  • Optional adaptive queue reordering
  • Queue heatmap statistics per session

🔌 Experimental Autoplay Events

  • on_autoplay_fetch
  • on_autoplay_success
  • on_autoplay_fail
  • on_smart_shuffle
  • on_queue_reorder

⚙ Autoplay Configuration

  • Configurable via:

    • Python dict
    • YAML
    • Environment variables

🧪 Testing & Stability

  • 50+ new autoplay & queue intelligence tests
  • Plugin + autoplay interaction tests
  • Smart shuffle randomness verification
  • Skip fatigue stress testing
  • Queue reorder correctness validation

Target coverage: ≥ 85% (in progress for beta)

🆕 New CLI Commands

  • sonoractl autoplay status
  • sonoractl autoplay strategy
  • sonoractl queue inspect

⚠️ Beta Warnings

  • Autoplay strategies may change before stable v1.2.0
  • Queue intelligence heuristics are still being tuned
  • API additions in this beta may receive breaking changes before final release

📦 Installation

pip install sonora==1.2.0b0

🧭 What’s Next

The next milestone is Sonora v1.2.0 (Stable), focused on:

  • Performance optimizations
  • Node-level load balancing
  • Faster queue serialization
  • Reduced memory pressure
  • Autoplay system stabilization

🙌 Acknowledgements

Thanks to:

  • Early beta testers
  • Plugin system contributors
  • The Lavalink ecosystem
  • The code-xon community

✅ This release keeps Sonora:
✔ A pure Python library
✔ No SaaS
✔ No dashboards
✔ No cloud dependencies
✔ No platform behavior

Sonora v1.2.0-beta is all about intelligence, not complexity.

Full Changelog: v1.1.0...v1.2.0-beta

Loading

🚀 Sonora v1.2.0 — Smart Autoplay & Intelligent Queue (Stable Release)

05 Dec 01:38
@ramkrishna-dev ramkrishna-dev
v1.2.0
cda916b

Choose a tag to compare

View all tags
🚀 Sonora v1.2.0 — Smart Autoplay & Intelligent Queue (Stable Release)

🚀 Sonora v1.2.0 — Smart Autoplay & Intelligent Queue (Stable Release)

Release Type: Stable
Package: py-sonora
Owner: code-xon
Lead Developer: Ramkrishna
Contact: ramkrishna@code-xon.fun

🎉 Overview

Sonora v1.2.0 marks a major production milestone for the project. This release fully stabilizes the Smart Autoplay Engine and Intelligent Queue System that debuted in the beta series, while preserving the rock-solid Plugin System from v1.1.0.

With v1.2.0, Sonora officially becomes a high-performance, intelligent, and extensible audio library ready for real-world production workloads.

This is a pure Python library release — no platforms, no dashboards, no SaaS.

✅ What’s Included (Stable Feature Set)

🔌 Plugin System (Production-Ready)

  • Stable Plugin API v1 with backward compatibility

  • Safe lifecycle:

    • on_load
    • on_enable
    • on_disable
    • on_unload

  • Plugin sandboxing & crash isolation

  • Dependency resolution & version enforcement

  • Permission scopes:

    • track.read
    • track.modify
    • filters.write
    • autoplay.read

  • Optional signed plugin verification

  • Hot-reload support (dev mode)

🎛 Built-in Filter Plugins (Stable)

  • BassBoost

  • Nightcore

  • Reverb

  • Equalizer Presets:

    • Rock
    • Pop
    • EDM
    • Classical

🧠 Smart Autoplay Engine (Now Fully Stable)

  • Automatic track selection when the queue ends

  • Context-aware recommendations:

    • Similar artist
    • Similar genre
    • Popularity-based fallback

  • Cold-start fallback playlist system

  • Multi-strategy weighted scoring engine

  • Loop-aware autoplay modes:

    • Track loop
    • Queue loop
    • Infinite autoplay

  • Fully cancellable autoplay tasks

  • Provider rate-limit protection

  • Allowlist & denylist enforcement

🗂 Intelligent Queue System (Stable)

  • Session-based queue memory
  • Smart shuffle (prevents recent repeats)
  • Queue similarity scoring
  • Skip fatigue detection
  • Track lifespan scoring
  • Optional adaptive queue reordering (OFF by default)
  • Queue heatmap statistics
  • Deterministic ordering guarantees

⚡ Performance & Reliability Improvements

  • Lock-free async queue architecture
  • High-speed track serialization
  • Adaptive backpressure handling
  • Reduced garbage-collection pressure
  • Zero-stall autoplay transitions
  • Ultra-fast node reconnection with jitter backoff
  • CPU-aware node load balancing

🧰 Expanded CLI Tooling

  • sonoractl plugin list
  • sonoractl plugin enable
  • sonoractl plugin disable
  • sonoractl plugin info
  • sonoractl autoplay status
  • sonoractl autoplay strategy
  • sonoractl queue inspect
  • sonoractl doctor
  • sonoractl profile

🔐 Security Enhancements

  • Encrypted Lavalink credential storage
  • Plugin sandbox execution
  • Autoplay source restrictions
  • Zero implicit network calls
  • Permission firewall across plugins & autoplay

🧪 Testing & Quality

  • 90%+ automated test coverage
  • Autoplay failover testing
  • Queue reorder correctness validation
  • Plugin + autoplay permission tests
  • Multi-node failure stress testing
  • Deterministic shuffle verification

📦 Installation

pip install -U sonora

🧭 Migration Notes

  • Fully backward compatible with v1.1.0
  • No breaking Plugin API changes
  • Autoplay & Smart Queue now promoted from beta to stable

✅ Final Guarantees

Sonora v1.2.0 is:
✔ Pure Python
✔ Production-ready
✔ Plugin-first
✔ Autoplay-stabilized
✔ Queue-intelligent
✔ High-performance
✔ Secure by default
✔ Free of SaaS & platform dependencies

🙌 Acknowledgements

Huge thanks to:

  • All beta testers
  • Plugin contributors
  • The Lavalink ecosystem
  • The code-xon community

Sonora v1.2.0 is the foundation for all future advanced releases. Stability, intelligence, and performance now ship by default. 🚀

Full Changelog: v1.1.0...v1.2.0

Loading

🔌 Sonora v1.1.0 — Plugin System (Stable Release)

04 Dec 16:50
@ramkrishna-dev ramkrishna-dev
v1.1.0
f4d1648

Choose a tag to compare

View all tags
🔌 Sonora v1.1.0 — Plugin System (Stable Release)

🔌 Sonora v1.1.0 — Plugin System (Stable Release)

Release Type: Stable
Owner: code-xon
Lead Developer: Ramkrishna
Contact: ramkrishna@code-xon.fun

🎉 Overview

We’re proud to announce the Sonora v1.1.0 stable release, bringing the official production-ready Plugin System to Sonora.

This release finalizes and stabilizes the features introduced during v1.1.0-beta, delivering a secure, extensible, and developer-friendly way to extend Sonora with custom logic, filters, and integrations — without modifying the core library.

This marks Sonora’s transition from a powerful audio engine to a fully extensible audio framework.

✨ What’s New

🔌 Stable Plugin System (Production-Ready)

  • Finalized Plugin API v1 (guaranteed backward compatibility until v2.x)

  • Official PluginBase lifecycle:

    • on_load()
    • on_enable()
    • on_disable()
    • on_unload()

  • Safe plugin auto-discovery from:

    • sonora/plugins/
    • user-defined plugin paths

  • Plugin configuration via:

    • JSON
    • YAML

  • Plugin crash isolation (plugin failure will NOT take down your bot)

  • Plugin dependency resolution

  • Version compatibility enforcement

  • Plugin permission scopes:

    • track.read
    • track.modify
    • filters.write
    • autoplay.read

🎛 Built-in Audio Filter Plugins (Stable)

  • BassBoost

  • Nightcore

  • Reverb

  • Equalizer Presets:

    • Rock
    • Pop
    • EDM
    • Classical

All filters are now:

  • ✅ Fully tested
  • ✅ Hot-switchable at runtime
  • ✅ Safe for production use

🧰 CLI Improvements

New plugin management commands:

sonoractl plugin list
sonoractl plugin enable <plugin>
sonoractl plugin disable <plugin>
sonoractl plugin info <plugin>
  • Plugin state persistence between restarts
  • Human-readable plugin diagnostics

🛡 Security & Stability Enhancements

  • Plugin sandboxing using restricted import layers
  • Optional signed plugin verification
  • Automatic plugin crash recovery
  • Memory safety checks for plugin lifecycles
  • Protection against malicious infinite startup loops

🧪 Testing & Quality

  • 40+ dedicated plugin-related unit tests

  • Regression test coverage for:

    • Plugin lifecycle
    • Permission enforcement
    • Dependency resolution
    • Runtime enable/disable

  • Improved test utilities for plugin mocking

📚 Documentation

  • New Plugins Guide (Stable)
  • Plugin authoring tutorial
  • Security & permission model documentation
  • CLI plugin management guide

🔄 Migration from v1.1.0-beta

If you used the beta:

  • ✅ Most plugins remain compatible
  • ⚠️ Plugin config schema now strictly validated
  • ⚠️ Some internal method names have been normalized
  • ✅ Official stable namespaces must now be used

A full migration guide is included in the documentation.

🛠 Bug Fixes

  • Fixed plugin hot-reload memory leaks (dev mode)
  • Fixed plugin dependency resolution-edge cases
  • Fixed filter stacking order inconsistency
  • Fixed rare plugin unload deadlock
  • Improved error messages during plugin boot failure

💥 Breaking Changes

  • ❗ Experimental beta plugin APIs have been removed
  • ❗ Direct internal imports from sonora.plugins._internal are no longer supported

📦 Installation

pip install -U sonora

🧭 What’s Next

The next milestone is v1.2.0-beta, introducing:

  • 🧠 Smart Autoplay
  • 🗂 Queue Intelligence
  • 🎵 Context-aware recommendations
  • 📊 Playback behavior analysis

🙌 Acknowledgements

Special thanks to:

  • Early beta testers
  • Plugin API contributors
  • The Lavalink ecosystem
  • The code-xon community

Full Changelog: v1.0.0...v1.1.0

Loading

🎶 Sonora v1.0.0 — First Stable Release

03 Dec 15:33
@ramkrishna-dev ramkrishna-dev
v1.0.0
3fc3777

Choose a tag to compare

View all tags
🎶 Sonora v1.0.0 — First Stable Release

🎶 Sonora v1.0.0 — First Stable Release

Owner: code-xon
Lead Developer: Ramkrishna
Contact: ramkrishna@code-xon.fun
Release Date: 2025-3-12

🚀 Overview

We are excited to announce the first official stable release of Sonora, a next-generation Python Lavalink client designed for performance, stability, modularity, and a premium developer experience.

Sonora is built from the ground up to be the most powerful and flexible audio engine for Discord bots and related audio applications. It surpasses existing ecosystems by introducing intelligent node management, advanced playback systems, extensible plugin architecture, and an unmatched developer tooling experience.

This is v1.0.0 — the foundation for the entire Sonora ecosystem.

✨ Key Features

🎵 Advanced Playback Engine

  • Fully asynchronous, zero-lag playback
  • Lavalink v3 & v4 protocol support
  • Gapless playback
  • Smart autoplay with pluggable recommendation providers
  • Track preloading for instant transitions
  • Queue system with jump, shuffle, loop, history, and filtering
  • Advanced audio filters: EQ, Reverb, BassBoost, Nightcore, etc.

⚙️ Node & Cluster Management

  • Multi-node load balancing
  • Automatic node failover + reconnection
  • Health-check pings & metrics
  • Node affinity (guild-aware selection)
  • TLS support
  • Crash recovery & session resume

🔌 Plugin System

  • Official plugin API for search, metadata, filters, analytics

  • Included plugins:

    • YouTube
    • Spotify
    • SoundCloud
    • Apple Music (metadata)
    • Lyrics provider

  • Developers can create and register custom plugins easily

💬 Typed Event System

  • 50+ strongly-typed, asynchronous events
  • Track lifecycle events
  • Node lifecycle events
  • Autoplay events
  • Voice state & voice server update helpers

📚 Discord Library Integrations

  • discord.py
  • nextcord
  • pycord
  • hikari (optional support)
  • Ready-to-run examples included

🧰 CLI Tools (sonoractl)

  • doctor — environment checks
  • debug — live player and node monitoring
  • create-bot — instant bot scaffolding
  • test-node — quick Lavalink diagnostics
  • show-stats — resource usage overview

📊 Monitoring & Observability

  • Optional Prometheus metrics exporter
  • JSON structured logging
  • Node/player health dashboards
  • Webhook alerts for failures

🧪 Testing & Quality

  • 90%+ test coverage
  • 400+ unit tests
  • 50+ integration tests
  • Mypy strict typing
  • Linting: ruff + black + flake8
  • Continuous integration via GitHub Actions

📦 Packaging & Distribution

  • Available as a PyPI-ready package
  • pyproject.toml with full metadata
  • py.typed for type distribution
  • Dockerfile + docker-compose setup included

📚 Documentation

Powered by MkDocs Material, including:

  • Quickstart
  • Installation
  • Concepts
  • API Reference
  • Plugin Development Guide
  • Node Configurations
  • Migration guides (from Wavelink, Lavalink.py, Riffy, etc.)

🛠️ Breaking Changes (N/A for v1.0.0)

This is the first release; no breaking changes exist.

🧩 Known Issues

  • Some plugins (Apple Music, advanced lyrics providers) rely on third-party APIs and may require credentials.
  • Autoplay recommendation system may behave differently based on node configuration.

🙌 Acknowledgements

Special thanks to:

  • The Lavalink project
  • Discord.py & related library maintainers
  • All early testers and contributors
  • The code-xon team

🔗 Install Sonora

pip install sonora-musicpy

🎉 Closing Notes

This is just the beginning of the Sonora ecosystem — future releases will include:

  • Web dashboard
  • Advanced plugins
  • Auto-sharding support
  • Streaming engine improvements
  • Cloud node orchestration tools

Thank you for being part of the journey.
If you build something with Sonora, share it with the community!

Full Changelog: https://github.com/code-xon/sonora/commits/v1.0.0

Loading