Queue Mode, Bass Boost, Position Saving, and Cache Split

[nunotfc]

Overview
This PR introduces queue-based playback, optional resume positions, a new bass boost control, cache storage split into multiple files, and several new commands/settings. It also includes fixes for YouTube search compatibility and improved status metadata handling, and chained commands.

Key Features

• Queue playback mode (m q) that plays items in FIFO order, integrated into player logic (next/end-file behavior).
• Queue management command (q) for listing, adding current track, removing by index, and clearing.
• Play/search behavior updated to enqueue in queue mode (p/u) without interrupting current playback.
• Optional position saving (ep) for seekable tracks; recents resume from saved position on r N.
• Bass boost command (bb) with 0–100 level scale, saved to config and applied at startup.
• User channel move command (go) allowing users to bring the bot into their channel (guarded by back_to_root_channel).
• Mute toggle command (mu) using mpv mute property.
• Time command (t) for elapsed/total playback duration and remaining time via tr.

Commands Added/Changed
User commands:

• t: show elapsed/total time for current playback.
• tr: show remaining time for current playback.
• ep: toggle position saving (enable_positions in config).
• bb [LEVEL]: set bass boost 0–100, bb shows current level.
• mu: toggle mute.
• q: queue management (q list, q + add current, q -N remove, q c clear).
• p: when in queue mode, search first result and enqueue; starts playback if idle.
• u: when in queue mode, enqueue URL/stream/file; starts playback if idle.
• m: adds queue mode (q) alongside st/rt/tl/rtl/rnd.
• go: move bot to user’s channel (respects back_to_root_channel setting).

Admin commands:

• sm: toggle metadata display in status messages.
• br: toggle allowing users to move bot to their channels.
• q removed for quit; admin quit now qq/quit.
• cc: now supports q (queue) and p (saved positions).

Playback/Player Changes

• Mode.Queue added to player enums and queue-specific logic in next/previous/end-file.
• Queue playback consumes items and continues automatically until empty.
• Position saving on pause/stop and before switching tracks if enabled.
• Resume positions stored on Track objects and applied on recents playback via delayed seek.
• Bass boost now uses mpv audio filter property (af) with a 0–100 scale mapped to gain -30..30.

Config and Migrations

• config version bumped to v3.
• General config additions:
  • back_to_root_channel
  • showmeta
  • enable_positions (default false)
• Player config addition:
  • bass_boost_level
• Config migrator adds missing fields for existing configs.

Cache Storage Changes

• Cache format version bumped to v4.
• Cache split into multiple files under a cache directory:
  • recents.dat
  • favorites.dat
  • queue.dat
  • meta.json
• Legacy single-file cache is still readable; split is written on save.
• Cache locking removed in favor of simpler IO and separate files.

Status/Metadata

• Status text now respects showmeta setting:
  • When enabled, shows track name/URL.
  • When disabled, uses generic “Active audio playback” / “Paused audio playback.”
• Auto return to root channel when alone and back_to_root_channel is enabled.

Service Updates

• YouTube service patches:
  • Ignore deprecated httpx “proxies” kwarg on httpx>=0.28.
  • Avoid TypeError when channel id is None in youtubesearchpython.
• Search now guards against errors when building Track objects.

Tools

• TeamTalk SDK downloader improved to select a stable 5.15 version when available, with better logging and fallback to latest version.

Files Added

• bot/services/patches.py (YouTube compatibility patches)

Notes/Behavioral Changes

• Queue mode auto-starts at startup if configured and queue has items.
• Admin quit command is now qq/quit to free q for queue management.

Chained Commands
It is now possible to chain multiple commands using the | separator in a single message.
Example: "t | v 30" shows the playback time and sets the volume to 30.
The processing splits the message by |, executes each command sequentially, and sends the responses.

Testing

• No automated tests added. Manual validation recommended for:
  • Queue playback flow (p/u in queue mode, q management, m q).
  • Position saving and resuming with r N.
  • Bass boost level set/clear behavior.
  • Status text with showmeta on/off.