⚡ feat (release 🤖): Stelle v3.8 🎉

Author: EvilG-MC

.env.example

@@ -27,13 +27,18 @@ ERRORS_WEBHOOK = "the-supremacy-is-here"
 REDIS_HOST = "for-rex-lapis"
 
 # The redis server port.
-# Replace the "0212" with your own redis server port.
-REDIS_PORT = 0212
+# Replace the "1202" with your own redis server port.
+# Can you guess what this represents? (Hint: cocogoat)
+REDIS_PORT = 1202
 
 # The redis server password.
 # Replace the "no-touchin!" with your own redis server password.
 REDIS_PASSWORD = "no-touchin!"
 
+# The redis server username.
+# Replace the "default" with your own redis server username.
+REDIS_USERNAME = "default"
+
 #
 # Aaand... That's all, you can add whatever you want.
 #

.gitignore

@@ -4,4 +4,5 @@ logs
 generated
 cache
 
+local.config.*
 .env

.husky/pre-commit

@@ -1 +1 @@
-pnpm tsc --noEmit && pnpm lint-staged
+pnpm typecheck && pnpm lint-staged

README.md

@@ -8,7 +8,7 @@
 
 Stelle was created with the purpose of exploring, learning and using the possibilities offered by [`Seyfert`](https://github.com/tiramisulabs/seyfert) a new library to interact with the Discord API.
 
-[![Invite](https://img.shields.io/badge/Add%20the%20bot-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/oauth2/authorize?client_id=1241085977544359968&permissions=36793344&integration_type=0&scope=bot+applications.commands)
+[![Invite](https://img.shields.io/badge/Add%20the%20bot-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/oauth2/authorize?client_id=1241085977544359968&permissions=36793408&integration_type=0&scope=bot+applications.commands)
 [![Server](https://img.shields.io/badge/Support%20Server-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/4JmKY8wgB6)
 
 ![Stelle](https://i.imgur.com/cDBZPmd.png)

assets/application.yml

@@ -1,6 +1,8 @@
 server:
   port: 2333
   address: 0.0.0.0
+  http2:
+    enabled: false # Whether to enable HTTP/2 support
 lavalink:
   server:
     sources:
@@ -12,7 +14,7 @@ lavalink:
       vimeo: true
       nico: true
       http: false # warning: keeping HTTP enabled without a proxy configured could expose your server's IP address.
-      local: false
+      local: true
     filters: # All filters are enabled by default
       volume: true
       equalizer: true
@@ -28,141 +30,159 @@ lavalink:
     bufferDurationMs: 225
     frameBufferDurationMs: 5000
     youtubePlaylistLoadLimit: 3
-    opusEncodingQuality: 5
-    resamplingQuality: MEDIUM
+    opusEncodingQuality: 10
+    resamplingQuality: HIGH
     trackStuckThresholdMs: 5000
     playerUpdateInterval: 3
     useSeekGhosting: true
     youtubeSearchEnabled: true
     soundcloudSearchEnabled: true
     gc-warnings: true
   plugins:
-    - dependency: "com.github.topi314.lavasrc:lavasrc-plugin:4.3.0" # LavaSrc - extra sources like deezer, spotify, etc. https://github.com/topi314/LavaSrc
-      snapshot: false
-    - dependency: "com.github.topi314.lavasearch:lavasearch-plugin:1.0.0" # https://github.com/topi314/LavaSearch
+    - dependency: "com.github.topi314.lavasrc:lavasrc-plugin:4.7.2" # https://github.com/topi314/LavaSrc
       snapshot: false
+    - dependency: "com.github.topi314.lavasearch:lavasearch-plugin:2edfc1b" # https://github.com/topi314/LavaSearch
+      snapshot: true
     - dependency: "com.dunctebot:skybot-lavalink-plugin:1.7.0" # https://github.com/DuncteBot/skybot-lavalink-plugin
       snapshot: false
-    - dependency: "com.github.devoxin:lavadspx-plugin:0.0.5" # https://github.com/devoxin/LavaDSPX-Plugin
+    - dependency: "com.github.Devoxin:LavaDSPX-Plugin:0.0.5" # https://github.com/devoxin/LavaDSPX-Plugin
       repository: "https://jitpack.io"
       snapshot: false
-    - dependency: "dev.lavalink.youtube:youtube-plugin:1.11.1" # https://github.com/lavalink-devs/youtube-source
+    - dependency: "dev.lavalink.youtube:youtube-plugin:1.13.3" # https://github.com/lavalink-devs/youtube-source
       snapshot: false
-    - dependency: "com.github.topi314.lavalyrics:lavalyrics-plugin:1.0.0" # https://github.com/topi314/LavaLyrics
+    - dependency: "com.github.topi314.lavalyrics:lavalyrics-plugin:7d60077" # https://github.com/topi314/LavaLyrics
+      snapshot: true
+    - dependency: "me.duncte123:java-lyrics-plugin:1.6.6" # https://github.com/DuncteBot/java-timed-lyrics
       snapshot: false
-    - dependency: "me.duncte123:java-lyrics-plugin:1.6.5" # https://github.com/DuncteBot/java-timed-lyrics
+    - dependency: "com.github.topi314.sponsorblock:sponsorblock-plugin:3.0.1" # https://github.com/topi314/SponsorBlock-Plugin
       snapshot: false
+    - dependency: "net.esmbot:lava-xm-plugin:0.2.7" # https://github.com/esmBot/lava-xm-plugin
+      repository: "https://repo.projectlounge.pw/maven/releases"
 plugins:
   youtube:
     enabled: true
-    # See: https://github.com/lavalink-devs/youtube-source?tab=readme-ov-file#using-oauth-tokens
     oauth:
       enabled: true
-      # Uncomment the 'refreshToken' section when you get a valid refresh token.
-      #refreshToken: "your account access token"
-      skipInitialization: false
-    # Only if you need/want use the pot data
-    # See: https://github.com/lavalink-devs/youtube-source?tab=readme-ov-file#using-a-potoken
-    #pot:
-    #  token: "your pot token"
-    #  visitorData: "the visitor data"
+      refreshToken: "the-refresh-token"
+      skipInitialization: true
+    pot:
+      token: "the-pot-token"
+      visitorData: "the-visitor-data"
     allowSearch: true
     allowDirectVideoIds: true
     allowDirectPlaylistIds: true
-    # See: https://github.com/lavalink-devs/youtube-source?tab=readme-ov-file#available-clients
     clients:
-      - MUSIC
-      - ANDROID_MUSIC
-      - ANDROID_VR
-      - WEB
-      - MWEB
-      - WEBEMBEDDED
-      - TVHTML5EMBEDDED
+      - "TV"
+      - "TVHTML5EMBEDDED"
+      - "WEB"
+      - "MWEB"
+      - "WEBEMBEDDED"
+      - "MUSIC"
+      - "ANDROID_VR"
+      - "ANDROID_MUSIC"
+      - "IOS"
     clientOptions:
-      ANDROID_MUSIC:
-        playback: false
+      TV: # OAuth
         playlistLoading: false
+        videoLoading: false
         searching: false
+        playback: true
+      TVHTML5EMBEDDED: # OAuth
+        playlistLoading: false
+        videoLoading: false
+        searching: false
+        playback: true
+      ANDROID_MUSIC:
+        playlistLoading: false
         videoLoading: true
-      ANDROID_VR:
+        searching: true
+        playback: true
+      MUSIC:
+        playlistLoading: false
+        videoLoading: false
+        searching: true
         playback: false
+      WEB:
         playlistLoading: true
-        searching: true
         videoLoading: true
+        searching: true
+        playback: true
       MWEB:
-        playback: false
         playlistLoading: true
-        searching: true
         videoLoading: true
-      MUSIC:
-        playback: true
-        playlistLoading: false
-        searching: true
-        videoLoading: false
-      TVHTML5EMBEDDED:
+        searching: false
         playback: true
+      WEBEMBEDDED:
         playlistLoading: false
-        searching: false
         videoLoading: true
-      WEB:
-        playback: false
+        searching: false
+        playback: true
+      ANDROID_VR:
         playlistLoading: true
-        searching: true
-        videoLoading: false
-      WEBEMBEDDED:
-        playback: false
+        videoLoading: true
+        searching: false
+        playback: true
+      IOS:
         playlistLoading: false
+        videoLoading: true
         searching: false
-        videoLoading: false
+        playback: true
   lyrics:
     countryCode: us #country code for resolving isrc tracks
-    geniusApiKey: "Your Genius Client Access Token" # leave this out to disable genius searching. Get your api key (Client Access Token) from https://genius.com/api-clients
+    geniusApiKey: "the-lyrics-genius-token" # leave this out to disable genius searching. Get your api key (Client Access Token) from https://genius.com/api-clients
   lavalyrics:
     sources:
       - spotify
       - youtube
-      - deezerf
+      - deezer
       - yandexMusic
   lavasrc:
     providers:
+      - "dzsearch:%QUERY%"
+      - "qbsearch:%QUERY%"
+      - "scsearch:%QUERY%"
       - 'ytsearch:"%ISRC%"'
       - "ytmsearch:%QUERY%"
       - "ytsearch:%QUERY%"
-      - "scsearch:%QUERY%"
+      - "amsearch:%QUERY%"
       - "spsearch:%QUERY%"
     sources:
       spotify: true # Enable Spotify source
-      applemusic: false # Enable Apple Music source
-      deezer: false # Enable Deezer source
-      yandexmusic: false # Enable Yandex Music source
+      applemusic: true # Enable Apple Music source
+      deezer: true # Enable Deezer source
+      yandexmusic: true # Enable Yandex Music source
       flowerytts: true # Enable Flowery TTS source
       youtube: true # Enable YouTube search source (https://github.com/topi314/LavaSearch)
       vkmusic: false # Enable Vk Music source
+      tidal: false # Enable Tidal source
+      qobuz: true # Enabled qobuz source
+      ytdlp: false # Enable yt-dlp source
     lyrics-sources:
-      spotify: false # Enable Spotify lyrics source
+      spotify: true # Enable Spotify lyrics source
       deezer: false # Enable Deezer lyrics source
       youtube: true # Enable YouTube lyrics source
-      yandexmusic: false # Enable Yandex Music lyrics source
+      yandexmusic: true # Enable Yandex Music lyrics source
       vkmusic: false # Enable Vk Music lyrics source
     youtube:
       countryCode: "US"
       playlistLoadLimit: 1 # The number of pages at 100 tracks each
       albumLoadLimit: 1 # The number of pages at 50 tracks each
       artistLoadLimit: 1 # The number of pages at 10 tracks each
     yandexmusic:
-      accessToken: "your yandex token" # the token used for accessing the yandex music api. See https://github.com/TopiSenpai/LavaSrc#yandex-music
+      accessToken: "the-yandex-access-token" # the token used for accessing the yandex music api. See https://github.com/TopiSenpai/LavaSrc#yandex-music
       playlistLoadLimit: 1 # The number of pages at 100 tracks each
       albumLoadLimit: 1 # The number of pages at 50 tracks each
       artistLoadLimit: 1 # The number of pages at 10 tracks each
     spotify:
-      # clientId: "your client id"
-      # clientSecret: "your client secret"
-      # spDc: "your sp dc cookie" # the sp dc cookie used for accessing the spotify lyrics api
+      clientId: "the-spotify-client-id"
+      clientSecret: "the-spotify-client-secret"
+      spDc: "the-spdc-cookie" # the sp dc cookie used for accessing the spotify lyrics api
       countryCode: "US" # the country code you want to use for filtering the artists top tracks. See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
       playlistLoadLimit: 6 # The number of pages at 100 tracks each
       albumLoadLimit: 6 # The number of pages at 50 tracks each
       resolveArtistsInSearch: true # Whether to resolve artists in track search results (can be slow)
       localFiles: false # Enable local files support with Spotify playlists. Please note `uri` & `isrc` will be `null` & `identifier` will be `"local"`
+      preferAnonymousToken: true # Whether to use the anonymous token for resolving tracks, artists and albums. Playlists are always resolved with the anonymous token to support autogenerated playlists.
     flowerytts:
       voice: "Olivia" # (case-sensitive) get default voice from here https://api.flowery.pw/v1/tts/voices
       translate: false # whether to translate the text to the native language of voice
@@ -183,25 +203,47 @@ plugins:
         soundgasm: true # soundgasm.net
     applemusic:
       countryCode: "US" # the country code you want to use for filtering the artists top tracks and language. See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
-      mediaAPIToken: "your apple music api token" # apple music api token
+      mediaAPIToken: "the-apple-music-token" # apple music api token
       # or specify an apple music key
       keyID: "your key id"
       teamID: "your team id"
       musicKitKey: |
         -----BEGIN PRIVATE KEY-----
         your key
-        -----END PRIVATE KEY-----      
+        -----END PRIVATE KEY-----
       playlistLoadLimit: 6 # The number of pages at 300 tracks each
       albumLoadLimit: 6 # The number of pages at 300 tracks each
     deezer:
-      masterDecryptionKey: "your master decryption key" # the master key used for decrypting the deezer tracks. (yes this is not here you need to get it from somewhere else)
-      # arl: "your deezer arl" # the arl cookie used for accessing the deezer api this is optional but required for formats above MP3_128
-      formats: [ "FLAC", "MP3_320", "MP3_256", "MP3_128", "MP3_64", "AAC_64" ] # the formats you want to use for the deezer tracks. "FLAC", "MP3_320", "MP3_256" & "AAC_64" are only available for premium users and require a valid arl
+      masterDecryptionKey: "the-deezer-key" # the master key used for decrypting the deezer tracks. (yes this is not here you need to get it from somewhere else)
+      arl: "the-arl-cookie" # the arl cookie used for accessing the deezer api this is optional but required for formats above MP3_128
+      formats: ["FLAC", "MP3_320", "MP3_256", "MP3_128", "MP3_64", "AAC_64"] # the formats you want to use for the deezer tracks. "FLAC", "MP3_320", "MP3_256" & "AAC_64" are only available for premium users and require a valid arl
     vkmusic:
       userToken: "your user token" # This token is needed for authorization in the api. Guide: https://github.com/topi314/LavaSrc#vk-music
       playlistLoadLimit: 1 # The number of pages at 50 tracks each
       artistLoadLimit: 1 # The number of pages at 10 tracks each
-      recommendationsLoadLimit: 10 # Number of tracks
+      recommendationsLoadLimit: 10 # Number of
+    tidal:
+      countryCode: "US" # the country code for accessing region-specific content on Tidal (ISO 3166-1 alpha-2).
+      searchLimit: 6 # How many search results should be returned
+      token: "your-tidal-token" # the token used for accessing the tidal api. See https://github.com/topi314/LavaSrc#tidal
+    qobuz:
+      userOauthToken: "the-qobuz-user-token" #This token is needed for authorization in the api. Guide: https://github.com/topi314/LavaSrc#qobuz
+      appId: "the-qobuz-app-id" #(Only pass it when you are using an old userOauthToken)
+      appSecret: "the-qobuz-app-secret" #(Only pass it when you are using an old userOauthToken)
+    ytdlp:
+      path: "yt-dlp" # the path to the yt-dlp executable.
+      searchLimit: 10 # How many search results should be returned
+      #customLoadArgs: ["-q", "--no-warnings", "--flat-playlist", "--skip-download", "-J"] # Custom arguments to pass to yt-dlp
+      #customPlaybackArgs: ["-q", "--no-warnings", "-f", "bestaudio", "-J"] # Custom arguments for yt-dlp
+  xm:
+    ampFactor: 1 # Amplification factor, can be between 0 and 3
+    interpolation: 1 # Mixer interpolation type (0 = Nearest neighbor, 1 = Linear, 2 = Cublic spline)
+    vblank: false # Uses vblank timing during playback
+    fx9Bug: false # Emulates the FX9 effect bug from Protracker 2.x
+    fixSampleLoop: false # Divides sample loop start values in half
+    amigaMixer: false # Emulates the Paula mixer in Amiga modules
+    defaultPan: 50 # Default stereo panning, can be between 0 and 100
+
 metrics:
   prometheus:
     enabled: false
@@ -213,11 +255,10 @@ logging:
   file:
     max-history: 5
     max-size: 10MB
-  path: ./logs/
+    path: ./logs/
   level:
     root: INFO
     lavalink: INFO
-    dev.lavalink.youtube.http.YoutubeOauth2Handler: INFO
   request:
     enabled: true
     includeClientInfo: true
@@ -228,4 +269,4 @@ logging:
   logback:
     rollingpolicy:
       max-file-size: 10MB
-      max-history: 5
+      max-history: 5