diff --git a/404.html b/404.html
index 3b2a2e815..502907f73 100644
--- a/404.html
+++ b/404.html
@@ -16,7 +16,7 @@
       
       
       <link rel="icon" href="/spotify-downloader/assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -24,7 +24,7 @@
       
     
     
-      <link rel="stylesheet" href="/spotify-downloader/assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="/spotify-downloader/assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="/spotify-downloader/assets/stylesheets/palette.06af60db.min.css">
@@ -183,7 +183,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -330,7 +330,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,11 +635,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="/spotify-downloader/reference/download/" class="md-nav__link ">
+            <a href="/spotify-downloader/reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -655,7 +655,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -665,56 +665,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -726,32 +676,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="/spotify-downloader/reference/types/" class="md-nav__link ">
+            <a href="/spotify-downloader/reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -762,53 +712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/album/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -825,11 +733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/saved/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -846,11 +754,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/result/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -867,11 +775,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/song/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -888,11 +796,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/types/options/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -927,32 +835,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="/spotify-downloader/reference/console/" class="md-nav__link ">
+            <a href="/spotify-downloader/reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -963,11 +871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/save/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -984,11 +892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/url/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1005,11 +913,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/meta/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1026,11 +934,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/web/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1047,11 +955,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/sync/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1068,11 +976,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/download/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1089,11 +997,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/console/entry_point/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1111,6 +1019,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1128,7 +1044,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1144,14 +1060,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1164,11 +1080,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/console/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1185,11 +1101,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/formatter/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1206,11 +1122,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/arguments/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1227,11 +1143,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/metadata/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1248,11 +1164,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/downloader/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1269,11 +1185,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/github/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1290,11 +1206,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/static/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1311,11 +1227,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/search/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1332,11 +1248,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/web/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1353,11 +1269,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/logging/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1374,11 +1290,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/spotify/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1395,11 +1311,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/matching/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1416,11 +1332,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1437,11 +1353,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/m3u/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1458,11 +1374,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/config/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1479,11 +1395,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/lrc/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1500,11 +1416,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/utils/archive/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1539,32 +1455,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="/spotify-downloader/reference/providers/" class="md-nav__link ">
+            <a href="/spotify-downloader/reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1574,45 +1490,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="/spotify-downloader/reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="/spotify-downloader/reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/spotify-downloader/reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1621,11 +1533,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1642,11 +1554,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1663,11 +1575,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1684,11 +1596,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1705,11 +1617,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1744,32 +1656,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="/spotify-downloader/reference/providers/audio/" class="md-nav__link ">
+            <a href="/spotify-downloader/reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1780,11 +1692,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1801,11 +1713,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1815,6 +1727,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="/spotify-downloader/reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1822,11 +1788,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/piped/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1843,11 +1809,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1864,11 +1830,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1885,11 +1851,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/base/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1906,11 +1872,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/spotify-downloader/reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="/spotify-downloader/reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1920,9 +1886,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/spotify-downloader/reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/spotify-downloader/reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -1999,7 +1999,7 @@ <h1>404 - Not found</h1>
     <script id="__config" type="application/json">{"base": "/spotify-downloader/", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "/spotify-downloader/assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="/spotify-downloader/assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="/spotify-downloader/assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/CODE_OF_CONDUCT/index.html b/CODE_OF_CONDUCT/index.html
index c0a838a91..a851db5d9 100644
--- a/CODE_OF_CONDUCT/index.html
+++ b/CODE_OF_CONDUCT/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -798,11 +798,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/download/" class="md-nav__link ">
+            <a href="../reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -818,7 +818,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -828,56 +828,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -889,32 +839,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/types/" class="md-nav__link ">
+            <a href="../reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -925,53 +875,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/album/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -988,11 +896,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/saved/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1009,11 +917,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/result/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1030,11 +938,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/song/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1051,11 +959,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/options/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1090,32 +998,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/console/" class="md-nav__link ">
+            <a href="../reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1126,11 +1034,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/save/" class="md-nav__link">
+      <a href="../reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1147,11 +1055,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/url/" class="md-nav__link">
+      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1168,11 +1076,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/meta/" class="md-nav__link">
+      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1189,11 +1097,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/web/" class="md-nav__link">
+      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1210,11 +1118,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/sync/" class="md-nav__link">
+      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1231,11 +1139,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/download/" class="md-nav__link">
+      <a href="../reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1252,11 +1160,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/entry_point/" class="md-nav__link">
+      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1274,6 +1182,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1291,7 +1207,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1307,14 +1223,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1327,11 +1243,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/console/" class="md-nav__link">
+      <a href="../reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1348,11 +1264,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/formatter/" class="md-nav__link">
+      <a href="../reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1369,11 +1285,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/arguments/" class="md-nav__link">
+      <a href="../reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1390,11 +1306,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/metadata/" class="md-nav__link">
+      <a href="../reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1411,11 +1327,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/downloader/" class="md-nav__link">
+      <a href="../reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1432,11 +1348,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/github/" class="md-nav__link">
+      <a href="../reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1453,11 +1369,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/static/" class="md-nav__link">
+      <a href="../reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1474,11 +1390,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/search/" class="md-nav__link">
+      <a href="../reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1495,11 +1411,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/web/" class="md-nav__link">
+      <a href="../reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1516,11 +1432,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/logging/" class="md-nav__link">
+      <a href="../reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1537,11 +1453,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/spotify/" class="md-nav__link">
+      <a href="../reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1558,11 +1474,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/matching/" class="md-nav__link">
+      <a href="../reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1579,11 +1495,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="../reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1600,11 +1516,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/m3u/" class="md-nav__link">
+      <a href="../reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1621,11 +1537,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/config/" class="md-nav__link">
+      <a href="../reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1642,11 +1558,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/lrc/" class="md-nav__link">
+      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1663,11 +1579,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/archive/" class="md-nav__link">
+      <a href="../reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1702,32 +1618,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/" class="md-nav__link ">
+            <a href="../reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1737,45 +1653,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1784,11 +1696,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="../reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1805,11 +1717,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1826,11 +1738,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1847,11 +1759,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="../reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1868,11 +1780,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="../reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1907,32 +1819,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/audio/" class="md-nav__link ">
+            <a href="../reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1943,11 +1855,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1964,11 +1876,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1978,6 +1890,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1985,11 +1951,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/piped/" class="md-nav__link">
+      <a href="../reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2006,11 +1972,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="../reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2027,11 +1993,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2048,11 +2014,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/base/" class="md-nav__link">
+      <a href="../reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2069,11 +2035,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2083,9 +2049,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2261,7 +2261,7 @@ <h2 id="attribution">Attribution<a class="headerlink" href="#attribution" title=
     <script id="__config" type="application/json">{"base": "..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/CONTRIBUTING/index.html b/CONTRIBUTING/index.html
index 3ad3c0f8a..e040ff066 100644
--- a/CONTRIBUTING/index.html
+++ b/CONTRIBUTING/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -888,11 +888,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/download/" class="md-nav__link ">
+            <a href="../reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -908,7 +908,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -918,56 +918,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -979,32 +929,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/types/" class="md-nav__link ">
+            <a href="../reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1015,53 +965,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/album/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -1078,11 +986,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/saved/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1099,11 +1007,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/result/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1120,11 +1028,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/song/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1141,11 +1049,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/options/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1180,32 +1088,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/console/" class="md-nav__link ">
+            <a href="../reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1216,11 +1124,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/save/" class="md-nav__link">
+      <a href="../reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1237,11 +1145,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/url/" class="md-nav__link">
+      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1258,11 +1166,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/meta/" class="md-nav__link">
+      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1279,11 +1187,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/web/" class="md-nav__link">
+      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1300,11 +1208,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/sync/" class="md-nav__link">
+      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1321,11 +1229,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/download/" class="md-nav__link">
+      <a href="../reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1342,11 +1250,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/entry_point/" class="md-nav__link">
+      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1364,6 +1272,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1381,7 +1297,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1397,14 +1313,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1417,11 +1333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/console/" class="md-nav__link">
+      <a href="../reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1438,11 +1354,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/formatter/" class="md-nav__link">
+      <a href="../reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1459,11 +1375,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/arguments/" class="md-nav__link">
+      <a href="../reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1480,11 +1396,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/metadata/" class="md-nav__link">
+      <a href="../reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1501,11 +1417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/downloader/" class="md-nav__link">
+      <a href="../reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1522,11 +1438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/github/" class="md-nav__link">
+      <a href="../reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1543,11 +1459,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/static/" class="md-nav__link">
+      <a href="../reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1564,11 +1480,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/search/" class="md-nav__link">
+      <a href="../reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1585,11 +1501,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/web/" class="md-nav__link">
+      <a href="../reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1606,11 +1522,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/logging/" class="md-nav__link">
+      <a href="../reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1627,11 +1543,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/spotify/" class="md-nav__link">
+      <a href="../reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1648,11 +1564,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/matching/" class="md-nav__link">
+      <a href="../reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1669,11 +1585,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="../reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1690,11 +1606,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/m3u/" class="md-nav__link">
+      <a href="../reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1711,11 +1627,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/config/" class="md-nav__link">
+      <a href="../reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1732,11 +1648,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/lrc/" class="md-nav__link">
+      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1753,11 +1669,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/archive/" class="md-nav__link">
+      <a href="../reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1792,32 +1708,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/" class="md-nav__link ">
+            <a href="../reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1827,45 +1743,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1874,11 +1786,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="../reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1895,11 +1807,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1916,11 +1828,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1937,11 +1849,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="../reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1958,11 +1870,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="../reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1997,32 +1909,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/audio/" class="md-nav__link ">
+            <a href="../reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2033,11 +1945,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2054,11 +1966,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2068,6 +1980,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2075,11 +2041,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/piped/" class="md-nav__link">
+      <a href="../reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2096,11 +2062,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="../reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2117,11 +2083,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2138,11 +2104,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/base/" class="md-nav__link">
+      <a href="../reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2159,11 +2125,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2173,9 +2139,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2242,10 +2242,10 @@ <h2 id="table-of-contents">Table of Contents<a class="headerlink" href="#table-o
 <li><a href="#i-want-to-contribute">I Want To Contribute</a></li>
 <li><a href="#reporting-bugs">Reporting Bugs</a></li>
 <li><a href="#suggesting-enhancements">Suggesting Enhancements</a></li>
-<li><a href="#Linting,-Formatting-and-Type-checking">Linting, Formatting and Type-checking</a></li>
-<li><a href="#Python-Documentation">Python Documentation</a></li>
-<li><a href="#Overview-of-the-Project-Structure">Overview of the Project Structure</a></li>
-<li><a href="#Join-The-Project-Team">Join The Project Team</a></li>
+<li><a href="#linting-formatting-and-type-checking">Linting, Formatting and Type-checking</a></li>
+<li><a href="#python-documentation">Python Documentation</a></li>
+<li><a href="#overview-of-the-project-structure">Overview of the Project Structure</a></li>
+<li><a href="#join-the-project-team">Join The Project Team</a></li>
 </ul>
 <h2 id="i-have-a-question">I Have a Question<a class="headerlink" href="#i-have-a-question" title="Permanent link">¤</a></h2>
 <blockquote>
@@ -2318,7 +2318,7 @@ <h4 id="before-submitting-a-bug-report">Before Submitting a Bug Report<a class="
 <h4 id="how-do-i-submit-a-good-bug-report">How Do I Submit a Good Bug Report?<a class="headerlink" href="#how-do-i-submit-a-good-bug-report" title="Permanent link">¤</a></h4>
 <blockquote>
 <p>You must never report security related issues, vulnerabilities or bugs to the issue tracker,
-or elsewhere in public. Instead sensitive bugs must be sent by discord to xnetcat#8144.</p>
+or elsewhere in public. Instead sensitive bugs must be sent by Discord to Silverarmor (spotDL Discord Owner).</p>
 </blockquote>
 <!-- You may add a PGP key to allow the messages to be sent encrypted as well. -->
 
@@ -2342,7 +2342,7 @@ <h4 id="how-do-i-submit-a-good-bug-report">How Do I Submit a Good Bug Report?<a
   addressed until they are reproduced.</li>
 <li>If the team is able to reproduce the issue, it will be marked <code>needs-fix</code>, as well as
   possibly other tags (such as <code>critical</code>), and the issue will be left to be
-  <a href="#your-first-code-contribution">implemented by someone</a>.</li>
+  implemented by someone.</li>
 </ul>
 <!-- You might want to create an issue template for bugs and errors that can be used as a guide and that defines the structure of the information to be included. If you do so, reference it here in the description. -->
 
@@ -2408,7 +2408,7 @@ <h3 id="linting-formatting-and-type-checking">Linting, Formatting and Type-check
 <ul>
 <li>We use <a href="https://pypi.org/project/pylint/"><code>pylint</code></a> for linting and expect a score above <code>9</code></li>
 </ul>
-<div class="language-bash highlight"><pre><span></span><code>pylint<span class="w"> </span>--limit-inference-results<span class="w"> </span><span class="m">0</span><span class="w"> </span>--fail-under<span class="w"> </span><span class="m">9</span><span class="w"> </span>./spotdl
+<div class="language-bash highlight"><pre><span></span><code>pylint<span class="w"> </span>--fail-under<span class="w"> </span><span class="m">10</span><span class="w"> </span>--limit-inference-results<span class="w"> </span><span class="m">0</span><span class="w"> </span>--disable<span class="o">=</span>R0917<span class="w"> </span>./spotdl
 </code></pre></div>
 <ul>
 <li>We use <a href="https://pypi.org/project/black/"><code>black</code></a> for code formatting</li>
@@ -2591,7 +2591,7 @@ <h3 id="attribution">Attribution<a class="headerlink" href="#attribution" title=
     <script id="__config" type="application/json">{"base": "..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/assets/javascripts/bundle.83f73b43.min.js b/assets/javascripts/bundle.88dd0f4e.min.js
similarity index 66%
rename from assets/javascripts/bundle.83f73b43.min.js
rename to assets/javascripts/bundle.88dd0f4e.min.js
index 43d8b70f6..fb8f31090 100644
--- a/assets/javascripts/bundle.83f73b43.min.js
+++ b/assets/javascripts/bundle.88dd0f4e.min.js
@@ -11,6 +11,6 @@
  * Licensed MIT © Zeno Rocha
  */(function(t,r){typeof It=="object"&&typeof Yr=="object"?Yr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof It=="object"?It.ClipboardJS=r():t.ClipboardJS=r()})(It,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return Ui}});var a=i(279),s=i.n(a),p=i(370),c=i.n(p),l=i(817),f=i.n(l);function u(V){try{return document.execCommand(V)}catch(A){return!1}}var d=function(A){var M=f()(A);return u("cut"),M},y=d;function L(V){var A=document.documentElement.getAttribute("dir")==="rtl",M=document.createElement("textarea");M.style.fontSize="12pt",M.style.border="0",M.style.padding="0",M.style.margin="0",M.style.position="absolute",M.style[A?"right":"left"]="-9999px";var F=window.pageYOffset||document.documentElement.scrollTop;return M.style.top="".concat(F,"px"),M.setAttribute("readonly",""),M.value=V,M}var X=function(A,M){var F=L(A);M.container.appendChild(F);var D=f()(F);return u("copy"),F.remove(),D},te=function(A){var M=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},F="";return typeof A=="string"?F=X(A,M):A instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(A==null?void 0:A.type)?F=X(A.value,M):(F=f()(A),u("copy")),F},J=te;function k(V){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?k=function(M){return typeof M}:k=function(M){return M&&typeof Symbol=="function"&&M.constructor===Symbol&&M!==Symbol.prototype?"symbol":typeof M},k(V)}var ft=function(){var A=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},M=A.action,F=M===void 0?"copy":M,D=A.container,Y=A.target,$e=A.text;if(F!=="copy"&&F!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(Y!==void 0)if(Y&&k(Y)==="object"&&Y.nodeType===1){if(F==="copy"&&Y.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(F==="cut"&&(Y.hasAttribute("readonly")||Y.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if($e)return J($e,{container:D});if(Y)return F==="cut"?y(Y):J(Y,{container:D})},qe=ft;function Fe(V){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?Fe=function(M){return typeof M}:Fe=function(M){return M&&typeof Symbol=="function"&&M.constructor===Symbol&&M!==Symbol.prototype?"symbol":typeof M},Fe(V)}function ki(V,A){if(!(V instanceof A))throw new TypeError("Cannot call a class as a function")}function no(V,A){for(var M=0;M<A.length;M++){var F=A[M];F.enumerable=F.enumerable||!1,F.configurable=!0,"value"in F&&(F.writable=!0),Object.defineProperty(V,F.key,F)}}function Hi(V,A,M){return A&&no(V.prototype,A),M&&no(V,M),V}function $i(V,A){if(typeof A!="function"&&A!==null)throw new TypeError("Super expression must either be null or a function");V.prototype=Object.create(A&&A.prototype,{constructor:{value:V,writable:!0,configurable:!0}}),A&&br(V,A)}function br(V,A){return br=Object.setPrototypeOf||function(F,D){return F.__proto__=D,F},br(V,A)}function Pi(V){var A=ji();return function(){var F=Wt(V),D;if(A){var Y=Wt(this).constructor;D=Reflect.construct(F,arguments,Y)}else D=F.apply(this,arguments);return Ri(this,D)}}function Ri(V,A){return A&&(Fe(A)==="object"||typeof A=="function")?A:Ii(V)}function Ii(V){if(V===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return V}function ji(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(V){return!1}}function Wt(V){return Wt=Object.setPrototypeOf?Object.getPrototypeOf:function(M){return M.__proto__||Object.getPrototypeOf(M)},Wt(V)}function vr(V,A){var M="data-clipboard-".concat(V);if(A.hasAttribute(M))return A.getAttribute(M)}var Fi=function(V){$i(M,V);var A=Pi(M);function M(F,D){var Y;return ki(this,M),Y=A.call(this),Y.resolveOptions(D),Y.listenClick(F),Y}return Hi(M,[{key:"resolveOptions",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof D.action=="function"?D.action:this.defaultAction,this.target=typeof D.target=="function"?D.target:this.defaultTarget,this.text=typeof D.text=="function"?D.text:this.defaultText,this.container=Fe(D.container)==="object"?D.container:document.body}},{key:"listenClick",value:function(D){var Y=this;this.listener=c()(D,"click",function($e){return Y.onClick($e)})}},{key:"onClick",value:function(D){var Y=D.delegateTarget||D.currentTarget,$e=this.action(Y)||"copy",Dt=qe({action:$e,container:this.container,target:this.target(Y),text:this.text(Y)});this.emit(Dt?"success":"error",{action:$e,text:Dt,trigger:Y,clearSelection:function(){Y&&Y.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(D){return vr("action",D)}},{key:"defaultTarget",value:function(D){var Y=vr("target",D);if(Y)return document.querySelector(Y)}},{key:"defaultText",value:function(D){return vr("text",D)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(D){var Y=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return J(D,Y)}},{key:"cut",value:function(D){return y(D)}},{key:"isSupported",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],Y=typeof D=="string"?[D]:D,$e=!!document.queryCommandSupported;return Y.forEach(function(Dt){$e=$e&&!!document.queryCommandSupported(Dt)}),$e}}]),M}(s()),Ui=Fi},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function a(s,p){for(;s&&s.nodeType!==n;){if(typeof s.matches=="function"&&s.matches(p))return s;s=s.parentNode}}o.exports=a},438:function(o,n,i){var a=i(828);function s(l,f,u,d,y){var L=c.apply(this,arguments);return l.addEventListener(u,L,y),{destroy:function(){l.removeEventListener(u,L,y)}}}function p(l,f,u,d,y){return typeof l.addEventListener=="function"?s.apply(null,arguments):typeof u=="function"?s.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(L){return s(L,f,u,d,y)}))}function c(l,f,u,d){return function(y){y.delegateTarget=a(y.target,f),y.delegateTarget&&d.call(l,y)}}o.exports=p},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var a=Object.prototype.toString.call(i);return i!==void 0&&(a==="[object NodeList]"||a==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var a=Object.prototype.toString.call(i);return a==="[object Function]"}},370:function(o,n,i){var a=i(879),s=i(438);function p(u,d,y){if(!u&&!d&&!y)throw new Error("Missing required arguments");if(!a.string(d))throw new TypeError("Second argument must be a String");if(!a.fn(y))throw new TypeError("Third argument must be a Function");if(a.node(u))return c(u,d,y);if(a.nodeList(u))return l(u,d,y);if(a.string(u))return f(u,d,y);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function c(u,d,y){return u.addEventListener(d,y),{destroy:function(){u.removeEventListener(d,y)}}}function l(u,d,y){return Array.prototype.forEach.call(u,function(L){L.addEventListener(d,y)}),{destroy:function(){Array.prototype.forEach.call(u,function(L){L.removeEventListener(d,y)})}}}function f(u,d,y){return s(document.body,u,d,y)}o.exports=p},817:function(o){function n(i){var a;if(i.nodeName==="SELECT")i.focus(),a=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var s=i.hasAttribute("readonly");s||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),s||i.removeAttribute("readonly"),a=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var p=window.getSelection(),c=document.createRange();c.selectNodeContents(i),p.removeAllRanges(),p.addRange(c),a=p.toString()}return a}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,a,s){var p=this.e||(this.e={});return(p[i]||(p[i]=[])).push({fn:a,ctx:s}),this},once:function(i,a,s){var p=this;function c(){p.off(i,c),a.apply(s,arguments)}return c._=a,this.on(i,c,s)},emit:function(i){var a=[].slice.call(arguments,1),s=((this.e||(this.e={}))[i]||[]).slice(),p=0,c=s.length;for(p;p<c;p++)s[p].fn.apply(s[p].ctx,a);return this},off:function(i,a){var s=this.e||(this.e={}),p=s[i],c=[];if(p&&a)for(var l=0,f=p.length;l<f;l++)p[l].fn!==a&&p[l].fn._!==a&&c.push(p[l]);return c.length?s[i]=c:delete s[i],this}},o.exports=n,o.exports.TinyEmitter=n}},t={};function r(o){if(t[o])return t[o].exports;var n=t[o]={exports:{}};return e[o](n,n.exports,r),n.exports}return function(){r.n=function(o){var n=o&&o.__esModule?function(){return o.default}:function(){return o};return r.d(n,{a:n}),n}}(),function(){r.d=function(o,n){for(var i in n)r.o(n,i)&&!r.o(o,i)&&Object.defineProperty(o,i,{enumerable:!0,get:n[i]})}}(),function(){r.o=function(o,n){return Object.prototype.hasOwnProperty.call(o,n)}}(),r(686)}().default})});var lL=Mt(lo());var wr=function(e,t){return wr=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},wr(e,t)};function oe(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");wr(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function mo(e,t,r,o){function n(i){return i instanceof r?i:new r(function(a){a(i)})}return new(r||(r=Promise))(function(i,a){function s(l){try{c(o.next(l))}catch(f){a(f)}}function p(l){try{c(o.throw(l))}catch(f){a(f)}}function c(l){l.done?i(l.value):n(l.value).then(s,p)}c((o=o.apply(e,t||[])).next())})}function Nt(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,a=Object.create((typeof Iterator=="function"?Iterator:Object).prototype);return a.next=s(0),a.throw=s(1),a.return=s(2),typeof Symbol=="function"&&(a[Symbol.iterator]=function(){return this}),a;function s(c){return function(l){return p([c,l])}}function p(c){if(o)throw new TypeError("Generator is already executing.");for(;a&&(a=0,c[0]&&(r=0)),r;)try{if(o=1,n&&(i=c[0]&2?n.return:c[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,c[1])).done)return i;switch(n=0,i&&(c=[c[0]&2,i.value]),c[0]){case 0:case 1:i=c;break;case 4:return r.label++,{value:c[1],done:!1};case 5:r.label++,n=c[1],c=[0];continue;case 7:c=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(c[0]===6||c[0]===2)){r=0;continue}if(c[0]===3&&(!i||c[1]>i[0]&&c[1]<i[3])){r.label=c[1];break}if(c[0]===6&&r.label<i[1]){r.label=i[1],i=c;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(c);break}i[2]&&r.ops.pop(),r.trys.pop();continue}c=t.call(e,r)}catch(l){c=[6,l],n=0}finally{o=i=0}if(c[0]&5)throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}}function he(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function N(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],a;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(s){a={error:s}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(a)throw a.error}}return i}function q(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function nt(e){return this instanceof nt?(this.v=e,this):new nt(e)}function fo(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n=Object.create((typeof AsyncIterator=="function"?AsyncIterator:Object).prototype),s("next"),s("throw"),s("return",a),n[Symbol.asyncIterator]=function(){return this},n;function a(d){return function(y){return Promise.resolve(y).then(d,f)}}function s(d,y){o[d]&&(n[d]=function(L){return new Promise(function(X,te){i.push([d,L,X,te])>1||p(d,L)})},y&&(n[d]=y(n[d])))}function p(d,y){try{c(o[d](y))}catch(L){u(i[0][3],L)}}function c(d){d.value instanceof nt?Promise.resolve(d.value.v).then(l,f):u(i[0][2],d)}function l(d){p("next",d)}function f(d){p("throw",d)}function u(d,y){d(y),i.shift(),i.length&&p(i[0][0],i[0][1])}}function uo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof he=="function"?he(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(a){return new Promise(function(s,p){a=e[i](a),n(s,p,a.done,a.value)})}}function n(i,a,s,p){Promise.resolve(p).then(function(c){i({value:c,done:s})},a)}}function H(e){return typeof e=="function"}function ut(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var zt=ut(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
 `+r.map(function(o,n){return n+1+") "+o.toString()}).join(`
-  `):"",this.name="UnsubscriptionError",this.errors=r}});function Qe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Ue=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=he(a),p=s.next();!p.done;p=s.next()){var c=p.value;c.remove(this)}}catch(L){t={error:L}}finally{try{p&&!p.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(H(l))try{l()}catch(L){i=L instanceof zt?L.errors:[L]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=he(f),d=u.next();!d.done;d=u.next()){var y=d.value;try{ho(y)}catch(L){i=i!=null?i:[],L instanceof zt?i=q(q([],N(i)),N(L.errors)):i.push(L)}}}catch(L){o={error:L}}finally{try{d&&!d.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new zt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)ho(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Qe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Qe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Tr=Ue.EMPTY;function qt(e){return e instanceof Ue||e&&"closed"in e&&H(e.remove)&&H(e.add)&&H(e.unsubscribe)}function ho(e){H(e)?e():e.unsubscribe()}var Pe={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var dt={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=dt.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,q([e,t],N(r))):setTimeout.apply(void 0,q([e,t],N(r)))},clearTimeout:function(e){var t=dt.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Qt(e){dt.setTimeout(function(){var t=Pe.onUnhandledError;if(t)t(e);else throw e})}function be(){}var bo=function(){return Sr("C",void 0,void 0)}();function vo(e){return Sr("E",void 0,e)}function go(e){return Sr("N",e,void 0)}function Sr(e,t,r){return{kind:e,value:t,error:r}}var it=null;function ht(e){if(Pe.useDeprecatedSynchronousErrorHandling){var t=!it;if(t&&(it={errorThrown:!1,error:null}),e(),t){var r=it,o=r.errorThrown,n=r.error;if(it=null,o)throw n}}else e()}function yo(e){Pe.useDeprecatedSynchronousErrorHandling&&it&&(it.errorThrown=!0,it.error=e)}var _t=function(e){oe(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,qt(r)&&r.add(o)):o.destination=Yi,o}return t.create=function(r,o,n){return new at(r,o,n)},t.prototype.next=function(r){this.isStopped?Lr(go(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Lr(vo(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Lr(bo,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Ue);var qi=Function.prototype.bind;function Or(e,t){return qi.call(e,t)}var Qi=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Kt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Kt(o)}else Kt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Kt(r)}},e}(),at=function(e){oe(t,e);function t(r,o,n){var i=e.call(this)||this,a;if(H(r)||!r)a={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var s;i&&Pe.useDeprecatedNextContext?(s=Object.create(r),s.unsubscribe=function(){return i.unsubscribe()},a={next:r.next&&Or(r.next,s),error:r.error&&Or(r.error,s),complete:r.complete&&Or(r.complete,s)}):a=r}return i.destination=new Qi(a),i}return t}(_t);function Kt(e){Pe.useDeprecatedSynchronousErrorHandling?yo(e):Qt(e)}function Ki(e){throw e}function Lr(e,t){var r=Pe.onStoppedNotification;r&&dt.setTimeout(function(){return r(e,t)})}var Yi={closed:!0,next:be,error:Ki,complete:be};var bt=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function le(e){return e}function xo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Mr(e)}function Mr(e){return e.length===0?le:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var j=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=Gi(t)?t:new at(t,r,o);return ht(function(){var a=n,s=a.operator,p=a.source;i.add(s?s.call(i,p):p?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=Eo(r),new r(function(n,i){var a=new at({next:function(s){try{t(s)}catch(p){i(p),a.unsubscribe()}},error:i,complete:n});o.subscribe(a)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[bt]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Mr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=Eo(t),new t(function(o,n){var i;r.subscribe(function(a){return i=a},function(a){return n(a)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function Eo(e){var t;return(t=e!=null?e:Pe.Promise)!==null&&t!==void 0?t:Promise}function Bi(e){return e&&H(e.next)&&H(e.error)&&H(e.complete)}function Gi(e){return e&&e instanceof _t||Bi(e)&&qt(e)}function Ji(e){return H(e==null?void 0:e.lift)}function E(e){return function(t){if(Ji(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function T(e,t,r,o,n){return new Xi(e,t,r,o,n)}var Xi=function(e){oe(t,e);function t(r,o,n,i,a,s){var p=e.call(this,r)||this;return p.onFinalize=a,p.shouldUnsubscribe=s,p._next=o?function(c){try{o(c)}catch(l){r.error(l)}}:e.prototype._next,p._error=i?function(c){try{i(c)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,p._complete=n?function(){try{n()}catch(c){r.error(c)}finally{this.unsubscribe()}}:e.prototype._complete,p}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(_t);var vt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=vt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Ue(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=vt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,q([],N(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=vt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,q([],N(e)))},delegate:void 0};var wo=ut(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var g=function(e){oe(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new To(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new wo},t.prototype.next=function(r){var o=this;ht(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var a=he(o.currentObservers),s=a.next();!s.done;s=a.next()){var p=s.value;p.next(r)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;ht(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;ht(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Tr:(this.currentObservers=null,s.push(r),new Ue(function(){o.currentObservers=null,Qe(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new j;return r.source=this,r},t.create=function(r,o){return new To(r,o)},t}(j);var To=function(e){oe(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Tr},t}(g);var _r=function(e){oe(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(g);var At={now:function(){return(At.delegate||Date).now()},delegate:void 0};var Ct=function(e){oe(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=At);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,p=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+p)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),p=0;p<s.length&&!r.closed;p+=i?1:2)r.next(s[p]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,a=r._infiniteTimeWindow,s=(a?1:2)*o;if(o<1/0&&s<i.length&&i.splice(0,i.length-s),!a){for(var p=n.now(),c=0,l=1;l<i.length&&i[l]<=p;l+=2)c=l;c&&i.splice(0,c+1)}},t}(g);var So=function(e){oe(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Ue);var kt={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=kt.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,q([e,t],N(r))):setInterval.apply(void 0,q([e,t],N(r)))},clearInterval:function(e){var t=kt.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var gt=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,a=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(a,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(a,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),kt.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&kt.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(a){n=!0,i=a||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,Qe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(So);var Ar=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=At.now,e}();var yt=function(e){oe(t,e);function t(r,o){o===void 0&&(o=Ar.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ar);var se=new yt(gt),Cr=se;var Oo=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(gt);var Lo=function(e){oe(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(yt);var kr=new Lo(Oo);var Mo=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=vt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(vt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(gt);var _o=function(e){oe(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(yt);var me=new _o(Mo);var S=new j(function(e){return e.complete()});function Yt(e){return e&&H(e.schedule)}function Hr(e){return e[e.length-1]}function Xe(e){return H(Hr(e))?e.pop():void 0}function ke(e){return Yt(Hr(e))?e.pop():void 0}function Bt(e,t){return typeof Hr(e)=="number"?e.pop():t}var xt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Gt(e){return H(e==null?void 0:e.then)}function Jt(e){return H(e[bt])}function Xt(e){return Symbol.asyncIterator&&H(e==null?void 0:e[Symbol.asyncIterator])}function Zt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Zi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var er=Zi();function tr(e){return H(e==null?void 0:e[er])}function rr(e){return fo(this,arguments,function(){var r,o,n,i;return Nt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,nt(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,nt(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,nt(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function or(e){return H(e==null?void 0:e.getReader)}function U(e){if(e instanceof j)return e;if(e!=null){if(Jt(e))return ea(e);if(xt(e))return ta(e);if(Gt(e))return ra(e);if(Xt(e))return Ao(e);if(tr(e))return oa(e);if(or(e))return na(e)}throw Zt(e)}function ea(e){return new j(function(t){var r=e[bt]();if(H(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function ta(e){return new j(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function ra(e){return new j(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Qt)})}function oa(e){return new j(function(t){var r,o;try{for(var n=he(e),i=n.next();!i.done;i=n.next()){var a=i.value;if(t.next(a),t.closed)return}}catch(s){r={error:s}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Ao(e){return new j(function(t){ia(e,t).catch(function(r){return t.error(r)})})}function na(e){return Ao(rr(e))}function ia(e,t){var r,o,n,i;return mo(this,void 0,void 0,function(){var a,s;return Nt(this,function(p){switch(p.label){case 0:p.trys.push([0,5,6,11]),r=uo(e),p.label=1;case 1:return[4,r.next()];case 2:if(o=p.sent(),!!o.done)return[3,4];if(a=o.value,t.next(a),t.closed)return[2];p.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return s=p.sent(),n={error:s},[3,11];case 6:return p.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:p.sent(),p.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function we(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function ve(e,t){return t===void 0&&(t=0),E(function(r,o){r.subscribe(T(o,function(n){return we(o,e,function(){return o.next(n)},t)},function(){return we(o,e,function(){return o.complete()},t)},function(n){return we(o,e,function(){return o.error(n)},t)}))})}function Ke(e,t){return t===void 0&&(t=0),E(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function Co(e,t){return U(e).pipe(Ke(t),ve(t))}function ko(e,t){return U(e).pipe(Ke(t),ve(t))}function Ho(e,t){return new j(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function $o(e,t){return new j(function(r){var o;return we(r,t,function(){o=e[er](),we(r,t,function(){var n,i,a;try{n=o.next(),i=n.value,a=n.done}catch(s){r.error(s);return}a?r.complete():r.next(i)},0,!0)}),function(){return H(o==null?void 0:o.return)&&o.return()}})}function nr(e,t){if(!e)throw new Error("Iterable cannot be null");return new j(function(r){we(r,t,function(){var o=e[Symbol.asyncIterator]();we(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function Po(e,t){return nr(rr(e),t)}function Ro(e,t){if(e!=null){if(Jt(e))return Co(e,t);if(xt(e))return Ho(e,t);if(Gt(e))return ko(e,t);if(Xt(e))return nr(e,t);if(tr(e))return $o(e,t);if(or(e))return Po(e,t)}throw Zt(e)}function ue(e,t){return t?Ro(e,t):U(e)}function I(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e);return ue(e,r)}function $r(e,t){var r=H(e)?e:function(){return e},o=function(n){return n.error(r())};return new j(t?function(n){return t.schedule(o,0,n)}:o)}var ir=ut(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Io(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return E(function(r,o){var n=0;r.subscribe(T(o,function(i){o.next(e.call(t,i,n++))}))})}var aa=Array.isArray;function sa(e,t){return aa(t)?e.apply(void 0,q([],N(t))):e(t)}function Ze(e){return m(function(t){return sa(e,t)})}var ca=Array.isArray,pa=Object.getPrototypeOf,la=Object.prototype,ma=Object.keys;function jo(e){if(e.length===1){var t=e[0];if(ca(t))return{args:t,keys:null};if(fa(t)){var r=ma(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function fa(e){return e&&typeof e=="object"&&pa(e)===la}function Fo(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Xe(e),n=jo(e),i=n.args,a=n.keys;if(i.length===0)return ue([],r);var s=new j(Pr(i,r,a?function(p){return Fo(a,p)}:le));return o?s.pipe(Ze(o)):s}function Pr(e,t,r){return r===void 0&&(r=le),function(o){Uo(t,function(){for(var n=e.length,i=new Array(n),a=n,s=n,p=function(l){Uo(t,function(){var f=ue(e[l],t),u=!1;f.subscribe(T(o,function(d){i[l]=d,u||(u=!0,s--),s||o.next(r(i.slice()))},function(){--a||o.complete()}))},o)},c=0;c<n;c++)p(c)},o)}}function Uo(e,t,r){e?we(r,e,t):t()}function Wo(e,t,r,o,n,i,a,s){var p=[],c=0,l=0,f=!1,u=function(){f&&!p.length&&!c&&t.complete()},d=function(L){return c<o?y(L):p.push(L)},y=function(L){i&&t.next(L),c++;var X=!1;U(r(L,l++)).subscribe(T(t,function(te){n==null||n(te),i?d(te):t.next(te)},function(){X=!0},void 0,function(){if(X)try{c--;for(var te=function(){var J=p.shift();a?we(t,a,function(){return y(J)}):y(J)};p.length&&c<o;)te();u()}catch(J){t.error(J)}}))};return e.subscribe(T(t,d,function(){f=!0,u()})),function(){s==null||s()}}function ne(e,t,r){return r===void 0&&(r=1/0),H(t)?ne(function(o,n){return m(function(i,a){return t(o,i,n,a)})(U(e(o,n)))},r):(typeof t=="number"&&(r=t),E(function(o,n){return Wo(o,n,e,r)}))}function Et(e){return e===void 0&&(e=1/0),ne(le,e)}function Do(){return Et(1)}function We(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Do()(ue(e,ke(e)))}function C(e){return new j(function(t){U(e()).subscribe(t)})}var ua=["addListener","removeListener"],da=["addEventListener","removeEventListener"],ha=["on","off"];function h(e,t,r,o){if(H(r)&&(o=r,r=void 0),o)return h(e,t,r).pipe(Ze(o));var n=N(ga(e)?da.map(function(s){return function(p){return e[s](t,p,r)}}):ba(e)?ua.map(Vo(e,t)):va(e)?ha.map(Vo(e,t)):[],2),i=n[0],a=n[1];if(!i&&xt(e))return ne(function(s){return h(s,t,r)})(U(e));if(!i)throw new TypeError("Invalid event target");return new j(function(s){var p=function(){for(var c=[],l=0;l<arguments.length;l++)c[l]=arguments[l];return s.next(1<c.length?c:c[0])};return i(p),function(){return a(p)}})}function Vo(e,t){return function(r){return function(o){return e[r](t,o)}}}function ba(e){return H(e.addListener)&&H(e.removeListener)}function va(e){return H(e.on)&&H(e.off)}function ga(e){return H(e.addEventListener)&&H(e.removeEventListener)}function ar(e,t,r){return r?ar(e,t).pipe(Ze(r)):new j(function(o){var n=function(){for(var a=[],s=0;s<arguments.length;s++)a[s]=arguments[s];return o.next(a.length===1?a[0]:a)},i=e(n);return H(t)?function(){return t(n,i)}:void 0})}function Le(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Cr);var o=-1;return t!=null&&(Yt(t)?r=t:o=t),new j(function(n){var i=Io(e)?+e-r.now():e;i<0&&(i=0);var a=0;return r.schedule(function(){n.closed||(n.next(a++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function O(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Bt(e,1/0),n=e;return n.length?n.length===1?U(n[0]):Et(o)(ue(n,r)):S}var Ye=new j(be);var ya=Array.isArray;function wt(e){return e.length===1&&ya(e[0])?e[0]:e}function b(e,t){return E(function(r,o){var n=0;r.subscribe(T(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function st(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e),o=wt(e);return o.length?new j(function(n){var i=o.map(function(){return[]}),a=o.map(function(){return!1});n.add(function(){i=a=null});for(var s=function(c){U(o[c]).subscribe(T(n,function(l){if(i[c].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,q([],N(f))):f),i.some(function(u,d){return!u.length&&a[d]})&&n.complete()}},function(){a[c]=!0,!i[c].length&&n.complete()}))},p=0;!n.closed&&p<o.length;p++)s(p);return function(){i=a=null}}):S}function No(e){return E(function(t,r){var o=!1,n=null,i=null,a=!1,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var c=n;n=null,r.next(c)}a&&r.complete()},p=function(){i=null,a&&r.complete()};t.subscribe(T(r,function(c){o=!0,n=c,i||U(e(c)).subscribe(i=T(r,s,p))},function(){a=!0,(!o||!i||i.closed)&&r.complete()}))})}function Me(e,t){return t===void 0&&(t=se),No(function(){return Le(e,t)})}function Be(e,t){return t===void 0&&(t=null),t=t!=null?t:e,E(function(r,o){var n=[],i=0;r.subscribe(T(o,function(a){var s,p,c,l,f=null;i++%t===0&&n.push([]);try{for(var u=he(n),d=u.next();!d.done;d=u.next()){var y=d.value;y.push(a),e<=y.length&&(f=f!=null?f:[],f.push(y))}}catch(te){s={error:te}}finally{try{d&&!d.done&&(p=u.return)&&p.call(u)}finally{if(s)throw s.error}}if(f)try{for(var L=he(f),X=L.next();!X.done;X=L.next()){var y=X.value;Qe(n,y),o.next(y)}}catch(te){c={error:te}}finally{try{X&&!X.done&&(l=L.return)&&l.call(L)}finally{if(c)throw c.error}}},function(){var a,s;try{for(var p=he(n),c=p.next();!c.done;c=p.next()){var l=c.value;o.next(l)}}catch(f){a={error:f}}finally{try{c&&!c.done&&(s=p.return)&&s.call(p)}finally{if(a)throw a.error}}o.complete()},void 0,function(){n=null}))})}function de(e){return E(function(t,r){var o=null,n=!1,i;o=t.subscribe(T(r,void 0,void 0,function(a){i=U(e(a,de(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function zo(e,t,r,o,n){return function(i,a){var s=r,p=t,c=0;i.subscribe(T(a,function(l){var f=c++;p=s?e(p,l,f):(s=!0,l),o&&a.next(p)},n&&function(){s&&a.next(p),a.complete()}))}}function Rr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return r?xo(Rr.apply(void 0,q([],N(e))),Ze(r)):E(function(o,n){Pr(q([o],N(wt(e))))(n)})}function He(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Rr.apply(void 0,q([],N(e)))}function Ht(e){return E(function(t,r){var o=!1,n=null,i=null,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var s=n;n=null,r.next(s)}};t.subscribe(T(r,function(s){i==null||i.unsubscribe(),o=!0,n=s,i=T(r,a,be),U(e(s)).subscribe(i)},function(){a(),r.complete()},void 0,function(){n=i=null}))})}function _e(e,t){return t===void 0&&(t=se),E(function(r,o){var n=null,i=null,a=null,s=function(){if(n){n.unsubscribe(),n=null;var c=i;i=null,o.next(c)}};function p(){var c=a+e,l=t.now();if(l<c){n=this.schedule(void 0,c-l),o.add(n);return}s()}r.subscribe(T(o,function(c){i=c,a=t.now(),n||(n=t.schedule(p,e),o.add(n))},function(){s(),o.complete()},void 0,function(){i=n=null}))})}function De(e){return E(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Te(e){return e<=0?function(){return S}:E(function(t,r){var o=0;t.subscribe(T(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function Z(){return E(function(e,t){e.subscribe(T(t,be))})}function qo(e){return m(function(){return e})}function Ir(e,t){return t?function(r){return We(t.pipe(Te(1),Z()),r.pipe(Ir(e)))}:ne(function(r,o){return U(e(r,o)).pipe(Te(1),qo(r))})}function Ge(e,t){t===void 0&&(t=se);var r=Le(e,t);return Ir(function(){return r})}function K(e,t){return t===void 0&&(t=le),e=e!=null?e:xa,E(function(r,o){var n,i=!0;r.subscribe(T(o,function(a){var s=t(a);(i||!e(n,s))&&(i=!1,n=s,o.next(a))}))})}function xa(e,t){return e===t}function ee(e,t){return K(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function Qo(e){return e===void 0&&(e=Ea),E(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function Ea(){return new ir}function ie(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return We(r,I.apply(void 0,q([],N(e))))}}function _(e){return E(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Ae(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?b(function(n,i){return e(n,i,o)}):le,Te(1),r?De(t):Qo(function(){return new ir}))}}function jr(e){return e<=0?function(){return S}:E(function(t,r){var o=[];t.subscribe(T(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var a=he(o),s=a.next();!s.done;s=a.next()){var p=s.value;r.next(p)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function Ko(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Bt(e,1/0);return e=wt(e),E(function(n,i){Et(o)(ue(q([n],N(e)),r)).subscribe(i)})}function Re(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Ko.apply(void 0,q([],N(e)))}function ct(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return S}:E(function(n,i){var a=0,s,p=function(){if(s==null||s.unsubscribe(),s=null,o!=null){var l=typeof o=="number"?Le(o):U(o(a)),f=T(i,function(){f.unsubscribe(),c()});l.subscribe(f)}else c()},c=function(){var l=!1;s=n.subscribe(T(i,void 0,function(){++a<r?s?p():l=!0:i.complete()})),l&&p()};c()})}function Fr(e,t){return E(zo(e,t,arguments.length>=2,!0))}function pe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new g}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,p=s===void 0?!0:s;return function(c){var l,f,u,d=0,y=!1,L=!1,X=function(){f==null||f.unsubscribe(),f=void 0},te=function(){X(),l=u=void 0,y=L=!1},J=function(){var k=l;te(),k==null||k.unsubscribe()};return E(function(k,ft){d++,!L&&!y&&X();var qe=u=u!=null?u:r();ft.add(function(){d--,d===0&&!L&&!y&&(f=Ur(J,p))}),qe.subscribe(ft),!l&&d>0&&(l=new at({next:function(Fe){return qe.next(Fe)},error:function(Fe){L=!0,X(),f=Ur(te,n,Fe),qe.error(Fe)},complete:function(){y=!0,X(),f=Ur(te,a),qe.complete()}}),U(k).subscribe(l))})(c)}}function Ur(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new at({next:function(){n.unsubscribe(),e()}});return U(t.apply(void 0,q([],N(r)))).subscribe(n)}}function G(e,t,r){var o,n,i,a,s=!1;return e&&typeof e=="object"?(o=e.bufferSize,a=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,s=i===void 0?!1:i,r=e.scheduler):a=e!=null?e:1/0,pe({connector:function(){return new Ct(a,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:s})}function Ce(e){return b(function(t,r){return e<=r})}function Wr(e){return E(function(t,r){var o=!1,n=T(r,function(){n==null||n.unsubscribe(),o=!0},be);U(e).subscribe(n),t.subscribe(T(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e);return E(function(o,n){(r?We(e,o,r):We(e,o)).subscribe(n)})}function v(e,t){return E(function(r,o){var n=null,i=0,a=!1,s=function(){return a&&!n&&o.complete()};r.subscribe(T(o,function(p){n==null||n.unsubscribe();var c=0,l=i++;U(e(p,l)).subscribe(n=T(o,function(f){return o.next(t?t(p,f,l,c++):f)},function(){n=null,s()}))},function(){a=!0,s()}))})}function W(e){return E(function(t,r){U(e).subscribe(T(r,function(){return r.complete()},be)),!r.closed&&t.subscribe(r)})}function Dr(e,t){return t===void 0&&(t=!1),E(function(r,o){var n=0;r.subscribe(T(o,function(i){var a=e(i,n++);(a||t)&&o.next(i),!a&&o.complete()}))})}function w(e,t,r){var o=H(e)||t||r?{next:e,error:t,complete:r}:e;return o?E(function(n,i){var a;(a=o.subscribe)===null||a===void 0||a.call(o);var s=!0;n.subscribe(T(i,function(p){var c;(c=o.next)===null||c===void 0||c.call(o,p),i.next(p)},function(){var p;s=!1,(p=o.complete)===null||p===void 0||p.call(o),i.complete()},function(p){var c;s=!1,(c=o.error)===null||c===void 0||c.call(o,p),i.error(p)},function(){var p,c;s&&((p=o.unsubscribe)===null||p===void 0||p.call(o)),(c=o.finalize)===null||c===void 0||c.call(o)}))}):le}function Yo(e,t){return E(function(r,o){var n=t!=null?t:{},i=n.leading,a=i===void 0?!0:i,s=n.trailing,p=s===void 0?!1:s,c=!1,l=null,f=null,u=!1,d=function(){f==null||f.unsubscribe(),f=null,p&&(X(),u&&o.complete())},y=function(){f=null,u&&o.complete()},L=function(te){return f=U(e(te)).subscribe(T(o,d,y))},X=function(){if(c){c=!1;var te=l;l=null,o.next(te),!u&&L(te)}};r.subscribe(T(o,function(te){c=!0,l=te,!(f&&!f.closed)&&(a?X():L(te))},function(){u=!0,!(p&&c&&f&&!f.closed)&&o.complete()}))})}function pt(e,t,r){t===void 0&&(t=se);var o=Le(e,t);return Yo(function(){return o},r)}function re(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return E(function(o,n){for(var i=e.length,a=new Array(i),s=e.map(function(){return!1}),p=!1,c=function(f){U(e[f]).subscribe(T(n,function(u){a[f]=u,!p&&!s[f]&&(s[f]=!0,(p=s.every(le))&&(s=null))},be))},l=0;l<i;l++)c(l);o.subscribe(T(n,function(f){if(p){var u=q([f],N(a));n.next(r?r.apply(void 0,q([],N(u))):u)}}))})}function Bo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return E(function(r,o){st.apply(void 0,q([r],N(e))).subscribe(o)})}function Vr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Bo.apply(void 0,q([],N(e)))}function Go(){let e=new Ct(1);return h(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function P(e,t=document){return Array.from(t.querySelectorAll(e))}function R(e,t=document){let r=fe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function fe(e,t=document){return t.querySelector(e)||void 0}function Ie(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var wa=O(h(document.body,"focusin"),h(document.body,"focusout")).pipe(_e(1),Q(void 0),m(()=>Ie()||document.body),G(1));function et(e){return wa.pipe(m(t=>e.contains(t)),K())}function $t(e,t){return C(()=>O(h(e,"mouseenter").pipe(m(()=>!0)),h(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ht(r=>Le(+!r*t)):le,Q(e.matches(":hover"))))}function Jo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Jo(e,r)}function x(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Jo(o,n);return o}function sr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function Tt(e){let t=x("script",{src:e});return C(()=>(document.head.appendChild(t),O(h(t,"load"),h(t,"error").pipe(v(()=>$r(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),_(()=>document.head.removeChild(t)),Te(1))))}var Xo=new g,Ta=C(()=>typeof ResizeObserver=="undefined"?Tt("https://unpkg.com/resize-observer-polyfill"):I(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>Xo.next(t)))),v(e=>O(Ye,I(e)).pipe(_(()=>e.disconnect()))),G(1));function ce(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return Ta.pipe(w(r=>r.observe(t)),v(r=>Xo.pipe(b(o=>o.target===t),_(()=>r.unobserve(t)))),m(()=>ce(e)),Q(ce(e)))}function St(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function Zo(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Ve(e){return{x:e.offsetLeft,y:e.offsetTop}}function en(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function tn(e){return O(h(window,"load"),h(window,"resize")).pipe(Me(0,me),m(()=>Ve(e)),Q(Ve(e)))}function pr(e){return{x:e.scrollLeft,y:e.scrollTop}}function Ne(e){return O(h(e,"scroll"),h(window,"scroll"),h(window,"resize")).pipe(Me(0,me),m(()=>pr(e)),Q(pr(e)))}var rn=new g,Sa=C(()=>I(new IntersectionObserver(e=>{for(let t of e)rn.next(t)},{threshold:0}))).pipe(v(e=>O(Ye,I(e)).pipe(_(()=>e.disconnect()))),G(1));function tt(e){return Sa.pipe(w(t=>t.observe(e)),v(t=>rn.pipe(b(({target:r})=>r===e),_(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function on(e,t=16){return Ne(e).pipe(m(({y:r})=>{let o=ce(e),n=St(e);return r>=n.height-o.height-t}),K())}var lr={drawer:R("[data-md-toggle=drawer]"),search:R("[data-md-toggle=search]")};function nn(e){return lr[e].checked}function Je(e,t){lr[e].checked!==t&&lr[e].click()}function ze(e){let t=lr[e];return h(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function Oa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function La(){return O(h(window,"compositionstart").pipe(m(()=>!0)),h(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function an(){let e=h(window,"keydown").pipe(b(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:nn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),b(({mode:t,type:r})=>{if(t==="global"){let o=Ie();if(typeof o!="undefined")return!Oa(o,r)}return!0}),pe());return La().pipe(v(t=>t?S:e))}function ye(){return new URL(location.href)}function lt(e,t=!1){if(B("navigation.instant")&&!t){let r=x("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function sn(){return new g}function cn(){return location.hash.slice(1)}function pn(e){let t=x("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Ma(e){return O(h(window,"hashchange"),e).pipe(m(cn),Q(cn()),b(t=>t.length>0),G(1))}function ln(e){return Ma(e).pipe(m(t=>fe(`[id="${t}"]`)),b(t=>typeof t!="undefined"))}function Pt(e){let t=matchMedia(e);return ar(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function mn(){let e=matchMedia("print");return O(h(window,"beforeprint").pipe(m(()=>!0)),h(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function Nr(e,t){return e.pipe(v(r=>r?t():S))}function zr(e,t){return new j(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let a=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+a*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function je(e,t){return zr(e,t).pipe(v(r=>r.text()),m(r=>JSON.parse(r)),G(1))}function fn(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),G(1))}function un(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),G(1))}function dn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function hn(){return O(h(window,"scroll",{passive:!0}),h(window,"resize",{passive:!0})).pipe(m(dn),Q(dn()))}function bn(){return{width:innerWidth,height:innerHeight}}function vn(){return h(window,"resize",{passive:!0}).pipe(m(bn),Q(bn()))}function gn(){return z([hn(),vn()]).pipe(m(([e,t])=>({offset:e,size:t})),G(1))}function mr(e,{viewport$:t,header$:r}){let o=t.pipe(ee("size")),n=z([o,r]).pipe(m(()=>Ve(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:p,y:c}])=>({offset:{x:a.x-p,y:a.y-c+i},size:s})))}function _a(e){return h(e,"message",t=>t.data)}function Aa(e){let t=new g;return t.subscribe(r=>e.postMessage(r)),t}function yn(e,t=new Worker(e)){let r=_a(t),o=Aa(t),n=new g;n.subscribe(o);let i=o.pipe(Z(),ie(!0));return n.pipe(Z(),Re(r.pipe(W(i))),pe())}var Ca=R("#__config"),Ot=JSON.parse(Ca.textContent);Ot.base=`${new URL(Ot.base,ye())}`;function xe(){return Ot}function B(e){return Ot.features.includes(e)}function Ee(e,t){return typeof t!="undefined"?Ot.translations[e].replace("#",t.toString()):Ot.translations[e]}function Se(e,t=document){return R(`[data-md-component=${e}]`,t)}function ae(e,t=document){return P(`[data-md-component=${e}]`,t)}function ka(e){let t=R(".md-typeset > :first-child",e);return h(t,"click",{once:!0}).pipe(m(()=>R(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function xn(e){if(!B("announce.dismiss")||!e.childElementCount)return S;if(!e.hidden){let t=R(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return C(()=>{let t=new g;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),ka(e).pipe(w(r=>t.next(r)),_(()=>t.complete()),m(r=>$({ref:e},r)))})}function Ha(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function En(e,t){let r=new g;return r.subscribe(({hidden:o})=>{e.hidden=o}),Ha(e,t).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))}function Rt(e,t){return t==="inline"?x("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"})):x("div",{class:"md-tooltip",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"}))}function wn(...e){return x("div",{class:"md-tooltip2",role:"tooltip"},x("div",{class:"md-tooltip2__inner md-typeset"},e))}function Tn(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return x("aside",{class:"md-annotation",tabIndex:0},Rt(t),x("a",{href:r,class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}else return x("aside",{class:"md-annotation",tabIndex:0},Rt(t),x("span",{class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}function Sn(e){return x("button",{class:"md-clipboard md-icon",title:Ee("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}var Ln=Mt(qr());function Qr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(p=>!e.terms[p]).reduce((p,c)=>[...p,x("del",null,(0,Ln.default)(c))," "],[]).slice(0,-1),i=xe(),a=new URL(e.location,i.base);B("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,p])=>p).reduce((p,[c])=>`${p} ${c}`.trim(),""));let{tags:s}=xe();return x("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},x("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&x("div",{class:"md-search-result__icon md-icon"}),r>0&&x("h1",null,e.title),r<=0&&x("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&x("nav",{class:"md-tags"},e.tags.map(p=>{let c=s?p in s?`md-tag-icon md-tag--${s[p]}`:"md-tag-icon":"";return x("span",{class:`md-tag ${c}`},p)})),o>0&&n.length>0&&x("p",{class:"md-search-result__terms"},Ee("search.result.term.missing"),": ",...n)))}function Mn(e){let t=e[0].score,r=[...e],o=xe(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.score<t);a===-1&&(a=r.length);let s=r.slice(0,a),p=r.slice(a),c=[Qr(i,2|+(!n&&a===0)),...s.map(l=>Qr(l,1)),...p.length?[x("details",{class:"md-search-result__more"},x("summary",{tabIndex:-1},x("div",null,p.length>0&&p.length===1?Ee("search.result.more.one"):Ee("search.result.more.other",p.length))),...p.map(l=>Qr(l,1)))]:[]];return x("li",{class:"md-search-result__item"},c)}function _n(e){return x("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>x("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?sr(r):r)))}function Kr(e){let t=`tabbed-control tabbed-control--${e}`;return x("div",{class:t,hidden:!0},x("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function An(e){return x("div",{class:"md-typeset__scrollwrap"},x("div",{class:"md-typeset__table"},e))}function Ra(e){var o;let t=xe(),r=new URL(`../${e.version}/`,t.base);return x("li",{class:"md-version__item"},x("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&x("span",{class:"md-version__alias"},e.aliases[0])))}function Cn(e,t){var o;let r=xe();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),x("div",{class:"md-version"},x("button",{class:"md-version__current","aria-label":Ee("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&x("span",{class:"md-version__alias"},t.aliases[0])),x("ul",{class:"md-version__list"},e.map(Ra)))}var Ia=0;function ja(e){let t=z([et(e),$t(e)]).pipe(m(([o,n])=>o||n),K()),r=C(()=>Zo(e)).pipe(ne(Ne),pt(1),He(t),m(()=>en(e)));return t.pipe(Ae(o=>o),v(()=>z([t,r])),m(([o,n])=>({active:o,offset:n})),pe())}function Fa(e,t){let{content$:r,viewport$:o}=t,n=`__tooltip2_${Ia++}`;return C(()=>{let i=new g,a=new _r(!1);i.pipe(Z(),ie(!1)).subscribe(a);let s=a.pipe(Ht(c=>Le(+!c*250,kr)),K(),v(c=>c?r:S),w(c=>c.id=n),pe());z([i.pipe(m(({active:c})=>c)),s.pipe(v(c=>$t(c,250)),Q(!1))]).pipe(m(c=>c.some(l=>l))).subscribe(a);let p=a.pipe(b(c=>c),re(s,o),m(([c,l,{size:f}])=>{let u=e.getBoundingClientRect(),d=u.width/2;if(l.role==="tooltip")return{x:d,y:8+u.height};if(u.y>=f.height/2){let{height:y}=ce(l);return{x:d,y:-16-y}}else return{x:d,y:16+u.height}}));return z([s,i,p]).subscribe(([c,{offset:l},f])=>{c.style.setProperty("--md-tooltip-host-x",`${l.x}px`),c.style.setProperty("--md-tooltip-host-y",`${l.y}px`),c.style.setProperty("--md-tooltip-x",`${f.x}px`),c.style.setProperty("--md-tooltip-y",`${f.y}px`),c.classList.toggle("md-tooltip2--top",f.y<0),c.classList.toggle("md-tooltip2--bottom",f.y>=0)}),a.pipe(b(c=>c),re(s,(c,l)=>l),b(c=>c.role==="tooltip")).subscribe(c=>{let l=ce(R(":scope > *",c));c.style.setProperty("--md-tooltip-width",`${l.width}px`),c.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(K(),ve(me),re(s)).subscribe(([c,l])=>{l.classList.toggle("md-tooltip2--active",c)}),z([a.pipe(b(c=>c)),s]).subscribe(([c,l])=>{l.role==="dialog"?(e.setAttribute("aria-controls",n),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",n)}),a.pipe(b(c=>!c)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),ja(e).pipe(w(c=>i.next(c)),_(()=>i.complete()),m(c=>$({ref:e},c)))})}function mt(e,{viewport$:t},r=document.body){return Fa(e,{content$:new j(o=>{let n=e.title,i=wn(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t})}function Ua(e,t){let r=C(()=>z([tn(e),Ne(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ce(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return et(e).pipe(v(o=>r.pipe(m(n=>({active:o,offset:n})),Te(+!o||1/0))))}function kn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return C(()=>{let i=new g,a=i.pipe(Z(),ie(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),tt(e).pipe(W(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),O(i.pipe(b(({active:s})=>s)),i.pipe(_e(250),b(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Me(16,me)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(pt(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),h(n,"click").pipe(W(a),b(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),h(n,"mousedown").pipe(W(a),re(i)).subscribe(([s,{active:p}])=>{var c;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(p){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(c=Ie())==null||c.blur()}}),r.pipe(W(a),b(s=>s===o),Ge(125)).subscribe(()=>e.focus()),Ua(e,t).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))})}function Wa(e){return e.tagName==="CODE"?P(".c, .c1, .cm",e):[e]}function Da(e){let t=[];for(let r of Wa(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,p]=a;if(typeof p=="undefined"){let c=i.splitText(a.index);i=c.splitText(s.length),t.push(c)}else{i.textContent=s,t.push(i);break}}}}return t}function Hn(e,t){t.append(...Array.from(e.childNodes))}function fr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Da(t)){let[,p]=s.textContent.match(/\((\d+)\)/);fe(`:scope > li:nth-child(${p})`,e)&&(a.set(p,Tn(p,i)),s.replaceWith(a.get(p)))}return a.size===0?S:C(()=>{let s=new g,p=s.pipe(Z(),ie(!0)),c=[];for(let[l,f]of a)c.push([R(".md-typeset",f),R(`:scope > li:nth-child(${l})`,e)]);return o.pipe(W(p)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of c)l?Hn(f,u):Hn(u,f)}),O(...[...a].map(([,l])=>kn(l,t,{target$:r}))).pipe(_(()=>s.complete()),pe())})}function $n(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return $n(t)}}function Pn(e,t){return C(()=>{let r=$n(e);return typeof r!="undefined"?fr(r,e,t):S})}var Rn=Mt(Br());var Va=0;function In(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return In(t)}}function Na(e){return ge(e).pipe(m(({width:t})=>({scrollable:St(e).width>t})),ee("scrollable"))}function jn(e,t){let{matches:r}=matchMedia("(hover)"),o=C(()=>{let n=new g,i=n.pipe(jr(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=[];if(Rn.default.isSupported()&&(e.closest(".copy")||B("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${Va++}`;let l=Sn(c.id);c.insertBefore(l,e),B("content.tooltips")&&a.push(mt(l,{viewport$}))}let s=e.closest(".highlight");if(s instanceof HTMLElement){let c=In(s);if(typeof c!="undefined"&&(s.classList.contains("annotate")||B("content.code.annotate"))){let l=fr(c,e,t);a.push(ge(s).pipe(W(i),m(({width:f,height:u})=>f&&u),K(),v(f=>f?l:S)))}}return P(":scope > span[id]",e).length&&e.classList.add("md-code__content"),Na(e).pipe(w(c=>n.next(c)),_(()=>n.complete()),m(c=>$({ref:e},c)),Re(...a))});return B("content.lazy")?tt(e).pipe(b(n=>n),Te(1),v(()=>o)):o}function za(e,{target$:t,print$:r}){let o=!0;return O(t.pipe(m(n=>n.closest("details:not([open])")),b(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(b(n=>n||!o),w(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Fn(e,t){return C(()=>{let r=new g;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),za(e,t).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}var Un=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel p,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel p{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var Gr,Qa=0;function Ka(){return typeof mermaid=="undefined"||mermaid instanceof Element?Tt("https://unpkg.com/mermaid@11/dist/mermaid.min.js"):I(void 0)}function Wn(e){return e.classList.remove("mermaid"),Gr||(Gr=Ka().pipe(w(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Un,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),G(1))),Gr.subscribe(()=>co(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Qa++}`,r=x("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})),Gr.pipe(m(()=>({ref:e})))}var Dn=x("table");function Vn(e){return e.replaceWith(Dn),Dn.replaceWith(An(e)),I({ref:e})}function Ya(e){let t=e.find(r=>r.checked)||e[0];return O(...e.map(r=>h(r,"change").pipe(m(()=>R(`label[for="${r.id}"]`))))).pipe(Q(R(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Nn(e,{viewport$:t,target$:r}){let o=R(".tabbed-labels",e),n=P(":scope > input",e),i=Kr("prev");e.append(i);let a=Kr("next");return e.append(a),C(()=>{let s=new g,p=s.pipe(Z(),ie(!0));z([s,ge(e),tt(e)]).pipe(W(p),Me(1,me)).subscribe({next([{active:c},l]){let f=Ve(c),{width:u}=ce(c);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let d=pr(o);(f.x<d.x||f.x+u>d.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([Ne(o),ge(o)]).pipe(W(p)).subscribe(([c,l])=>{let f=St(o);i.hidden=c.x<16,a.hidden=c.x>f.width-l.width-16}),O(h(i,"click").pipe(m(()=>-1)),h(a,"click").pipe(m(()=>1))).pipe(W(p)).subscribe(c=>{let{width:l}=ce(o);o.scrollBy({left:l*c,behavior:"smooth"})}),r.pipe(W(p),b(c=>n.includes(c))).subscribe(c=>c.click()),o.classList.add("tabbed-labels--linked");for(let c of n){let l=R(`label[for="${c.id}"]`);l.replaceChildren(x("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),h(l.firstElementChild,"click").pipe(W(p),b(f=>!(f.metaKey||f.ctrlKey)),w(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return B("content.tabs.link")&&s.pipe(Ce(1),re(t)).subscribe(([{active:c},{offset:l}])=>{let f=c.innerText.trim();if(c.hasAttribute("data-md-switching"))c.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let y of P("[data-tabs]"))for(let L of P(":scope > input",y)){let X=R(`label[for="${L.id}"]`);if(X!==c&&X.innerText.trim()===f){X.setAttribute("data-md-switching",""),L.click();break}}window.scrollTo({top:e.offsetTop-u});let d=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...d])])}}),s.pipe(W(p)).subscribe(()=>{for(let c of P("audio, video",e))c.pause()}),Ya(n).pipe(w(c=>s.next(c)),_(()=>s.complete()),m(c=>$({ref:e},c)))}).pipe(Ke(se))}function zn(e,{viewport$:t,target$:r,print$:o}){return O(...P(".annotate:not(.highlight)",e).map(n=>Pn(n,{target$:r,print$:o})),...P("pre:not(.mermaid) > code",e).map(n=>jn(n,{target$:r,print$:o})),...P("pre.mermaid",e).map(n=>Wn(n)),...P("table:not([class])",e).map(n=>Vn(n)),...P("details",e).map(n=>Fn(n,{target$:r,print$:o})),...P("[data-tabs]",e).map(n=>Nn(n,{viewport$:t,target$:r})),...P("[title]",e).filter(()=>B("content.tooltips")).map(n=>mt(n,{viewport$:t})))}function Ba(e,{alert$:t}){return t.pipe(v(r=>O(I(!0),I(!1).pipe(Ge(2e3))).pipe(m(o=>({message:r,active:o})))))}function qn(e,t){let r=R(".md-typeset",e);return C(()=>{let o=new g;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),Ba(e,t).pipe(w(n=>o.next(n)),_(()=>o.complete()),m(n=>$({ref:e},n)))})}var Ga=0;function Ja(e,t){document.body.append(e);let{width:r}=ce(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=cr(t),n=typeof o!="undefined"?Ne(o):I({x:0,y:0}),i=O(et(t),$t(t)).pipe(K());return z([i,n]).pipe(m(([a,s])=>{let{x:p,y:c}=Ve(t),l=ce(t),f=t.closest("table");return f&&t.parentElement&&(p+=f.offsetLeft+t.parentElement.offsetLeft,c+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:p-s.x+l.width/2-r/2,y:c-s.y+l.height+8}}}))}function Qn(e){let t=e.title;if(!t.length)return S;let r=`__tooltip_${Ga++}`,o=Rt(r,"inline"),n=R(".md-typeset",o);return n.innerHTML=t,C(()=>{let i=new g;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),O(i.pipe(b(({active:a})=>a)),i.pipe(_e(250),b(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Me(16,me)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(pt(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Ja(o,e).pipe(w(a=>i.next(a)),_(()=>i.complete()),m(a=>$({ref:e},a)))}).pipe(Ke(se))}function Xa({viewport$:e}){if(!B("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Be(2,1),m(([n,i])=>[n<i,i]),ee(0)),r=z([e,t]).pipe(b(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),K()),o=ze("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),K(),v(n=>n?r:I(!1)),Q(!1))}function Kn(e,t){return C(()=>z([ge(e),Xa(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),K((r,o)=>r.height===o.height&&r.hidden===o.hidden),G(1))}function Yn(e,{header$:t,main$:r}){return C(()=>{let o=new g,n=o.pipe(Z(),ie(!0));o.pipe(ee("active"),He(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=ue(P("[title]",e)).pipe(b(()=>B("content.tooltips")),ne(a=>Qn(a)));return r.subscribe(o),t.pipe(W(n),m(a=>$({ref:e},a)),Re(i.pipe(W(n))))})}function Za(e,{viewport$:t,header$:r}){return mr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ce(e);return{active:o>=n}}),ee("active"))}function Bn(e,t){return C(()=>{let r=new g;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=fe(".md-content h1");return typeof o=="undefined"?S:Za(o,t).pipe(w(n=>r.next(n)),_(()=>r.complete()),m(n=>$({ref:e},n)))})}function Gn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),K()),n=o.pipe(v(()=>ge(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),ee("bottom"))));return z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:p},size:{height:c}}])=>(c=Math.max(0,c-Math.max(0,a-p,i)-Math.max(0,c+p-s)),{offset:a-i,height:c,active:a-i<=p})),K((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function es(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return I(...e).pipe(ne(o=>h(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),G(1))}function Jn(e){let t=P("input",e),r=x("meta",{name:"theme-color"});document.head.appendChild(r);let o=x("meta",{name:"color-scheme"});document.head.appendChild(o);let n=Pt("(prefers-color-scheme: light)");return C(()=>{let i=new g;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),p=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=p.getAttribute("data-md-color-scheme"),a.color.primary=p.getAttribute("data-md-color-primary"),a.color.accent=p.getAttribute("data-md-color-accent")}for(let[s,p]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,p);for(let s=0;s<t.length;s++){let p=t[s].nextElementSibling;p instanceof HTMLElement&&(p.hidden=a.index!==s)}__md_set("__palette",a)}),h(e,"keydown").pipe(b(a=>a.key==="Enter"),re(i,(a,s)=>s)).subscribe(({index:a})=>{a=(a+1)%t.length,t[a].click(),t[a].focus()}),i.pipe(m(()=>{let a=Se("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(p=>(+p).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(ve(se)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),es(t).pipe(W(n.pipe(Ce(1))),ct(),w(a=>i.next(a)),_(()=>i.complete()),m(a=>$({ref:e},a)))})}function Xn(e,{progress$:t}){return C(()=>{let r=new g;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(w(o=>r.next({value:o})),_(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Jr=Mt(Br());function ts(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Zn({alert$:e}){Jr.default.isSupported()&&new j(t=>{new Jr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||ts(R(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(w(t=>{t.trigger.focus()}),m(()=>Ee("clipboard.copied"))).subscribe(e)}function ei(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function rs(e,t){let r=new Map;for(let o of P("url",e)){let n=R("loc",o),i=[ei(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let a of P("[rel=alternate]",o)){let s=a.getAttribute("href");s!=null&&i.push(ei(new URL(s),t))}}return r}function ur(e){return un(new URL("sitemap.xml",e)).pipe(m(t=>rs(t,new URL(e))),de(()=>I(new Map)))}function os(e,t){if(!(e.target instanceof Element))return S;let r=e.target.closest("a");if(r===null)return S;if(r.target||e.metaKey||e.ctrlKey)return S;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),I(new URL(r.href))):S}function ti(e){let t=new Map;for(let r of P(":scope > *",e.head))t.set(r.outerHTML,r);return t}function ri(e){for(let t of P("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return I(e)}function ns(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...B("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=fe(o),i=fe(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=ti(document);for(let[o,n]of ti(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Se("container");return We(P("script",r)).pipe(v(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new j(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),S}),Z(),ie(document))}function oi({location$:e,viewport$:t,progress$:r}){let o=xe();if(location.protocol==="file:")return S;let n=ur(o.base);I(document).subscribe(ri);let i=h(document.body,"click").pipe(He(n),v(([p,c])=>os(p,c)),pe()),a=h(window,"popstate").pipe(m(ye),pe());i.pipe(re(t)).subscribe(([p,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",p)}),O(i,a).subscribe(e);let s=e.pipe(ee("pathname"),v(p=>fn(p,{progress$:r}).pipe(de(()=>(lt(p,!0),S)))),v(ri),v(ns),pe());return O(s.pipe(re(e,(p,c)=>c)),s.pipe(v(()=>e),ee("pathname"),v(()=>e),ee("hash")),e.pipe(K((p,c)=>p.pathname===c.pathname&&p.hash===c.hash),v(()=>i),w(()=>history.back()))).subscribe(p=>{var c,l;history.state!==null||!p.hash?window.scrollTo(0,(l=(c=history.state)==null?void 0:c.y)!=null?l:0):(history.scrollRestoration="auto",pn(p.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),h(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(ee("offset"),_e(100)).subscribe(({offset:p})=>{history.replaceState(p,"")}),s}var ni=Mt(qr());function ii(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}<mark data-md-highlight>${a}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ni.default)(a).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function jt(e){return e.type===1}function dr(e){return e.type===3}function ai(e,t){let r=yn(e);return O(I(location.protocol!=="file:"),ze("search")).pipe(Ae(o=>o),v(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:B("search.suggest")}}})),r}function si(e){var l;let{selectedVersionSitemap:t,selectedVersionBaseURL:r,currentLocation:o,currentBaseURL:n}=e,i=(l=Xr(n))==null?void 0:l.pathname;if(i===void 0)return;let a=ss(o.pathname,i);if(a===void 0)return;let s=ps(t.keys());if(!t.has(s))return;let p=Xr(a,s);if(!p||!t.has(p.href))return;let c=Xr(a,r);if(c)return c.hash=o.hash,c.search=o.search,c}function Xr(e,t){try{return new URL(e,t)}catch(r){return}}function ss(e,t){if(e.startsWith(t))return e.slice(t.length)}function cs(e,t){let r=Math.min(e.length,t.length),o;for(o=0;o<r&&e[o]===t[o];++o);return o}function ps(e){let t;for(let r of e)t===void 0?t=r:t=t.slice(0,cs(t,r));return t!=null?t:""}function ci({document$:e}){let t=xe(),r=je(new URL("../versions.json",t.base)).pipe(de(()=>S)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),v(n=>h(document.body,"click").pipe(b(i=>!i.metaKey&&!i.ctrlKey),re(o),v(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let p=s.href;return!i.target.closest(".md-version")&&n.get(p)===a?S:(i.preventDefault(),I(new URL(p)))}}return S}),v(i=>ur(i).pipe(m(a=>{var s;return(s=si({selectedVersionSitemap:a,selectedVersionBaseURL:i,currentLocation:ye(),currentBaseURL:t.base}))!=null?s:i})))))).subscribe(n=>lt(n,!0)),z([r,o]).subscribe(([n,i])=>{R(".md-header__topic").appendChild(Cn(n,i))}),e.pipe(v(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let p of s)for(let c of n.aliases.concat(n.version))if(new RegExp(p,"i").test(c)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of ae("outdated"))s.hidden=!1})}function ls(e,{worker$:t}){let{searchParams:r}=ye();r.has("q")&&(Je("search",!0),e.value=r.get("q"),e.focus(),ze("search").pipe(Ae(i=>!i)).subscribe(()=>{let i=ye();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=et(e),n=O(t.pipe(Ae(jt)),h(e,"keyup"),o).pipe(m(()=>e.value),K());return z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),G(1))}function pi(e,{worker$:t}){let r=new g,o=r.pipe(Z(),ie(!0));z([t.pipe(Ae(jt)),r],(i,a)=>a).pipe(ee("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(ee("focus")).subscribe(({focus:i})=>{i&&Je("search",i)}),h(e.form,"reset").pipe(W(o)).subscribe(()=>e.focus());let n=R("header [for=__search]");return h(n,"click").subscribe(()=>e.focus()),ls(e,{worker$:t}).pipe(w(i=>r.next(i)),_(()=>r.complete()),m(i=>$({ref:e},i)),G(1))}function li(e,{worker$:t,query$:r}){let o=new g,n=on(e.parentElement).pipe(b(Boolean)),i=e.parentElement,a=R(":scope > :first-child",e),s=R(":scope > :last-child",e);ze("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(re(r),Wr(t.pipe(Ae(jt)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?Ee("search.result.none"):Ee("search.result.placeholder");break;case 1:a.textContent=Ee("search.result.one");break;default:let u=sr(l.length);a.textContent=Ee("search.result.other",u)}});let p=o.pipe(w(()=>s.innerHTML=""),v(({items:l})=>O(I(...l.slice(0,10)),I(...l.slice(10)).pipe(Be(4),Vr(n),v(([f])=>f)))),m(Mn),pe());return p.subscribe(l=>s.appendChild(l)),p.pipe(ne(l=>{let f=fe("details",l);return typeof f=="undefined"?S:h(f,"toggle").pipe(W(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(b(dr),m(({data:l})=>l)).pipe(w(l=>o.next(l)),_(()=>o.complete()),m(l=>$({ref:e},l)))}function ms(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=ye();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function mi(e,t){let r=new g,o=r.pipe(Z(),ie(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),h(e,"click").pipe(W(o)).subscribe(n=>n.preventDefault()),ms(e,t).pipe(w(n=>r.next(n)),_(()=>r.complete()),m(n=>$({ref:e},n)))}function fi(e,{worker$:t,keyboard$:r}){let o=new g,n=Se("search-query"),i=O(h(n,"keydown"),h(n,"focus")).pipe(ve(se),m(()=>n.value),K());return o.pipe(He(i),m(([{suggest:s},p])=>{let c=p.split(/([\s-]+)/);if(s!=null&&s.length&&c[c.length-1]){let l=s[s.length-1];l.startsWith(c[c.length-1])&&(c[c.length-1]=l)}else c.length=0;return c})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g,"&nbsp;")),r.pipe(b(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(b(dr),m(({data:s})=>s)).pipe(w(s=>o.next(s)),_(()=>o.complete()),m(()=>({ref:e})))}function ui(e,{index$:t,keyboard$:r}){let o=xe();try{let n=ai(o.search,t),i=Se("search-query",e),a=Se("search-result",e);h(e,"click").pipe(b(({target:p})=>p instanceof Element&&!!p.closest("a"))).subscribe(()=>Je("search",!1)),r.pipe(b(({mode:p})=>p==="search")).subscribe(p=>{let c=Ie();switch(p.type){case"Enter":if(c===i){let l=new Map;for(let f of P(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,d])=>d-u);f.click()}p.claim()}break;case"Escape":case"Tab":Je("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof c=="undefined")i.focus();else{let l=[i,...P(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(c))+l.length+(p.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}p.claim();break;default:i!==Ie()&&i.focus()}}),r.pipe(b(({mode:p})=>p==="global")).subscribe(p=>{switch(p.type){case"f":case"s":case"/":i.focus(),i.select(),p.claim();break}});let s=pi(i,{worker$:n});return O(s,li(a,{worker$:n,query$:s})).pipe(Re(...ae("search-share",e).map(p=>mi(p,{query$:s})),...ae("search-suggest",e).map(p=>fi(p,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Ye}}function di(e,{index$:t,location$:r}){return z([t,r.pipe(Q(ye()),b(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>ii(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let p=s.textContent,c=o(p);c.length>p.length&&n.set(s,c)}for(let[s,p]of n){let{childNodes:c}=x("span",null,p);s.replaceWith(...Array.from(c))}return{ref:e,nodes:n}}))}function fs(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),K((i,a)=>i.height===a.height&&i.locked===a.locked))}function Zr(e,o){var n=o,{header$:t}=n,r=so(n,["header$"]);let i=R(".md-sidebar__scrollwrap",e),{y:a}=Ve(i);return C(()=>{let s=new g,p=s.pipe(Z(),ie(!0)),c=s.pipe(Me(0,me));return c.pipe(re(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),c.pipe(Ae()).subscribe(()=>{for(let l of P(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=ce(f);f.scrollTo({top:u-d/2})}}}),ue(P("label[tabindex]",e)).pipe(ne(l=>h(l,"click").pipe(ve(se),m(()=>l),W(p)))).subscribe(l=>{let f=R(`[id="${l.htmlFor}"]`);R(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),fs(e,r).pipe(w(l=>s.next(l)),_(()=>s.complete()),m(l=>$({ref:e},l)))})}function hi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return st(je(`${r}/releases/latest`).pipe(de(()=>S),m(o=>({version:o.tag_name})),De({})),je(r).pipe(de(()=>S),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),De({}))).pipe(m(([o,n])=>$($({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return je(r).pipe(m(o=>({repositories:o.public_repos})),De({}))}}function bi(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return st(je(`${r}/releases/permalink/latest`).pipe(de(()=>S),m(({tag_name:o})=>({version:o})),De({})),je(r).pipe(de(()=>S),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),De({}))).pipe(m(([o,n])=>$($({},o),n)))}function vi(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return hi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return bi(r,o)}return S}var us;function ds(e){return us||(us=C(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(ae("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return S}return vi(e.href).pipe(w(o=>__md_set("__source",o,sessionStorage)))}).pipe(de(()=>S),b(t=>Object.keys(t).length>0),m(t=>({facts:t})),G(1)))}function gi(e){let t=R(":scope > :last-child",e);return C(()=>{let r=new g;return r.subscribe(({facts:o})=>{t.appendChild(_n(o)),t.classList.add("md-source__repository--active")}),ds(e).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}function hs(e,{viewport$:t,header$:r}){return ge(document.body).pipe(v(()=>mr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),ee("hidden"))}function yi(e,t){return C(()=>{let r=new g;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(B("navigation.tabs.sticky")?I({hidden:!1}):hs(e,t)).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}function bs(e,{viewport$:t,header$:r}){let o=new Map,n=P(".md-nav__link",e);for(let s of n){let p=decodeURIComponent(s.hash.substring(1)),c=fe(`[id="${p}"]`);typeof c!="undefined"&&o.set(s,c)}let i=r.pipe(ee("height"),m(({height:s})=>{let p=Se("main"),c=R(":scope > :first-child",p);return s+.8*(c.offsetTop-p.offsetTop)}),pe());return ge(document.body).pipe(ee("height"),v(s=>C(()=>{let p=[];return I([...o].reduce((c,[l,f])=>{for(;p.length&&o.get(p[p.length-1]).tagName>=f.tagName;)p.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let d=f.offsetParent;for(;d;d=d.offsetParent)u+=d.offsetTop;return c.set([...p=[...p,l]].reverse(),u)},new Map))}).pipe(m(p=>new Map([...p].sort(([,c],[,l])=>c-l))),He(i),v(([p,c])=>t.pipe(Fr(([l,f],{offset:{y:u},size:d})=>{let y=u+d.height>=Math.floor(s.height);for(;f.length;){let[,L]=f[0];if(L-c<u||y)l=[...l,f.shift()];else break}for(;l.length;){let[,L]=l[l.length-1];if(L-c>=u&&!y)f=[l.pop(),...f];else break}return[l,f]},[[],[...p]]),K((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,p])=>({prev:s.map(([c])=>c),next:p.map(([c])=>c)})),Q({prev:[],next:[]}),Be(2,1),m(([s,p])=>s.prev.length<p.prev.length?{prev:p.prev.slice(Math.max(0,s.prev.length-1),p.prev.length),next:[]}:{prev:p.prev.slice(-1),next:p.next.slice(0,p.next.length-s.next.length)}))}function xi(e,{viewport$:t,header$:r,main$:o,target$:n}){return C(()=>{let i=new g,a=i.pipe(Z(),ie(!0));if(i.subscribe(({prev:s,next:p})=>{for(let[c]of p)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",c===s.length-1)}),B("toc.follow")){let s=O(t.pipe(_e(1),m(()=>{})),t.pipe(_e(250),m(()=>"smooth")));i.pipe(b(({prev:p})=>p.length>0),He(o.pipe(ve(se))),re(s)).subscribe(([[{prev:p}],c])=>{let[l]=p[p.length-1];if(l.offsetHeight){let f=cr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=ce(f);f.scrollTo({top:u-d/2,behavior:c})}}})}return B("navigation.tracking")&&t.pipe(W(a),ee("offset"),_e(250),Ce(1),W(n.pipe(Ce(1))),ct({delay:250}),re(i)).subscribe(([,{prev:s}])=>{let p=ye(),c=s[s.length-1];if(c&&c.length){let[l]=c,{hash:f}=new URL(l.href);p.hash!==f&&(p.hash=f,history.replaceState({},"",`${p}`))}else p.hash="",history.replaceState({},"",`${p}`)}),bs(e,{viewport$:t,header$:r}).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))})}function vs(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Be(2,1),m(([a,s])=>a>s&&s>0),K()),i=r.pipe(m(({active:a})=>a));return z([i,n]).pipe(m(([a,s])=>!(a&&s)),K(),W(o.pipe(Ce(1))),ie(!0),ct({delay:250}),m(a=>({hidden:a})))}function Ei(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new g,a=i.pipe(Z(),ie(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(W(a),ee("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),h(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),vs(e,{viewport$:t,main$:o,target$:n}).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))}function wi({document$:e,viewport$:t}){e.pipe(v(()=>P(".md-ellipsis")),ne(r=>tt(r).pipe(W(e.pipe(Ce(1))),b(o=>o),m(()=>r),Te(1))),b(r=>r.offsetWidth<r.scrollWidth),ne(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,B("content.tooltips")?mt(n,{viewport$:t}).pipe(W(e.pipe(Ce(1))),_(()=>n.removeAttribute("title"))):S})).subscribe(),B("content.tooltips")&&e.pipe(v(()=>P(".md-status")),ne(r=>mt(r,{viewport$:t}))).subscribe()}function Ti({document$:e,tablet$:t}){e.pipe(v(()=>P(".md-toggle--indeterminate")),w(r=>{r.indeterminate=!0,r.checked=!1}),ne(r=>h(r,"change").pipe(Dr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),re(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function gs(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Si({document$:e}){e.pipe(v(()=>P("[data-md-scrollfix]")),w(t=>t.removeAttribute("data-md-scrollfix")),b(gs),ne(t=>h(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function Oi({viewport$:e,tablet$:t}){z([ze("search"),t]).pipe(m(([r,o])=>r&&!o),v(r=>I(r).pipe(Ge(r?400:100))),re(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function ys(){return location.protocol==="file:"?Tt(`${new URL("search/search_index.js",eo.base)}`).pipe(m(()=>__index),G(1)):je(new URL("search/search_index.json",eo.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ot=Go(),Ut=sn(),Lt=ln(Ut),to=an(),Oe=gn(),hr=Pt("(min-width: 960px)"),Mi=Pt("(min-width: 1220px)"),_i=mn(),eo=xe(),Ai=document.forms.namedItem("search")?ys():Ye,ro=new g;Zn({alert$:ro});var oo=new g;B("navigation.instant")&&oi({location$:Ut,viewport$:Oe,progress$:oo}).subscribe(ot);var Li;((Li=eo.version)==null?void 0:Li.provider)==="mike"&&ci({document$:ot});O(Ut,Lt).pipe(Ge(125)).subscribe(()=>{Je("drawer",!1),Je("search",!1)});to.pipe(b(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=fe("link[rel=prev]");typeof t!="undefined"&&lt(t);break;case"n":case".":let r=fe("link[rel=next]");typeof r!="undefined"&&lt(r);break;case"Enter":let o=Ie();o instanceof HTMLLabelElement&&o.click()}});wi({viewport$:Oe,document$:ot});Ti({document$:ot,tablet$:hr});Si({document$:ot});Oi({viewport$:Oe,tablet$:hr});var rt=Kn(Se("header"),{viewport$:Oe}),Ft=ot.pipe(m(()=>Se("main")),v(e=>Gn(e,{viewport$:Oe,header$:rt})),G(1)),xs=O(...ae("consent").map(e=>En(e,{target$:Lt})),...ae("dialog").map(e=>qn(e,{alert$:ro})),...ae("palette").map(e=>Jn(e)),...ae("progress").map(e=>Xn(e,{progress$:oo})),...ae("search").map(e=>ui(e,{index$:Ai,keyboard$:to})),...ae("source").map(e=>gi(e))),Es=C(()=>O(...ae("announce").map(e=>xn(e)),...ae("content").map(e=>zn(e,{viewport$:Oe,target$:Lt,print$:_i})),...ae("content").map(e=>B("search.highlight")?di(e,{index$:Ai,location$:Ut}):S),...ae("header").map(e=>Yn(e,{viewport$:Oe,header$:rt,main$:Ft})),...ae("header-title").map(e=>Bn(e,{viewport$:Oe,header$:rt})),...ae("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Nr(Mi,()=>Zr(e,{viewport$:Oe,header$:rt,main$:Ft})):Nr(hr,()=>Zr(e,{viewport$:Oe,header$:rt,main$:Ft}))),...ae("tabs").map(e=>yi(e,{viewport$:Oe,header$:rt})),...ae("toc").map(e=>xi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Lt})),...ae("top").map(e=>Ei(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Lt})))),Ci=ot.pipe(v(()=>Es),Re(xs),G(1));Ci.subscribe();window.document$=ot;window.location$=Ut;window.target$=Lt;window.keyboard$=to;window.viewport$=Oe;window.tablet$=hr;window.screen$=Mi;window.print$=_i;window.alert$=ro;window.progress$=oo;window.component$=Ci;})();
-//# sourceMappingURL=bundle.83f73b43.min.js.map
+  `):"",this.name="UnsubscriptionError",this.errors=r}});function Qe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Ue=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=he(a),p=s.next();!p.done;p=s.next()){var c=p.value;c.remove(this)}}catch(L){t={error:L}}finally{try{p&&!p.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(H(l))try{l()}catch(L){i=L instanceof zt?L.errors:[L]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=he(f),d=u.next();!d.done;d=u.next()){var y=d.value;try{ho(y)}catch(L){i=i!=null?i:[],L instanceof zt?i=q(q([],N(i)),N(L.errors)):i.push(L)}}}catch(L){o={error:L}}finally{try{d&&!d.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new zt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)ho(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Qe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Qe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Tr=Ue.EMPTY;function qt(e){return e instanceof Ue||e&&"closed"in e&&H(e.remove)&&H(e.add)&&H(e.unsubscribe)}function ho(e){H(e)?e():e.unsubscribe()}var Pe={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var dt={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=dt.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,q([e,t],N(r))):setTimeout.apply(void 0,q([e,t],N(r)))},clearTimeout:function(e){var t=dt.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Qt(e){dt.setTimeout(function(){var t=Pe.onUnhandledError;if(t)t(e);else throw e})}function be(){}var bo=function(){return Sr("C",void 0,void 0)}();function vo(e){return Sr("E",void 0,e)}function go(e){return Sr("N",e,void 0)}function Sr(e,t,r){return{kind:e,value:t,error:r}}var it=null;function ht(e){if(Pe.useDeprecatedSynchronousErrorHandling){var t=!it;if(t&&(it={errorThrown:!1,error:null}),e(),t){var r=it,o=r.errorThrown,n=r.error;if(it=null,o)throw n}}else e()}function yo(e){Pe.useDeprecatedSynchronousErrorHandling&&it&&(it.errorThrown=!0,it.error=e)}var _t=function(e){oe(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,qt(r)&&r.add(o)):o.destination=Yi,o}return t.create=function(r,o,n){return new at(r,o,n)},t.prototype.next=function(r){this.isStopped?Lr(go(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Lr(vo(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Lr(bo,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Ue);var qi=Function.prototype.bind;function Or(e,t){return qi.call(e,t)}var Qi=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Kt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Kt(o)}else Kt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Kt(r)}},e}(),at=function(e){oe(t,e);function t(r,o,n){var i=e.call(this)||this,a;if(H(r)||!r)a={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var s;i&&Pe.useDeprecatedNextContext?(s=Object.create(r),s.unsubscribe=function(){return i.unsubscribe()},a={next:r.next&&Or(r.next,s),error:r.error&&Or(r.error,s),complete:r.complete&&Or(r.complete,s)}):a=r}return i.destination=new Qi(a),i}return t}(_t);function Kt(e){Pe.useDeprecatedSynchronousErrorHandling?yo(e):Qt(e)}function Ki(e){throw e}function Lr(e,t){var r=Pe.onStoppedNotification;r&&dt.setTimeout(function(){return r(e,t)})}var Yi={closed:!0,next:be,error:Ki,complete:be};var bt=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function le(e){return e}function xo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Mr(e)}function Mr(e){return e.length===0?le:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var j=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=Gi(t)?t:new at(t,r,o);return ht(function(){var a=n,s=a.operator,p=a.source;i.add(s?s.call(i,p):p?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=Eo(r),new r(function(n,i){var a=new at({next:function(s){try{t(s)}catch(p){i(p),a.unsubscribe()}},error:i,complete:n});o.subscribe(a)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[bt]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Mr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=Eo(t),new t(function(o,n){var i;r.subscribe(function(a){return i=a},function(a){return n(a)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function Eo(e){var t;return(t=e!=null?e:Pe.Promise)!==null&&t!==void 0?t:Promise}function Bi(e){return e&&H(e.next)&&H(e.error)&&H(e.complete)}function Gi(e){return e&&e instanceof _t||Bi(e)&&qt(e)}function Ji(e){return H(e==null?void 0:e.lift)}function E(e){return function(t){if(Ji(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function T(e,t,r,o,n){return new Xi(e,t,r,o,n)}var Xi=function(e){oe(t,e);function t(r,o,n,i,a,s){var p=e.call(this,r)||this;return p.onFinalize=a,p.shouldUnsubscribe=s,p._next=o?function(c){try{o(c)}catch(l){r.error(l)}}:e.prototype._next,p._error=i?function(c){try{i(c)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,p._complete=n?function(){try{n()}catch(c){r.error(c)}finally{this.unsubscribe()}}:e.prototype._complete,p}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(_t);var vt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=vt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Ue(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=vt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,q([],N(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=vt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,q([],N(e)))},delegate:void 0};var wo=ut(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var g=function(e){oe(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new To(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new wo},t.prototype.next=function(r){var o=this;ht(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var a=he(o.currentObservers),s=a.next();!s.done;s=a.next()){var p=s.value;p.next(r)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;ht(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;ht(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Tr:(this.currentObservers=null,s.push(r),new Ue(function(){o.currentObservers=null,Qe(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new j;return r.source=this,r},t.create=function(r,o){return new To(r,o)},t}(j);var To=function(e){oe(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Tr},t}(g);var _r=function(e){oe(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(g);var At={now:function(){return(At.delegate||Date).now()},delegate:void 0};var Ct=function(e){oe(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=At);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,p=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+p)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),p=0;p<s.length&&!r.closed;p+=i?1:2)r.next(s[p]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,a=r._infiniteTimeWindow,s=(a?1:2)*o;if(o<1/0&&s<i.length&&i.splice(0,i.length-s),!a){for(var p=n.now(),c=0,l=1;l<i.length&&i[l]<=p;l+=2)c=l;c&&i.splice(0,c+1)}},t}(g);var So=function(e){oe(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Ue);var kt={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=kt.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,q([e,t],N(r))):setInterval.apply(void 0,q([e,t],N(r)))},clearInterval:function(e){var t=kt.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var gt=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,a=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(a,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(a,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),kt.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&kt.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(a){n=!0,i=a||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,Qe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(So);var Ar=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=At.now,e}();var yt=function(e){oe(t,e);function t(r,o){o===void 0&&(o=Ar.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ar);var se=new yt(gt),Cr=se;var Oo=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(gt);var Lo=function(e){oe(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(yt);var kr=new Lo(Oo);var Mo=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=vt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(vt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(gt);var _o=function(e){oe(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(yt);var me=new _o(Mo);var S=new j(function(e){return e.complete()});function Yt(e){return e&&H(e.schedule)}function Hr(e){return e[e.length-1]}function Xe(e){return H(Hr(e))?e.pop():void 0}function ke(e){return Yt(Hr(e))?e.pop():void 0}function Bt(e,t){return typeof Hr(e)=="number"?e.pop():t}var xt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Gt(e){return H(e==null?void 0:e.then)}function Jt(e){return H(e[bt])}function Xt(e){return Symbol.asyncIterator&&H(e==null?void 0:e[Symbol.asyncIterator])}function Zt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Zi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var er=Zi();function tr(e){return H(e==null?void 0:e[er])}function rr(e){return fo(this,arguments,function(){var r,o,n,i;return Nt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,nt(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,nt(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,nt(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function or(e){return H(e==null?void 0:e.getReader)}function U(e){if(e instanceof j)return e;if(e!=null){if(Jt(e))return ea(e);if(xt(e))return ta(e);if(Gt(e))return ra(e);if(Xt(e))return Ao(e);if(tr(e))return oa(e);if(or(e))return na(e)}throw Zt(e)}function ea(e){return new j(function(t){var r=e[bt]();if(H(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function ta(e){return new j(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function ra(e){return new j(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Qt)})}function oa(e){return new j(function(t){var r,o;try{for(var n=he(e),i=n.next();!i.done;i=n.next()){var a=i.value;if(t.next(a),t.closed)return}}catch(s){r={error:s}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Ao(e){return new j(function(t){ia(e,t).catch(function(r){return t.error(r)})})}function na(e){return Ao(rr(e))}function ia(e,t){var r,o,n,i;return mo(this,void 0,void 0,function(){var a,s;return Nt(this,function(p){switch(p.label){case 0:p.trys.push([0,5,6,11]),r=uo(e),p.label=1;case 1:return[4,r.next()];case 2:if(o=p.sent(),!!o.done)return[3,4];if(a=o.value,t.next(a),t.closed)return[2];p.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return s=p.sent(),n={error:s},[3,11];case 6:return p.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:p.sent(),p.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function we(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function ve(e,t){return t===void 0&&(t=0),E(function(r,o){r.subscribe(T(o,function(n){return we(o,e,function(){return o.next(n)},t)},function(){return we(o,e,function(){return o.complete()},t)},function(n){return we(o,e,function(){return o.error(n)},t)}))})}function Ke(e,t){return t===void 0&&(t=0),E(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function Co(e,t){return U(e).pipe(Ke(t),ve(t))}function ko(e,t){return U(e).pipe(Ke(t),ve(t))}function Ho(e,t){return new j(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function $o(e,t){return new j(function(r){var o;return we(r,t,function(){o=e[er](),we(r,t,function(){var n,i,a;try{n=o.next(),i=n.value,a=n.done}catch(s){r.error(s);return}a?r.complete():r.next(i)},0,!0)}),function(){return H(o==null?void 0:o.return)&&o.return()}})}function nr(e,t){if(!e)throw new Error("Iterable cannot be null");return new j(function(r){we(r,t,function(){var o=e[Symbol.asyncIterator]();we(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function Po(e,t){return nr(rr(e),t)}function Ro(e,t){if(e!=null){if(Jt(e))return Co(e,t);if(xt(e))return Ho(e,t);if(Gt(e))return ko(e,t);if(Xt(e))return nr(e,t);if(tr(e))return $o(e,t);if(or(e))return Po(e,t)}throw Zt(e)}function ue(e,t){return t?Ro(e,t):U(e)}function I(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e);return ue(e,r)}function $r(e,t){var r=H(e)?e:function(){return e},o=function(n){return n.error(r())};return new j(t?function(n){return t.schedule(o,0,n)}:o)}var ir=ut(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Io(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return E(function(r,o){var n=0;r.subscribe(T(o,function(i){o.next(e.call(t,i,n++))}))})}var aa=Array.isArray;function sa(e,t){return aa(t)?e.apply(void 0,q([],N(t))):e(t)}function Ze(e){return m(function(t){return sa(e,t)})}var ca=Array.isArray,pa=Object.getPrototypeOf,la=Object.prototype,ma=Object.keys;function jo(e){if(e.length===1){var t=e[0];if(ca(t))return{args:t,keys:null};if(fa(t)){var r=ma(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function fa(e){return e&&typeof e=="object"&&pa(e)===la}function Fo(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Xe(e),n=jo(e),i=n.args,a=n.keys;if(i.length===0)return ue([],r);var s=new j(Pr(i,r,a?function(p){return Fo(a,p)}:le));return o?s.pipe(Ze(o)):s}function Pr(e,t,r){return r===void 0&&(r=le),function(o){Uo(t,function(){for(var n=e.length,i=new Array(n),a=n,s=n,p=function(l){Uo(t,function(){var f=ue(e[l],t),u=!1;f.subscribe(T(o,function(d){i[l]=d,u||(u=!0,s--),s||o.next(r(i.slice()))},function(){--a||o.complete()}))},o)},c=0;c<n;c++)p(c)},o)}}function Uo(e,t,r){e?we(r,e,t):t()}function Wo(e,t,r,o,n,i,a,s){var p=[],c=0,l=0,f=!1,u=function(){f&&!p.length&&!c&&t.complete()},d=function(L){return c<o?y(L):p.push(L)},y=function(L){i&&t.next(L),c++;var X=!1;U(r(L,l++)).subscribe(T(t,function(te){n==null||n(te),i?d(te):t.next(te)},function(){X=!0},void 0,function(){if(X)try{c--;for(var te=function(){var J=p.shift();a?we(t,a,function(){return y(J)}):y(J)};p.length&&c<o;)te();u()}catch(J){t.error(J)}}))};return e.subscribe(T(t,d,function(){f=!0,u()})),function(){s==null||s()}}function ne(e,t,r){return r===void 0&&(r=1/0),H(t)?ne(function(o,n){return m(function(i,a){return t(o,i,n,a)})(U(e(o,n)))},r):(typeof t=="number"&&(r=t),E(function(o,n){return Wo(o,n,e,r)}))}function Et(e){return e===void 0&&(e=1/0),ne(le,e)}function Do(){return Et(1)}function We(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Do()(ue(e,ke(e)))}function C(e){return new j(function(t){U(e()).subscribe(t)})}var ua=["addListener","removeListener"],da=["addEventListener","removeEventListener"],ha=["on","off"];function h(e,t,r,o){if(H(r)&&(o=r,r=void 0),o)return h(e,t,r).pipe(Ze(o));var n=N(ga(e)?da.map(function(s){return function(p){return e[s](t,p,r)}}):ba(e)?ua.map(Vo(e,t)):va(e)?ha.map(Vo(e,t)):[],2),i=n[0],a=n[1];if(!i&&xt(e))return ne(function(s){return h(s,t,r)})(U(e));if(!i)throw new TypeError("Invalid event target");return new j(function(s){var p=function(){for(var c=[],l=0;l<arguments.length;l++)c[l]=arguments[l];return s.next(1<c.length?c:c[0])};return i(p),function(){return a(p)}})}function Vo(e,t){return function(r){return function(o){return e[r](t,o)}}}function ba(e){return H(e.addListener)&&H(e.removeListener)}function va(e){return H(e.on)&&H(e.off)}function ga(e){return H(e.addEventListener)&&H(e.removeEventListener)}function ar(e,t,r){return r?ar(e,t).pipe(Ze(r)):new j(function(o){var n=function(){for(var a=[],s=0;s<arguments.length;s++)a[s]=arguments[s];return o.next(a.length===1?a[0]:a)},i=e(n);return H(t)?function(){return t(n,i)}:void 0})}function Le(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Cr);var o=-1;return t!=null&&(Yt(t)?r=t:o=t),new j(function(n){var i=Io(e)?+e-r.now():e;i<0&&(i=0);var a=0;return r.schedule(function(){n.closed||(n.next(a++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function O(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Bt(e,1/0),n=e;return n.length?n.length===1?U(n[0]):Et(o)(ue(n,r)):S}var Ye=new j(be);var ya=Array.isArray;function wt(e){return e.length===1&&ya(e[0])?e[0]:e}function b(e,t){return E(function(r,o){var n=0;r.subscribe(T(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function st(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e),o=wt(e);return o.length?new j(function(n){var i=o.map(function(){return[]}),a=o.map(function(){return!1});n.add(function(){i=a=null});for(var s=function(c){U(o[c]).subscribe(T(n,function(l){if(i[c].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,q([],N(f))):f),i.some(function(u,d){return!u.length&&a[d]})&&n.complete()}},function(){a[c]=!0,!i[c].length&&n.complete()}))},p=0;!n.closed&&p<o.length;p++)s(p);return function(){i=a=null}}):S}function No(e){return E(function(t,r){var o=!1,n=null,i=null,a=!1,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var c=n;n=null,r.next(c)}a&&r.complete()},p=function(){i=null,a&&r.complete()};t.subscribe(T(r,function(c){o=!0,n=c,i||U(e(c)).subscribe(i=T(r,s,p))},function(){a=!0,(!o||!i||i.closed)&&r.complete()}))})}function Me(e,t){return t===void 0&&(t=se),No(function(){return Le(e,t)})}function Be(e,t){return t===void 0&&(t=null),t=t!=null?t:e,E(function(r,o){var n=[],i=0;r.subscribe(T(o,function(a){var s,p,c,l,f=null;i++%t===0&&n.push([]);try{for(var u=he(n),d=u.next();!d.done;d=u.next()){var y=d.value;y.push(a),e<=y.length&&(f=f!=null?f:[],f.push(y))}}catch(te){s={error:te}}finally{try{d&&!d.done&&(p=u.return)&&p.call(u)}finally{if(s)throw s.error}}if(f)try{for(var L=he(f),X=L.next();!X.done;X=L.next()){var y=X.value;Qe(n,y),o.next(y)}}catch(te){c={error:te}}finally{try{X&&!X.done&&(l=L.return)&&l.call(L)}finally{if(c)throw c.error}}},function(){var a,s;try{for(var p=he(n),c=p.next();!c.done;c=p.next()){var l=c.value;o.next(l)}}catch(f){a={error:f}}finally{try{c&&!c.done&&(s=p.return)&&s.call(p)}finally{if(a)throw a.error}}o.complete()},void 0,function(){n=null}))})}function de(e){return E(function(t,r){var o=null,n=!1,i;o=t.subscribe(T(r,void 0,void 0,function(a){i=U(e(a,de(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function zo(e,t,r,o,n){return function(i,a){var s=r,p=t,c=0;i.subscribe(T(a,function(l){var f=c++;p=s?e(p,l,f):(s=!0,l),o&&a.next(p)},n&&function(){s&&a.next(p),a.complete()}))}}function Rr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return r?xo(Rr.apply(void 0,q([],N(e))),Ze(r)):E(function(o,n){Pr(q([o],N(wt(e))))(n)})}function He(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Rr.apply(void 0,q([],N(e)))}function Ht(e){return E(function(t,r){var o=!1,n=null,i=null,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var s=n;n=null,r.next(s)}};t.subscribe(T(r,function(s){i==null||i.unsubscribe(),o=!0,n=s,i=T(r,a,be),U(e(s)).subscribe(i)},function(){a(),r.complete()},void 0,function(){n=i=null}))})}function _e(e,t){return t===void 0&&(t=se),E(function(r,o){var n=null,i=null,a=null,s=function(){if(n){n.unsubscribe(),n=null;var c=i;i=null,o.next(c)}};function p(){var c=a+e,l=t.now();if(l<c){n=this.schedule(void 0,c-l),o.add(n);return}s()}r.subscribe(T(o,function(c){i=c,a=t.now(),n||(n=t.schedule(p,e),o.add(n))},function(){s(),o.complete()},void 0,function(){i=n=null}))})}function De(e){return E(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Te(e){return e<=0?function(){return S}:E(function(t,r){var o=0;t.subscribe(T(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function Z(){return E(function(e,t){e.subscribe(T(t,be))})}function qo(e){return m(function(){return e})}function Ir(e,t){return t?function(r){return We(t.pipe(Te(1),Z()),r.pipe(Ir(e)))}:ne(function(r,o){return U(e(r,o)).pipe(Te(1),qo(r))})}function Ge(e,t){t===void 0&&(t=se);var r=Le(e,t);return Ir(function(){return r})}function K(e,t){return t===void 0&&(t=le),e=e!=null?e:xa,E(function(r,o){var n,i=!0;r.subscribe(T(o,function(a){var s=t(a);(i||!e(n,s))&&(i=!1,n=s,o.next(a))}))})}function xa(e,t){return e===t}function ee(e,t){return K(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function Qo(e){return e===void 0&&(e=Ea),E(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function Ea(){return new ir}function ie(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return We(r,I.apply(void 0,q([],N(e))))}}function _(e){return E(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Ae(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?b(function(n,i){return e(n,i,o)}):le,Te(1),r?De(t):Qo(function(){return new ir}))}}function jr(e){return e<=0?function(){return S}:E(function(t,r){var o=[];t.subscribe(T(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var a=he(o),s=a.next();!s.done;s=a.next()){var p=s.value;r.next(p)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function Ko(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Bt(e,1/0);return e=wt(e),E(function(n,i){Et(o)(ue(q([n],N(e)),r)).subscribe(i)})}function Re(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Ko.apply(void 0,q([],N(e)))}function ct(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return S}:E(function(n,i){var a=0,s,p=function(){if(s==null||s.unsubscribe(),s=null,o!=null){var l=typeof o=="number"?Le(o):U(o(a)),f=T(i,function(){f.unsubscribe(),c()});l.subscribe(f)}else c()},c=function(){var l=!1;s=n.subscribe(T(i,void 0,function(){++a<r?s?p():l=!0:i.complete()})),l&&p()};c()})}function Fr(e,t){return E(zo(e,t,arguments.length>=2,!0))}function pe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new g}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,p=s===void 0?!0:s;return function(c){var l,f,u,d=0,y=!1,L=!1,X=function(){f==null||f.unsubscribe(),f=void 0},te=function(){X(),l=u=void 0,y=L=!1},J=function(){var k=l;te(),k==null||k.unsubscribe()};return E(function(k,ft){d++,!L&&!y&&X();var qe=u=u!=null?u:r();ft.add(function(){d--,d===0&&!L&&!y&&(f=Ur(J,p))}),qe.subscribe(ft),!l&&d>0&&(l=new at({next:function(Fe){return qe.next(Fe)},error:function(Fe){L=!0,X(),f=Ur(te,n,Fe),qe.error(Fe)},complete:function(){y=!0,X(),f=Ur(te,a),qe.complete()}}),U(k).subscribe(l))})(c)}}function Ur(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new at({next:function(){n.unsubscribe(),e()}});return U(t.apply(void 0,q([],N(r)))).subscribe(n)}}function G(e,t,r){var o,n,i,a,s=!1;return e&&typeof e=="object"?(o=e.bufferSize,a=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,s=i===void 0?!1:i,r=e.scheduler):a=e!=null?e:1/0,pe({connector:function(){return new Ct(a,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:s})}function Ce(e){return b(function(t,r){return e<=r})}function Wr(e){return E(function(t,r){var o=!1,n=T(r,function(){n==null||n.unsubscribe(),o=!0},be);U(e).subscribe(n),t.subscribe(T(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e);return E(function(o,n){(r?We(e,o,r):We(e,o)).subscribe(n)})}function v(e,t){return E(function(r,o){var n=null,i=0,a=!1,s=function(){return a&&!n&&o.complete()};r.subscribe(T(o,function(p){n==null||n.unsubscribe();var c=0,l=i++;U(e(p,l)).subscribe(n=T(o,function(f){return o.next(t?t(p,f,l,c++):f)},function(){n=null,s()}))},function(){a=!0,s()}))})}function W(e){return E(function(t,r){U(e).subscribe(T(r,function(){return r.complete()},be)),!r.closed&&t.subscribe(r)})}function Dr(e,t){return t===void 0&&(t=!1),E(function(r,o){var n=0;r.subscribe(T(o,function(i){var a=e(i,n++);(a||t)&&o.next(i),!a&&o.complete()}))})}function w(e,t,r){var o=H(e)||t||r?{next:e,error:t,complete:r}:e;return o?E(function(n,i){var a;(a=o.subscribe)===null||a===void 0||a.call(o);var s=!0;n.subscribe(T(i,function(p){var c;(c=o.next)===null||c===void 0||c.call(o,p),i.next(p)},function(){var p;s=!1,(p=o.complete)===null||p===void 0||p.call(o),i.complete()},function(p){var c;s=!1,(c=o.error)===null||c===void 0||c.call(o,p),i.error(p)},function(){var p,c;s&&((p=o.unsubscribe)===null||p===void 0||p.call(o)),(c=o.finalize)===null||c===void 0||c.call(o)}))}):le}function Yo(e,t){return E(function(r,o){var n=t!=null?t:{},i=n.leading,a=i===void 0?!0:i,s=n.trailing,p=s===void 0?!1:s,c=!1,l=null,f=null,u=!1,d=function(){f==null||f.unsubscribe(),f=null,p&&(X(),u&&o.complete())},y=function(){f=null,u&&o.complete()},L=function(te){return f=U(e(te)).subscribe(T(o,d,y))},X=function(){if(c){c=!1;var te=l;l=null,o.next(te),!u&&L(te)}};r.subscribe(T(o,function(te){c=!0,l=te,!(f&&!f.closed)&&(a?X():L(te))},function(){u=!0,!(p&&c&&f&&!f.closed)&&o.complete()}))})}function pt(e,t,r){t===void 0&&(t=se);var o=Le(e,t);return Yo(function(){return o},r)}function re(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return E(function(o,n){for(var i=e.length,a=new Array(i),s=e.map(function(){return!1}),p=!1,c=function(f){U(e[f]).subscribe(T(n,function(u){a[f]=u,!p&&!s[f]&&(s[f]=!0,(p=s.every(le))&&(s=null))},be))},l=0;l<i;l++)c(l);o.subscribe(T(n,function(f){if(p){var u=q([f],N(a));n.next(r?r.apply(void 0,q([],N(u))):u)}}))})}function Bo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return E(function(r,o){st.apply(void 0,q([r],N(e))).subscribe(o)})}function Vr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Bo.apply(void 0,q([],N(e)))}function Go(){let e=new Ct(1);return h(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function P(e,t=document){return Array.from(t.querySelectorAll(e))}function R(e,t=document){let r=fe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function fe(e,t=document){return t.querySelector(e)||void 0}function Ie(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var wa=O(h(document.body,"focusin"),h(document.body,"focusout")).pipe(_e(1),Q(void 0),m(()=>Ie()||document.body),G(1));function et(e){return wa.pipe(m(t=>e.contains(t)),K())}function $t(e,t){return C(()=>O(h(e,"mouseenter").pipe(m(()=>!0)),h(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ht(r=>Le(+!r*t)):le,Q(e.matches(":hover"))))}function Jo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Jo(e,r)}function x(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Jo(o,n);return o}function sr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function Tt(e){let t=x("script",{src:e});return C(()=>(document.head.appendChild(t),O(h(t,"load"),h(t,"error").pipe(v(()=>$r(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),_(()=>document.head.removeChild(t)),Te(1))))}var Xo=new g,Ta=C(()=>typeof ResizeObserver=="undefined"?Tt("https://unpkg.com/resize-observer-polyfill"):I(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>Xo.next(t)))),v(e=>O(Ye,I(e)).pipe(_(()=>e.disconnect()))),G(1));function ce(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return Ta.pipe(w(r=>r.observe(t)),v(r=>Xo.pipe(b(o=>o.target===t),_(()=>r.unobserve(t)))),m(()=>ce(e)),Q(ce(e)))}function St(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function Zo(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Ve(e){return{x:e.offsetLeft,y:e.offsetTop}}function en(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function tn(e){return O(h(window,"load"),h(window,"resize")).pipe(Me(0,me),m(()=>Ve(e)),Q(Ve(e)))}function pr(e){return{x:e.scrollLeft,y:e.scrollTop}}function Ne(e){return O(h(e,"scroll"),h(window,"scroll"),h(window,"resize")).pipe(Me(0,me),m(()=>pr(e)),Q(pr(e)))}var rn=new g,Sa=C(()=>I(new IntersectionObserver(e=>{for(let t of e)rn.next(t)},{threshold:0}))).pipe(v(e=>O(Ye,I(e)).pipe(_(()=>e.disconnect()))),G(1));function tt(e){return Sa.pipe(w(t=>t.observe(e)),v(t=>rn.pipe(b(({target:r})=>r===e),_(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function on(e,t=16){return Ne(e).pipe(m(({y:r})=>{let o=ce(e),n=St(e);return r>=n.height-o.height-t}),K())}var lr={drawer:R("[data-md-toggle=drawer]"),search:R("[data-md-toggle=search]")};function nn(e){return lr[e].checked}function Je(e,t){lr[e].checked!==t&&lr[e].click()}function ze(e){let t=lr[e];return h(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function Oa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function La(){return O(h(window,"compositionstart").pipe(m(()=>!0)),h(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function an(){let e=h(window,"keydown").pipe(b(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:nn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),b(({mode:t,type:r})=>{if(t==="global"){let o=Ie();if(typeof o!="undefined")return!Oa(o,r)}return!0}),pe());return La().pipe(v(t=>t?S:e))}function ye(){return new URL(location.href)}function lt(e,t=!1){if(B("navigation.instant")&&!t){let r=x("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function sn(){return new g}function cn(){return location.hash.slice(1)}function pn(e){let t=x("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Ma(e){return O(h(window,"hashchange"),e).pipe(m(cn),Q(cn()),b(t=>t.length>0),G(1))}function ln(e){return Ma(e).pipe(m(t=>fe(`[id="${t}"]`)),b(t=>typeof t!="undefined"))}function Pt(e){let t=matchMedia(e);return ar(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function mn(){let e=matchMedia("print");return O(h(window,"beforeprint").pipe(m(()=>!0)),h(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function Nr(e,t){return e.pipe(v(r=>r?t():S))}function zr(e,t){return new j(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let a=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+a*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function je(e,t){return zr(e,t).pipe(v(r=>r.text()),m(r=>JSON.parse(r)),G(1))}function fn(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),G(1))}function un(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),G(1))}function dn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function hn(){return O(h(window,"scroll",{passive:!0}),h(window,"resize",{passive:!0})).pipe(m(dn),Q(dn()))}function bn(){return{width:innerWidth,height:innerHeight}}function vn(){return h(window,"resize",{passive:!0}).pipe(m(bn),Q(bn()))}function gn(){return z([hn(),vn()]).pipe(m(([e,t])=>({offset:e,size:t})),G(1))}function mr(e,{viewport$:t,header$:r}){let o=t.pipe(ee("size")),n=z([o,r]).pipe(m(()=>Ve(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:p,y:c}])=>({offset:{x:a.x-p,y:a.y-c+i},size:s})))}function _a(e){return h(e,"message",t=>t.data)}function Aa(e){let t=new g;return t.subscribe(r=>e.postMessage(r)),t}function yn(e,t=new Worker(e)){let r=_a(t),o=Aa(t),n=new g;n.subscribe(o);let i=o.pipe(Z(),ie(!0));return n.pipe(Z(),Re(r.pipe(W(i))),pe())}var Ca=R("#__config"),Ot=JSON.parse(Ca.textContent);Ot.base=`${new URL(Ot.base,ye())}`;function xe(){return Ot}function B(e){return Ot.features.includes(e)}function Ee(e,t){return typeof t!="undefined"?Ot.translations[e].replace("#",t.toString()):Ot.translations[e]}function Se(e,t=document){return R(`[data-md-component=${e}]`,t)}function ae(e,t=document){return P(`[data-md-component=${e}]`,t)}function ka(e){let t=R(".md-typeset > :first-child",e);return h(t,"click",{once:!0}).pipe(m(()=>R(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function xn(e){if(!B("announce.dismiss")||!e.childElementCount)return S;if(!e.hidden){let t=R(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return C(()=>{let t=new g;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),ka(e).pipe(w(r=>t.next(r)),_(()=>t.complete()),m(r=>$({ref:e},r)))})}function Ha(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function En(e,t){let r=new g;return r.subscribe(({hidden:o})=>{e.hidden=o}),Ha(e,t).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))}function Rt(e,t){return t==="inline"?x("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"})):x("div",{class:"md-tooltip",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"}))}function wn(...e){return x("div",{class:"md-tooltip2",role:"tooltip"},x("div",{class:"md-tooltip2__inner md-typeset"},e))}function Tn(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return x("aside",{class:"md-annotation",tabIndex:0},Rt(t),x("a",{href:r,class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}else return x("aside",{class:"md-annotation",tabIndex:0},Rt(t),x("span",{class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}function Sn(e){return x("button",{class:"md-clipboard md-icon",title:Ee("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}var Ln=Mt(qr());function Qr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(p=>!e.terms[p]).reduce((p,c)=>[...p,x("del",null,(0,Ln.default)(c))," "],[]).slice(0,-1),i=xe(),a=new URL(e.location,i.base);B("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,p])=>p).reduce((p,[c])=>`${p} ${c}`.trim(),""));let{tags:s}=xe();return x("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},x("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&x("div",{class:"md-search-result__icon md-icon"}),r>0&&x("h1",null,e.title),r<=0&&x("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&x("nav",{class:"md-tags"},e.tags.map(p=>{let c=s?p in s?`md-tag-icon md-tag--${s[p]}`:"md-tag-icon":"";return x("span",{class:`md-tag ${c}`},p)})),o>0&&n.length>0&&x("p",{class:"md-search-result__terms"},Ee("search.result.term.missing"),": ",...n)))}function Mn(e){let t=e[0].score,r=[...e],o=xe(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.score<t);a===-1&&(a=r.length);let s=r.slice(0,a),p=r.slice(a),c=[Qr(i,2|+(!n&&a===0)),...s.map(l=>Qr(l,1)),...p.length?[x("details",{class:"md-search-result__more"},x("summary",{tabIndex:-1},x("div",null,p.length>0&&p.length===1?Ee("search.result.more.one"):Ee("search.result.more.other",p.length))),...p.map(l=>Qr(l,1)))]:[]];return x("li",{class:"md-search-result__item"},c)}function _n(e){return x("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>x("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?sr(r):r)))}function Kr(e){let t=`tabbed-control tabbed-control--${e}`;return x("div",{class:t,hidden:!0},x("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function An(e){return x("div",{class:"md-typeset__scrollwrap"},x("div",{class:"md-typeset__table"},e))}function Ra(e){var o;let t=xe(),r=new URL(`../${e.version}/`,t.base);return x("li",{class:"md-version__item"},x("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&x("span",{class:"md-version__alias"},e.aliases[0])))}function Cn(e,t){var o;let r=xe();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),x("div",{class:"md-version"},x("button",{class:"md-version__current","aria-label":Ee("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&x("span",{class:"md-version__alias"},t.aliases[0])),x("ul",{class:"md-version__list"},e.map(Ra)))}var Ia=0;function ja(e){let t=z([et(e),$t(e)]).pipe(m(([o,n])=>o||n),K()),r=C(()=>Zo(e)).pipe(ne(Ne),pt(1),He(t),m(()=>en(e)));return t.pipe(Ae(o=>o),v(()=>z([t,r])),m(([o,n])=>({active:o,offset:n})),pe())}function Fa(e,t){let{content$:r,viewport$:o}=t,n=`__tooltip2_${Ia++}`;return C(()=>{let i=new g,a=new _r(!1);i.pipe(Z(),ie(!1)).subscribe(a);let s=a.pipe(Ht(c=>Le(+!c*250,kr)),K(),v(c=>c?r:S),w(c=>c.id=n),pe());z([i.pipe(m(({active:c})=>c)),s.pipe(v(c=>$t(c,250)),Q(!1))]).pipe(m(c=>c.some(l=>l))).subscribe(a);let p=a.pipe(b(c=>c),re(s,o),m(([c,l,{size:f}])=>{let u=e.getBoundingClientRect(),d=u.width/2;if(l.role==="tooltip")return{x:d,y:8+u.height};if(u.y>=f.height/2){let{height:y}=ce(l);return{x:d,y:-16-y}}else return{x:d,y:16+u.height}}));return z([s,i,p]).subscribe(([c,{offset:l},f])=>{c.style.setProperty("--md-tooltip-host-x",`${l.x}px`),c.style.setProperty("--md-tooltip-host-y",`${l.y}px`),c.style.setProperty("--md-tooltip-x",`${f.x}px`),c.style.setProperty("--md-tooltip-y",`${f.y}px`),c.classList.toggle("md-tooltip2--top",f.y<0),c.classList.toggle("md-tooltip2--bottom",f.y>=0)}),a.pipe(b(c=>c),re(s,(c,l)=>l),b(c=>c.role==="tooltip")).subscribe(c=>{let l=ce(R(":scope > *",c));c.style.setProperty("--md-tooltip-width",`${l.width}px`),c.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(K(),ve(me),re(s)).subscribe(([c,l])=>{l.classList.toggle("md-tooltip2--active",c)}),z([a.pipe(b(c=>c)),s]).subscribe(([c,l])=>{l.role==="dialog"?(e.setAttribute("aria-controls",n),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",n)}),a.pipe(b(c=>!c)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),ja(e).pipe(w(c=>i.next(c)),_(()=>i.complete()),m(c=>$({ref:e},c)))})}function mt(e,{viewport$:t},r=document.body){return Fa(e,{content$:new j(o=>{let n=e.title,i=wn(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t})}function Ua(e,t){let r=C(()=>z([tn(e),Ne(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ce(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return et(e).pipe(v(o=>r.pipe(m(n=>({active:o,offset:n})),Te(+!o||1/0))))}function kn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return C(()=>{let i=new g,a=i.pipe(Z(),ie(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),tt(e).pipe(W(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),O(i.pipe(b(({active:s})=>s)),i.pipe(_e(250),b(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Me(16,me)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(pt(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),h(n,"click").pipe(W(a),b(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),h(n,"mousedown").pipe(W(a),re(i)).subscribe(([s,{active:p}])=>{var c;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(p){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(c=Ie())==null||c.blur()}}),r.pipe(W(a),b(s=>s===o),Ge(125)).subscribe(()=>e.focus()),Ua(e,t).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))})}function Wa(e){return e.tagName==="CODE"?P(".c, .c1, .cm",e):[e]}function Da(e){let t=[];for(let r of Wa(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,p]=a;if(typeof p=="undefined"){let c=i.splitText(a.index);i=c.splitText(s.length),t.push(c)}else{i.textContent=s,t.push(i);break}}}}return t}function Hn(e,t){t.append(...Array.from(e.childNodes))}function fr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Da(t)){let[,p]=s.textContent.match(/\((\d+)\)/);fe(`:scope > li:nth-child(${p})`,e)&&(a.set(p,Tn(p,i)),s.replaceWith(a.get(p)))}return a.size===0?S:C(()=>{let s=new g,p=s.pipe(Z(),ie(!0)),c=[];for(let[l,f]of a)c.push([R(".md-typeset",f),R(`:scope > li:nth-child(${l})`,e)]);return o.pipe(W(p)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of c)l?Hn(f,u):Hn(u,f)}),O(...[...a].map(([,l])=>kn(l,t,{target$:r}))).pipe(_(()=>s.complete()),pe())})}function $n(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return $n(t)}}function Pn(e,t){return C(()=>{let r=$n(e);return typeof r!="undefined"?fr(r,e,t):S})}var Rn=Mt(Br());var Va=0;function In(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return In(t)}}function Na(e){return ge(e).pipe(m(({width:t})=>({scrollable:St(e).width>t})),ee("scrollable"))}function jn(e,t){let{matches:r}=matchMedia("(hover)"),o=C(()=>{let n=new g,i=n.pipe(jr(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=[];if(Rn.default.isSupported()&&(e.closest(".copy")||B("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${Va++}`;let l=Sn(c.id);c.insertBefore(l,e),B("content.tooltips")&&a.push(mt(l,{viewport$}))}let s=e.closest(".highlight");if(s instanceof HTMLElement){let c=In(s);if(typeof c!="undefined"&&(s.classList.contains("annotate")||B("content.code.annotate"))){let l=fr(c,e,t);a.push(ge(s).pipe(W(i),m(({width:f,height:u})=>f&&u),K(),v(f=>f?l:S)))}}return P(":scope > span[id]",e).length&&e.classList.add("md-code__content"),Na(e).pipe(w(c=>n.next(c)),_(()=>n.complete()),m(c=>$({ref:e},c)),Re(...a))});return B("content.lazy")?tt(e).pipe(b(n=>n),Te(1),v(()=>o)):o}function za(e,{target$:t,print$:r}){let o=!0;return O(t.pipe(m(n=>n.closest("details:not([open])")),b(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(b(n=>n||!o),w(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Fn(e,t){return C(()=>{let r=new g;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),za(e,t).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}var Un=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.flowchartTitleText{fill:var(--md-mermaid-label-fg-color)}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel p,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel p{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}.classDiagramTitleText{fill:var(--md-mermaid-label-fg-color)}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}.statediagramTitleText{fill:var(--md-mermaid-label-fg-color)}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.entityTitleText{fill:var(--md-mermaid-label-fg-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}text:not([class]):last-child{fill:var(--md-mermaid-label-fg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var Gr,Qa=0;function Ka(){return typeof mermaid=="undefined"||mermaid instanceof Element?Tt("https://unpkg.com/mermaid@11/dist/mermaid.min.js"):I(void 0)}function Wn(e){return e.classList.remove("mermaid"),Gr||(Gr=Ka().pipe(w(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Un,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),G(1))),Gr.subscribe(()=>co(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Qa++}`,r=x("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})),Gr.pipe(m(()=>({ref:e})))}var Dn=x("table");function Vn(e){return e.replaceWith(Dn),Dn.replaceWith(An(e)),I({ref:e})}function Ya(e){let t=e.find(r=>r.checked)||e[0];return O(...e.map(r=>h(r,"change").pipe(m(()=>R(`label[for="${r.id}"]`))))).pipe(Q(R(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Nn(e,{viewport$:t,target$:r}){let o=R(".tabbed-labels",e),n=P(":scope > input",e),i=Kr("prev");e.append(i);let a=Kr("next");return e.append(a),C(()=>{let s=new g,p=s.pipe(Z(),ie(!0));z([s,ge(e),tt(e)]).pipe(W(p),Me(1,me)).subscribe({next([{active:c},l]){let f=Ve(c),{width:u}=ce(c);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let d=pr(o);(f.x<d.x||f.x+u>d.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([Ne(o),ge(o)]).pipe(W(p)).subscribe(([c,l])=>{let f=St(o);i.hidden=c.x<16,a.hidden=c.x>f.width-l.width-16}),O(h(i,"click").pipe(m(()=>-1)),h(a,"click").pipe(m(()=>1))).pipe(W(p)).subscribe(c=>{let{width:l}=ce(o);o.scrollBy({left:l*c,behavior:"smooth"})}),r.pipe(W(p),b(c=>n.includes(c))).subscribe(c=>c.click()),o.classList.add("tabbed-labels--linked");for(let c of n){let l=R(`label[for="${c.id}"]`);l.replaceChildren(x("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),h(l.firstElementChild,"click").pipe(W(p),b(f=>!(f.metaKey||f.ctrlKey)),w(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return B("content.tabs.link")&&s.pipe(Ce(1),re(t)).subscribe(([{active:c},{offset:l}])=>{let f=c.innerText.trim();if(c.hasAttribute("data-md-switching"))c.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let y of P("[data-tabs]"))for(let L of P(":scope > input",y)){let X=R(`label[for="${L.id}"]`);if(X!==c&&X.innerText.trim()===f){X.setAttribute("data-md-switching",""),L.click();break}}window.scrollTo({top:e.offsetTop-u});let d=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...d])])}}),s.pipe(W(p)).subscribe(()=>{for(let c of P("audio, video",e))c.pause()}),Ya(n).pipe(w(c=>s.next(c)),_(()=>s.complete()),m(c=>$({ref:e},c)))}).pipe(Ke(se))}function zn(e,{viewport$:t,target$:r,print$:o}){return O(...P(".annotate:not(.highlight)",e).map(n=>Pn(n,{target$:r,print$:o})),...P("pre:not(.mermaid) > code",e).map(n=>jn(n,{target$:r,print$:o})),...P("pre.mermaid",e).map(n=>Wn(n)),...P("table:not([class])",e).map(n=>Vn(n)),...P("details",e).map(n=>Fn(n,{target$:r,print$:o})),...P("[data-tabs]",e).map(n=>Nn(n,{viewport$:t,target$:r})),...P("[title]",e).filter(()=>B("content.tooltips")).map(n=>mt(n,{viewport$:t})))}function Ba(e,{alert$:t}){return t.pipe(v(r=>O(I(!0),I(!1).pipe(Ge(2e3))).pipe(m(o=>({message:r,active:o})))))}function qn(e,t){let r=R(".md-typeset",e);return C(()=>{let o=new g;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),Ba(e,t).pipe(w(n=>o.next(n)),_(()=>o.complete()),m(n=>$({ref:e},n)))})}var Ga=0;function Ja(e,t){document.body.append(e);let{width:r}=ce(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=cr(t),n=typeof o!="undefined"?Ne(o):I({x:0,y:0}),i=O(et(t),$t(t)).pipe(K());return z([i,n]).pipe(m(([a,s])=>{let{x:p,y:c}=Ve(t),l=ce(t),f=t.closest("table");return f&&t.parentElement&&(p+=f.offsetLeft+t.parentElement.offsetLeft,c+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:p-s.x+l.width/2-r/2,y:c-s.y+l.height+8}}}))}function Qn(e){let t=e.title;if(!t.length)return S;let r=`__tooltip_${Ga++}`,o=Rt(r,"inline"),n=R(".md-typeset",o);return n.innerHTML=t,C(()=>{let i=new g;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),O(i.pipe(b(({active:a})=>a)),i.pipe(_e(250),b(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Me(16,me)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(pt(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Ja(o,e).pipe(w(a=>i.next(a)),_(()=>i.complete()),m(a=>$({ref:e},a)))}).pipe(Ke(se))}function Xa({viewport$:e}){if(!B("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Be(2,1),m(([n,i])=>[n<i,i]),ee(0)),r=z([e,t]).pipe(b(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),K()),o=ze("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),K(),v(n=>n?r:I(!1)),Q(!1))}function Kn(e,t){return C(()=>z([ge(e),Xa(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),K((r,o)=>r.height===o.height&&r.hidden===o.hidden),G(1))}function Yn(e,{header$:t,main$:r}){return C(()=>{let o=new g,n=o.pipe(Z(),ie(!0));o.pipe(ee("active"),He(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=ue(P("[title]",e)).pipe(b(()=>B("content.tooltips")),ne(a=>Qn(a)));return r.subscribe(o),t.pipe(W(n),m(a=>$({ref:e},a)),Re(i.pipe(W(n))))})}function Za(e,{viewport$:t,header$:r}){return mr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ce(e);return{active:o>=n}}),ee("active"))}function Bn(e,t){return C(()=>{let r=new g;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=fe(".md-content h1");return typeof o=="undefined"?S:Za(o,t).pipe(w(n=>r.next(n)),_(()=>r.complete()),m(n=>$({ref:e},n)))})}function Gn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),K()),n=o.pipe(v(()=>ge(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),ee("bottom"))));return z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:p},size:{height:c}}])=>(c=Math.max(0,c-Math.max(0,a-p,i)-Math.max(0,c+p-s)),{offset:a-i,height:c,active:a-i<=p})),K((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function es(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return I(...e).pipe(ne(o=>h(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),G(1))}function Jn(e){let t=P("input",e),r=x("meta",{name:"theme-color"});document.head.appendChild(r);let o=x("meta",{name:"color-scheme"});document.head.appendChild(o);let n=Pt("(prefers-color-scheme: light)");return C(()=>{let i=new g;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),p=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=p.getAttribute("data-md-color-scheme"),a.color.primary=p.getAttribute("data-md-color-primary"),a.color.accent=p.getAttribute("data-md-color-accent")}for(let[s,p]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,p);for(let s=0;s<t.length;s++){let p=t[s].nextElementSibling;p instanceof HTMLElement&&(p.hidden=a.index!==s)}__md_set("__palette",a)}),h(e,"keydown").pipe(b(a=>a.key==="Enter"),re(i,(a,s)=>s)).subscribe(({index:a})=>{a=(a+1)%t.length,t[a].click(),t[a].focus()}),i.pipe(m(()=>{let a=Se("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(p=>(+p).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(ve(se)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),es(t).pipe(W(n.pipe(Ce(1))),ct(),w(a=>i.next(a)),_(()=>i.complete()),m(a=>$({ref:e},a)))})}function Xn(e,{progress$:t}){return C(()=>{let r=new g;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(w(o=>r.next({value:o})),_(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Jr=Mt(Br());function ts(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Zn({alert$:e}){Jr.default.isSupported()&&new j(t=>{new Jr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||ts(R(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(w(t=>{t.trigger.focus()}),m(()=>Ee("clipboard.copied"))).subscribe(e)}function ei(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function rs(e,t){let r=new Map;for(let o of P("url",e)){let n=R("loc",o),i=[ei(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let a of P("[rel=alternate]",o)){let s=a.getAttribute("href");s!=null&&i.push(ei(new URL(s),t))}}return r}function ur(e){return un(new URL("sitemap.xml",e)).pipe(m(t=>rs(t,new URL(e))),de(()=>I(new Map)))}function os(e,t){if(!(e.target instanceof Element))return S;let r=e.target.closest("a");if(r===null)return S;if(r.target||e.metaKey||e.ctrlKey)return S;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),I(new URL(r.href))):S}function ti(e){let t=new Map;for(let r of P(":scope > *",e.head))t.set(r.outerHTML,r);return t}function ri(e){for(let t of P("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return I(e)}function ns(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...B("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=fe(o),i=fe(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=ti(document);for(let[o,n]of ti(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Se("container");return We(P("script",r)).pipe(v(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new j(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),S}),Z(),ie(document))}function oi({location$:e,viewport$:t,progress$:r}){let o=xe();if(location.protocol==="file:")return S;let n=ur(o.base);I(document).subscribe(ri);let i=h(document.body,"click").pipe(He(n),v(([p,c])=>os(p,c)),pe()),a=h(window,"popstate").pipe(m(ye),pe());i.pipe(re(t)).subscribe(([p,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",p)}),O(i,a).subscribe(e);let s=e.pipe(ee("pathname"),v(p=>fn(p,{progress$:r}).pipe(de(()=>(lt(p,!0),S)))),v(ri),v(ns),pe());return O(s.pipe(re(e,(p,c)=>c)),s.pipe(v(()=>e),ee("pathname"),v(()=>e),ee("hash")),e.pipe(K((p,c)=>p.pathname===c.pathname&&p.hash===c.hash),v(()=>i),w(()=>history.back()))).subscribe(p=>{var c,l;history.state!==null||!p.hash?window.scrollTo(0,(l=(c=history.state)==null?void 0:c.y)!=null?l:0):(history.scrollRestoration="auto",pn(p.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),h(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(ee("offset"),_e(100)).subscribe(({offset:p})=>{history.replaceState(p,"")}),s}var ni=Mt(qr());function ii(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}<mark data-md-highlight>${a}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ni.default)(a).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function jt(e){return e.type===1}function dr(e){return e.type===3}function ai(e,t){let r=yn(e);return O(I(location.protocol!=="file:"),ze("search")).pipe(Ae(o=>o),v(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:B("search.suggest")}}})),r}function si(e){var l;let{selectedVersionSitemap:t,selectedVersionBaseURL:r,currentLocation:o,currentBaseURL:n}=e,i=(l=Xr(n))==null?void 0:l.pathname;if(i===void 0)return;let a=ss(o.pathname,i);if(a===void 0)return;let s=ps(t.keys());if(!t.has(s))return;let p=Xr(a,s);if(!p||!t.has(p.href))return;let c=Xr(a,r);if(c)return c.hash=o.hash,c.search=o.search,c}function Xr(e,t){try{return new URL(e,t)}catch(r){return}}function ss(e,t){if(e.startsWith(t))return e.slice(t.length)}function cs(e,t){let r=Math.min(e.length,t.length),o;for(o=0;o<r&&e[o]===t[o];++o);return o}function ps(e){let t;for(let r of e)t===void 0?t=r:t=t.slice(0,cs(t,r));return t!=null?t:""}function ci({document$:e}){let t=xe(),r=je(new URL("../versions.json",t.base)).pipe(de(()=>S)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),v(n=>h(document.body,"click").pipe(b(i=>!i.metaKey&&!i.ctrlKey),re(o),v(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let p=s.href;return!i.target.closest(".md-version")&&n.get(p)===a?S:(i.preventDefault(),I(new URL(p)))}}return S}),v(i=>ur(i).pipe(m(a=>{var s;return(s=si({selectedVersionSitemap:a,selectedVersionBaseURL:i,currentLocation:ye(),currentBaseURL:t.base}))!=null?s:i})))))).subscribe(n=>lt(n,!0)),z([r,o]).subscribe(([n,i])=>{R(".md-header__topic").appendChild(Cn(n,i))}),e.pipe(v(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let p of s)for(let c of n.aliases.concat(n.version))if(new RegExp(p,"i").test(c)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of ae("outdated"))s.hidden=!1})}function ls(e,{worker$:t}){let{searchParams:r}=ye();r.has("q")&&(Je("search",!0),e.value=r.get("q"),e.focus(),ze("search").pipe(Ae(i=>!i)).subscribe(()=>{let i=ye();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=et(e),n=O(t.pipe(Ae(jt)),h(e,"keyup"),o).pipe(m(()=>e.value),K());return z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),G(1))}function pi(e,{worker$:t}){let r=new g,o=r.pipe(Z(),ie(!0));z([t.pipe(Ae(jt)),r],(i,a)=>a).pipe(ee("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(ee("focus")).subscribe(({focus:i})=>{i&&Je("search",i)}),h(e.form,"reset").pipe(W(o)).subscribe(()=>e.focus());let n=R("header [for=__search]");return h(n,"click").subscribe(()=>e.focus()),ls(e,{worker$:t}).pipe(w(i=>r.next(i)),_(()=>r.complete()),m(i=>$({ref:e},i)),G(1))}function li(e,{worker$:t,query$:r}){let o=new g,n=on(e.parentElement).pipe(b(Boolean)),i=e.parentElement,a=R(":scope > :first-child",e),s=R(":scope > :last-child",e);ze("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(re(r),Wr(t.pipe(Ae(jt)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?Ee("search.result.none"):Ee("search.result.placeholder");break;case 1:a.textContent=Ee("search.result.one");break;default:let u=sr(l.length);a.textContent=Ee("search.result.other",u)}});let p=o.pipe(w(()=>s.innerHTML=""),v(({items:l})=>O(I(...l.slice(0,10)),I(...l.slice(10)).pipe(Be(4),Vr(n),v(([f])=>f)))),m(Mn),pe());return p.subscribe(l=>s.appendChild(l)),p.pipe(ne(l=>{let f=fe("details",l);return typeof f=="undefined"?S:h(f,"toggle").pipe(W(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(b(dr),m(({data:l})=>l)).pipe(w(l=>o.next(l)),_(()=>o.complete()),m(l=>$({ref:e},l)))}function ms(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=ye();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function mi(e,t){let r=new g,o=r.pipe(Z(),ie(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),h(e,"click").pipe(W(o)).subscribe(n=>n.preventDefault()),ms(e,t).pipe(w(n=>r.next(n)),_(()=>r.complete()),m(n=>$({ref:e},n)))}function fi(e,{worker$:t,keyboard$:r}){let o=new g,n=Se("search-query"),i=O(h(n,"keydown"),h(n,"focus")).pipe(ve(se),m(()=>n.value),K());return o.pipe(He(i),m(([{suggest:s},p])=>{let c=p.split(/([\s-]+)/);if(s!=null&&s.length&&c[c.length-1]){let l=s[s.length-1];l.startsWith(c[c.length-1])&&(c[c.length-1]=l)}else c.length=0;return c})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g,"&nbsp;")),r.pipe(b(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(b(dr),m(({data:s})=>s)).pipe(w(s=>o.next(s)),_(()=>o.complete()),m(()=>({ref:e})))}function ui(e,{index$:t,keyboard$:r}){let o=xe();try{let n=ai(o.search,t),i=Se("search-query",e),a=Se("search-result",e);h(e,"click").pipe(b(({target:p})=>p instanceof Element&&!!p.closest("a"))).subscribe(()=>Je("search",!1)),r.pipe(b(({mode:p})=>p==="search")).subscribe(p=>{let c=Ie();switch(p.type){case"Enter":if(c===i){let l=new Map;for(let f of P(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,d])=>d-u);f.click()}p.claim()}break;case"Escape":case"Tab":Je("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof c=="undefined")i.focus();else{let l=[i,...P(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(c))+l.length+(p.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}p.claim();break;default:i!==Ie()&&i.focus()}}),r.pipe(b(({mode:p})=>p==="global")).subscribe(p=>{switch(p.type){case"f":case"s":case"/":i.focus(),i.select(),p.claim();break}});let s=pi(i,{worker$:n});return O(s,li(a,{worker$:n,query$:s})).pipe(Re(...ae("search-share",e).map(p=>mi(p,{query$:s})),...ae("search-suggest",e).map(p=>fi(p,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Ye}}function di(e,{index$:t,location$:r}){return z([t,r.pipe(Q(ye()),b(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>ii(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let p=s.textContent,c=o(p);c.length>p.length&&n.set(s,c)}for(let[s,p]of n){let{childNodes:c}=x("span",null,p);s.replaceWith(...Array.from(c))}return{ref:e,nodes:n}}))}function fs(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),K((i,a)=>i.height===a.height&&i.locked===a.locked))}function Zr(e,o){var n=o,{header$:t}=n,r=so(n,["header$"]);let i=R(".md-sidebar__scrollwrap",e),{y:a}=Ve(i);return C(()=>{let s=new g,p=s.pipe(Z(),ie(!0)),c=s.pipe(Me(0,me));return c.pipe(re(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),c.pipe(Ae()).subscribe(()=>{for(let l of P(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=ce(f);f.scrollTo({top:u-d/2})}}}),ue(P("label[tabindex]",e)).pipe(ne(l=>h(l,"click").pipe(ve(se),m(()=>l),W(p)))).subscribe(l=>{let f=R(`[id="${l.htmlFor}"]`);R(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),fs(e,r).pipe(w(l=>s.next(l)),_(()=>s.complete()),m(l=>$({ref:e},l)))})}function hi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return st(je(`${r}/releases/latest`).pipe(de(()=>S),m(o=>({version:o.tag_name})),De({})),je(r).pipe(de(()=>S),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),De({}))).pipe(m(([o,n])=>$($({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return je(r).pipe(m(o=>({repositories:o.public_repos})),De({}))}}function bi(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return st(je(`${r}/releases/permalink/latest`).pipe(de(()=>S),m(({tag_name:o})=>({version:o})),De({})),je(r).pipe(de(()=>S),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),De({}))).pipe(m(([o,n])=>$($({},o),n)))}function vi(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return hi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return bi(r,o)}return S}var us;function ds(e){return us||(us=C(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(ae("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return S}return vi(e.href).pipe(w(o=>__md_set("__source",o,sessionStorage)))}).pipe(de(()=>S),b(t=>Object.keys(t).length>0),m(t=>({facts:t})),G(1)))}function gi(e){let t=R(":scope > :last-child",e);return C(()=>{let r=new g;return r.subscribe(({facts:o})=>{t.appendChild(_n(o)),t.classList.add("md-source__repository--active")}),ds(e).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}function hs(e,{viewport$:t,header$:r}){return ge(document.body).pipe(v(()=>mr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),ee("hidden"))}function yi(e,t){return C(()=>{let r=new g;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(B("navigation.tabs.sticky")?I({hidden:!1}):hs(e,t)).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}function bs(e,{viewport$:t,header$:r}){let o=new Map,n=P(".md-nav__link",e);for(let s of n){let p=decodeURIComponent(s.hash.substring(1)),c=fe(`[id="${p}"]`);typeof c!="undefined"&&o.set(s,c)}let i=r.pipe(ee("height"),m(({height:s})=>{let p=Se("main"),c=R(":scope > :first-child",p);return s+.8*(c.offsetTop-p.offsetTop)}),pe());return ge(document.body).pipe(ee("height"),v(s=>C(()=>{let p=[];return I([...o].reduce((c,[l,f])=>{for(;p.length&&o.get(p[p.length-1]).tagName>=f.tagName;)p.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let d=f.offsetParent;for(;d;d=d.offsetParent)u+=d.offsetTop;return c.set([...p=[...p,l]].reverse(),u)},new Map))}).pipe(m(p=>new Map([...p].sort(([,c],[,l])=>c-l))),He(i),v(([p,c])=>t.pipe(Fr(([l,f],{offset:{y:u},size:d})=>{let y=u+d.height>=Math.floor(s.height);for(;f.length;){let[,L]=f[0];if(L-c<u||y)l=[...l,f.shift()];else break}for(;l.length;){let[,L]=l[l.length-1];if(L-c>=u&&!y)f=[l.pop(),...f];else break}return[l,f]},[[],[...p]]),K((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,p])=>({prev:s.map(([c])=>c),next:p.map(([c])=>c)})),Q({prev:[],next:[]}),Be(2,1),m(([s,p])=>s.prev.length<p.prev.length?{prev:p.prev.slice(Math.max(0,s.prev.length-1),p.prev.length),next:[]}:{prev:p.prev.slice(-1),next:p.next.slice(0,p.next.length-s.next.length)}))}function xi(e,{viewport$:t,header$:r,main$:o,target$:n}){return C(()=>{let i=new g,a=i.pipe(Z(),ie(!0));if(i.subscribe(({prev:s,next:p})=>{for(let[c]of p)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",c===s.length-1)}),B("toc.follow")){let s=O(t.pipe(_e(1),m(()=>{})),t.pipe(_e(250),m(()=>"smooth")));i.pipe(b(({prev:p})=>p.length>0),He(o.pipe(ve(se))),re(s)).subscribe(([[{prev:p}],c])=>{let[l]=p[p.length-1];if(l.offsetHeight){let f=cr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=ce(f);f.scrollTo({top:u-d/2,behavior:c})}}})}return B("navigation.tracking")&&t.pipe(W(a),ee("offset"),_e(250),Ce(1),W(n.pipe(Ce(1))),ct({delay:250}),re(i)).subscribe(([,{prev:s}])=>{let p=ye(),c=s[s.length-1];if(c&&c.length){let[l]=c,{hash:f}=new URL(l.href);p.hash!==f&&(p.hash=f,history.replaceState({},"",`${p}`))}else p.hash="",history.replaceState({},"",`${p}`)}),bs(e,{viewport$:t,header$:r}).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))})}function vs(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Be(2,1),m(([a,s])=>a>s&&s>0),K()),i=r.pipe(m(({active:a})=>a));return z([i,n]).pipe(m(([a,s])=>!(a&&s)),K(),W(o.pipe(Ce(1))),ie(!0),ct({delay:250}),m(a=>({hidden:a})))}function Ei(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new g,a=i.pipe(Z(),ie(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(W(a),ee("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),h(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),vs(e,{viewport$:t,main$:o,target$:n}).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))}function wi({document$:e,viewport$:t}){e.pipe(v(()=>P(".md-ellipsis")),ne(r=>tt(r).pipe(W(e.pipe(Ce(1))),b(o=>o),m(()=>r),Te(1))),b(r=>r.offsetWidth<r.scrollWidth),ne(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,B("content.tooltips")?mt(n,{viewport$:t}).pipe(W(e.pipe(Ce(1))),_(()=>n.removeAttribute("title"))):S})).subscribe(),B("content.tooltips")&&e.pipe(v(()=>P(".md-status")),ne(r=>mt(r,{viewport$:t}))).subscribe()}function Ti({document$:e,tablet$:t}){e.pipe(v(()=>P(".md-toggle--indeterminate")),w(r=>{r.indeterminate=!0,r.checked=!1}),ne(r=>h(r,"change").pipe(Dr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),re(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function gs(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Si({document$:e}){e.pipe(v(()=>P("[data-md-scrollfix]")),w(t=>t.removeAttribute("data-md-scrollfix")),b(gs),ne(t=>h(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function Oi({viewport$:e,tablet$:t}){z([ze("search"),t]).pipe(m(([r,o])=>r&&!o),v(r=>I(r).pipe(Ge(r?400:100))),re(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function ys(){return location.protocol==="file:"?Tt(`${new URL("search/search_index.js",eo.base)}`).pipe(m(()=>__index),G(1)):je(new URL("search/search_index.json",eo.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ot=Go(),Ut=sn(),Lt=ln(Ut),to=an(),Oe=gn(),hr=Pt("(min-width: 960px)"),Mi=Pt("(min-width: 1220px)"),_i=mn(),eo=xe(),Ai=document.forms.namedItem("search")?ys():Ye,ro=new g;Zn({alert$:ro});var oo=new g;B("navigation.instant")&&oi({location$:Ut,viewport$:Oe,progress$:oo}).subscribe(ot);var Li;((Li=eo.version)==null?void 0:Li.provider)==="mike"&&ci({document$:ot});O(Ut,Lt).pipe(Ge(125)).subscribe(()=>{Je("drawer",!1),Je("search",!1)});to.pipe(b(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=fe("link[rel=prev]");typeof t!="undefined"&&lt(t);break;case"n":case".":let r=fe("link[rel=next]");typeof r!="undefined"&&lt(r);break;case"Enter":let o=Ie();o instanceof HTMLLabelElement&&o.click()}});wi({viewport$:Oe,document$:ot});Ti({document$:ot,tablet$:hr});Si({document$:ot});Oi({viewport$:Oe,tablet$:hr});var rt=Kn(Se("header"),{viewport$:Oe}),Ft=ot.pipe(m(()=>Se("main")),v(e=>Gn(e,{viewport$:Oe,header$:rt})),G(1)),xs=O(...ae("consent").map(e=>En(e,{target$:Lt})),...ae("dialog").map(e=>qn(e,{alert$:ro})),...ae("palette").map(e=>Jn(e)),...ae("progress").map(e=>Xn(e,{progress$:oo})),...ae("search").map(e=>ui(e,{index$:Ai,keyboard$:to})),...ae("source").map(e=>gi(e))),Es=C(()=>O(...ae("announce").map(e=>xn(e)),...ae("content").map(e=>zn(e,{viewport$:Oe,target$:Lt,print$:_i})),...ae("content").map(e=>B("search.highlight")?di(e,{index$:Ai,location$:Ut}):S),...ae("header").map(e=>Yn(e,{viewport$:Oe,header$:rt,main$:Ft})),...ae("header-title").map(e=>Bn(e,{viewport$:Oe,header$:rt})),...ae("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Nr(Mi,()=>Zr(e,{viewport$:Oe,header$:rt,main$:Ft})):Nr(hr,()=>Zr(e,{viewport$:Oe,header$:rt,main$:Ft}))),...ae("tabs").map(e=>yi(e,{viewport$:Oe,header$:rt})),...ae("toc").map(e=>xi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Lt})),...ae("top").map(e=>Ei(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Lt})))),Ci=ot.pipe(v(()=>Es),Re(xs),G(1));Ci.subscribe();window.document$=ot;window.location$=Ut;window.target$=Lt;window.keyboard$=to;window.viewport$=Oe;window.tablet$=hr;window.screen$=Mi;window.print$=_i;window.alert$=ro;window.progress$=oo;window.component$=Ci;})();
+//# sourceMappingURL=bundle.88dd0f4e.min.js.map
 
diff --git a/assets/javascripts/bundle.83f73b43.min.js.map b/assets/javascripts/bundle.88dd0f4e.min.js.map
similarity index 82%
rename from assets/javascripts/bundle.83f73b43.min.js.map
rename to assets/javascripts/bundle.88dd0f4e.min.js.map
index fe920b7d6..dab2a8754 100644
--- a/assets/javascripts/bundle.83f73b43.min.js.map
+++ b/assets/javascripts/bundle.88dd0f4e.min.js.map
@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/escape-html/index.js", "node_modules/clipboard/dist/clipboard.js", "src/templates/assets/javascripts/bundle.ts", "node_modules/tslib/tslib.es6.mjs", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/BehaviorSubject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/QueueAction.ts", "node_modules/rxjs/src/internal/scheduler/QueueScheduler.ts", "node_modules/rxjs/src/internal/scheduler/queue.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/observable/throwError.ts", "node_modules/rxjs/src/internal/util/EmptyError.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/debounce.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/throwIfEmpty.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/first.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/repeat.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/templates/assets/javascripts/browser/document/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/browser/element/focus/index.ts", "src/templates/assets/javascripts/browser/element/hover/index.ts", "src/templates/assets/javascripts/utilities/h/index.ts", "src/templates/assets/javascripts/utilities/round/index.ts", "src/templates/assets/javascripts/browser/script/index.ts", "src/templates/assets/javascripts/browser/element/size/_/index.ts", "src/templates/assets/javascripts/browser/element/size/content/index.ts", "src/templates/assets/javascripts/browser/element/offset/_/index.ts", "src/templates/assets/javascripts/browser/element/offset/content/index.ts", "src/templates/assets/javascripts/browser/element/visibility/index.ts", "src/templates/assets/javascripts/browser/toggle/index.ts", "src/templates/assets/javascripts/browser/keyboard/index.ts", "src/templates/assets/javascripts/browser/location/_/index.ts", "src/templates/assets/javascripts/browser/location/hash/index.ts", "src/templates/assets/javascripts/browser/media/index.ts", "src/templates/assets/javascripts/browser/request/index.ts", "src/templates/assets/javascripts/browser/viewport/offset/index.ts", "src/templates/assets/javascripts/browser/viewport/size/index.ts", "src/templates/assets/javascripts/browser/viewport/_/index.ts", "src/templates/assets/javascripts/browser/viewport/at/index.ts", "src/templates/assets/javascripts/browser/worker/index.ts", "src/templates/assets/javascripts/_/index.ts", "src/templates/assets/javascripts/components/_/index.ts", "src/templates/assets/javascripts/components/announce/index.ts", "src/templates/assets/javascripts/components/consent/index.ts", "src/templates/assets/javascripts/templates/tooltip/index.tsx", "src/templates/assets/javascripts/templates/annotation/index.tsx", "src/templates/assets/javascripts/templates/clipboard/index.tsx", "src/templates/assets/javascripts/templates/search/index.tsx", "src/templates/assets/javascripts/templates/source/index.tsx", "src/templates/assets/javascripts/templates/tabbed/index.tsx", "src/templates/assets/javascripts/templates/table/index.tsx", "src/templates/assets/javascripts/templates/version/index.tsx", "src/templates/assets/javascripts/components/tooltip2/index.ts", "src/templates/assets/javascripts/components/content/annotation/_/index.ts", "src/templates/assets/javascripts/components/content/annotation/list/index.ts", "src/templates/assets/javascripts/components/content/annotation/block/index.ts", "src/templates/assets/javascripts/components/content/code/_/index.ts", "src/templates/assets/javascripts/components/content/details/index.ts", "src/templates/assets/javascripts/components/content/mermaid/index.css", "src/templates/assets/javascripts/components/content/mermaid/index.ts", "src/templates/assets/javascripts/components/content/table/index.ts", "src/templates/assets/javascripts/components/content/tabs/index.ts", "src/templates/assets/javascripts/components/content/_/index.ts", "src/templates/assets/javascripts/components/dialog/index.ts", "src/templates/assets/javascripts/components/tooltip/index.ts", "src/templates/assets/javascripts/components/header/_/index.ts", "src/templates/assets/javascripts/components/header/title/index.ts", "src/templates/assets/javascripts/components/main/index.ts", "src/templates/assets/javascripts/components/palette/index.ts", "src/templates/assets/javascripts/components/progress/index.ts", "src/templates/assets/javascripts/integrations/clipboard/index.ts", "src/templates/assets/javascripts/integrations/sitemap/index.ts", "src/templates/assets/javascripts/integrations/instant/index.ts", "src/templates/assets/javascripts/integrations/search/highlighter/index.ts", "src/templates/assets/javascripts/integrations/search/worker/message/index.ts", "src/templates/assets/javascripts/integrations/search/worker/_/index.ts", "src/templates/assets/javascripts/integrations/version/findurl/index.ts", "src/templates/assets/javascripts/integrations/version/index.ts", "src/templates/assets/javascripts/components/search/query/index.ts", "src/templates/assets/javascripts/components/search/result/index.ts", "src/templates/assets/javascripts/components/search/share/index.ts", "src/templates/assets/javascripts/components/search/suggest/index.ts", "src/templates/assets/javascripts/components/search/_/index.ts", "src/templates/assets/javascripts/components/search/highlight/index.ts", "src/templates/assets/javascripts/components/sidebar/index.ts", "src/templates/assets/javascripts/components/source/facts/github/index.ts", "src/templates/assets/javascripts/components/source/facts/gitlab/index.ts", "src/templates/assets/javascripts/components/source/facts/_/index.ts", "src/templates/assets/javascripts/components/source/_/index.ts", "src/templates/assets/javascripts/components/tabs/index.ts", "src/templates/assets/javascripts/components/toc/index.ts", "src/templates/assets/javascripts/components/top/index.ts", "src/templates/assets/javascripts/patches/ellipsis/index.ts", "src/templates/assets/javascripts/patches/indeterminate/index.ts", "src/templates/assets/javascripts/patches/scrollfix/index.ts", "src/templates/assets/javascripts/patches/scrolllock/index.ts", "src/templates/assets/javascripts/polyfills/index.ts"],
-  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see /~https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see /~https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via /~https://github.com/lipsmack from /~https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by /~https://github.com/lazd\n    // Ref: /~https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ viewport$, document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/******************************************************************************\nCopyright (c) Microsoft Corporation.\n\nPermission to use, copy, modify, and/or distribute this software for any\npurpose with or without fee is hereby granted.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\nPERFORMANCE OF THIS SOFTWARE.\n***************************************************************************** */\n/* global Reflect, Promise, SuppressedError, Symbol, Iterator */\n\nvar extendStatics = function(d, b) {\n  extendStatics = Object.setPrototypeOf ||\n      ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\n      function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\n  return extendStatics(d, b);\n};\n\nexport function __extends(d, b) {\n  if (typeof b !== \"function\" && b !== null)\n      throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\n  extendStatics(d, b);\n  function __() { this.constructor = d; }\n  d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\n}\n\nexport var __assign = function() {\n  __assign = Object.assign || function __assign(t) {\n      for (var s, i = 1, n = arguments.length; i < n; i++) {\n          s = arguments[i];\n          for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\n      }\n      return t;\n  }\n  return __assign.apply(this, arguments);\n}\n\nexport function __rest(s, e) {\n  var t = {};\n  for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\n      t[p] = s[p];\n  if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\n      for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\n          if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\n              t[p[i]] = s[p[i]];\n      }\n  return t;\n}\n\nexport function __decorate(decorators, target, key, desc) {\n  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\n  if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\n  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\n  return c > 3 && r && Object.defineProperty(target, key, r), r;\n}\n\nexport function __param(paramIndex, decorator) {\n  return function (target, key) { decorator(target, key, paramIndex); }\n}\n\nexport function __esDecorate(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {\n  function accept(f) { if (f !== void 0 && typeof f !== \"function\") throw new TypeError(\"Function expected\"); return f; }\n  var kind = contextIn.kind, key = kind === \"getter\" ? \"get\" : kind === \"setter\" ? \"set\" : \"value\";\n  var target = !descriptorIn && ctor ? contextIn[\"static\"] ? ctor : ctor.prototype : null;\n  var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});\n  var _, done = false;\n  for (var i = decorators.length - 1; i >= 0; i--) {\n      var context = {};\n      for (var p in contextIn) context[p] = p === \"access\" ? {} : contextIn[p];\n      for (var p in contextIn.access) context.access[p] = contextIn.access[p];\n      context.addInitializer = function (f) { if (done) throw new TypeError(\"Cannot add initializers after decoration has completed\"); extraInitializers.push(accept(f || null)); };\n      var result = (0, decorators[i])(kind === \"accessor\" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);\n      if (kind === \"accessor\") {\n          if (result === void 0) continue;\n          if (result === null || typeof result !== \"object\") throw new TypeError(\"Object expected\");\n          if (_ = accept(result.get)) descriptor.get = _;\n          if (_ = accept(result.set)) descriptor.set = _;\n          if (_ = accept(result.init)) initializers.unshift(_);\n      }\n      else if (_ = accept(result)) {\n          if (kind === \"field\") initializers.unshift(_);\n          else descriptor[key] = _;\n      }\n  }\n  if (target) Object.defineProperty(target, contextIn.name, descriptor);\n  done = true;\n};\n\nexport function __runInitializers(thisArg, initializers, value) {\n  var useValue = arguments.length > 2;\n  for (var i = 0; i < initializers.length; i++) {\n      value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);\n  }\n  return useValue ? value : void 0;\n};\n\nexport function __propKey(x) {\n  return typeof x === \"symbol\" ? x : \"\".concat(x);\n};\n\nexport function __setFunctionName(f, name, prefix) {\n  if (typeof name === \"symbol\") name = name.description ? \"[\".concat(name.description, \"]\") : \"\";\n  return Object.defineProperty(f, \"name\", { configurable: true, value: prefix ? \"\".concat(prefix, \" \", name) : name });\n};\n\nexport function __metadata(metadataKey, metadataValue) {\n  if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\n}\n\nexport function __awaiter(thisArg, _arguments, P, generator) {\n  function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n  return new (P || (P = Promise))(function (resolve, reject) {\n      function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n      function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n      function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n      step((generator = generator.apply(thisArg, _arguments || [])).next());\n  });\n}\n\nexport function __generator(thisArg, body) {\n  var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === \"function\" ? Iterator : Object).prototype);\n  return g.next = verb(0), g[\"throw\"] = verb(1), g[\"return\"] = verb(2), typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\n  function verb(n) { return function (v) { return step([n, v]); }; }\n  function step(op) {\n      if (f) throw new TypeError(\"Generator is already executing.\");\n      while (g && (g = 0, op[0] && (_ = 0)), _) try {\n          if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\n          if (y = 0, t) op = [op[0] & 2, t.value];\n          switch (op[0]) {\n              case 0: case 1: t = op; break;\n              case 4: _.label++; return { value: op[1], done: false };\n              case 5: _.label++; y = op[1]; op = [0]; continue;\n              case 7: op = _.ops.pop(); _.trys.pop(); continue;\n              default:\n                  if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\n                  if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\n                  if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\n                  if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\n                  if (t[2]) _.ops.pop();\n                  _.trys.pop(); continue;\n          }\n          op = body.call(thisArg, _);\n      } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\n      if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\n  }\n}\n\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\n  if (k2 === undefined) k2 = k;\n  var desc = Object.getOwnPropertyDescriptor(m, k);\n  if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n  }\n  Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n  if (k2 === undefined) k2 = k;\n  o[k2] = m[k];\n});\n\nexport function __exportStar(m, o) {\n  for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\n}\n\nexport function __values(o) {\n  var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\n  if (m) return m.call(o);\n  if (o && typeof o.length === \"number\") return {\n      next: function () {\n          if (o && i >= o.length) o = void 0;\n          return { value: o && o[i++], done: !o };\n      }\n  };\n  throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\n}\n\nexport function __read(o, n) {\n  var m = typeof Symbol === \"function\" && o[Symbol.iterator];\n  if (!m) return o;\n  var i = m.call(o), r, ar = [], e;\n  try {\n      while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\n  }\n  catch (error) { e = { error: error }; }\n  finally {\n      try {\n          if (r && !r.done && (m = i[\"return\"])) m.call(i);\n      }\n      finally { if (e) throw e.error; }\n  }\n  return ar;\n}\n\n/** @deprecated */\nexport function __spread() {\n  for (var ar = [], i = 0; i < arguments.length; i++)\n      ar = ar.concat(__read(arguments[i]));\n  return ar;\n}\n\n/** @deprecated */\nexport function __spreadArrays() {\n  for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\n  for (var r = Array(s), k = 0, i = 0; i < il; i++)\n      for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\n          r[k] = a[j];\n  return r;\n}\n\nexport function __spreadArray(to, from, pack) {\n  if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\n      if (ar || !(i in from)) {\n          if (!ar) ar = Array.prototype.slice.call(from, 0, i);\n          ar[i] = from[i];\n      }\n  }\n  return to.concat(ar || Array.prototype.slice.call(from));\n}\n\nexport function __await(v) {\n  return this instanceof __await ? (this.v = v, this) : new __await(v);\n}\n\nexport function __asyncGenerator(thisArg, _arguments, generator) {\n  if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\n  var g = generator.apply(thisArg, _arguments || []), i, q = [];\n  return i = Object.create((typeof AsyncIterator === \"function\" ? AsyncIterator : Object).prototype), verb(\"next\"), verb(\"throw\"), verb(\"return\", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;\n  function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }\n  function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }\n  function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\n  function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\n  function fulfill(value) { resume(\"next\", value); }\n  function reject(value) { resume(\"throw\", value); }\n  function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\n}\n\nexport function __asyncDelegator(o) {\n  var i, p;\n  return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\n  function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }\n}\n\nexport function __asyncValues(o) {\n  if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\n  var m = o[Symbol.asyncIterator], i;\n  return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\n  function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\n  function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\n}\n\nexport function __makeTemplateObject(cooked, raw) {\n  if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\n  return cooked;\n};\n\nvar __setModuleDefault = Object.create ? (function(o, v) {\n  Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n  o[\"default\"] = v;\n};\n\nexport function __importStar(mod) {\n  if (mod && mod.__esModule) return mod;\n  var result = {};\n  if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\n  __setModuleDefault(result, mod);\n  return result;\n}\n\nexport function __importDefault(mod) {\n  return (mod && mod.__esModule) ? mod : { default: mod };\n}\n\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\n  if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\n  if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\n  return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\n}\n\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\n  if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\n  if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\n  if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\n  return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\n}\n\nexport function __classPrivateFieldIn(state, receiver) {\n  if (receiver === null || (typeof receiver !== \"object\" && typeof receiver !== \"function\")) throw new TypeError(\"Cannot use 'in' operator on non-object\");\n  return typeof state === \"function\" ? receiver === state : state.has(receiver);\n}\n\nexport function __addDisposableResource(env, value, async) {\n  if (value !== null && value !== void 0) {\n    if (typeof value !== \"object\" && typeof value !== \"function\") throw new TypeError(\"Object expected.\");\n    var dispose, inner;\n    if (async) {\n      if (!Symbol.asyncDispose) throw new TypeError(\"Symbol.asyncDispose is not defined.\");\n      dispose = value[Symbol.asyncDispose];\n    }\n    if (dispose === void 0) {\n      if (!Symbol.dispose) throw new TypeError(\"Symbol.dispose is not defined.\");\n      dispose = value[Symbol.dispose];\n      if (async) inner = dispose;\n    }\n    if (typeof dispose !== \"function\") throw new TypeError(\"Object not disposable.\");\n    if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };\n    env.stack.push({ value: value, dispose: dispose, async: async });\n  }\n  else if (async) {\n    env.stack.push({ async: true });\n  }\n  return value;\n}\n\nvar _SuppressedError = typeof SuppressedError === \"function\" ? SuppressedError : function (error, suppressed, message) {\n  var e = new Error(message);\n  return e.name = \"SuppressedError\", e.error = error, e.suppressed = suppressed, e;\n};\n\nexport function __disposeResources(env) {\n  function fail(e) {\n    env.error = env.hasError ? new _SuppressedError(e, env.error, \"An error was suppressed during disposal.\") : e;\n    env.hasError = true;\n  }\n  var r, s = 0;\n  function next() {\n    while (r = env.stack.pop()) {\n      try {\n        if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);\n        if (r.dispose) {\n          var result = r.dispose.call(r.value);\n          if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });\n        }\n        else s |= 1;\n      }\n      catch (e) {\n        fail(e);\n      }\n    }\n    if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();\n    if (env.hasError) throw env.error;\n  }\n  return next();\n}\n\nexport default {\n  __extends,\n  __assign,\n  __rest,\n  __decorate,\n  __param,\n  __metadata,\n  __awaiter,\n  __generator,\n  __createBinding,\n  __exportStar,\n  __values,\n  __read,\n  __spread,\n  __spreadArrays,\n  __spreadArray,\n  __await,\n  __asyncGenerator,\n  __asyncDelegator,\n  __asyncValues,\n  __makeTemplateObject,\n  __importStar,\n  __importDefault,\n  __classPrivateFieldGet,\n  __classPrivateFieldSet,\n  __classPrivateFieldIn,\n  __addDisposableResource,\n  __disposeResources,\n};\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: /~https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: /~https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec /~https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: /~https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { Subject } from './Subject';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\n\n/**\n * A variant of Subject that requires an initial value and emits its current\n * value whenever it is subscribed to.\n *\n * @class BehaviorSubject<T>\n */\nexport class BehaviorSubject<T> extends Subject<T> {\n  constructor(private _value: T) {\n    super();\n  }\n\n  get value(): T {\n    return this.getValue();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    const subscription = super._subscribe(subscriber);\n    !subscription.closed && subscriber.next(this._value);\n    return subscription;\n  }\n\n  getValue(): T {\n    const { hasError, thrownError, _value } = this;\n    if (hasError) {\n      throw thrownError;\n    }\n    this._throwIfClosed();\n    return _value;\n  }\n\n  next(value: T): void {\n    super.next((this._value = value));\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { Subscription } from '../Subscription';\nimport { QueueScheduler } from './QueueScheduler';\nimport { SchedulerAction } from '../types';\nimport { TimerHandle } from './timerHandle';\n\nexport class QueueAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: QueueScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (delay > 0) {\n      return super.schedule(state, delay);\n    }\n    this.delay = delay;\n    this.state = state;\n    this.scheduler.flush(this);\n    return this;\n  }\n\n  public execute(state: T, delay: number): any {\n    return delay > 0 || this.closed ? super.execute(state, delay) : this._execute(state, delay);\n  }\n\n  protected requestAsyncId(scheduler: QueueScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n\n    if ((delay != null && delay > 0) || (delay == null && this.delay > 0)) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n\n    // Otherwise flush the scheduler starting with this action.\n    scheduler.flush(this);\n\n    // HACK: In the past, this was returning `void`. However, `void` isn't a valid\n    // `TimerHandle`, and generally the return value here isn't really used. So the\n    // compromise is to return `0` which is both \"falsy\" and a valid `TimerHandle`,\n    // as opposed to refactoring every other instanceo of `requestAsyncId`.\n    return 0;\n  }\n}\n", "import { AsyncScheduler } from './AsyncScheduler';\n\nexport class QueueScheduler extends AsyncScheduler {\n}\n", "import { QueueAction } from './QueueAction';\nimport { QueueScheduler } from './QueueScheduler';\n\n/**\n *\n * Queue Scheduler\n *\n * <span class=\"informal\">Put every next task on a queue, instead of executing it immediately</span>\n *\n * `queue` scheduler, when used with delay, behaves the same as {@link asyncScheduler} scheduler.\n *\n * When used without delay, it schedules given task synchronously - executes it right when\n * it is scheduled. However when called recursively, that is when inside the scheduled task,\n * another task is scheduled with queue scheduler, instead of executing immediately as well,\n * that task will be put on a queue and wait for current one to finish.\n *\n * This means that when you execute task with `queue` scheduler, you are sure it will end\n * before any other task scheduled with that scheduler will start.\n *\n * ## Examples\n * Schedule recursively first, then do something\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(() => {\n *   queueScheduler.schedule(() => console.log('second')); // will not happen now, but will be put on a queue\n *\n *   console.log('first');\n * });\n *\n * // Logs:\n * // \"first\"\n * // \"second\"\n * ```\n *\n * Reschedule itself recursively\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(function(state) {\n *   if (state !== 0) {\n *     console.log('before', state);\n *     this.schedule(state - 1); // `this` references currently executing Action,\n *                               // which we reschedule with new state\n *     console.log('after', state);\n *   }\n * }, 0, 3);\n *\n * // In scheduler that runs recursively, you would expect:\n * // \"before\", 3\n * // \"before\", 2\n * // \"before\", 1\n * // \"after\", 1\n * // \"after\", 2\n * // \"after\", 3\n *\n * // But with queue it logs:\n * // \"before\", 3\n * // \"after\", 3\n * // \"before\", 2\n * // \"after\", 2\n * // \"before\", 1\n * // \"after\", 1\n * ```\n */\n\nexport const queueScheduler = new QueueScheduler(QueueAction);\n\n/**\n * @deprecated Renamed to {@link queueScheduler}. Will be removed in v8.\n */\nexport const queue = queueScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: /~https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// /~https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { noop } from '../util/noop';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * determined by another Observable has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link debounceTime}, but the time span of\n * emission silence is determined by a second Observable.</span>\n *\n * ![](debounce.svg)\n *\n * `debounce` delays notifications emitted by the source Observable, but drops previous\n * pending delayed emissions if a new notification arrives on the source Observable.\n * This operator keeps track of the most recent notification from the source\n * Observable, and spawns a duration Observable by calling the\n * `durationSelector` function. The notification is emitted only when the duration\n * Observable emits a next notification, and if no other notification was emitted on\n * the source Observable since the duration Observable was spawned. If a new\n * notification appears before the duration Observable emits, the previous notification will\n * not be emitted and a new duration is scheduled from `durationSelector` is scheduled.\n * If the completing event happens during the scheduled duration the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during the scheduled duration or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * Like {@link debounceTime}, this is a rate-limiting operator, and also a\n * delay-like operator since output emissions do not necessarily occur at the\n * same time as they did on the source Observable.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, scan, debounce, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(\n *   scan(i => ++i, 1),\n *   debounce(i => interval(200 * i))\n * );\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the timeout\n * duration for each source value, returned as an Observable or a Promise.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified duration Observable returned by\n * `durationSelector`, and may drop some values if they occur too frequently.\n */\nexport function debounce<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    // The subscriber/subscription for the current debounce, if there is one.\n    let durationSubscriber: Subscriber<any> | null = null;\n\n    const emit = () => {\n      // Unsubscribe any current debounce subscription we have,\n      // we only cared about the first notification from it, and we\n      // want to clean that subscription up as soon as possible.\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        // We have a value! Free up memory first, then emit the value.\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          // Cancel any pending debounce duration. We don't\n          // need to null it out here yet tho, because we're just going\n          // to create another one in a few lines.\n          durationSubscriber?.unsubscribe();\n          hasValue = true;\n          lastValue = value;\n          // Capture our duration subscriber, so we can unsubscribe it when we're notified\n          // and we're going to emit the value.\n          durationSubscriber = createOperatorSubscriber(subscriber, emit, noop);\n          // Subscribe to the duration.\n          innerFrom(durationSelector(value)).subscribe(durationSubscriber);\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = durationSubscriber = null;\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounce,\n  defer,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith,\n  timer\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * The second parameter allows to specify a timeout in milliseconds after which\n * the hover state will be reset to `false`. This is useful for tooltips which\n * should disappear after a certain amount of time, in order to allow the user\n * to move the cursor from the host to the tooltip.\n *\n * @param el - Element\n * @param timeout - Timeout\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, timeout?: number\n): Observable<boolean> {\n  return defer(() => merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      timeout ? debounce(active => timer(+!active * timeout)) : identity,\n      startWith(el.matches(\":hover\"))\n    )\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => (\n      entries.forEach(entry => entry$.next(entry))\n    ))),\n    switchMap(observer => merge(NEVER, of(observer)).pipe(\n      finalize(() => observer.disconnect())\n    )),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n\n  // Compute target element - since inline elements cannot be observed by the\n  // current `ResizeObserver` implementation as provided by browsers, we need\n  // to determine the first containing parent element and use that one as a\n  // target, while we always compute the actual size from the element.\n  let target = el\n  while (target.clientWidth === 0)\n    if (target.parentElement)\n      target = target.parentElement\n    else\n      break\n\n  // Observe target element and recompute element size on resize - as described\n  // above, the target element is not necessarily the element of interest\n  return observer$.pipe(\n    tap(observer => observer.observe(target)),\n    switchMap(observer => entry$.pipe(\n      filter(entry => entry.target === target),\n      finalize(() => observer.unobserve(target))\n    )),\n    map(() => getElementSize(el)),\n    startWith(getElementSize(el))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n\n/**\n * Retrieve all overflowing containers of an element, if any\n *\n * Note that this function has a slightly different behavior, so we should at\n * some point consider refactoring how overflowing containers are handled.\n *\n * @param el - Element\n *\n * @returns Overflowing containers\n */\nexport function getElementContainers(\n  el: HTMLElement\n): HTMLElement[] {\n  const containers: HTMLElement[] = []\n\n  // Walk up the DOM tree until we find an overflowing container\n  let parent = el.parentElement\n  while (parent) {\n    if (\n      el.clientWidth  > parent.clientWidth ||\n      el.clientHeight > parent.clientHeight\n    )\n      containers.push(parent)\n\n    // Continue with parent element\n    parent = (el = parent).parentElement\n  }\n\n  // If the page is short, the body might not be overflowing and there might be\n  // no other containers, which is why we need to make sure the body is present\n  if (containers.length === 0)\n    containers.push(document.documentElement)\n\n  // Return overflowing containers\n  return containers\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { watchElementSize } from \"../../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/**\n * Retrieve absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffsetAbsolute(\n  el: HTMLElement\n): ElementOffset {\n  const rect = el.getBoundingClientRect()\n  return {\n    x: rect.x + window.scrollX,\n    y: rect.y + window.scrollY\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n\n/**\n * Watch absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffsetAbsolute(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    watchElementOffset(el),\n    watchElementSize(document.body) // @todo find a better way for this\n  )\n    .pipe(\n      map(() => getElementOffsetAbsolute(el)),\n      startWith(getElementOffsetAbsolute(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n  alias?: boolean                      /* Show alias */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n\n// @todo: rename\nexport function renderInlineTooltip2(\n  ...children: ComponentChild[]\n): HTMLElement {\n  return (\n    <div class=\"md-tooltip2\" role=\"tooltip\">\n      <div class=\"md-tooltip2__inner md-typeset\">\n        {children}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{escapeHTML(key)}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && (\n          <nav class=\"md-tags\">\n            {document.tags.map(tag => {\n              const type = tags\n                ? tag in tags\n                  ? `md-tag-icon md-tag--${tags[tag]}`\n                  : \"md-tag-icon\"\n                : \"\"\n              return (\n                <span class={`md-tag ${type}`}>{tag}</span>\n              )\n            })}\n          </nav>\n        )}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n        {config.version?.alias && version.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {version.aliases[0]}\n          </span>\n        )}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  const config = configuration()\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n        {config.version?.alias && active.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {active.aliases[0]}\n          </span>\n        )}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  BehaviorSubject,\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  combineLatest,\n  combineLatestWith,\n  debounce,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  filter,\n  finalize,\n  first,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  queueScheduler,\n  share,\n  startWith,\n  switchMap,\n  tap,\n  throttleTime,\n  timer,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  Viewport,\n  getElement,\n  getElementContainers,\n  getElementOffsetAbsolute,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderInlineTooltip2 } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      // Tooltip is active\n  offset: ElementOffset                // Tooltip offset\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dependencies\n */\ninterface Dependencies {\n  content$: Observable<HTMLElement>    // Tooltip content observable\n  viewport$: Observable<Viewport>      // Viewport observable\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function tracks the tooltip host element, and deduces the active state\n * and offset of the tooltip from it. The active state is determined by whether\n * the host element is focused or hovered, and the offset is determined by the\n * host element's absolute position in the document.\n *\n * @param el - Tooltip host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip2(\n  el: HTMLElement\n): Observable<Tooltip> {\n\n  // Compute whether tooltip should be shown - we need to watch both focus and\n  // hover events on the host element and emit if one of them is active. In case\n  // of a hover event, we keep the element visible for a short amount of time\n  // after the pointer left the host element for a better user experience.\n  const active$ =\n    combineLatest([\n      watchElementFocus(el),\n      watchElementHover(el)\n    ])\n      .pipe(\n        map(([focus, hover]) => focus || hover),\n        distinctUntilChanged()\n      )\n\n  // We need to determine all parent elements of the host element that are\n  // currently scrollable, as they might affect the position of the tooltip\n  // depending on their horizontal of vertical offset. We must track all of\n  // them and recompute the position of the tooltip if they change.\n  const offset$ =\n    defer(() => getElementContainers(el)).pipe(\n      mergeMap(watchElementContentOffset),\n      throttleTime(1),\n      // Note that we need to poll the value again if the active state changes,\n      // as otherwise the tooltip might be misplaced. This particularly happens\n      // when using third-party integrations like tablesort that change the\n      // position of elements \u2013 see https://t.ly/Y-V7X\n      combineLatestWith(active$),\n      map(() => getElementOffsetAbsolute(el)),\n    )\n\n  // Only track parent elements and compute offset of the tooltip host if the\n  // tooltip should be shown - we defer the computation of the offset until the\n  // tooltip becomes active for the first time. This is necessary, because we\n  // must also keep the tooltip active as long as it is focused or hovered.\n  return active$.pipe(\n    first(active => active),\n    switchMap(() => combineLatest([active$, offset$])),\n    map(([active, offset]) => ({ active, offset })),\n    share()\n  )\n}\n\n/**\n * Mount tooltip\n *\n * This function renders a tooltip with the content from the provided `content$`\n * observable as passed via the dependencies. If the returned element has a role\n * of type `dialog`, the tooltip is considered to be interactive, and rendered\n * either above or below the host element, depending on the available space.\n *\n * If the returned element has a role of type `tooltip`, the tooltip is always\n * rendered below the host element and considered to be non-interactive. This\n * allows us to reuse the same positioning logic for both interactive and\n * non-interactive tooltips, as it is largely the same.\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip2(\n  el: HTMLElement, dependencies: Dependencies\n): Observable<Component<Tooltip>> {\n  const { content$, viewport$ } = dependencies\n\n  // Compute unique tooltip id - this is necessary to associate the tooltip host\n  // element with the tooltip element for ARIA purposes\n  const id = `__tooltip2_${sequence++}`\n\n  // Create component on subscription\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n\n    // Create subject to track tooltip presence and visibility - we use another\n    // purely internal subject to track the tooltip's presence and visibility,\n    // as the tooltip should be visible if the host element or tooltip itself\n    // is focused or hovered to allow for smooth pointer migration\n    const show$ = new BehaviorSubject(false)\n    push$.pipe(ignoreElements(), endWith(false))\n      .subscribe(show$)\n\n    // Create observable controlling tooltip element - we create and attach the\n    // tooltip only if it is actually present, in order to keep the number of\n    // elements low. We need to keep the tooltip visible for a short time after\n    // the pointer left the host element or tooltip itself. For this, we use an\n    // inner subscription to the tooltip observable, which we terminate when the\n    // tooltip should not be shown, automatically removing the element. Moreover\n    // we use the queue scheduler, which will schedule synchronously in case the\n    // tooltip should be shown, and asynchronously if it should be hidden.\n    const node$ = show$.pipe(\n      debounce(active => timer(+!active * 250, queueScheduler)),\n      distinctUntilChanged(),\n      switchMap(active => active ? content$ : EMPTY),\n      tap(node => node.id = id),\n      share()\n    )\n\n    // Compute tooltip presence and visibility - the tooltip should be shown if\n    // the host element or the tooltip itself is focused or hovered\n    combineLatest([\n      push$.pipe(map(({ active }) => active)),\n      node$.pipe(\n        switchMap(node => watchElementHover(node, 250)),\n        startWith(false)\n      )\n    ])\n      .pipe(map(states => states.some(active => active)))\n      .subscribe(show$)\n\n    // Compute tooltip origin - we need to compute the tooltip origin depending\n    // on the position of the host element, the viewport size, as well as the\n    // actual size of the tooltip, if positioned above. The tooltip must about\n    // to be rendered for this to be correct, which is why we do it here.\n    const origin$ = show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, viewport$),\n      map(([_, node, { size }]) => {\n        const host = el.getBoundingClientRect()\n        const x = host.width / 2\n\n        // If the tooltip is non-interactive, we always render it below the\n        // actual element because all operating systems do it that way\n        if (node.role === \"tooltip\") {\n          return { x, y: 8 + host.height }\n\n        // Otherwise, we determine where there is more space, and render the\n        // tooltip either above or below the host element\n        } else if (host.y >= size.height / 2) {\n          const { height } = getElementSize(node)\n          return { x, y: -16 - height }\n        } else {\n          return { x, y: +16 + host.height }\n        }\n      })\n    )\n\n    // Update tooltip position - we always need to update the position of the\n    // tooltip, as it might change depending on the viewport offset of the host\n    combineLatest([node$, push$, origin$])\n      .subscribe(([node, { offset }, origin]) => {\n        node.style.setProperty(\"--md-tooltip-host-x\", `${offset.x}px`)\n        node.style.setProperty(\"--md-tooltip-host-y\", `${offset.y}px`)\n\n        // Update tooltip origin - this is mainly set to determine the position\n        // of the tooltip tail, to show the direction it is originating from\n        node.style.setProperty(\"--md-tooltip-x\", `${origin.x}px`)\n        node.style.setProperty(\"--md-tooltip-y\", `${origin.y}px`)\n\n        // Update tooltip render location, i.e., whether the tooltip is shown\n        // above or below the host element, depending on the available space\n        node.classList.toggle(\"md-tooltip2--top\",    origin.y <  0)\n        node.classList.toggle(\"md-tooltip2--bottom\", origin.y >= 0)\n      })\n\n    // Update tooltip width - we only explicitly set the width of the tooltip\n    // if it is non-interactive, in case it should always be rendered centered\n    show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, (_, node) => node),\n      filter(node => node.role === \"tooltip\")\n    )\n      .subscribe(node => {\n        const size = getElementSize(getElement(\":scope > *\", node))\n\n        // Set tooltip width and remove tail by setting it to a width of zero -\n        // if authors want to keep the tail, we can move this to CSS later\n        node.style.setProperty(\"--md-tooltip-width\", `${size.width}px`)\n        node.style.setProperty(\"--md-tooltip-tail\",  `${0}px`)\n      })\n\n    // Update tooltip visibility - we defer to the next animation frame, because\n    // the tooltip must first be added to the document before we make it appear,\n    // or it will appear instantly without delay. Additionally, we need to keep\n    // the tooltip visible for a short time after the pointer left the host.\n    show$.pipe(\n      distinctUntilChanged(),\n      observeOn(animationFrameScheduler),\n      withLatestFrom(node$)\n    )\n      .subscribe(([active, node]) => {\n        node.classList.toggle(\"md-tooltip2--active\", active)\n      })\n\n    // Set up ARIA attributes when tooltip is visible\n    combineLatest([\n      show$.pipe(filter(active => active)),\n      node$\n    ])\n      .subscribe(([_, node]) => {\n        if (node.role === \"dialog\") {\n          el.setAttribute(\"aria-controls\", id)\n          el.setAttribute(\"aria-haspopup\", \"dialog\")\n        } else {\n          el.setAttribute(\"aria-describedby\", id)\n        }\n      })\n\n    // Remove ARIA attributes when tooltip is hidden\n    show$.pipe(filter(active => !active))\n      .subscribe(() => {\n        el.removeAttribute(\"aria-controls\")\n        el.removeAttribute(\"aria-describedby\")\n        el.removeAttribute(\"aria-haspopup\")\n      })\n\n    // Create and return component\n    return watchTooltip2(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n\n// ----------------------------------------------------------------------------\n\n/**\n * Mount inline tooltip\n *\n * @todo refactor this function\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n * @param container - Container\n *\n * @returns Tooltip component observable\n */\nexport function mountInlineTooltip2(\n  el: HTMLElement, { viewport$ }: { viewport$: Observable<Viewport> },\n  container = document.body\n): Observable<Component<Tooltip>> {\n  return mountTooltip2(el, {\n    content$: new Observable<HTMLElement>(observer => {\n      const title = el.title\n      const node = renderInlineTooltip2(title)\n      observer.next(node)\n      el.removeAttribute(\"title\")\n      // Append tooltip and remove on unsubscription\n      container.append(node)\n      return () => {\n        node.remove()\n        el.setAttribute(\"title\", title)\n      }\n    }),\n    viewport$\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  getElements,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"~/components/tooltip2\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountInlineTooltip2(button, { viewport$ }))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    // If the code block has line spans, we can add this additional class to\n    // the code block element, which fixes the problem for highlighted code\n    // lines not stretching to the entirety of the screen when the code block\n    // overflows, e.g., on mobile - see\n    const spans = getElements(\":scope > span[id]\", el)\n    if (spans.length)\n      el.classList.add(\"md-code__content\")\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel p,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel p{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@11/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el), watchElementVisibility(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchContentTabs(inputs)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"../../tooltip2\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountInlineTooltip2(child, { viewport$ }))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    // Handle color switch on Enter or Space - see https://t.ly/YIhVj\n    fromEvent<KeyboardEvent>(el, \"keydown\").pipe(\n      filter(ev => ev.key === \"Enter\"),\n      withLatestFrom(push$, (_, palette) => palette)\n    )\n      .subscribe(({ index }) => {\n        index = (index + 1) % inputs.length\n        inputs[index].click()\n        inputs[index].focus()\n      })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    document$.pipe(\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\")\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. It is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "import { Sitemap } from \"../../sitemap\"\n\n/** See docstring for `selectedVersionCorrespondingURL` for the meaning of these fields. */\ntype CorrespondingURLParams = {\n  selectedVersionSitemap: Sitemap\n  selectedVersionBaseURL: URL\n  currentLocation: URL\n  currentBaseURL: string\n}\n\n/**\n * Choose a URL to navigate to when the user chooses a version in the version\n * selector.\n *\n * The parameters in `params` are named as follows, in order to make it clearer\n * which parameter means what when invoking the function:\n *\n *  - selectedVersionSitemap: Sitemap - as obtained by fetchSitemap from `${selectedVersionBaseURL}/sitemap.xml`\n *\n *  - selectedVersionBaseURL: URL - usually `${currentBaseURL}/../selectedVersion`\n *\n *  - currentLocation: URL - current web browser location\n *\n *  - currentBaseURL: string - as obtained from `config.base`\n *\n * @param params - arguments with the meanings explained above.\n * @returns the URL to navigate to or null if we can't be sure that the\n * corresponding page to the current page exists in the selected version\n */\nexport function selectedVersionCorrespondingURL(\n  params: CorrespondingURLParams\n): URL | undefined {\n  const {selectedVersionSitemap,\n    selectedVersionBaseURL,\n    currentLocation,\n    currentBaseURL} = params\n  const current_path = safeURLParse(currentBaseURL)?.pathname\n  if (current_path === undefined) {\n    return\n  }\n  const currentRelativePath = stripPrefix(currentLocation.pathname, current_path)\n  if (currentRelativePath === undefined) {\n    return\n  }\n  const sitemapCommonPrefix = shortestCommonPrefix(selectedVersionSitemap.keys())\n  if (!selectedVersionSitemap.has(sitemapCommonPrefix)) {\n    // We could also check that `commonSitemapPrefix` ends in the canonical version,\n    // similarly to /~https://github.com/squidfunk/mkdocs-material/pull/7227. However,\n    // I don't believe that Mike/MkDocs ever generate sitemaps where it would matter\n    return\n  }\n\n  const potentialSitemapURL = safeURLParse(currentRelativePath, sitemapCommonPrefix)\n  if (!potentialSitemapURL || !selectedVersionSitemap.has(potentialSitemapURL.href)) {\n    return\n  }\n\n  const result = safeURLParse(currentRelativePath, selectedVersionBaseURL)\n  if (!result) {\n    return\n  }\n  result.hash = currentLocation.hash\n  result.search = currentLocation.search\n  return result\n}\n\n/**\n * A version of `new URL` that never throws. A polyfill for URL.parse() which is\n * not yet ubuquitous.\n *\n * @param url - passed to `new URL` constructor\n * @param base - passed to `new URL` constructor\n *\n * @returns `new URL(url, base)` or undefined if the URL is invalid.\n */\nfunction safeURLParse(url: string|URL, base?: string|URL): URL | undefined {\n  try {\n    return new URL(url, base)\n  } catch {\n    return\n  }\n}\n\n// Basic string manipulation\n\n/** Strip a given prefix from a function\n *\n * @param s - string\n * @param prefix - prefix to strip\n *\n * @returns either the string with the prefix stripped or undefined if the\n * string did not begin with the prefix.\n */\nexport function stripPrefix(s: string, prefix: string): string | undefined {\n  if (s.startsWith(prefix)) {\n    return s.slice(prefix.length)\n  }\n  return undefined\n}\n\n/** Find the length of the longest common prefix of two strings\n *\n * @param s1 - first string\n * @param s2 - second string\n *\n * @returns - the length of the longest common prefix of the two strings.\n */\nfunction commonPrefixLen(s1: string, s2: string): number {\n  const max = Math.min(s1.length, s2.length)\n  let result\n  for (result = 0; result < max; ++result) {\n    if (s1[result] !== s2[result]) {\n      break\n    }\n  }\n  return result\n}\n\n/** Find the longest common prefix of any number of strings\n *\n * @param strs - an iterable of strings\n *\n * @returns the longest common prefix of all the strings\n */\nexport function shortestCommonPrefix(strs: Iterable<string>): string {\n  let result  // Undefined if no iterations happened\n  for (const s of strs) {\n    if (result === undefined) {\n      result = s\n    } else {\n      result = result.slice(0, commonPrefixLen(result, s))\n    }\n  }\n  return result ?? \"\"\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\nimport { selectedVersionCorrespondingURL } from \"./findurl\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See /~https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(new URL(url))\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(selectedVersionBaseURL => {\n            return fetchSitemap(selectedVersionBaseURL).pipe(\n              map(\n                sitemap =>\n                  selectedVersionCorrespondingURL({\n                    selectedVersionSitemap: sitemap,\n                    selectedVersionBaseURL,\n                    currentLocation: getLocation(),\n                    currentBaseURL: config.base\n                  }) ?? selectedVersionBaseURL,\n              ),\n            )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitLab release (partial)\n */\ninterface Release { // @todo remove and use the ReleaseSchema type instead after switching from gitlab to @gitbeaker/rest\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return zip(\n\n    /* Fetch version */\n    requestJSON<Release>(`${url}/releases/permalink/latest`)\n      .pipe(\n        catchError(() => EMPTY), // @todo refactor instant loading\n        map(({ tag_name }) => ({\n          version: tag_name\n        })),\n        defaultIfEmpty({})\n      ),\n\n    /* Fetch stars and forks */\n    requestJSON<ProjectSchema>(url)\n      .pipe(\n        catchError(() => EMPTY), // @todo refactor instant loading\n        map(({ star_count, forks_count }) => ({\n          stars: star_count,\n          forks: forks_count\n        })),\n        defaultIfEmpty({})\n      )\n  )\n    .pipe(\n      map(([release, info]) => ({ ...release, ...info }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountInlineTooltip2 } from \"~/components/tooltip2\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$, viewport$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        // Do not mount improved tooltip if feature is disabled\n        if (!feature(\"content.tooltips\"))\n          return EMPTY\n\n        /* Mount tooltip */\n        return mountInlineTooltip2(host, { viewport$ })\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  if (feature(\"content.tooltips\"))\n    document$\n      .pipe(\n        switchMap(() => getElements(\".md-status\")),\n        mergeMap(el => mountInlineTooltip2(el, { viewport$ }))\n      )\n        .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see /~https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see /~https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via /~https://github.com/lipsmack from /~https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by /~https://github.com/lazd\n    // Ref: /~https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ viewport$, document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/******************************************************************************\nCopyright (c) Microsoft Corporation.\n\nPermission to use, copy, modify, and/or distribute this software for any\npurpose with or without fee is hereby granted.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\nPERFORMANCE OF THIS SOFTWARE.\n***************************************************************************** */\n/* global Reflect, Promise, SuppressedError, Symbol, Iterator */\n\nvar extendStatics = function(d, b) {\n  extendStatics = Object.setPrototypeOf ||\n      ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\n      function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\n  return extendStatics(d, b);\n};\n\nexport function __extends(d, b) {\n  if (typeof b !== \"function\" && b !== null)\n      throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\n  extendStatics(d, b);\n  function __() { this.constructor = d; }\n  d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\n}\n\nexport var __assign = function() {\n  __assign = Object.assign || function __assign(t) {\n      for (var s, i = 1, n = arguments.length; i < n; i++) {\n          s = arguments[i];\n          for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\n      }\n      return t;\n  }\n  return __assign.apply(this, arguments);\n}\n\nexport function __rest(s, e) {\n  var t = {};\n  for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\n      t[p] = s[p];\n  if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\n      for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\n          if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\n              t[p[i]] = s[p[i]];\n      }\n  return t;\n}\n\nexport function __decorate(decorators, target, key, desc) {\n  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\n  if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\n  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\n  return c > 3 && r && Object.defineProperty(target, key, r), r;\n}\n\nexport function __param(paramIndex, decorator) {\n  return function (target, key) { decorator(target, key, paramIndex); }\n}\n\nexport function __esDecorate(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {\n  function accept(f) { if (f !== void 0 && typeof f !== \"function\") throw new TypeError(\"Function expected\"); return f; }\n  var kind = contextIn.kind, key = kind === \"getter\" ? \"get\" : kind === \"setter\" ? \"set\" : \"value\";\n  var target = !descriptorIn && ctor ? contextIn[\"static\"] ? ctor : ctor.prototype : null;\n  var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});\n  var _, done = false;\n  for (var i = decorators.length - 1; i >= 0; i--) {\n      var context = {};\n      for (var p in contextIn) context[p] = p === \"access\" ? {} : contextIn[p];\n      for (var p in contextIn.access) context.access[p] = contextIn.access[p];\n      context.addInitializer = function (f) { if (done) throw new TypeError(\"Cannot add initializers after decoration has completed\"); extraInitializers.push(accept(f || null)); };\n      var result = (0, decorators[i])(kind === \"accessor\" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);\n      if (kind === \"accessor\") {\n          if (result === void 0) continue;\n          if (result === null || typeof result !== \"object\") throw new TypeError(\"Object expected\");\n          if (_ = accept(result.get)) descriptor.get = _;\n          if (_ = accept(result.set)) descriptor.set = _;\n          if (_ = accept(result.init)) initializers.unshift(_);\n      }\n      else if (_ = accept(result)) {\n          if (kind === \"field\") initializers.unshift(_);\n          else descriptor[key] = _;\n      }\n  }\n  if (target) Object.defineProperty(target, contextIn.name, descriptor);\n  done = true;\n};\n\nexport function __runInitializers(thisArg, initializers, value) {\n  var useValue = arguments.length > 2;\n  for (var i = 0; i < initializers.length; i++) {\n      value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);\n  }\n  return useValue ? value : void 0;\n};\n\nexport function __propKey(x) {\n  return typeof x === \"symbol\" ? x : \"\".concat(x);\n};\n\nexport function __setFunctionName(f, name, prefix) {\n  if (typeof name === \"symbol\") name = name.description ? \"[\".concat(name.description, \"]\") : \"\";\n  return Object.defineProperty(f, \"name\", { configurable: true, value: prefix ? \"\".concat(prefix, \" \", name) : name });\n};\n\nexport function __metadata(metadataKey, metadataValue) {\n  if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\n}\n\nexport function __awaiter(thisArg, _arguments, P, generator) {\n  function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n  return new (P || (P = Promise))(function (resolve, reject) {\n      function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n      function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n      function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n      step((generator = generator.apply(thisArg, _arguments || [])).next());\n  });\n}\n\nexport function __generator(thisArg, body) {\n  var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === \"function\" ? Iterator : Object).prototype);\n  return g.next = verb(0), g[\"throw\"] = verb(1), g[\"return\"] = verb(2), typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\n  function verb(n) { return function (v) { return step([n, v]); }; }\n  function step(op) {\n      if (f) throw new TypeError(\"Generator is already executing.\");\n      while (g && (g = 0, op[0] && (_ = 0)), _) try {\n          if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\n          if (y = 0, t) op = [op[0] & 2, t.value];\n          switch (op[0]) {\n              case 0: case 1: t = op; break;\n              case 4: _.label++; return { value: op[1], done: false };\n              case 5: _.label++; y = op[1]; op = [0]; continue;\n              case 7: op = _.ops.pop(); _.trys.pop(); continue;\n              default:\n                  if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\n                  if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\n                  if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\n                  if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\n                  if (t[2]) _.ops.pop();\n                  _.trys.pop(); continue;\n          }\n          op = body.call(thisArg, _);\n      } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\n      if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\n  }\n}\n\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\n  if (k2 === undefined) k2 = k;\n  var desc = Object.getOwnPropertyDescriptor(m, k);\n  if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n  }\n  Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n  if (k2 === undefined) k2 = k;\n  o[k2] = m[k];\n});\n\nexport function __exportStar(m, o) {\n  for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\n}\n\nexport function __values(o) {\n  var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\n  if (m) return m.call(o);\n  if (o && typeof o.length === \"number\") return {\n      next: function () {\n          if (o && i >= o.length) o = void 0;\n          return { value: o && o[i++], done: !o };\n      }\n  };\n  throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\n}\n\nexport function __read(o, n) {\n  var m = typeof Symbol === \"function\" && o[Symbol.iterator];\n  if (!m) return o;\n  var i = m.call(o), r, ar = [], e;\n  try {\n      while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\n  }\n  catch (error) { e = { error: error }; }\n  finally {\n      try {\n          if (r && !r.done && (m = i[\"return\"])) m.call(i);\n      }\n      finally { if (e) throw e.error; }\n  }\n  return ar;\n}\n\n/** @deprecated */\nexport function __spread() {\n  for (var ar = [], i = 0; i < arguments.length; i++)\n      ar = ar.concat(__read(arguments[i]));\n  return ar;\n}\n\n/** @deprecated */\nexport function __spreadArrays() {\n  for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\n  for (var r = Array(s), k = 0, i = 0; i < il; i++)\n      for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\n          r[k] = a[j];\n  return r;\n}\n\nexport function __spreadArray(to, from, pack) {\n  if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\n      if (ar || !(i in from)) {\n          if (!ar) ar = Array.prototype.slice.call(from, 0, i);\n          ar[i] = from[i];\n      }\n  }\n  return to.concat(ar || Array.prototype.slice.call(from));\n}\n\nexport function __await(v) {\n  return this instanceof __await ? (this.v = v, this) : new __await(v);\n}\n\nexport function __asyncGenerator(thisArg, _arguments, generator) {\n  if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\n  var g = generator.apply(thisArg, _arguments || []), i, q = [];\n  return i = Object.create((typeof AsyncIterator === \"function\" ? AsyncIterator : Object).prototype), verb(\"next\"), verb(\"throw\"), verb(\"return\", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;\n  function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }\n  function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }\n  function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\n  function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\n  function fulfill(value) { resume(\"next\", value); }\n  function reject(value) { resume(\"throw\", value); }\n  function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\n}\n\nexport function __asyncDelegator(o) {\n  var i, p;\n  return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\n  function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }\n}\n\nexport function __asyncValues(o) {\n  if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\n  var m = o[Symbol.asyncIterator], i;\n  return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\n  function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\n  function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\n}\n\nexport function __makeTemplateObject(cooked, raw) {\n  if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\n  return cooked;\n};\n\nvar __setModuleDefault = Object.create ? (function(o, v) {\n  Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n  o[\"default\"] = v;\n};\n\nexport function __importStar(mod) {\n  if (mod && mod.__esModule) return mod;\n  var result = {};\n  if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\n  __setModuleDefault(result, mod);\n  return result;\n}\n\nexport function __importDefault(mod) {\n  return (mod && mod.__esModule) ? mod : { default: mod };\n}\n\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\n  if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\n  if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\n  return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\n}\n\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\n  if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\n  if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\n  if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\n  return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\n}\n\nexport function __classPrivateFieldIn(state, receiver) {\n  if (receiver === null || (typeof receiver !== \"object\" && typeof receiver !== \"function\")) throw new TypeError(\"Cannot use 'in' operator on non-object\");\n  return typeof state === \"function\" ? receiver === state : state.has(receiver);\n}\n\nexport function __addDisposableResource(env, value, async) {\n  if (value !== null && value !== void 0) {\n    if (typeof value !== \"object\" && typeof value !== \"function\") throw new TypeError(\"Object expected.\");\n    var dispose, inner;\n    if (async) {\n      if (!Symbol.asyncDispose) throw new TypeError(\"Symbol.asyncDispose is not defined.\");\n      dispose = value[Symbol.asyncDispose];\n    }\n    if (dispose === void 0) {\n      if (!Symbol.dispose) throw new TypeError(\"Symbol.dispose is not defined.\");\n      dispose = value[Symbol.dispose];\n      if (async) inner = dispose;\n    }\n    if (typeof dispose !== \"function\") throw new TypeError(\"Object not disposable.\");\n    if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };\n    env.stack.push({ value: value, dispose: dispose, async: async });\n  }\n  else if (async) {\n    env.stack.push({ async: true });\n  }\n  return value;\n}\n\nvar _SuppressedError = typeof SuppressedError === \"function\" ? SuppressedError : function (error, suppressed, message) {\n  var e = new Error(message);\n  return e.name = \"SuppressedError\", e.error = error, e.suppressed = suppressed, e;\n};\n\nexport function __disposeResources(env) {\n  function fail(e) {\n    env.error = env.hasError ? new _SuppressedError(e, env.error, \"An error was suppressed during disposal.\") : e;\n    env.hasError = true;\n  }\n  var r, s = 0;\n  function next() {\n    while (r = env.stack.pop()) {\n      try {\n        if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);\n        if (r.dispose) {\n          var result = r.dispose.call(r.value);\n          if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });\n        }\n        else s |= 1;\n      }\n      catch (e) {\n        fail(e);\n      }\n    }\n    if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();\n    if (env.hasError) throw env.error;\n  }\n  return next();\n}\n\nexport default {\n  __extends,\n  __assign,\n  __rest,\n  __decorate,\n  __param,\n  __metadata,\n  __awaiter,\n  __generator,\n  __createBinding,\n  __exportStar,\n  __values,\n  __read,\n  __spread,\n  __spreadArrays,\n  __spreadArray,\n  __await,\n  __asyncGenerator,\n  __asyncDelegator,\n  __asyncValues,\n  __makeTemplateObject,\n  __importStar,\n  __importDefault,\n  __classPrivateFieldGet,\n  __classPrivateFieldSet,\n  __classPrivateFieldIn,\n  __addDisposableResource,\n  __disposeResources,\n};\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: /~https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: /~https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec /~https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: /~https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { Subject } from './Subject';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\n\n/**\n * A variant of Subject that requires an initial value and emits its current\n * value whenever it is subscribed to.\n *\n * @class BehaviorSubject<T>\n */\nexport class BehaviorSubject<T> extends Subject<T> {\n  constructor(private _value: T) {\n    super();\n  }\n\n  get value(): T {\n    return this.getValue();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    const subscription = super._subscribe(subscriber);\n    !subscription.closed && subscriber.next(this._value);\n    return subscription;\n  }\n\n  getValue(): T {\n    const { hasError, thrownError, _value } = this;\n    if (hasError) {\n      throw thrownError;\n    }\n    this._throwIfClosed();\n    return _value;\n  }\n\n  next(value: T): void {\n    super.next((this._value = value));\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { Subscription } from '../Subscription';\nimport { QueueScheduler } from './QueueScheduler';\nimport { SchedulerAction } from '../types';\nimport { TimerHandle } from './timerHandle';\n\nexport class QueueAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: QueueScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (delay > 0) {\n      return super.schedule(state, delay);\n    }\n    this.delay = delay;\n    this.state = state;\n    this.scheduler.flush(this);\n    return this;\n  }\n\n  public execute(state: T, delay: number): any {\n    return delay > 0 || this.closed ? super.execute(state, delay) : this._execute(state, delay);\n  }\n\n  protected requestAsyncId(scheduler: QueueScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n\n    if ((delay != null && delay > 0) || (delay == null && this.delay > 0)) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n\n    // Otherwise flush the scheduler starting with this action.\n    scheduler.flush(this);\n\n    // HACK: In the past, this was returning `void`. However, `void` isn't a valid\n    // `TimerHandle`, and generally the return value here isn't really used. So the\n    // compromise is to return `0` which is both \"falsy\" and a valid `TimerHandle`,\n    // as opposed to refactoring every other instanceo of `requestAsyncId`.\n    return 0;\n  }\n}\n", "import { AsyncScheduler } from './AsyncScheduler';\n\nexport class QueueScheduler extends AsyncScheduler {\n}\n", "import { QueueAction } from './QueueAction';\nimport { QueueScheduler } from './QueueScheduler';\n\n/**\n *\n * Queue Scheduler\n *\n * <span class=\"informal\">Put every next task on a queue, instead of executing it immediately</span>\n *\n * `queue` scheduler, when used with delay, behaves the same as {@link asyncScheduler} scheduler.\n *\n * When used without delay, it schedules given task synchronously - executes it right when\n * it is scheduled. However when called recursively, that is when inside the scheduled task,\n * another task is scheduled with queue scheduler, instead of executing immediately as well,\n * that task will be put on a queue and wait for current one to finish.\n *\n * This means that when you execute task with `queue` scheduler, you are sure it will end\n * before any other task scheduled with that scheduler will start.\n *\n * ## Examples\n * Schedule recursively first, then do something\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(() => {\n *   queueScheduler.schedule(() => console.log('second')); // will not happen now, but will be put on a queue\n *\n *   console.log('first');\n * });\n *\n * // Logs:\n * // \"first\"\n * // \"second\"\n * ```\n *\n * Reschedule itself recursively\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(function(state) {\n *   if (state !== 0) {\n *     console.log('before', state);\n *     this.schedule(state - 1); // `this` references currently executing Action,\n *                               // which we reschedule with new state\n *     console.log('after', state);\n *   }\n * }, 0, 3);\n *\n * // In scheduler that runs recursively, you would expect:\n * // \"before\", 3\n * // \"before\", 2\n * // \"before\", 1\n * // \"after\", 1\n * // \"after\", 2\n * // \"after\", 3\n *\n * // But with queue it logs:\n * // \"before\", 3\n * // \"after\", 3\n * // \"before\", 2\n * // \"after\", 2\n * // \"before\", 1\n * // \"after\", 1\n * ```\n */\n\nexport const queueScheduler = new QueueScheduler(QueueAction);\n\n/**\n * @deprecated Renamed to {@link queueScheduler}. Will be removed in v8.\n */\nexport const queue = queueScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: /~https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// /~https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { noop } from '../util/noop';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * determined by another Observable has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link debounceTime}, but the time span of\n * emission silence is determined by a second Observable.</span>\n *\n * ![](debounce.svg)\n *\n * `debounce` delays notifications emitted by the source Observable, but drops previous\n * pending delayed emissions if a new notification arrives on the source Observable.\n * This operator keeps track of the most recent notification from the source\n * Observable, and spawns a duration Observable by calling the\n * `durationSelector` function. The notification is emitted only when the duration\n * Observable emits a next notification, and if no other notification was emitted on\n * the source Observable since the duration Observable was spawned. If a new\n * notification appears before the duration Observable emits, the previous notification will\n * not be emitted and a new duration is scheduled from `durationSelector` is scheduled.\n * If the completing event happens during the scheduled duration the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during the scheduled duration or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * Like {@link debounceTime}, this is a rate-limiting operator, and also a\n * delay-like operator since output emissions do not necessarily occur at the\n * same time as they did on the source Observable.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, scan, debounce, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(\n *   scan(i => ++i, 1),\n *   debounce(i => interval(200 * i))\n * );\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the timeout\n * duration for each source value, returned as an Observable or a Promise.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified duration Observable returned by\n * `durationSelector`, and may drop some values if they occur too frequently.\n */\nexport function debounce<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    // The subscriber/subscription for the current debounce, if there is one.\n    let durationSubscriber: Subscriber<any> | null = null;\n\n    const emit = () => {\n      // Unsubscribe any current debounce subscription we have,\n      // we only cared about the first notification from it, and we\n      // want to clean that subscription up as soon as possible.\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        // We have a value! Free up memory first, then emit the value.\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          // Cancel any pending debounce duration. We don't\n          // need to null it out here yet tho, because we're just going\n          // to create another one in a few lines.\n          durationSubscriber?.unsubscribe();\n          hasValue = true;\n          lastValue = value;\n          // Capture our duration subscriber, so we can unsubscribe it when we're notified\n          // and we're going to emit the value.\n          durationSubscriber = createOperatorSubscriber(subscriber, emit, noop);\n          // Subscribe to the duration.\n          innerFrom(durationSelector(value)).subscribe(durationSubscriber);\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = durationSubscriber = null;\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounce,\n  defer,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith,\n  timer\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * The second parameter allows to specify a timeout in milliseconds after which\n * the hover state will be reset to `false`. This is useful for tooltips which\n * should disappear after a certain amount of time, in order to allow the user\n * to move the cursor from the host to the tooltip.\n *\n * @param el - Element\n * @param timeout - Timeout\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, timeout?: number\n): Observable<boolean> {\n  return defer(() => merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      timeout ? debounce(active => timer(+!active * timeout)) : identity,\n      startWith(el.matches(\":hover\"))\n    )\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => (\n      entries.forEach(entry => entry$.next(entry))\n    ))),\n    switchMap(observer => merge(NEVER, of(observer)).pipe(\n      finalize(() => observer.disconnect())\n    )),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n\n  // Compute target element - since inline elements cannot be observed by the\n  // current `ResizeObserver` implementation as provided by browsers, we need\n  // to determine the first containing parent element and use that one as a\n  // target, while we always compute the actual size from the element.\n  let target = el\n  while (target.clientWidth === 0)\n    if (target.parentElement)\n      target = target.parentElement\n    else\n      break\n\n  // Observe target element and recompute element size on resize - as described\n  // above, the target element is not necessarily the element of interest\n  return observer$.pipe(\n    tap(observer => observer.observe(target)),\n    switchMap(observer => entry$.pipe(\n      filter(entry => entry.target === target),\n      finalize(() => observer.unobserve(target))\n    )),\n    map(() => getElementSize(el)),\n    startWith(getElementSize(el))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n\n/**\n * Retrieve all overflowing containers of an element, if any\n *\n * Note that this function has a slightly different behavior, so we should at\n * some point consider refactoring how overflowing containers are handled.\n *\n * @param el - Element\n *\n * @returns Overflowing containers\n */\nexport function getElementContainers(\n  el: HTMLElement\n): HTMLElement[] {\n  const containers: HTMLElement[] = []\n\n  // Walk up the DOM tree until we find an overflowing container\n  let parent = el.parentElement\n  while (parent) {\n    if (\n      el.clientWidth  > parent.clientWidth ||\n      el.clientHeight > parent.clientHeight\n    )\n      containers.push(parent)\n\n    // Continue with parent element\n    parent = (el = parent).parentElement\n  }\n\n  // If the page is short, the body might not be overflowing and there might be\n  // no other containers, which is why we need to make sure the body is present\n  if (containers.length === 0)\n    containers.push(document.documentElement)\n\n  // Return overflowing containers\n  return containers\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { watchElementSize } from \"../../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/**\n * Retrieve absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffsetAbsolute(\n  el: HTMLElement\n): ElementOffset {\n  const rect = el.getBoundingClientRect()\n  return {\n    x: rect.x + window.scrollX,\n    y: rect.y + window.scrollY\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n\n/**\n * Watch absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffsetAbsolute(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    watchElementOffset(el),\n    watchElementSize(document.body) // @todo find a better way for this\n  )\n    .pipe(\n      map(() => getElementOffsetAbsolute(el)),\n      startWith(getElementOffsetAbsolute(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n  alias?: boolean                      /* Show alias */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n\n// @todo: rename\nexport function renderInlineTooltip2(\n  ...children: ComponentChild[]\n): HTMLElement {\n  return (\n    <div class=\"md-tooltip2\" role=\"tooltip\">\n      <div class=\"md-tooltip2__inner md-typeset\">\n        {children}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{escapeHTML(key)}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && (\n          <nav class=\"md-tags\">\n            {document.tags.map(tag => {\n              const type = tags\n                ? tag in tags\n                  ? `md-tag-icon md-tag--${tags[tag]}`\n                  : \"md-tag-icon\"\n                : \"\"\n              return (\n                <span class={`md-tag ${type}`}>{tag}</span>\n              )\n            })}\n          </nav>\n        )}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n        {config.version?.alias && version.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {version.aliases[0]}\n          </span>\n        )}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  const config = configuration()\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n        {config.version?.alias && active.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {active.aliases[0]}\n          </span>\n        )}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  BehaviorSubject,\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  combineLatest,\n  combineLatestWith,\n  debounce,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  filter,\n  finalize,\n  first,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  queueScheduler,\n  share,\n  startWith,\n  switchMap,\n  tap,\n  throttleTime,\n  timer,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  Viewport,\n  getElement,\n  getElementContainers,\n  getElementOffsetAbsolute,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderInlineTooltip2 } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      // Tooltip is active\n  offset: ElementOffset                // Tooltip offset\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dependencies\n */\ninterface Dependencies {\n  content$: Observable<HTMLElement>    // Tooltip content observable\n  viewport$: Observable<Viewport>      // Viewport observable\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function tracks the tooltip host element, and deduces the active state\n * and offset of the tooltip from it. The active state is determined by whether\n * the host element is focused or hovered, and the offset is determined by the\n * host element's absolute position in the document.\n *\n * @param el - Tooltip host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip2(\n  el: HTMLElement\n): Observable<Tooltip> {\n\n  // Compute whether tooltip should be shown - we need to watch both focus and\n  // hover events on the host element and emit if one of them is active. In case\n  // of a hover event, we keep the element visible for a short amount of time\n  // after the pointer left the host element for a better user experience.\n  const active$ =\n    combineLatest([\n      watchElementFocus(el),\n      watchElementHover(el)\n    ])\n      .pipe(\n        map(([focus, hover]) => focus || hover),\n        distinctUntilChanged()\n      )\n\n  // We need to determine all parent elements of the host element that are\n  // currently scrollable, as they might affect the position of the tooltip\n  // depending on their horizontal of vertical offset. We must track all of\n  // them and recompute the position of the tooltip if they change.\n  const offset$ =\n    defer(() => getElementContainers(el)).pipe(\n      mergeMap(watchElementContentOffset),\n      throttleTime(1),\n      // Note that we need to poll the value again if the active state changes,\n      // as otherwise the tooltip might be misplaced. This particularly happens\n      // when using third-party integrations like tablesort that change the\n      // position of elements \u2013 see https://t.ly/Y-V7X\n      combineLatestWith(active$),\n      map(() => getElementOffsetAbsolute(el)),\n    )\n\n  // Only track parent elements and compute offset of the tooltip host if the\n  // tooltip should be shown - we defer the computation of the offset until the\n  // tooltip becomes active for the first time. This is necessary, because we\n  // must also keep the tooltip active as long as it is focused or hovered.\n  return active$.pipe(\n    first(active => active),\n    switchMap(() => combineLatest([active$, offset$])),\n    map(([active, offset]) => ({ active, offset })),\n    share()\n  )\n}\n\n/**\n * Mount tooltip\n *\n * This function renders a tooltip with the content from the provided `content$`\n * observable as passed via the dependencies. If the returned element has a role\n * of type `dialog`, the tooltip is considered to be interactive, and rendered\n * either above or below the host element, depending on the available space.\n *\n * If the returned element has a role of type `tooltip`, the tooltip is always\n * rendered below the host element and considered to be non-interactive. This\n * allows us to reuse the same positioning logic for both interactive and\n * non-interactive tooltips, as it is largely the same.\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip2(\n  el: HTMLElement, dependencies: Dependencies\n): Observable<Component<Tooltip>> {\n  const { content$, viewport$ } = dependencies\n\n  // Compute unique tooltip id - this is necessary to associate the tooltip host\n  // element with the tooltip element for ARIA purposes\n  const id = `__tooltip2_${sequence++}`\n\n  // Create component on subscription\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n\n    // Create subject to track tooltip presence and visibility - we use another\n    // purely internal subject to track the tooltip's presence and visibility,\n    // as the tooltip should be visible if the host element or tooltip itself\n    // is focused or hovered to allow for smooth pointer migration\n    const show$ = new BehaviorSubject(false)\n    push$.pipe(ignoreElements(), endWith(false))\n      .subscribe(show$)\n\n    // Create observable controlling tooltip element - we create and attach the\n    // tooltip only if it is actually present, in order to keep the number of\n    // elements low. We need to keep the tooltip visible for a short time after\n    // the pointer left the host element or tooltip itself. For this, we use an\n    // inner subscription to the tooltip observable, which we terminate when the\n    // tooltip should not be shown, automatically removing the element. Moreover\n    // we use the queue scheduler, which will schedule synchronously in case the\n    // tooltip should be shown, and asynchronously if it should be hidden.\n    const node$ = show$.pipe(\n      debounce(active => timer(+!active * 250, queueScheduler)),\n      distinctUntilChanged(),\n      switchMap(active => active ? content$ : EMPTY),\n      tap(node => node.id = id),\n      share()\n    )\n\n    // Compute tooltip presence and visibility - the tooltip should be shown if\n    // the host element or the tooltip itself is focused or hovered\n    combineLatest([\n      push$.pipe(map(({ active }) => active)),\n      node$.pipe(\n        switchMap(node => watchElementHover(node, 250)),\n        startWith(false)\n      )\n    ])\n      .pipe(map(states => states.some(active => active)))\n      .subscribe(show$)\n\n    // Compute tooltip origin - we need to compute the tooltip origin depending\n    // on the position of the host element, the viewport size, as well as the\n    // actual size of the tooltip, if positioned above. The tooltip must about\n    // to be rendered for this to be correct, which is why we do it here.\n    const origin$ = show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, viewport$),\n      map(([_, node, { size }]) => {\n        const host = el.getBoundingClientRect()\n        const x = host.width / 2\n\n        // If the tooltip is non-interactive, we always render it below the\n        // actual element because all operating systems do it that way\n        if (node.role === \"tooltip\") {\n          return { x, y: 8 + host.height }\n\n        // Otherwise, we determine where there is more space, and render the\n        // tooltip either above or below the host element\n        } else if (host.y >= size.height / 2) {\n          const { height } = getElementSize(node)\n          return { x, y: -16 - height }\n        } else {\n          return { x, y: +16 + host.height }\n        }\n      })\n    )\n\n    // Update tooltip position - we always need to update the position of the\n    // tooltip, as it might change depending on the viewport offset of the host\n    combineLatest([node$, push$, origin$])\n      .subscribe(([node, { offset }, origin]) => {\n        node.style.setProperty(\"--md-tooltip-host-x\", `${offset.x}px`)\n        node.style.setProperty(\"--md-tooltip-host-y\", `${offset.y}px`)\n\n        // Update tooltip origin - this is mainly set to determine the position\n        // of the tooltip tail, to show the direction it is originating from\n        node.style.setProperty(\"--md-tooltip-x\", `${origin.x}px`)\n        node.style.setProperty(\"--md-tooltip-y\", `${origin.y}px`)\n\n        // Update tooltip render location, i.e., whether the tooltip is shown\n        // above or below the host element, depending on the available space\n        node.classList.toggle(\"md-tooltip2--top\",    origin.y <  0)\n        node.classList.toggle(\"md-tooltip2--bottom\", origin.y >= 0)\n      })\n\n    // Update tooltip width - we only explicitly set the width of the tooltip\n    // if it is non-interactive, in case it should always be rendered centered\n    show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, (_, node) => node),\n      filter(node => node.role === \"tooltip\")\n    )\n      .subscribe(node => {\n        const size = getElementSize(getElement(\":scope > *\", node))\n\n        // Set tooltip width and remove tail by setting it to a width of zero -\n        // if authors want to keep the tail, we can move this to CSS later\n        node.style.setProperty(\"--md-tooltip-width\", `${size.width}px`)\n        node.style.setProperty(\"--md-tooltip-tail\",  `${0}px`)\n      })\n\n    // Update tooltip visibility - we defer to the next animation frame, because\n    // the tooltip must first be added to the document before we make it appear,\n    // or it will appear instantly without delay. Additionally, we need to keep\n    // the tooltip visible for a short time after the pointer left the host.\n    show$.pipe(\n      distinctUntilChanged(),\n      observeOn(animationFrameScheduler),\n      withLatestFrom(node$)\n    )\n      .subscribe(([active, node]) => {\n        node.classList.toggle(\"md-tooltip2--active\", active)\n      })\n\n    // Set up ARIA attributes when tooltip is visible\n    combineLatest([\n      show$.pipe(filter(active => active)),\n      node$\n    ])\n      .subscribe(([_, node]) => {\n        if (node.role === \"dialog\") {\n          el.setAttribute(\"aria-controls\", id)\n          el.setAttribute(\"aria-haspopup\", \"dialog\")\n        } else {\n          el.setAttribute(\"aria-describedby\", id)\n        }\n      })\n\n    // Remove ARIA attributes when tooltip is hidden\n    show$.pipe(filter(active => !active))\n      .subscribe(() => {\n        el.removeAttribute(\"aria-controls\")\n        el.removeAttribute(\"aria-describedby\")\n        el.removeAttribute(\"aria-haspopup\")\n      })\n\n    // Create and return component\n    return watchTooltip2(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n\n// ----------------------------------------------------------------------------\n\n/**\n * Mount inline tooltip\n *\n * @todo refactor this function\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n * @param container - Container\n *\n * @returns Tooltip component observable\n */\nexport function mountInlineTooltip2(\n  el: HTMLElement, { viewport$ }: { viewport$: Observable<Viewport> },\n  container = document.body\n): Observable<Component<Tooltip>> {\n  return mountTooltip2(el, {\n    content$: new Observable<HTMLElement>(observer => {\n      const title = el.title\n      const node = renderInlineTooltip2(title)\n      observer.next(node)\n      el.removeAttribute(\"title\")\n      // Append tooltip and remove on unsubscription\n      container.append(node)\n      return () => {\n        node.remove()\n        el.setAttribute(\"title\", title)\n      }\n    }),\n    viewport$\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  getElements,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"~/components/tooltip2\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountInlineTooltip2(button, { viewport$ }))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    // If the code block has line spans, we can add this additional class to\n    // the code block element, which fixes the problem for highlighted code\n    // lines not stretching to the entirety of the screen when the code block\n    // overflows, e.g., on mobile - see\n    const spans = getElements(\":scope > span[id]\", el)\n    if (spans.length)\n      el.classList.add(\"md-code__content\")\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.flowchartTitleText{fill:var(--md-mermaid-label-fg-color)}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel p,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel p{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}.classDiagramTitleText{fill:var(--md-mermaid-label-fg-color)}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}.statediagramTitleText{fill:var(--md-mermaid-label-fg-color)}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.entityTitleText{fill:var(--md-mermaid-label-fg-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}text:not([class]):last-child{fill:var(--md-mermaid-label-fg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@11/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el), watchElementVisibility(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchContentTabs(inputs)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"../../tooltip2\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountInlineTooltip2(child, { viewport$ }))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    // Handle color switch on Enter or Space - see https://t.ly/YIhVj\n    fromEvent<KeyboardEvent>(el, \"keydown\").pipe(\n      filter(ev => ev.key === \"Enter\"),\n      withLatestFrom(push$, (_, palette) => palette)\n    )\n      .subscribe(({ index }) => {\n        index = (index + 1) % inputs.length\n        inputs[index].click()\n        inputs[index].focus()\n      })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    document$.pipe(\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\")\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. It is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "import { Sitemap } from \"../../sitemap\"\n\n/** See docstring for `selectedVersionCorrespondingURL` for the meaning of these fields. */\ntype CorrespondingURLParams = {\n  selectedVersionSitemap: Sitemap\n  selectedVersionBaseURL: URL\n  currentLocation: URL\n  currentBaseURL: string\n}\n\n/**\n * Choose a URL to navigate to when the user chooses a version in the version\n * selector.\n *\n * The parameters in `params` are named as follows, in order to make it clearer\n * which parameter means what when invoking the function:\n *\n *  - selectedVersionSitemap: Sitemap - as obtained by fetchSitemap from `${selectedVersionBaseURL}/sitemap.xml`\n *\n *  - selectedVersionBaseURL: URL - usually `${currentBaseURL}/../selectedVersion`\n *\n *  - currentLocation: URL - current web browser location\n *\n *  - currentBaseURL: string - as obtained from `config.base`\n *\n * @param params - arguments with the meanings explained above.\n * @returns the URL to navigate to or null if we can't be sure that the\n * corresponding page to the current page exists in the selected version\n */\nexport function selectedVersionCorrespondingURL(\n  params: CorrespondingURLParams\n): URL | undefined {\n  const {selectedVersionSitemap,\n    selectedVersionBaseURL,\n    currentLocation,\n    currentBaseURL} = params\n  const current_path = safeURLParse(currentBaseURL)?.pathname\n  if (current_path === undefined) {\n    return\n  }\n  const currentRelativePath = stripPrefix(currentLocation.pathname, current_path)\n  if (currentRelativePath === undefined) {\n    return\n  }\n  const sitemapCommonPrefix = shortestCommonPrefix(selectedVersionSitemap.keys())\n  if (!selectedVersionSitemap.has(sitemapCommonPrefix)) {\n    // We could also check that `commonSitemapPrefix` ends in the canonical version,\n    // similarly to /~https://github.com/squidfunk/mkdocs-material/pull/7227. However,\n    // I don't believe that Mike/MkDocs ever generate sitemaps where it would matter\n    return\n  }\n\n  const potentialSitemapURL = safeURLParse(currentRelativePath, sitemapCommonPrefix)\n  if (!potentialSitemapURL || !selectedVersionSitemap.has(potentialSitemapURL.href)) {\n    return\n  }\n\n  const result = safeURLParse(currentRelativePath, selectedVersionBaseURL)\n  if (!result) {\n    return\n  }\n  result.hash = currentLocation.hash\n  result.search = currentLocation.search\n  return result\n}\n\n/**\n * A version of `new URL` that never throws. A polyfill for URL.parse() which is\n * not yet ubuquitous.\n *\n * @param url - passed to `new URL` constructor\n * @param base - passed to `new URL` constructor\n *\n * @returns `new URL(url, base)` or undefined if the URL is invalid.\n */\nfunction safeURLParse(url: string|URL, base?: string|URL): URL | undefined {\n  try {\n    return new URL(url, base)\n  } catch {\n    return\n  }\n}\n\n// Basic string manipulation\n\n/** Strip a given prefix from a function\n *\n * @param s - string\n * @param prefix - prefix to strip\n *\n * @returns either the string with the prefix stripped or undefined if the\n * string did not begin with the prefix.\n */\nexport function stripPrefix(s: string, prefix: string): string | undefined {\n  if (s.startsWith(prefix)) {\n    return s.slice(prefix.length)\n  }\n  return undefined\n}\n\n/** Find the length of the longest common prefix of two strings\n *\n * @param s1 - first string\n * @param s2 - second string\n *\n * @returns - the length of the longest common prefix of the two strings.\n */\nfunction commonPrefixLen(s1: string, s2: string): number {\n  const max = Math.min(s1.length, s2.length)\n  let result\n  for (result = 0; result < max; ++result) {\n    if (s1[result] !== s2[result]) {\n      break\n    }\n  }\n  return result\n}\n\n/** Find the longest common prefix of any number of strings\n *\n * @param strs - an iterable of strings\n *\n * @returns the longest common prefix of all the strings\n */\nexport function shortestCommonPrefix(strs: Iterable<string>): string {\n  let result  // Undefined if no iterations happened\n  for (const s of strs) {\n    if (result === undefined) {\n      result = s\n    } else {\n      result = result.slice(0, commonPrefixLen(result, s))\n    }\n  }\n  return result ?? \"\"\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\nimport { selectedVersionCorrespondingURL } from \"./findurl\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See /~https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(new URL(url))\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(selectedVersionBaseURL => {\n            return fetchSitemap(selectedVersionBaseURL).pipe(\n              map(\n                sitemap =>\n                  selectedVersionCorrespondingURL({\n                    selectedVersionSitemap: sitemap,\n                    selectedVersionBaseURL,\n                    currentLocation: getLocation(),\n                    currentBaseURL: config.base\n                  }) ?? selectedVersionBaseURL,\n              ),\n            )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitLab release (partial)\n */\ninterface Release { // @todo remove and use the ReleaseSchema type instead after switching from gitlab to @gitbeaker/rest\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return zip(\n\n    /* Fetch version */\n    requestJSON<Release>(`${url}/releases/permalink/latest`)\n      .pipe(\n        catchError(() => EMPTY), // @todo refactor instant loading\n        map(({ tag_name }) => ({\n          version: tag_name\n        })),\n        defaultIfEmpty({})\n      ),\n\n    /* Fetch stars and forks */\n    requestJSON<ProjectSchema>(url)\n      .pipe(\n        catchError(() => EMPTY), // @todo refactor instant loading\n        map(({ star_count, forks_count }) => ({\n          stars: star_count,\n          forks: forks_count\n        })),\n        defaultIfEmpty({})\n      )\n  )\n    .pipe(\n      map(([release, info]) => ({ ...release, ...info }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountInlineTooltip2 } from \"~/components/tooltip2\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$, viewport$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        // Do not mount improved tooltip if feature is disabled\n        if (!feature(\"content.tooltips\"))\n          return EMPTY\n\n        /* Mount tooltip */\n        return mountInlineTooltip2(host, { viewport$ })\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  if (feature(\"content.tooltips\"))\n    document$\n      .pipe(\n        switchMap(() => getElements(\".md-status\")),\n        mergeMap(el => mountInlineTooltip2(el, { viewport$ }))\n      )\n        .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
+  "mappings": "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",
   "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "import_focus_visible", "extendStatics", "d", "b", "p", "__extends", "__", "__awaiter", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "e", "rejected", "result", "__generator", "body", "_", "t", "f", "y", "g", "verb", "n", "v", "op", "__values", "o", "s", "m", "i", "__read", "n", "r", "ar", "e", "error", "__spreadArray", "to", "from", "pack", "i", "l", "ar", "__await", "v", "__asyncGenerator", "thisArg", "_arguments", "generator", "g", "q", "verb", "awaitReturn", "f", "reject", "n", "a", "b", "resume", "step", "e", "settle", "r", "fulfill", "value", "__asyncValues", "o", "m", "i", "__values", "verb", "n", "v", "resolve", "reject", "settle", "d", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "BehaviorSubject", "_super", "__extends", "_value", "_this", "subscriber", "subscription", "_a", "hasError", "thrownError", "value", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "QueueAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "AsyncAction", "QueueScheduler", "_super", "__extends", "AsyncScheduler", "queueScheduler", "QueueScheduler", "QueueAction", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "EmptyError", "createErrorClass", "_super", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "debounce", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "emit", "value", "createOperatorSubscriber", "noop", "innerFrom", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "innerFrom", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "throwIfEmpty", "errorFactory", "defaultErrorFactory", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "EmptyError", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "first", "predicate", "defaultValue", "hasDefaultValue", "source", "filter", "v", "identity", "take", "defaultIfEmpty", "throwIfEmpty", "EmptyError", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "_a", "_b", "leading", "_c", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "_a", "_b", "_c", "_d", "observer$", "merge", "fromEvent", "debounceTime", "startWith", "map", "getActiveElement", "shareReplay", "watchElementFocus", "el", "active", "distinctUntilChanged", "watchElementHover", "el", "timeout", "defer", "merge", "fromEvent", "map", "debounce", "active", "timer", "identity", "startWith", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "round", "value", "digits", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "entry$", "Subject", "observer$", "defer", "watchScript", "of", "map", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "target", "tap", "filter", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "getElementContainers", "containers", "getElementOffset", "el", "getElementOffsetAbsolute", "rect", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchComposition", "merge", "fromEvent", "map", "startWith", "watchKeyboard", "keyboard$", "filter", "ev", "getToggle", "mode", "active", "getActiveElement", "share", "switchMap", "EMPTY", "getLocation", "setLocation", "url", "navigate", "feature", "el", "h", "watchLocation", "Subject", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "location$", "merge", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "Observable", "observer", "req", "event", "_a", "length", "requestJSON", "switchMap", "res", "map", "body", "shareReplay", "requestHTML", "dom", "requestXML", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "recv", "worker", "fromEvent", "ev", "send", "send$", "Subject", "data", "watchWorker", "url", "recv$", "worker$", "done$", "ignoreElements", "endWith", "mergeWith", "takeUntil", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "hash", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "renderTooltip", "id", "style", "h", "renderInlineTooltip2", "children", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "import_escape_html", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "escapeHTML", "config", "configuration", "url", "feature", "match", "highlight", "value", "tags", "tag", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "_a", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "translation", "sequence", "watchTooltip2", "el", "active$", "combineLatest", "watchElementFocus", "watchElementHover", "map", "focus", "hover", "distinctUntilChanged", "offset$", "defer", "getElementContainers", "mergeMap", "watchElementContentOffset", "throttleTime", "combineLatestWith", "getElementOffsetAbsolute", "first", "active", "switchMap", "offset", "share", "mountTooltip2", "dependencies", "content$", "viewport$", "id", "push$", "Subject", "show$", "BehaviorSubject", "ignoreElements", "endWith", "node$", "debounce", "timer", "queueScheduler", "EMPTY", "tap", "node", "startWith", "states", "origin$", "filter", "withLatestFrom", "_", "size", "host", "x", "height", "getElementSize", "origin", "getElement", "observeOn", "animationFrameScheduler", "state", "finalize", "__spreadValues", "mountInlineTooltip2", "container", "Observable", "observer", "title", "renderInlineTooltip2", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "ignoreElements", "endWith", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findHosts", "container", "getElements", "findMarkers", "markers", "el", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "pairs", "annotation", "getElement", "takeUntil", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "findList", "el", "sibling", "mountAnnotationBlock", "options", "defer", "list", "mountAnnotationList", "EMPTY", "import_clipboard", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "done$", "takeLast", "scrollable", "content$", "ClipboardJS", "feature", "parent", "button", "renderClipboardButton", "mountInlineTooltip2", "container", "list", "annotations$", "mountAnnotationList", "takeUntil", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "getElements", "tap", "state", "finalize", "__spreadValues", "mergeWith", "watchElementVisibility", "filter", "visible", "take", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "mermaid_default", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "__async", "id", "host", "h", "text", "svg", "fn", "shadow", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "inputs", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "el", "viewport$", "target$", "container", "getElements", "prev", "renderTabbedControl", "next", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatest", "watchElementSize", "watchElementVisibility", "takeUntil", "auditTime", "animationFrameScheduler", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "filter", "label", "h", "ev", "tap", "feature", "skip", "withLatestFrom", "tab", "y", "set", "tabs", "media", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountAnnotationBlock", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "feature", "mountInlineTooltip2", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "sequence", "watchTooltip", "el", "host", "width", "getElementSize", "container", "getElementContainer", "scroll$", "watchElementContentOffset", "of", "active$", "merge", "watchElementFocus", "watchElementHover", "distinctUntilChanged", "combineLatest", "map", "active", "scroll", "x", "y", "getElementOffset", "size", "table", "mountTooltip", "title", "EMPTY", "id", "tooltip", "renderTooltip", "typeset", "getElement", "defer", "push$", "Subject", "offset", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatestWith", "tooltips", "from", "getElements", "mergeMap", "child", "mountTooltip", "takeUntil", "state", "__spreadValues", "mergeWith", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "index", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "getElements", "meta", "h", "scheme", "media$", "watchMedia", "defer", "push$", "Subject", "palette", "media", "key", "value", "label", "filter", "ev", "withLatestFrom", "_", "header", "getComponentElement", "style", "color", "observeOn", "asyncScheduler", "takeUntil", "skip", "repeat", "tap", "state", "finalize", "__spreadValues", "mountProgress", "el", "progress$", "defer", "push$", "Subject", "value", "tap", "finalize", "map", "import_clipboard", "extract", "el", "copy", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "resolve", "url", "base", "extract", "document", "sitemap", "el", "getElements", "getElement", "links", "link", "href", "fetchSitemap", "requestXML", "map", "catchError", "of", "handle", "ev", "sitemap", "EMPTY", "el", "url", "of", "head", "document", "tags", "getElements", "resolve", "key", "value", "inject", "next", "selector", "feature", "source", "getOptionalElement", "target", "html", "name", "container", "getComponentElement", "concat", "switchMap", "script", "Observable", "observer", "ignoreElements", "endWith", "setupInstantNavigation", "location$", "viewport$", "progress$", "config", "configuration", "sitemap$", "fetchSitemap", "instant$", "fromEvent", "combineLatestWith", "share", "history$", "map", "getLocation", "withLatestFrom", "offset", "merge", "document$", "distinctUntilKeyChanged", "requestHTML", "catchError", "setLocation", "_", "distinctUntilChanged", "a", "b", "tap", "_a", "_b", "setLocationHash", "debounceTime", "import_escape_html", "setupSearchHighlighter", "config", "regex", "term", "separator", "highlight", "_", "data", "query", "match", "value", "escapeHTML", "isSearchReadyMessage", "message", "isSearchResultMessage", "setupSearchWorker", "url", "index$", "worker$", "watchWorker", "merge", "of", "watchToggle", "first", "active", "switchMap", "config", "docs", "feature", "selectedVersionCorrespondingURL", "params", "_a", "selectedVersionSitemap", "selectedVersionBaseURL", "currentLocation", "currentBaseURL", "current_path", "safeURLParse", "currentRelativePath", "stripPrefix", "sitemapCommonPrefix", "shortestCommonPrefix", "potentialSitemapURL", "result", "url", "base", "e", "s", "prefix", "commonPrefixLen", "s1", "s2", "max", "strs", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "selectedVersionBaseURL", "fetchSitemap", "sitemap", "_a", "selectedVersionCorrespondingURL", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "outdated", "ignored", "main", "ignore", "warning", "getComponentElements", "watchSearchQuery", "el", "worker$", "searchParams", "getLocation", "setToggle", "watchToggle", "first", "active", "url", "focus$", "watchElementFocus", "value$", "merge", "isSearchReadyMessage", "fromEvent", "map", "distinctUntilChanged", "combineLatest", "value", "focus", "shareReplay", "mountSearchQuery", "push$", "Subject", "done$", "ignoreElements", "endWith", "_", "query", "distinctUntilKeyChanged", "takeUntil", "label", "getElement", "tap", "state", "finalize", "__spreadValues", "mountSearchResult", "el", "worker$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "container", "meta", "getElement", "list", "watchToggle", "active", "withLatestFrom", "skipUntil", "first", "isSearchReadyMessage", "items", "value", "translation", "count", "round", "render$", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "map", "renderSearchResultItem", "share", "item", "mergeMap", "details", "getOptionalElement", "EMPTY", "fromEvent", "takeUntil", "isSearchResultMessage", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "done$", "ignoreElements", "endWith", "fromEvent", "takeUntil", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "worker$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggest", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "worker$", "setupSearchWorker", "query", "getComponentElement", "result", "fromEvent", "filter", "target", "setToggle", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "els", "i", "query$", "mountSearchQuery", "merge", "mountSearchResult", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "next$", "auditTime", "animationFrameScheduler", "withLatestFrom", "first", "item", "getElements", "container", "getElementSize", "from", "mergeMap", "label", "fromEvent", "observeOn", "asyncScheduler", "takeUntil", "input", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "tag_name", "defaultIfEmpty", "star_count", "forks_count", "release", "info", "__spreadValues", "fetchSourceFacts", "url", "match", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "parent", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "main$", "target$", "push$", "Subject", "done$", "ignoreElements", "endWith", "feature", "smooth$", "merge", "debounceTime", "filter", "observeOn", "asyncScheduler", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "ignoreElements", "distinctUntilKeyChanged", "height", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "patchEllipsis", "document$", "viewport$", "switchMap", "getElements", "mergeMap", "el", "watchElementVisibility", "takeUntil", "skip", "filter", "visible", "map", "take", "text", "host", "feature", "mountInlineTooltip2", "finalize", "EMPTY", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "fetchSearchIndex", "watchScript", "config", "map", "shareReplay", "requestJSON", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "configuration", "index$", "NEVER", "alert$", "Subject", "setupClipboardJS", "progress$", "feature", "setupInstantNavigation", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "setLocation", "next", "active", "getActiveElement", "patchEllipsis", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "switchMap", "el", "watchMain", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountPalette", "mountProgress", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeader", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"]
 }
diff --git a/assets/stylesheets/main.0253249f.min.css b/assets/stylesheets/main.0253249f.min.css
deleted file mode 100644
index 9a7a6982d..000000000
--- a/assets/stylesheets/main.0253249f.min.css
+++ /dev/null
@@ -1 +0,0 @@
-@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}.md-typeset ul[type]{list-style-type:revert-layer}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}.md-typeset ol ol ol ol,.md-typeset ul ol ol ol{list-style-type:upper-alpha}.md-typeset ol ol ol ol ol,.md-typeset ul ol ol ol ol{list-style-type:upper-roman}.md-typeset ol[type],.md-typeset ul[type]{list-style-type:revert-layer}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{border-radius:100%;filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .md-code__content{display:grid}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}@media print{.md-feedback{display:none}}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3zm0 4h14v-2H3zm0 4h14v-2H3zm16 0h2v-2h-2zm0-10v2h2V7zm0 6h2v-2h-2z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em;position:relative}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8zm6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22zm-3.81.1a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0M5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0m6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5m-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.5 2.5 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.5 2.5 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.25.25 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25m0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.75 1.75 0 0 1 1 7.775m1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68zm-10 5h-2v-2h2zm0-4h-2V7h2z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3zm0 5h2v9H9zm4 0h2v9h-2z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5zm0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4zM9.53 9l-1.06 6h6l1.06-6z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>')}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-style:normal;font-weight:400;outline:none;text-align:initial;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}:root{--md-tooltip-width:20rem;--md-tooltip-tail:0.3rem}.md-tooltip2{-webkit-backface-visibility:hidden;backface-visibility:hidden;color:var(--md-default-fg-color);font-family:var(--md-text-font-family);opacity:0;pointer-events:none;position:absolute;top:calc(var(--md-tooltip-host-y) + var(--md-tooltip-y));transform:translateY(-.4rem);transform-origin:calc(var(--md-tooltip-host-x) + var(--md-tooltip-x)) 0;transition:transform 0ms .25s,opacity .25s,z-index .25s;width:100%;z-index:0}.md-tooltip2:before{border-left:var(--md-tooltip-tail) solid #0000;border-right:var(--md-tooltip-tail) solid #0000;content:"";display:block;left:clamp(1.5 * .8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-tail),100vw - 2 * var(--md-tooltip-tail) - 1.5 * .8rem);position:absolute;z-index:1}.md-tooltip2--top:before{border-top:var(--md-tooltip-tail) solid var(--md-default-bg-color);bottom:calc(var(--md-tooltip-tail)*-1 + .025rem);filter:drop-shadow(0 1px 0 hsla(0,0%,0%,.05))}.md-tooltip2--bottom:before{border-bottom:var(--md-tooltip-tail) solid var(--md-default-bg-color);filter:drop-shadow(0 -1px 0 hsla(0,0%,0%,.05));top:calc(var(--md-tooltip-tail)*-1 + .025rem)}.md-tooltip2--active{opacity:1;transform:translateY(0);transition:transform .4s cubic-bezier(0,1,.5,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip2__inner{scrollbar-gutter:stable;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);left:clamp(.8rem,var(--md-tooltip-host-x) - .8rem,100vw - var(--md-tooltip-width) - .8rem);max-height:40vh;max-width:calc(100vw - 1.6rem);position:relative;scrollbar-width:thin}.md-tooltip2__inner::-webkit-scrollbar{height:.2rem;width:.2rem}.md-tooltip2__inner::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-tooltip2__inner::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}[role=tooltip]>.md-tooltip2__inner{font-size:.5rem;font-weight:700;left:clamp(.8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-width)/2,100vw - var(--md-tooltip-width) - .8rem);max-width:min(100vw - 2 * .8rem,400px);padding:.2rem .4rem;-webkit-user-select:none;user-select:none;width:-moz-fit-content;width:fit-content}.md-tooltip2__inner.md-typeset>:first-child{margin-top:0}.md-tooltip2__inner.md-typeset>:last-child{margin-bottom:0}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__alias{margin-left:.3rem;opacity:.7}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1s-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.6.6 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5zM12 2c2.75 0 5.1 1 7.05 2.95S22 9.25 22 12s-1 5.1-2.95 7.05S14.75 22 12 22s-5.1-1-7.05-2.95S2 14.75 2 12s1-5.1 2.95-7.05S9.25 2 12 2"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2zm10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4zm-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2zm-6 2h2v-1h-2z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2zm4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying]{display:initial}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m16.28-2.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m16.28-2.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}@media print{.giscus,[id=__comments]{display:none}}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
diff --git a/assets/stylesheets/main.0253249f.min.css.map b/assets/stylesheets/main.0253249f.min.css.map
deleted file mode 100644
index 748194709..000000000
--- a/assets/stylesheets/main.0253249f.min.css.map
+++ /dev/null
@@ -1 +0,0 @@
-{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_code.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_tooltip2.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_giscus.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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,4DACE,oBlC05GJ,CkCv5GI,sFACE,gClCy5GN,CkCp5GE,oEACE,0BlCu5GJ,CkCp5GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClCs5GN,CkCl5GI,gFACE,alCo5GN,CkCz6GE,4DACE,oBlC46GJ,CkCz6GI,sFACE,gClC26GN,CkCt6GE,oEACE,0BlCy6GJ,CkCt6GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClCw6GN,CkCp6GI,gFACE,alCs6GN,CkC37GE,0DACE,oBlC87GJ,CkC37GI,oFACE,gClC67GN,CkCx7GE,kEACE,0BlC27GJ,CkCx7GI,gFACE,wBAlBG,CAmBH,oDAAA,CAAA,4ClC07GN,CkCt7GI,8EACE,alCw7GN,CkC78GE,oDACE,oBlCg9GJ,CkC78GI,8EACE,gClC+8GN,CkC18GE,4DACE,0BlC68GJ,CkC18GI,0EACE,wBAlBG,CAmBH,iDAAA,CAAA,yClC48GN,CkCx8GI,wEACE,alC08GN,CkC/9GE,4DACE,oBlCk+GJ,CkC/9GI,sFACE,gClCi+GN,CkC59GE,oEACE,0BlC+9GJ,CkC59GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClC89GN,CkC19GI,gFACE,alC49GN,CkCj/GE,wDACE,oBlCo/GJ,CkCj/GI,kFACE,gClCm/GN,CkC9+GE,gEACE,0BlCi/GJ,CkC9+GI,8EACE,wBAlBG,CAmBH,mDAAA,CAAA,2ClCg/GN,CkC5+GI,4EACE,alC8+GN,CmClpHA,MACE,qMnCqpHF,CmC5oHE,sBAEE,uCAAA,CADA,gBnCgpHJ,CmC5oHI,mCACE,anC8oHN,CmC/oHI,mCACE,cnC8oHN,CmC1oHM,4BACE,sBnC4oHR,CmCzoHQ,mCACE,gCnC2oHV,CmCvoHQ,2DACE,SAAA,CAEA,uBAAA,CADA,enC0oHV,CmCroHQ,yGACE,SAAA,CACA,uBnCuoHV,CmCnoHQ,yCACE,YnCqoHV,CmC9nHE,0BACE,eAAA,CACA,enCgoHJ,CmC7nHI,+BACE,oBnC+nHN,CmC1nHE,gDACE,YnC4nHJ,CmCxnHE,8BAIE,+BAAA,CAHA,oBAAA,CAEA,WAAA,CAGA,SAAA,CAKA,4B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","file":"main.css"}
\ No newline at end of file
diff --git a/assets/stylesheets/main.6f8fc17f.min.css b/assets/stylesheets/main.6f8fc17f.min.css
new file mode 100644
index 000000000..a0d06b0eb
--- /dev/null
+++ b/assets/stylesheets/main.6f8fc17f.min.css
@@ -0,0 +1 @@
+@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset h5 code{text-transform:none}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}.md-typeset ul[type]{list-style-type:revert-layer}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}.md-typeset ol ol ol ol,.md-typeset ul ol ol ol{list-style-type:upper-alpha}.md-typeset ol ol ol ol ol,.md-typeset ul ol ol ol ol{list-style-type:upper-roman}.md-typeset ol[type],.md-typeset ul[type]{list-style-type:revert-layer}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{border-radius:100%;filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .md-code__content{display:grid}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}@media print{.md-feedback{display:none}}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3zm0 4h14v-2H3zm0 4h14v-2H3zm16 0h2v-2h-2zm0-10v2h2V7zm0 6h2v-2h-2z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em;position:relative}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8zm6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22zm-3.81.1a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0M5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0m6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5m-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.5 2.5 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.5 2.5 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.25.25 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25m0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.75 1.75 0 0 1 1 7.775m1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68zm-10 5h-2v-2h2zm0-4h-2V7h2z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3zm0 5h2v9H9zm4 0h2v9h-2z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5zm0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4zM9.53 9l-1.06 6h6l1.06-6z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>')}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-style:normal;font-weight:400;outline:none;text-align:initial;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}:root{--md-tooltip-width:20rem;--md-tooltip-tail:0.3rem}.md-tooltip2{-webkit-backface-visibility:hidden;backface-visibility:hidden;color:var(--md-default-fg-color);font-family:var(--md-text-font-family);opacity:0;pointer-events:none;position:absolute;top:calc(var(--md-tooltip-host-y) + var(--md-tooltip-y));transform:translateY(-.4rem);transform-origin:calc(var(--md-tooltip-host-x) + var(--md-tooltip-x)) 0;transition:transform 0ms .25s,opacity .25s,z-index .25s;width:100%;z-index:0}.md-tooltip2:before{border-left:var(--md-tooltip-tail) solid #0000;border-right:var(--md-tooltip-tail) solid #0000;content:"";display:block;left:clamp(1.5 * .8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-tail),100vw - 2 * var(--md-tooltip-tail) - 1.5 * .8rem);position:absolute;z-index:1}.md-tooltip2--top:before{border-top:var(--md-tooltip-tail) solid var(--md-default-bg-color);bottom:calc(var(--md-tooltip-tail)*-1 + .025rem);filter:drop-shadow(0 1px 0 hsla(0,0%,0%,.05))}.md-tooltip2--bottom:before{border-bottom:var(--md-tooltip-tail) solid var(--md-default-bg-color);filter:drop-shadow(0 -1px 0 hsla(0,0%,0%,.05));top:calc(var(--md-tooltip-tail)*-1 + .025rem)}.md-tooltip2--active{opacity:1;transform:translateY(0);transition:transform .4s cubic-bezier(0,1,.5,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip2__inner{scrollbar-gutter:stable;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);left:clamp(.8rem,var(--md-tooltip-host-x) - .8rem,100vw - var(--md-tooltip-width) - .8rem);max-height:40vh;max-width:calc(100vw - 1.6rem);position:relative;scrollbar-width:thin}.md-tooltip2__inner::-webkit-scrollbar{height:.2rem;width:.2rem}.md-tooltip2__inner::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-tooltip2__inner::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}[role=tooltip]>.md-tooltip2__inner{font-size:.5rem;font-weight:700;left:clamp(.8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-width)/2,100vw - var(--md-tooltip-width) - .8rem);max-width:min(100vw - 2 * .8rem,400px);padding:.2rem .4rem;-webkit-user-select:none;user-select:none;width:-moz-fit-content;width:fit-content}.md-tooltip2__inner.md-typeset>:first-child{margin-top:0}.md-tooltip2__inner.md-typeset>:last-child{margin-bottom:0}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__alias{margin-left:.3rem;opacity:.7}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1s-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.6.6 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5zM12 2c2.75 0 5.1 1 7.05 2.95S22 9.25 22 12s-1 5.1-2.95 7.05S14.75 22 12 22s-5.1-1-7.05-2.95S2 14.75 2 12s1-5.1 2.95-7.05S9.25 2 12 2"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2zm10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4zm-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2zm-6 2h2v-1h-2z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2zm4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying]{display:initial}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m16.28-2.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m16.28-2.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}@media print{.giscus,[id=__comments]{display:none}}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
diff --git a/assets/stylesheets/main.6f8fc17f.min.css.map b/assets/stylesheets/main.6f8fc17f.min.css.map
new file mode 100644
index 000000000..8ba5ce39e
--- /dev/null
+++ b/assets/stylesheets/main.6f8fc17f.min.css.map
@@ -0,0 +1 @@
+{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_code.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_tooltip2.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_giscus.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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FACE,alCq4GN,CkC15GE,4DACE,oBlC65GJ,CkC15GI,sFACE,gClC45GN,CkCv5GE,oEACE,0BlC05GJ,CkCv5GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClCy5GN,CkCr5GI,gFACE,alCu5GN,CkC56GE,4DACE,oBlC+6GJ,CkC56GI,sFACE,gClC86GN,CkCz6GE,oEACE,0BlC46GJ,CkCz6GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClC26GN,CkCv6GI,gFACE,alCy6GN,CkC97GE,0DACE,oBlCi8GJ,CkC97GI,oFACE,gClCg8GN,CkC37GE,kEACE,0BlC87GJ,CkC37GI,gFACE,wBAlBG,CAmBH,oDAAA,CAAA,4ClC67GN,CkCz7GI,8EACE,alC27GN,CkCh9GE,oDACE,oBlCm9GJ,CkCh9GI,8EACE,gClCk9GN,CkC78GE,4DACE,0BlCg9GJ,CkC78GI,0EACE,wBAlBG,CAmBH,iDAAA,CAAA,yClC+8GN,CkC38GI,wEACE,alC68GN,CkCl+GE,4DACE,oBlCq+GJ,CkCl+GI,sFACE,gClCo+GN,CkC/9GE,oEACE,0BlCk+GJ,CkC/9GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClCi+GN,CkC79GI,gFACE,alC+9GN,CkCp/GE,wDACE,oBlCu/GJ,CkCp/GI,kFACE,gClCs/GN,CkCj/GE,gEACE,0BlCo/GJ,CkCj/GI,8EACE,wBAlBG,CAmBH,mDAAA,CAAA,2ClCm/GN,CkC/+GI,4EACE,alCi/GN,CmCrpHA,MACE,qMnCwpHF,CmC/oHE,sBAEE,uCAAA,CADA,gBnCmpHJ,CmC/oHI,mCACE,anCipHN,CmClpHI,mCACE,cnCipHN,CmC7oHM,4BACE,sBnC+oHR,CmC5oHQ,mCACE,gCnC8oHV,CmC1oHQ,2DACE,SAAA,CAEA,uBAAA,CADA,enC6oHV,CmCxoHQ,yGACE,SAAA,CACA,uBnC0oHV,CmCtoHQ,yCACE,YnCwoHV,CmCjoHE,0BACE,eAAA,CACA,enCmoHJ,CmChoHI,+BACE,oBnCkoHN,CmC7nHE,gDACE,YnC+nHJ,CmC3nHE,8BAIE,+BAAA,CAHA,oBAAA,CAEA,WA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","file":"main.css"}
\ No newline at end of file
diff --git a/index.html b/index.html
index 861c355d1..caecee731 100644
--- a/index.html
+++ b/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -28,7 +28,7 @@
       
     
     
-      <link rel="stylesheet" href="assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="assets/stylesheets/palette.06af60db.min.css">
@@ -192,7 +192,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -341,7 +341,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -500,15 +500,6 @@
     </span>
   </a>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#donate" class="md-nav__link">
-    <span class="md-ellipsis">
-      Donate
-    </span>
-  </a>
-  
 </li>
       
         <li class="md-nav__item">
@@ -803,11 +794,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="reference/download/" class="md-nav__link ">
+            <a href="reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -823,7 +814,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -833,56 +824,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -894,32 +835,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="reference/types/" class="md-nav__link ">
+            <a href="reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -930,53 +871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="reference/types/album/" class="md-nav__link">
+      <a href="reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -993,11 +892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/types/saved/" class="md-nav__link">
+      <a href="reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1014,11 +913,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/types/result/" class="md-nav__link">
+      <a href="reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1035,11 +934,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/types/song/" class="md-nav__link">
+      <a href="reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1056,11 +955,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/types/options/" class="md-nav__link">
+      <a href="reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1095,32 +994,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="reference/console/" class="md-nav__link ">
+            <a href="reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1131,11 +1030,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/save/" class="md-nav__link">
+      <a href="reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1152,11 +1051,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/url/" class="md-nav__link">
+      <a href="reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1173,11 +1072,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/meta/" class="md-nav__link">
+      <a href="reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1194,11 +1093,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/web/" class="md-nav__link">
+      <a href="reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1215,11 +1114,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/sync/" class="md-nav__link">
+      <a href="reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1236,11 +1135,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/download/" class="md-nav__link">
+      <a href="reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1257,11 +1156,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/console/entry_point/" class="md-nav__link">
+      <a href="reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1279,6 +1178,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1296,7 +1203,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1312,14 +1219,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1332,11 +1239,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/console/" class="md-nav__link">
+      <a href="reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1353,11 +1260,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/formatter/" class="md-nav__link">
+      <a href="reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1374,11 +1281,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/arguments/" class="md-nav__link">
+      <a href="reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1395,11 +1302,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/metadata/" class="md-nav__link">
+      <a href="reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1416,11 +1323,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/downloader/" class="md-nav__link">
+      <a href="reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1437,11 +1344,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/github/" class="md-nav__link">
+      <a href="reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1458,11 +1365,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/static/" class="md-nav__link">
+      <a href="reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1479,11 +1386,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/search/" class="md-nav__link">
+      <a href="reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1500,11 +1407,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/web/" class="md-nav__link">
+      <a href="reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1521,11 +1428,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/logging/" class="md-nav__link">
+      <a href="reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1542,11 +1449,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/spotify/" class="md-nav__link">
+      <a href="reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1563,11 +1470,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/matching/" class="md-nav__link">
+      <a href="reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1584,11 +1491,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1605,11 +1512,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/m3u/" class="md-nav__link">
+      <a href="reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1626,11 +1533,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/config/" class="md-nav__link">
+      <a href="reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1647,11 +1554,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/lrc/" class="md-nav__link">
+      <a href="reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1668,11 +1575,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/utils/archive/" class="md-nav__link">
+      <a href="reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1707,32 +1614,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="reference/providers/" class="md-nav__link ">
+            <a href="reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1742,45 +1649,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1789,11 +1692,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1810,11 +1713,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1831,11 +1734,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1852,11 +1755,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1873,11 +1776,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1912,32 +1815,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="reference/providers/audio/" class="md-nav__link ">
+            <a href="reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1948,11 +1851,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1969,11 +1872,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1983,6 +1886,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1990,11 +1947,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/piped/" class="md-nav__link">
+      <a href="reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2011,11 +1968,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2032,11 +1989,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2053,11 +2010,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/base/" class="md-nav__link">
+      <a href="reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2074,11 +2031,11 @@
   
   
     <li class="md-nav__item">
-      <a href="reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2088,9 +2045,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2166,7 +2157,7 @@ <h3 id="other-options">Other options<a class="headerlink" href="#other-options"
 <li>On Termux</li>
 <li><code>curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh</code></li>
 <li>Arch</li>
-<li>There is an <a href="https://aur.archlinux.org/packages/python-spotdl/">Arch User Repository (AUR) package</a> for
+<li>There is an <a href="https://aur.archlinux.org/packages/spotdl/">Arch User Repository (AUR) package</a> for
     spotDL.</li>
 <li>Docker</li>
 <li>
@@ -2261,14 +2252,10 @@ <h2 id="music-sourcing-and-audio-quality">Music Sourcing and Audio Quality<a cla
 </blockquote>
 <h3 id="audio-quality">Audio Quality<a class="headerlink" href="#audio-quality" title="Permanent link">¤</a></h3>
 <p>spotDL downloads music from YouTube and is designed to always download the highest possible bitrate; which is 128 kbps for regular users and 256 kbps for YouTube Music premium users.</p>
-<p>Check the <a href="usage#audio-formats-and-quality">Audio Formats</a> page for more info.</p>
+<p>Check the <a href="usage/#audio-formats-and-quality">Audio Formats</a> page for more info.</p>
 <h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">¤</a></h2>
-<p>Interested in contributing? Check out our <a href="CONTRIBUTING">CONTRIBUTING.md</a> to find
+<p>Interested in contributing? Check out our <a href="CONTRIBUTING/">CONTRIBUTING.md</a> to find
 resources around contributing along with a guide on how to set up a development environment.</p>
-<h2 id="donate">Donate<a class="headerlink" href="#donate" title="Permanent link">¤</a></h2>
-<p>help support the development and maintenance of the software ❤️</p>
-<p><a href="https://paypal.me/kko7"><img alt="paypal" src="https://img.shields.io/badge/paypal-%2300457C.svg?&amp;style=for-the-badge&amp;logo=paypal&amp;logoColor=white" /></a>
-<a href="https://ko-fi.com/xnetcat"><img alt="kofi" src="https://img.shields.io/badge/kofi-%23F16061.svg?&amp;style=for-the-badge&amp;logo=ko-fi&amp;logoColor=white" /></a></p>
 <h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">¤</a></h2>
 <p>This project is Licensed under the <a href="/LICENSE">MIT</a> License.</p>
 
@@ -2326,7 +2313,7 @@ <h2 id="license">License<a class="headerlink" href="#license" title="Permanent l
     <script id="__config" type="application/json">{"base": ".", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/installation/index.html b/installation/index.html
index f8b1a98c9..abb9cd26a 100644
--- a/installation/index.html
+++ b/installation/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -874,11 +874,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/download/" class="md-nav__link ">
+            <a href="../reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -894,7 +894,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -904,56 +904,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -965,32 +915,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/types/" class="md-nav__link ">
+            <a href="../reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1001,53 +951,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/album/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -1064,11 +972,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/saved/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1085,11 +993,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/result/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1106,11 +1014,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/song/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1127,11 +1035,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/options/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1166,32 +1074,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/console/" class="md-nav__link ">
+            <a href="../reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1202,11 +1110,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/save/" class="md-nav__link">
+      <a href="../reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1223,11 +1131,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/url/" class="md-nav__link">
+      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1244,11 +1152,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/meta/" class="md-nav__link">
+      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1265,11 +1173,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/web/" class="md-nav__link">
+      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1286,11 +1194,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/sync/" class="md-nav__link">
+      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1307,11 +1215,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/download/" class="md-nav__link">
+      <a href="../reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1328,11 +1236,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/entry_point/" class="md-nav__link">
+      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1350,6 +1258,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1367,7 +1283,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1383,14 +1299,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1403,11 +1319,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/console/" class="md-nav__link">
+      <a href="../reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1424,11 +1340,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/formatter/" class="md-nav__link">
+      <a href="../reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1445,11 +1361,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/arguments/" class="md-nav__link">
+      <a href="../reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1466,11 +1382,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/metadata/" class="md-nav__link">
+      <a href="../reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1487,11 +1403,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/downloader/" class="md-nav__link">
+      <a href="../reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1508,11 +1424,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/github/" class="md-nav__link">
+      <a href="../reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1529,11 +1445,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/static/" class="md-nav__link">
+      <a href="../reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1550,11 +1466,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/search/" class="md-nav__link">
+      <a href="../reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1571,11 +1487,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/web/" class="md-nav__link">
+      <a href="../reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1592,11 +1508,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/logging/" class="md-nav__link">
+      <a href="../reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1613,11 +1529,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/spotify/" class="md-nav__link">
+      <a href="../reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1634,11 +1550,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/matching/" class="md-nav__link">
+      <a href="../reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1655,11 +1571,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="../reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1676,11 +1592,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/m3u/" class="md-nav__link">
+      <a href="../reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1697,11 +1613,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/config/" class="md-nav__link">
+      <a href="../reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1718,11 +1634,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/lrc/" class="md-nav__link">
+      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1739,11 +1655,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/archive/" class="md-nav__link">
+      <a href="../reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1778,32 +1694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/" class="md-nav__link ">
+            <a href="../reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1813,45 +1729,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1860,11 +1772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="../reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1881,11 +1793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1902,11 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1923,11 +1835,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="../reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1944,11 +1856,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="../reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1983,32 +1895,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/audio/" class="md-nav__link ">
+            <a href="../reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2019,11 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2040,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2054,6 +1966,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2061,11 +2027,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/piped/" class="md-nav__link">
+      <a href="../reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2082,11 +2048,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="../reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2103,11 +2069,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2124,11 +2090,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/base/" class="md-nav__link">
+      <a href="../reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2145,11 +2111,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2159,9 +2125,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2297,7 +2297,7 @@ <h3 id="termux">Termux<a class="headerlink" href="#termux" title="Permanent link
 <p>We have a dedicated Termux installation script
 <code>curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh</code></p>
 <h3 id="arch-user-repository-aur-package">Arch User Repository (AUR) package<a class="headerlink" href="#arch-user-repository-aur-package" title="Permanent link">¤</a></h3>
-<p><a href="https://aur.archlinux.org/packages/python-spotdl">You can find the AUR Package here</a></p>
+<p><a href="https://aur.archlinux.org/packages/spotdl">You can find the AUR Package here</a></p>
 <h2 id="where-does-spotdl-download-songs">Where does spotDL download songs?<a class="headerlink" href="#where-does-spotdl-download-songs" title="Permanent link">¤</a></h2>
 <p>spotDL downloads files to the folder where you ran spotDL from.</p>
 <p>Open pwsh/powershell/cmd/terminal/similar in the folder you want files to download to, or cd to
@@ -2362,7 +2362,7 @@ <h2 id="we-have-a-public-discord-server-at-discordggxca23pwjwy">We have a public
     <script id="__config" type="application/json">{"base": "..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/SUMMARY/index.html b/reference/SUMMARY/index.html
index 387c937ab..2b4e83ec9 100644
--- a/reference/SUMMARY/index.html
+++ b/reference/SUMMARY/index.html
@@ -18,7 +18,7 @@
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -26,7 +26,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -185,7 +185,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -332,7 +332,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -637,11 +637,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../download/" class="md-nav__link ">
+            <a href="../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -657,7 +657,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -667,56 +667,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -728,32 +678,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../types/" class="md-nav__link ">
+            <a href="../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -764,53 +714,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/album/" class="md-nav__link">
+      <a href="../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -827,11 +735,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/saved/" class="md-nav__link">
+      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -848,11 +756,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/result/" class="md-nav__link">
+      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -869,11 +777,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/song/" class="md-nav__link">
+      <a href="../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -890,11 +798,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/options/" class="md-nav__link">
+      <a href="../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -929,32 +837,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../console/" class="md-nav__link ">
+            <a href="../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -965,11 +873,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/save/" class="md-nav__link">
+      <a href="../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -986,11 +894,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/url/" class="md-nav__link">
+      <a href="../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1007,11 +915,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/meta/" class="md-nav__link">
+      <a href="../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1028,11 +936,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/web/" class="md-nav__link">
+      <a href="../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1049,11 +957,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/sync/" class="md-nav__link">
+      <a href="../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1070,11 +978,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/download/" class="md-nav__link">
+      <a href="../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1091,11 +999,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/entry_point/" class="md-nav__link">
+      <a href="../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1113,6 +1021,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1130,7 +1046,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1146,14 +1062,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1166,11 +1082,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/console/" class="md-nav__link">
+      <a href="../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1187,11 +1103,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/formatter/" class="md-nav__link">
+      <a href="../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1208,11 +1124,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/arguments/" class="md-nav__link">
+      <a href="../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1229,11 +1145,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/metadata/" class="md-nav__link">
+      <a href="../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1250,11 +1166,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/downloader/" class="md-nav__link">
+      <a href="../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1271,11 +1187,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/github/" class="md-nav__link">
+      <a href="../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1292,11 +1208,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/static/" class="md-nav__link">
+      <a href="../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1313,11 +1229,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/search/" class="md-nav__link">
+      <a href="../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1334,11 +1250,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/web/" class="md-nav__link">
+      <a href="../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1355,11 +1271,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/logging/" class="md-nav__link">
+      <a href="../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1376,11 +1292,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/spotify/" class="md-nav__link">
+      <a href="../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1397,11 +1313,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/matching/" class="md-nav__link">
+      <a href="../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1418,11 +1334,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/ffmpeg/" class="md-nav__link">
+      <a href="../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1439,11 +1355,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/m3u/" class="md-nav__link">
+      <a href="../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1460,11 +1376,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/config/" class="md-nav__link">
+      <a href="../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1481,11 +1397,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/lrc/" class="md-nav__link">
+      <a href="../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1502,11 +1418,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/archive/" class="md-nav__link">
+      <a href="../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1541,32 +1457,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/" class="md-nav__link ">
+            <a href="../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1576,45 +1492,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1623,11 +1535,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1644,11 +1556,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1665,11 +1577,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1686,11 +1598,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1707,11 +1619,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/base/" class="md-nav__link">
+      <a href="../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1746,32 +1658,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/audio/" class="md-nav__link ">
+            <a href="../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1782,11 +1694,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1803,11 +1715,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -1824,11 +1811,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/piped/" class="md-nav__link">
+      <a href="../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -1845,11 +1832,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/youtube/" class="md-nav__link">
+      <a href="../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1866,11 +1853,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -1887,11 +1874,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/base/" class="md-nav__link">
+      <a href="../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -1908,11 +1895,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -1922,9 +1909,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -1964,70 +1964,70 @@ <h1>SUMMARY</h1>
 
 <ul>
 <li><a href="../">__init__</a></li>
-<li><a href="../download/">download</a><ul>
-<li><a href="../download/downloader/">downloader</a></li>
-<li><a href="../download/progress_handler/">progress_handler</a></li>
+<li><a href="../providers/">providers</a><ul>
+<li><a href="../providers/lyrics/">lyrics</a><ul>
+<li><a href="../providers/lyrics/synced/">synced</a></li>
+<li><a href="../providers/lyrics/musixmatch/">musixmatch</a></li>
+<li><a href="../providers/lyrics/azlyrics/">azlyrics</a></li>
+<li><a href="../providers/lyrics/base/">base</a></li>
+<li><a href="../providers/lyrics/genius/">genius</a></li>
 </ul>
 </li>
-<li><a href="../types/">types</a><ul>
-<li><a href="../types/artist/">artist</a></li>
-<li><a href="../types/playlist/">playlist</a></li>
-<li><a href="../types/album/">album</a></li>
-<li><a href="../types/saved/">saved</a></li>
-<li><a href="../types/result/">result</a></li>
-<li><a href="../types/song/">song</a></li>
-<li><a href="../types/options/">options</a></li>
+<li><a href="../providers/audio/">audio</a><ul>
+<li><a href="../providers/audio/piped/">piped</a></li>
+<li><a href="../providers/audio/youtube/">youtube</a></li>
+<li><a href="../providers/audio/soundcloud/">soundcloud</a></li>
+<li><a href="../providers/audio/bandcamp/">bandcamp</a></li>
+<li><a href="../providers/audio/ytmusic/">ytmusic</a></li>
+<li><a href="../providers/audio/base/">base</a></li>
+<li><a href="../providers/audio/sliderkz/">sliderkz</a></li>
 </ul>
 </li>
-<li><a href="../console/">console</a><ul>
-<li><a href="../console/save/">save</a></li>
-<li><a href="../console/url/">url</a></li>
-<li><a href="../console/meta/">meta</a></li>
-<li><a href="../console/web/">web</a></li>
-<li><a href="../console/sync/">sync</a></li>
-<li><a href="../console/download/">download</a></li>
-<li><a href="../console/entry_point/">entry_point</a></li>
 </ul>
 </li>
 <li><a href="../utils/">utils</a><ul>
-<li><a href="../utils/console/">console</a></li>
-<li><a href="../utils/formatter/">formatter</a></li>
-<li><a href="../utils/arguments/">arguments</a></li>
+<li><a href="../utils/spotify/">spotify</a></li>
+<li><a href="../utils/m3u/">m3u</a></li>
 <li><a href="../utils/metadata/">metadata</a></li>
-<li><a href="../utils/downloader/">downloader</a></li>
-<li><a href="../utils/github/">github</a></li>
+<li><a href="../utils/logging/">logging</a></li>
 <li><a href="../utils/static/">static</a></li>
+<li><a href="../utils/matching/">matching</a></li>
 <li><a href="../utils/search/">search</a></li>
+<li><a href="../utils/downloader/">downloader</a></li>
+<li><a href="../utils/archive/">archive</a></li>
+<li><a href="../utils/lrc/">lrc</a></li>
+<li><a href="../utils/config/">config</a></li>
+<li><a href="../utils/arguments/">arguments</a></li>
+<li><a href="../utils/console/">console</a></li>
+<li><a href="../utils/github/">github</a></li>
 <li><a href="../utils/web/">web</a></li>
-<li><a href="../utils/logging/">logging</a></li>
-<li><a href="../utils/spotify/">spotify</a></li>
-<li><a href="../utils/matching/">matching</a></li>
 <li><a href="../utils/ffmpeg/">ffmpeg</a></li>
-<li><a href="../utils/m3u/">m3u</a></li>
-<li><a href="../utils/config/">config</a></li>
-<li><a href="../utils/lrc/">lrc</a></li>
-<li><a href="../utils/archive/">archive</a></li>
+<li><a href="../utils/formatter/">formatter</a></li>
 </ul>
 </li>
-<li><a href="../providers/">providers</a><ul>
-<li><a href="../providers/lyrics/">lyrics</a><ul>
-<li><a href="../providers/lyrics/synced/">synced</a></li>
-<li><a href="../providers/lyrics/musixmatch/">musixmatch</a></li>
-<li><a href="../providers/lyrics/azlyrics/">azlyrics</a></li>
-<li><a href="../providers/lyrics/genius/">genius</a></li>
-<li><a href="../providers/lyrics/base/">base</a></li>
+<li><a href="../types/">types</a><ul>
+<li><a href="../types/options/">options</a></li>
+<li><a href="../types/saved/">saved</a></li>
+<li><a href="../types/artist/">artist</a></li>
+<li><a href="../types/result/">result</a></li>
+<li><a href="../types/playlist/">playlist</a></li>
+<li><a href="../types/song/">song</a></li>
+<li><a href="../types/album/">album</a></li>
 </ul>
 </li>
-<li><a href="../providers/audio/">audio</a><ul>
-<li><a href="../providers/audio/bandcamp/">bandcamp</a></li>
-<li><a href="../providers/audio/sliderkz/">sliderkz</a></li>
-<li><a href="../providers/audio/piped/">piped</a></li>
-<li><a href="../providers/audio/youtube/">youtube</a></li>
-<li><a href="../providers/audio/soundcloud/">soundcloud</a></li>
-<li><a href="../providers/audio/base/">base</a></li>
-<li><a href="../providers/audio/ytmusic/">ytmusic</a></li>
+<li><a href="../download/">download</a><ul>
+<li><a href="../download/downloader/">downloader</a></li>
+<li><a href="../download/progress_handler/">progress_handler</a></li>
 </ul>
 </li>
+<li><a href="../console/">console</a><ul>
+<li><a href="../console/save/">save</a></li>
+<li><a href="../console/url/">url</a></li>
+<li><a href="../console/entry_point/">entry_point</a></li>
+<li><a href="../console/sync/">sync</a></li>
+<li><a href="../console/meta/">meta</a></li>
+<li><a href="../console/download/">download</a></li>
+<li><a href="../console/web/">web</a></li>
 </ul>
 </li>
 </ul>
@@ -2086,7 +2086,7 @@ <h1>SUMMARY</h1>
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/download/index.html b/reference/console/download/index.html
index 0b8a5cc7f..305c25ca9 100644
--- a/reference/console/download/index.html
+++ b/reference/console/download/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/console/download/">
       
       
-        <link rel="prev" href="../sync/">
+        <link rel="prev" href="../meta/">
       
       
-        <link rel="next" href="../entry_point/">
+        <link rel="next" href="../web/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -744,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -801,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -822,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -843,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -864,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -885,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -928,12 +1037,18 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
-    
-  
   
   
     
@@ -943,36 +1058,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1004,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1025,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1046,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1067,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sync/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1085,104 +1200,56 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../utils/matching/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    search
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.download" class="md-nav__link">
-    <span class="md-ellipsis">
-      download
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.download.download" class="md-nav__link">
-    <span class="md-ellipsis">
-      download
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="download">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.download.download--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
+              
+            
+              
+                
   
   
   
   
     <li class="md-nav__item">
-      <a href="../entry_point/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    downloader
   </span>
   
 
@@ -1192,60 +1259,6 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    utils
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
               
                 
   
@@ -1253,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1274,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1295,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1316,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1337,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1379,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1400,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1421,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1435,26 +1448,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1463,11 +1509,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    options
   </span>
   
 
@@ -1484,11 +1530,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1505,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1526,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1547,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1568,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1589,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1628,78 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1710,74 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1794,11 +1731,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1820,6 +1757,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1829,36 +1768,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1869,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1890,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1911,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1932,11 +1871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -1953,11 +1892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -1971,18 +1910,87 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.download" class="md-nav__link">
+    <span class="md-ellipsis">
+      download
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.download.download" class="md-nav__link">
+    <span class="md-ellipsis">
+      download
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="download">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.download.download--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1995,11 +2003,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2023,14 +2031,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2119,7 +2119,7 @@ <h5 id="spotdl.console.download.download--arguments">Arguments<a class="headerli
 <span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
-<span class="normal">35</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download</span><span class="p">(</span>
+<span class="normal">35</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download</span><span class="p">(</span>
     <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">downloader</span><span class="p">:</span> <span class="n">Downloader</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
@@ -2210,7 +2210,7 @@ <h5 id="spotdl.console.download.download--arguments">Arguments<a class="headerli
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/entry_point/index.html b/reference/console/entry_point/index.html
index 5b4bb84fb..d3403b839 100644
--- a/reference/console/entry_point/index.html
+++ b/reference/console/entry_point/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/console/entry_point/">
       
       
-        <link rel="prev" href="../download/">
+        <link rel="prev" href="../url/">
       
       
-        <link rel="next" href="../../utils/">
+        <link rel="next" href="../sync/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -943,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1004,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1025,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1046,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1067,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1088,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1106,80 +1012,25 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    entry_point
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.entry_point" class="md-nav__link">
-    <span class="md-ellipsis">
-      entry_point
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.entry_point.console_entry_point" class="md-nav__link">
-    <span class="md-ellipsis">
-      console_entry_point
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.entry_point.entry_point" class="md-nav__link">
-    <span class="md-ellipsis">
-      entry_point
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
+    </li>
   
-</nav>
+
+              
+            
+          </ul>
+        </nav>
       
     </li>
   
@@ -1211,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1227,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1247,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1268,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1289,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1310,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1331,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1352,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1373,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1394,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1415,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1436,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1457,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1478,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1499,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1520,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1541,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1562,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1583,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1622,32 +1473,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1657,45 +1508,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1704,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1725,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1746,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1767,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1788,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1827,32 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1863,11 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1884,11 +1731,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1898,6 +1745,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1905,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1926,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1944,14 +1847,98 @@
                 
   
   
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    entry_point
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    entry_point
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.entry_point" class="md-nav__link">
+    <span class="md-ellipsis">
+      entry_point
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.entry_point.console_entry_point" class="md-nav__link">
+    <span class="md-ellipsis">
+      console_entry_point
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.entry_point.entry_point" class="md-nav__link">
+    <span class="md-ellipsis">
+      entry_point
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -1968,11 +1955,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -1989,11 +1976,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2003,9 +1990,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2100,7 +2100,7 @@ <h2 id="spotdl.console.entry_point.console_entry_point" class="doc doc-heading">
 <span class="normal">50</span>
 <span class="normal">51</span>
 <span class="normal">52</span>
-<span class="normal">53</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">console_entry_point</span><span class="p">():</span>
+<span class="normal">53</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">console_entry_point</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Entry point for the console. With profile flag, it runs the code with cProfile.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2268,7 +2268,7 @@ <h2 id="spotdl.console.entry_point.entry_point" class="doc doc-heading">
 <span class="normal">186</span>
 <span class="normal">187</span>
 <span class="normal">188</span>
-<span class="normal">189</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">entry_point</span><span class="p">():</span>
+<span class="normal">189</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">entry_point</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Console entry point for spotdl. This is where the magic happens.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2357,7 +2357,7 @@ <h2 id="spotdl.console.entry_point.entry_point" class="doc doc-heading">
     <span class="c1"># for download, load and preload operations</span>
     <span class="n">downloader</span> <span class="o">=</span> <span class="n">Downloader</span><span class="p">(</span><span class="n">downloader_settings</span><span class="p">)</span>
 
-    <span class="k">def</span> <span class="nf">graceful_exit</span><span class="p">(</span><span class="n">_signal</span><span class="p">,</span> <span class="n">_frame</span><span class="p">):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">graceful_exit</span><span class="p">(</span><span class="n">_signal</span><span class="p">,</span> <span class="n">_frame</span><span class="p">):</span>
         <span class="k">if</span> <span class="n">spotify_settings</span><span class="p">[</span><span class="s2">&quot;use_cache_file&quot;</span><span class="p">]:</span>
             <span class="n">save_spotify_cache</span><span class="p">(</span><span class="n">spotify_client</span><span class="o">.</span><span class="n">cache</span><span class="p">)</span>
 
@@ -2470,7 +2470,7 @@ <h2 id="spotdl.console.entry_point.entry_point" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/index.html b/reference/console/index.html
index 2e3799837..ff6f9f323 100644
--- a/reference/console/index.html
+++ b/reference/console/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/console/">
       
       
-        <link rel="prev" href="../types/options/">
+        <link rel="prev" href="../download/progress_handler/">
       
       
         <link rel="next" href="save/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../download/" class="md-nav__link ">
+            <a href="../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../types/" class="md-nav__link ">
+            <a href="../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/album/" class="md-nav__link">
+      <a href="../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/saved/" class="md-nav__link">
+      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/result/" class="md-nav__link">
+      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/song/" class="md-nav__link">
+      <a href="../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/options/" class="md-nav__link">
+      <a href="../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -943,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="./" class="md-nav__link md-nav__link--active">
+            <a href="../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="save/" class="md-nav__link">
+      <a href="../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1004,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="url/" class="md-nav__link">
+      <a href="../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1025,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="meta/" class="md-nav__link">
+      <a href="../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1046,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="web/" class="md-nav__link">
+      <a href="../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1067,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="sync/" class="md-nav__link">
+      <a href="../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1088,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="download/" class="md-nav__link">
+      <a href="../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1109,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="entry_point/" class="md-nav__link">
+      <a href="../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1131,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1164,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/console/" class="md-nav__link">
+      <a href="../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/formatter/" class="md-nav__link">
+      <a href="../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/arguments/" class="md-nav__link">
+      <a href="../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/metadata/" class="md-nav__link">
+      <a href="../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/downloader/" class="md-nav__link">
+      <a href="../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/github/" class="md-nav__link">
+      <a href="../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/static/" class="md-nav__link">
+      <a href="../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/search/" class="md-nav__link">
+      <a href="../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/web/" class="md-nav__link">
+      <a href="../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1373,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/logging/" class="md-nav__link">
+      <a href="../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1394,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/spotify/" class="md-nav__link">
+      <a href="../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1415,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/matching/" class="md-nav__link">
+      <a href="../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1436,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/ffmpeg/" class="md-nav__link">
+      <a href="../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1457,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/m3u/" class="md-nav__link">
+      <a href="../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1478,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/config/" class="md-nav__link">
+      <a href="../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1499,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/lrc/" class="md-nav__link">
+      <a href="../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1520,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/archive/" class="md-nav__link">
+      <a href="../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1559,32 +1473,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/" class="md-nav__link ">
+            <a href="../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1508,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/base/" class="md-nav__link">
+      <a href="../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1764,32 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/audio/" class="md-nav__link ">
+            <a href="../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1800,11 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1821,11 +1731,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1835,6 +1745,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1842,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/piped/" class="md-nav__link">
+      <a href="save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1863,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/youtube/" class="md-nav__link">
+      <a href="url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1884,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1905,11 +1871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/base/" class="md-nav__link">
+      <a href="sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1926,11 +1892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1940,9 +1906,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2037,7 +2037,7 @@ <h2 id="spotdl.console.console_entry_point" class="doc doc-heading">
 <span class="normal">50</span>
 <span class="normal">51</span>
 <span class="normal">52</span>
-<span class="normal">53</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">console_entry_point</span><span class="p">():</span>
+<span class="normal">53</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">console_entry_point</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Entry point for the console. With profile flag, it runs the code with cProfile.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2119,7 +2119,7 @@ <h2 id="spotdl.console.console_entry_point" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/meta/index.html b/reference/console/meta/index.html
index 415cb6bd4..ad47baf5b 100644
--- a/reference/console/meta/index.html
+++ b/reference/console/meta/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/console/meta/">
       
       
-        <link rel="prev" href="../url/">
+        <link rel="prev" href="../sync/">
       
       
-        <link rel="next" href="../web/">
+        <link rel="next" href="../download/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -943,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1004,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1022,96 +928,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    meta
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.meta" class="md-nav__link">
-    <span class="md-ellipsis">
-      meta
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.meta.meta" class="md-nav__link">
-    <span class="md-ellipsis">
-      meta
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="meta">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.meta.meta--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.meta.meta--notes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Notes
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1124,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1145,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1166,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1187,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1209,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1226,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1242,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1262,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1283,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1304,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1325,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1346,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1367,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1388,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1409,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1430,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1451,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1472,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1493,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1514,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1535,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1556,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1577,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1598,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1637,32 +1473,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1672,45 +1508,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1719,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1740,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1761,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1782,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1803,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1842,32 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1878,11 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1899,11 +1731,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1913,6 +1745,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1920,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1941,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1962,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1983,15 +1871,114 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    meta
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    meta
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.meta" class="md-nav__link">
+    <span class="md-ellipsis">
+      meta
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.meta.meta" class="md-nav__link">
+    <span class="md-ellipsis">
+      meta
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="meta">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.meta.meta--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.meta.meta--notes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -2004,11 +1991,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2018,9 +2005,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2275,7 +2275,7 @@ <h5 id="spotdl.console.meta.meta--notes">Notes<a class="headerlink" href="#spotd
 <span class="normal">181</span>
 <span class="normal">182</span>
 <span class="normal">183</span>
-<span class="normal">184</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">meta</span><span class="p">(</span><span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">downloader</span><span class="p">:</span> <span class="n">Downloader</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">184</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">meta</span><span class="p">(</span><span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">downloader</span><span class="p">:</span> <span class="n">Downloader</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    This function applies metadata to the selected songs</span>
 <span class="sd">    based on the file name.</span>
@@ -2307,7 +2307,7 @@ <h5 id="spotdl.console.meta.meta--notes">Notes<a class="headerlink" href="#spotd
 
             <span class="n">paths</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">test_path</span><span class="p">)</span>
 
-    <span class="k">def</span> <span class="nf">process_file</span><span class="p">(</span><span class="n">file</span><span class="p">:</span> <span class="n">Path</span><span class="p">):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">process_file</span><span class="p">(</span><span class="n">file</span><span class="p">:</span> <span class="n">Path</span><span class="p">):</span>
         <span class="c1"># metadata of the file, url is present in the file.</span>
         <span class="n">song_meta</span> <span class="o">=</span> <span class="n">get_file_metadata</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;id3_separator&quot;</span><span class="p">])</span>
 
@@ -2403,7 +2403,7 @@ <h5 id="spotdl.console.meta.meta--notes">Notes<a class="headerlink" href="#spotd
                 <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Could not find lrc file for </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">song</span><span class="o">.</span><span class="n">display_name</span><span class="p">)</span>
         <span class="k">return</span> <span class="kc">None</span>
 
-    <span class="k">async</span> <span class="k">def</span> <span class="nf">pool_worker</span><span class="p">(</span><span class="n">file_path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+    <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">pool_worker</span><span class="p">(</span><span class="n">file_path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="k">async</span> <span class="k">with</span> <span class="n">downloader</span><span class="o">.</span><span class="n">semaphore</span><span class="p">:</span>
             <span class="c1"># The following function calls blocking code, which would block whole event loop.</span>
             <span class="c1"># Therefore it has to be called in a separate thread via ThreadPoolExecutor. This</span>
@@ -2506,7 +2506,7 @@ <h5 id="spotdl.console.meta.meta--notes">Notes<a class="headerlink" href="#spotd
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/save/index.html b/reference/console/save/index.html
index 1953b99ca..15f9fd5ac 100644
--- a/reference/console/save/index.html
+++ b/reference/console/save/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -943,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -980,96 +886,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    save
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.save" class="md-nav__link">
-    <span class="md-ellipsis">
-      save
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.save.save" class="md-nav__link">
-    <span class="md-ellipsis">
-      save
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="save">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.save.save--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.save.save--notes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Notes
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1082,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1103,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1124,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1145,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1166,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1187,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1209,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1226,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1242,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1262,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1283,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1304,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1325,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1346,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1367,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1388,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1409,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1430,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1451,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1472,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1493,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1514,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1535,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1556,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1577,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1598,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1637,32 +1473,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1672,45 +1508,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1719,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1740,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1761,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1782,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1803,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1842,32 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1878,11 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1899,15 +1731,170 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    save
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.save" class="md-nav__link">
+    <span class="md-ellipsis">
+      save
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.save.save" class="md-nav__link">
+    <span class="md-ellipsis">
+      save
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="save">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.save.save--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.save.save--notes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1920,11 +1907,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -1941,11 +1928,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1962,11 +1949,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -1983,11 +1970,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2004,11 +1991,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2018,9 +2005,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2214,7 +2214,7 @@ <h5 id="spotdl.console.save.save--notes">Notes<a class="headerlink" href="#spotd
 <span class="normal">120</span>
 <span class="normal">121</span>
 <span class="normal">122</span>
-<span class="normal">123</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">save</span><span class="p">(</span>
+<span class="normal">123</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">save</span><span class="p">(</span>
     <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">downloader</span><span class="p">:</span> <span class="n">Downloader</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
@@ -2248,7 +2248,7 @@ <h5 id="spotdl.console.save.save--notes">Notes<a class="headerlink" href="#spotd
     <span class="p">)</span>
     <span class="n">save_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">song</span><span class="o">.</span><span class="n">json</span> <span class="k">for</span> <span class="n">song</span> <span class="ow">in</span> <span class="n">songs</span><span class="p">]</span>
 
-    <span class="k">def</span> <span class="nf">process_song</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">process_song</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
         <span class="n">download_url</span> <span class="o">=</span> <span class="kc">None</span>
         <span class="k">if</span> <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;preload&quot;</span><span class="p">]:</span>
             <span class="k">try</span><span class="p">:</span>
@@ -2280,7 +2280,7 @@ <h5 id="spotdl.console.save.save--notes">Notes<a class="headerlink" href="#spotd
 
         <span class="k">return</span> <span class="p">{</span><span class="o">**</span><span class="n">song</span><span class="o">.</span><span class="n">json</span><span class="p">,</span> <span class="s2">&quot;download_url&quot;</span><span class="p">:</span> <span class="n">download_url</span><span class="p">,</span> <span class="s2">&quot;lyrics&quot;</span><span class="p">:</span> <span class="n">lyrics</span><span class="p">}</span>
 
-    <span class="k">async</span> <span class="k">def</span> <span class="nf">pool_worker</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
+    <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">pool_worker</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
         <span class="k">async</span> <span class="k">with</span> <span class="n">downloader</span><span class="o">.</span><span class="n">semaphore</span><span class="p">:</span>
             <span class="c1"># The following function calls blocking code, which would block whole event loop.</span>
             <span class="c1"># Therefore it has to be called in a separate thread via ThreadPoolExecutor. This</span>
@@ -2305,7 +2305,7 @@ <h5 id="spotdl.console.save.save--notes">Notes<a class="headerlink" href="#spotd
         <span class="n">gen_m3u_files</span><span class="p">(</span>
             <span class="n">songs</span><span class="p">,</span>
             <span class="n">m3u_file</span><span class="p">,</span>
-            <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;m3u_output&quot;</span><span class="p">],</span>
+            <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">],</span>
             <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;format&quot;</span><span class="p">],</span>
             <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;restrict&quot;</span><span class="p">],</span>
             <span class="kc">False</span><span class="p">,</span>
@@ -2386,7 +2386,7 @@ <h5 id="spotdl.console.save.save--notes">Notes<a class="headerlink" href="#spotd
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/sync/index.html b/reference/console/sync/index.html
index 4f5886df0..2100f2646 100644
--- a/reference/console/sync/index.html
+++ b/reference/console/sync/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/console/sync/">
       
       
-        <link rel="prev" href="../web/">
+        <link rel="prev" href="../entry_point/">
       
       
-        <link rel="next" href="../download/">
+        <link rel="next" href="../meta/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -744,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -801,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -822,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -843,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -864,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -885,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -928,12 +1037,18 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
-    
-  
   
   
     
@@ -943,36 +1058,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1004,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1025,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1046,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1064,87 +1179,18 @@
                 
   
   
-    
-  
-  
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    sync
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.sync" class="md-nav__link">
-    <span class="md-ellipsis">
-      sync
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.sync.sync" class="md-nav__link">
-    <span class="md-ellipsis">
-      sync
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="sync">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.sync.sync--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1157,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../download/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1178,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../entry_point/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1192,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1253,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1274,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1295,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1316,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1337,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1379,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1400,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1421,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1435,26 +1448,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1463,11 +1509,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    options
   </span>
   
 
@@ -1484,11 +1530,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1505,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1526,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1547,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1568,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1589,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1628,78 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1710,74 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1794,11 +1731,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1820,6 +1757,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1829,36 +1768,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1869,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1890,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1911,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1929,18 +1868,87 @@
                 
   
   
+    
+  
   
   
-    <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    sync
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.sync" class="md-nav__link">
+    <span class="md-ellipsis">
+      sync
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.sync.sync" class="md-nav__link">
+    <span class="md-ellipsis">
+      sync
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="sync">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.sync.sync--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1953,11 +1961,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -1974,11 +1982,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -1995,11 +2003,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2023,14 +2031,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2340,7 +2340,7 @@ <h5 id="spotdl.console.sync.sync--arguments">Arguments<a class="headerlink" href
 <span class="normal">258</span>
 <span class="normal">259</span>
 <span class="normal">260</span>
-<span class="normal">261</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">sync</span><span class="p">(</span>
+<span class="normal">261</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">sync</span><span class="p">(</span>
     <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">downloader</span><span class="p">:</span> <span class="n">Downloader</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
@@ -2404,7 +2404,7 @@ <h5 id="spotdl.console.sync.sync--arguments">Arguments<a class="headerlink" href
             <span class="n">gen_m3u_files</span><span class="p">(</span>
                 <span class="n">songs_list</span><span class="p">,</span>
                 <span class="n">m3u_file</span><span class="p">,</span>
-                <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;m3u_output&quot;</span><span class="p">],</span>
+                <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">],</span>
                 <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;format&quot;</span><span class="p">],</span>
                 <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;restrict&quot;</span><span class="p">],</span>
                 <span class="kc">False</span><span class="p">,</span>
@@ -2554,7 +2554,7 @@ <h5 id="spotdl.console.sync.sync--arguments">Arguments<a class="headerlink" href
             <span class="n">gen_m3u_files</span><span class="p">(</span>
                 <span class="n">songs_playlist</span><span class="p">,</span>
                 <span class="n">m3u_file</span><span class="p">,</span>
-                <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;m3u_output&quot;</span><span class="p">],</span>
+                <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">],</span>
                 <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;format&quot;</span><span class="p">],</span>
                 <span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;restrict&quot;</span><span class="p">],</span>
                 <span class="kc">False</span><span class="p">,</span>
@@ -2649,7 +2649,7 @@ <h5 id="spotdl.console.sync.sync--arguments">Arguments<a class="headerlink" href
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/url/index.html b/reference/console/url/index.html
index b72b1b5a8..38e04afd4 100644
--- a/reference/console/url/index.html
+++ b/reference/console/url/index.html
@@ -18,11 +18,11 @@
         <link rel="prev" href="../save/">
       
       
-        <link rel="next" href="../meta/">
+        <link rel="next" href="../entry_point/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -943,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1001,87 +907,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    url
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.url" class="md-nav__link">
-    <span class="md-ellipsis">
-      url
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.url.url" class="md-nav__link">
-    <span class="md-ellipsis">
-      url
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="url">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.url.url--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1094,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1115,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1136,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1157,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1178,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1200,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1217,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1233,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1253,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1274,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1295,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1316,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1337,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1358,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1379,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1400,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1421,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1442,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1463,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1484,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1505,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1526,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1547,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1568,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1589,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1628,32 +1473,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1663,45 +1508,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1710,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1731,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1752,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1773,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1794,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1833,32 +1674,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1869,11 +1710,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1890,11 +1731,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1904,6 +1745,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1911,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1929,14 +1826,104 @@
                 
   
   
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    url
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    url
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.url" class="md-nav__link">
+    <span class="md-ellipsis">
+      url
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.url.url" class="md-nav__link">
+    <span class="md-ellipsis">
+      url
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="url">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.url.url--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1953,11 +1940,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -1974,11 +1961,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -1995,11 +1982,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2009,9 +1996,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2144,7 +2144,7 @@ <h5 id="spotdl.console.url.url--arguments">Arguments<a class="headerlink" href="
 <span class="normal">62</span>
 <span class="normal">63</span>
 <span class="normal">64</span>
-<span class="normal">65</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">url</span><span class="p">(</span>
+<span class="normal">65</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">url</span><span class="p">(</span>
     <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">downloader</span><span class="p">:</span> <span class="n">Downloader</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
@@ -2165,7 +2165,7 @@ <h5 id="spotdl.console.url.url--arguments">Arguments<a class="headerlink" href="
         <span class="n">playlist_retain_track_cover</span><span class="o">=</span><span class="n">downloader</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;playlist_retain_track_cover&quot;</span><span class="p">],</span>
     <span class="p">)</span>
 
-    <span class="k">def</span> <span class="nf">process_song</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">process_song</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
         <span class="k">try</span><span class="p">:</span>
             <span class="n">data</span> <span class="o">=</span> <span class="n">downloader</span><span class="o">.</span><span class="n">search</span><span class="p">(</span><span class="n">song</span><span class="p">)</span>
             <span class="k">if</span> <span class="n">data</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
@@ -2182,7 +2182,7 @@ <h5 id="spotdl.console.url.url--arguments">Arguments<a class="headerlink" href="
 
         <span class="k">return</span> <span class="kc">None</span>
 
-    <span class="k">async</span> <span class="k">def</span> <span class="nf">pool_worker</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
+    <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">pool_worker</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
         <span class="k">async</span> <span class="k">with</span> <span class="n">downloader</span><span class="o">.</span><span class="n">semaphore</span><span class="p">:</span>
             <span class="c1"># The following function calls blocking code, which would block whole event loop.</span>
             <span class="c1"># Therefore it has to be called in a separate thread via ThreadPoolExecutor. This</span>
@@ -2260,7 +2260,7 @@ <h5 id="spotdl.console.url.url--arguments">Arguments<a class="headerlink" href="
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/console/web/index.html b/reference/console/web/index.html
index 91d422936..9c84e93cf 100644
--- a/reference/console/web/index.html
+++ b/reference/console/web/index.html
@@ -15,14 +15,12 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/console/web/">
       
       
-        <link rel="prev" href="../meta/">
+        <link rel="prev" href="../download/">
       
       
-        <link rel="next" href="../sync/">
-      
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +28,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +192,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +341,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +651,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +671,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +681,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +692,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +728,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +749,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +770,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +791,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +812,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,8 +838,6 @@
                 
   
   
-    
-  
   
   
     
@@ -943,36 +847,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +887,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1004,11 +908,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1025,11 +929,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1043,87 +947,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    web
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.web" class="md-nav__link">
-    <span class="md-ellipsis">
-      web
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.console.web.web" class="md-nav__link">
-    <span class="md-ellipsis">
-      web
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="web">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.console.web.web--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1136,11 +971,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1157,11 +992,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1178,11 +1013,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1200,6 +1035,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1217,7 +1060,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1233,14 +1076,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1253,11 +1096,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1274,11 +1117,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1295,11 +1138,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1316,11 +1159,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1337,11 +1180,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1358,11 +1201,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1379,11 +1222,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1400,11 +1243,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1421,11 +1264,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1442,11 +1285,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1463,11 +1306,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1484,11 +1327,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1505,11 +1348,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1526,11 +1369,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1547,11 +1390,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1568,11 +1411,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1589,11 +1432,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1628,32 +1471,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1663,45 +1506,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1710,11 +1549,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1731,11 +1570,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1752,11 +1591,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1773,11 +1612,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1794,11 +1633,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1833,32 +1672,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1869,11 +1708,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1890,11 +1729,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1904,6 +1743,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1911,11 +1806,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1932,11 +1827,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1953,11 +1848,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1974,11 +1869,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1995,11 +1890,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2009,8 +1904,111 @@
 
               
             
-          </ul>
-        </nav>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.web" class="md-nav__link">
+    <span class="md-ellipsis">
+      web
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.console.web.web" class="md-nav__link">
+    <span class="md-ellipsis">
+      web
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="web">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.console.web.web--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
       
     </li>
   
@@ -2225,7 +2223,7 @@ <h5 id="spotdl.console.web.web--arguments">Arguments<a class="headerlink" href="
 <span class="normal">159</span>
 <span class="normal">160</span>
 <span class="normal">161</span>
-<span class="normal">162</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">web</span><span class="p">(</span><span class="n">web_settings</span><span class="p">:</span> <span class="n">WebOptions</span><span class="p">,</span> <span class="n">downloader_settings</span><span class="p">:</span> <span class="n">DownloaderOptions</span><span class="p">):</span>
+<span class="normal">162</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">web</span><span class="p">(</span><span class="n">web_settings</span><span class="p">:</span> <span class="n">WebOptions</span><span class="p">,</span> <span class="n">downloader_settings</span><span class="p">:</span> <span class="n">DownloaderOptions</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Run the web server.</span>
 
@@ -2421,7 +2419,7 @@ <h5 id="spotdl.console.web.web--arguments">Arguments<a class="headerlink" href="
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/download/downloader/index.html b/reference/download/downloader/index.html
index 05c309f31..9836dabed 100644
--- a/reference/download/downloader/index.html
+++ b/reference/download/downloader/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,8 +635,6 @@
                 
   
   
-    
-  
   
   
     
@@ -646,20 +644,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -672,10 +670,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,321 +681,127 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
+    
+    
+    
       
       
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
       
-      <a href="./" class="md-nav__link md-nav__link--active">
         
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    downloader
+    lyrics
   </span>
   
 
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.downloader" class="md-nav__link">
-    <span class="md-ellipsis">
-      downloader
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader" class="md-nav__link">
-    <span class="md-ellipsis">
-      Downloader
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Downloader">
-      <ul class="md-nav__list">
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader--notes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Notes
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.download_multiple_songs" class="md-nav__link">
-    <span class="md-ellipsis">
-      download_multiple_songs
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="download_multiple_songs">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.download_multiple_songs--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.download_multiple_songs--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.download_song" class="md-nav__link">
-    <span class="md-ellipsis">
-      download_song
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    synced
+  </span>
   
-    <nav class="md-nav" aria-label="download_song">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.download_song--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.download_song--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.pool_download" class="md-nav__link">
-    <span class="md-ellipsis">
-      pool_download
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="pool_download">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.pool_download--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.pool_download--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.pool_download--notes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Notes
-    </span>
-  </a>
-  
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search" class="md-nav__link">
-    <span class="md-ellipsis">
-      search
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    musixmatch
+  </span>
   
-    <nav class="md-nav" aria-label="search">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_and_download" class="md-nav__link">
-    <span class="md-ellipsis">
-      search_and_download
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="search_and_download">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_and_download--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_and_download--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_and_download--notes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Notes
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      search_lyrics
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="search_lyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.Downloader.search_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.downloader.DownloaderError" class="md-nav__link">
-    <span class="md-ellipsis">
-      DownloaderError
-    </span>
-  </a>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    base
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1010,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    genius
   </span>
   
 
@@ -1049,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1085,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -1106,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -1127,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -1148,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -1169,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -1190,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1211,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -1233,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1250,32 +1062,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1286,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1307,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1328,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1349,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1370,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1391,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1412,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1426,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1487,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1508,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1529,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1550,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1571,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1613,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1634,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1655,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1669,26 +1448,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1697,11 +1509,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    options
   </span>
   
 
@@ -1718,11 +1530,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1739,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1760,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1781,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1802,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1823,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1849,6 +1661,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1858,36 +1672,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1895,127 +1709,321 @@
                 
   
   
+    
   
   
-    
-    
-    
+  
+    <li class="md-nav__item md-nav__item--active">
       
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
       
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
       
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
-        
-          
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
           
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    downloader
   </span>
   
 
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
   
+  <span class="md-ellipsis">
+    downloader
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.downloader" class="md-nav__link">
+    <span class="md-ellipsis">
+      downloader
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader" class="md-nav__link">
+    <span class="md-ellipsis">
+      Downloader
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Downloader">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader--notes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.download_multiple_songs" class="md-nav__link">
+    <span class="md-ellipsis">
+      download_multiple_songs
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="download_multiple_songs">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.download_multiple_songs--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.download_multiple_songs--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.download_song" class="md-nav__link">
+    <span class="md-ellipsis">
+      download_song
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="download_song">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.download_song--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.download_song--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.pool_download" class="md-nav__link">
+    <span class="md-ellipsis">
+      pool_download
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="pool_download">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.pool_download--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.pool_download--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.pool_download--notes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search" class="md-nav__link">
+    <span class="md-ellipsis">
+      search
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+    <nav class="md-nav" aria-label="search">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_and_download" class="md-nav__link">
+    <span class="md-ellipsis">
+      search_and_download
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="search_and_download">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_and_download--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_and_download--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_and_download--notes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      search_lyrics
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="search_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.Downloader.search_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    genius
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.downloader.DownloaderError" class="md-nav__link">
+    <span class="md-ellipsis">
+      DownloaderError
+    </span>
+  </a>
   
-
-      </a>
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -2028,11 +2036,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -2067,32 +2075,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2103,11 +2111,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2124,11 +2132,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2145,11 +2153,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2166,11 +2174,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2187,11 +2195,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2208,11 +2216,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2229,11 +2237,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2257,14 +2265,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2487,7 +2487,7 @@ <h5 id="spotdl.download.downloader.Downloader--notes">Notes<a class="headerlink"
 <span class="normal">236</span>
 <span class="normal">237</span>
 <span class="normal">238</span>
-<span class="normal">239</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">239</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">settings</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">DownloaderOptionalOptions</span><span class="p">,</span> <span class="n">DownloaderOptions</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
     <span class="n">loop</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">asyncio</span><span class="o">.</span><span class="n">AbstractEventLoop</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2765,7 +2765,7 @@ <h6 id="spotdl.download.downloader.Downloader.download_multiple_songs--returns">
 <span class="normal">353</span>
 <span class="normal">354</span>
 <span class="normal">355</span>
-<span class="normal">356</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download_multiple_songs</span><span class="p">(</span>
+<span class="normal">356</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download_multiple_songs</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -2849,7 +2849,7 @@ <h6 id="spotdl.download.downloader.Downloader.download_multiple_songs--returns">
         <span class="n">gen_m3u_files</span><span class="p">(</span>
             <span class="n">song_list</span><span class="p">,</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;m3u&quot;</span><span class="p">],</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;m3u_output&quot;</span><span class="p">],</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">],</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;format&quot;</span><span class="p">],</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;restrict&quot;</span><span class="p">],</span>
             <span class="kc">False</span><span class="p">,</span>
@@ -2908,7 +2908,7 @@ <h6 id="spotdl.download.downloader.Downloader.download_song--returns">Returns<a
 <span class="normal">253</span>
 <span class="normal">254</span>
 <span class="normal">255</span>
-<span class="normal">256</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download_song</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
+<span class="normal">256</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download_song</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Download a single song.</span>
 
@@ -2978,7 +2978,7 @@ <h6 id="spotdl.download.downloader.Downloader.pool_download--notes">Notes<a clas
 <span class="normal">372</span>
 <span class="normal">373</span>
 <span class="normal">374</span>
-<span class="normal">375</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span> <span class="nf">pool_download</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
+<span class="normal">375</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">pool_download</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Run asynchronous task in a pool to make sure that all processes.</span>
 
@@ -3043,7 +3043,7 @@ <h6 id="spotdl.download.downloader.Downloader.search--returns">Returns<a class="
 <span class="normal">392</span>
 <span class="normal">393</span>
 <span class="normal">394</span>
-<span class="normal">395</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">395</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for a song using all available providers.</span>
 
@@ -3552,7 +3552,7 @@ <h6 id="spotdl.download.downloader.Downloader.search_and_download--notes">Notes<
 <span class="normal">879</span>
 <span class="normal">880</span>
 <span class="normal">881</span>
-<span class="normal">882</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search_and_download</span><span class="p">(</span>  <span class="c1"># pylint: disable=R0911</span>
+<span class="normal">882</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search_and_download</span><span class="p">(</span>  <span class="c1"># pylint: disable=R0911</span>
     <span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3902,7 +3902,7 @@ <h6 id="spotdl.download.downloader.Downloader.search_and_download--notes">Notes<
 
                 <span class="k">raise</span> <span class="n">DownloaderError</span><span class="p">(</span>
                     <span class="sa">f</span><span class="s2">&quot;Could not remove temp file: </span><span class="si">{</span><span class="n">temp_file</span><span class="si">}</span><span class="s2">, possible duplicate song&quot;</span>
-                <span class="p">)</span> <span class="kn">from</span> <span class="nn">exc</span>
+                <span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exc</span>
 
         <span class="k">if</span> <span class="ow">not</span> <span class="n">success</span> <span class="ow">and</span> <span class="n">result</span><span class="p">:</span>
             <span class="c1"># If the conversion failed and there is an error message</span>
@@ -3981,7 +3981,7 @@ <h6 id="spotdl.download.downloader.Downloader.search_and_download--notes">Notes<
         <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exception</span><span class="p">:</span>
             <span class="k">raise</span> <span class="n">MetadataError</span><span class="p">(</span>
                 <span class="s2">&quot;Failed to embed metadata to the song&quot;</span>
-            <span class="p">)</span> <span class="kn">from</span> <span class="nn">exception</span>
+            <span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exception</span>
 
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">settings</span><span class="p">[</span><span class="s2">&quot;generate_lrc&quot;</span><span class="p">]:</span>
             <span class="n">generate_lrc</span><span class="p">(</span><span class="n">song</span><span class="p">,</span> <span class="n">output_file</span><span class="p">)</span>
@@ -4065,7 +4065,7 @@ <h6 id="spotdl.download.downloader.Downloader.search_lyrics--returns">Returns<a
 <span class="normal">420</span>
 <span class="normal">421</span>
 <span class="normal">422</span>
-<span class="normal">423</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">423</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for lyrics using all available providers.</span>
 
@@ -4197,7 +4197,7 @@ <h2 id="spotdl.download.downloader.DownloaderError" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/download/index.html b/reference/download/index.html
index 551295121..ae0e73954 100644
--- a/reference/download/index.html
+++ b/reference/download/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/download/">
       
       
-        <link rel="prev" href="../">
+        <link rel="prev" href="../types/album/">
       
       
         <link rel="next" href="downloader/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,8 +635,6 @@
                 
   
   
-    
-  
   
   
     
@@ -646,36 +644,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="./" class="md-nav__link md-nav__link--active">
+            <a href="../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -685,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -746,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../types/" class="md-nav__link ">
+            <a href="../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/album/" class="md-nav__link">
+      <a href="../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -845,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/saved/" class="md-nav__link">
+      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -866,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/result/" class="md-nav__link">
+      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -887,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/song/" class="md-nav__link">
+      <a href="../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -908,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/options/" class="md-nav__link">
+      <a href="../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -947,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../console/" class="md-nav__link ">
+            <a href="../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/save/" class="md-nav__link">
+      <a href="../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1004,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/url/" class="md-nav__link">
+      <a href="../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1025,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/meta/" class="md-nav__link">
+      <a href="../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1046,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/web/" class="md-nav__link">
+      <a href="../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1067,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/sync/" class="md-nav__link">
+      <a href="../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1088,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/download/" class="md-nav__link">
+      <a href="../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1109,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/entry_point/" class="md-nav__link">
+      <a href="../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1131,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1164,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/console/" class="md-nav__link">
+      <a href="../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/formatter/" class="md-nav__link">
+      <a href="../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/arguments/" class="md-nav__link">
+      <a href="../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/metadata/" class="md-nav__link">
+      <a href="../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/downloader/" class="md-nav__link">
+      <a href="../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/github/" class="md-nav__link">
+      <a href="../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/static/" class="md-nav__link">
+      <a href="../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/search/" class="md-nav__link">
+      <a href="../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/web/" class="md-nav__link">
+      <a href="../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1373,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/logging/" class="md-nav__link">
+      <a href="../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1394,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/spotify/" class="md-nav__link">
+      <a href="../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1415,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/matching/" class="md-nav__link">
+      <a href="../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1436,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/ffmpeg/" class="md-nav__link">
+      <a href="../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1457,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/m3u/" class="md-nav__link">
+      <a href="../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1478,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/config/" class="md-nav__link">
+      <a href="../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1499,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/lrc/" class="md-nav__link">
+      <a href="../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1520,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/archive/" class="md-nav__link">
+      <a href="../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1559,32 +1473,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/" class="md-nav__link ">
+            <a href="../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1508,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/base/" class="md-nav__link">
+      <a href="../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,6 +1661,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1760,36 +1672,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/audio/" class="md-nav__link ">
+            <a href="./" class="md-nav__link md-nav__link--active">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1800,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1821,11 +1733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1835,6 +1747,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1842,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/piped/" class="md-nav__link">
+      <a href="../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1863,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/youtube/" class="md-nav__link">
+      <a href="../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1884,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1905,11 +1871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/base/" class="md-nav__link">
+      <a href="../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1926,11 +1892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1940,9 +1906,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2071,7 +2071,7 @@ <h1>download</h1>
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/download/progress_handler/index.html b/reference/download/progress_handler/index.html
index 352f04d37..1d83d069c 100644
--- a/reference/download/progress_handler/index.html
+++ b/reference/download/progress_handler/index.html
@@ -18,11 +18,11 @@
         <link rel="prev" href="../downloader/">
       
       
-        <link rel="next" href="../../types/">
+        <link rel="next" href="../../console/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,8 +635,6 @@
                 
   
   
-    
-  
   
   
     
@@ -646,20 +644,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -672,10 +670,56 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -686,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -704,491 +748,289 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    azlyrics
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler" class="md-nav__link">
-    <span class="md-ellipsis">
-      progress_handler
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProgressHandler
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    base
+  </span>
   
-    <nav class="md-nav" aria-label="ProgressHandler">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.add_song" class="md-nav__link">
-    <span class="md-ellipsis">
-      add_song
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="add_song">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.add_song--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.close" class="md-nav__link">
-    <span class="md-ellipsis">
-      close
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.get_new_tracker" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_new_tracker
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="get_new_tracker">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    genius
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.set_song_count" class="md-nav__link">
-    <span class="md-ellipsis">
-      set_song_count
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="set_song_count">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.set_song_count--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.set_songs" class="md-nav__link">
-    <span class="md-ellipsis">
-      set_songs
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="set_songs">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.set_songs--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
-      </ul>
-    </nav>
-  
-</li>
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandler.update_overall" class="md-nav__link">
-    <span class="md-ellipsis">
-      update_overall
-    </span>
-  </a>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/audio/" class="md-nav__link ">
+              
   
-</li>
+  <span class="md-ellipsis">
+    audio
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-      </ul>
-    </nav>
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            audio
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.ProgressHandlerError" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProgressHandlerError
-    </span>
-  </a>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SizedTextColumn" class="md-nav__link">
-    <span class="md-ellipsis">
-      SizedTextColumn
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="SizedTextColumn">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SizedTextColumn--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SizedTextColumn.render" class="md-nav__link">
-    <span class="md-ellipsis">
-      render
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="render">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SizedTextColumn.render--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    piped
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SizedTextColumn.render--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker" class="md-nav__link">
-    <span class="md-ellipsis">
-      SongTracker
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="SongTracker">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook" class="md-nav__link">
-    <span class="md-ellipsis">
-      ffmpeg_progress_hook
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="ffmpeg_progress_hook">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    youtube
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_complete" class="md-nav__link">
-    <span class="md-ellipsis">
-      notify_complete
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="notify_complete">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_complete--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_conversion_complete" class="md-nav__link">
-    <span class="md-ellipsis">
-      notify_conversion_complete
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="notify_conversion_complete">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_conversion_complete--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    soundcloud
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_complete" class="md-nav__link">
-    <span class="md-ellipsis">
-      notify_download_complete
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label="notify_download_complete">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_complete--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_skip" class="md-nav__link">
-    <span class="md-ellipsis">
-      notify_download_skip
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="notify_download_skip">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_skip--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_error" class="md-nav__link">
-    <span class="md-ellipsis">
-      notify_error
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    bandcamp
+  </span>
   
-    <nav class="md-nav" aria-label="notify_error">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.notify_error--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      update
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="update">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.update--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook" class="md-nav__link">
-    <span class="md-ellipsis">
-      yt_dlp_progress_hook
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="yt_dlp_progress_hook">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    ytmusic
+  </span>
   
-</li>
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    sliderkz
+  </span>
   
-</nav>
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
       
     </li>
   
@@ -1225,11 +1067,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    utils
   </span>
   
 
@@ -1245,7 +1087,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            types
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1256,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    spotify
   </span>
   
 
@@ -1277,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    m3u
   </span>
   
 
@@ -1298,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    metadata
   </span>
   
 
@@ -1319,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    logging
   </span>
   
 
@@ -1340,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    static
   </span>
   
 
@@ -1361,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    matching
   </span>
   
 
@@ -1382,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    search
   </span>
   
 
@@ -1396,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    console
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            console
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1457,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    archive
   </span>
   
 
@@ -1478,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    lrc
   </span>
   
 
@@ -1499,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    config
   </span>
   
 
@@ -1520,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    arguments
   </span>
   
 
@@ -1541,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    console
   </span>
   
 
@@ -1562,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    github
   </span>
   
 
@@ -1583,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    web
   </span>
   
 
@@ -1597,60 +1406,6 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    utils
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
               
                 
   
@@ -1658,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    ffmpeg
   </span>
   
 
@@ -1693,22 +1448,9 @@
 
               
             
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    arguments
-  </span>
-  
-
-      </a>
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1720,20 +1462,45 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    metadata
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1742,11 +1509,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    options
   </span>
   
 
@@ -1763,11 +1530,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    saved
   </span>
   
 
@@ -1784,11 +1551,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    artist
   </span>
   
 
@@ -1805,11 +1572,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    result
   </span>
   
 
@@ -1826,11 +1593,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    playlist
   </span>
   
 
@@ -1847,11 +1614,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    song
   </span>
   
 
@@ -1868,11 +1635,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    album
   </span>
   
 
@@ -1882,22 +1649,9 @@
 
               
             
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    matching
-  </span>
-  
-
-      </a>
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1907,22 +1661,49 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
         
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    ffmpeg
+    download
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1931,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    downloader
   </span>
   
 
@@ -1949,265 +1730,492 @@
                 
   
   
+    
+  
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
-        
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    config
+    progress_handler
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    lrc
+    progress_handler
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
-  
-  
-  
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
-    <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
-        
   
-  <span class="md-ellipsis">
-    archive
-  </span>
   
-
-      </a>
-    </li>
   
-
-              
-            
-          </ul>
-        </nav>
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
-    </li>
+        <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler" class="md-nav__link">
+    <span class="md-ellipsis">
+      progress_handler
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler" class="md-nav__link">
+    <span class="md-ellipsis">
+      ProgressHandler
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="ProgressHandler">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.add_song" class="md-nav__link">
+    <span class="md-ellipsis">
+      add_song
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="add_song">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.add_song--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
+</li>
         
+      </ul>
+    </nav>
+  
+</li>
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.close" class="md-nav__link">
+    <span class="md-ellipsis">
+      close
+    </span>
+  </a>
+  
+</li>
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.get_new_tracker" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_new_tracker
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    providers
-  </span>
+    <nav class="md-nav" aria-label="get_new_tracker">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
+</li>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.set_song_count" class="md-nav__link">
+    <span class="md-ellipsis">
+      set_song_count
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="set_song_count">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.set_song_count--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
+</li>
         
+      </ul>
+    </nav>
+  
+</li>
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.set_songs" class="md-nav__link">
+    <span class="md-ellipsis">
+      set_songs
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="set_songs">
+      <ul class="md-nav__list">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.set_songs--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    lyrics
-  </span>
+</li>
+        
+      </ul>
+    </nav>
   
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
+</li>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandler.update_overall" class="md-nav__link">
+    <span class="md-ellipsis">
+      update_overall
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.ProgressHandlerError" class="md-nav__link">
+    <span class="md-ellipsis">
+      ProgressHandlerError
+    </span>
+  </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SizedTextColumn" class="md-nav__link">
+    <span class="md-ellipsis">
+      SizedTextColumn
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+    <nav class="md-nav" aria-label="SizedTextColumn">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SizedTextColumn--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    synced
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SizedTextColumn.render" class="md-nav__link">
+    <span class="md-ellipsis">
+      render
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+    <nav class="md-nav" aria-label="render">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SizedTextColumn.render--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SizedTextColumn.render--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker" class="md-nav__link">
+    <span class="md-ellipsis">
+      SongTracker
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="SongTracker">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook" class="md-nav__link">
+    <span class="md-ellipsis">
+      ffmpeg_progress_hook
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="ffmpeg_progress_hook">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_complete" class="md-nav__link">
+    <span class="md-ellipsis">
+      notify_complete
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
+    <nav class="md-nav" aria-label="notify_complete">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_complete--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_conversion_complete" class="md-nav__link">
+    <span class="md-ellipsis">
+      notify_conversion_complete
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="notify_conversion_complete">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_conversion_complete--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_complete" class="md-nav__link">
+    <span class="md-ellipsis">
+      notify_download_complete
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+    <nav class="md-nav" aria-label="notify_download_complete">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_complete--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
+</li>
+        
+      </ul>
+    </nav>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_skip" class="md-nav__link">
+    <span class="md-ellipsis">
+      notify_download_skip
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="notify_download_skip">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_download_skip--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_error" class="md-nav__link">
+    <span class="md-ellipsis">
+      notify_error
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="notify_error">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.notify_error--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    genius
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.update" class="md-nav__link">
+    <span class="md-ellipsis">
+      update
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+    <nav class="md-nav" aria-label="update">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.update--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook" class="md-nav__link">
+    <span class="md-ellipsis">
+      yt_dlp_progress_hook
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="yt_dlp_progress_hook">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    base
-  </span>
+</li>
+      
+    </ul>
   
-
-      </a>
+</nav>
+      
     </li>
   
 
@@ -2238,32 +2246,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2274,11 +2282,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2295,11 +2303,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2316,11 +2324,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2337,11 +2345,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2358,11 +2366,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2379,11 +2387,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2400,11 +2408,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2428,14 +2436,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2560,7 +2560,7 @@ <h5 id="spotdl.download.progress_handler.ProgressHandler--arguments">Arguments<a
 <span class="normal">154</span>
 <span class="normal">155</span>
 <span class="normal">156</span>
-<span class="normal">157</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">157</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">simple_tui</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
     <span class="n">update_callback</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Callable</span><span class="p">[[</span><span class="n">Any</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span> <span class="kc">None</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2654,7 +2654,7 @@ <h6 id="spotdl.download.progress_handler.ProgressHandler.add_song--arguments">Ar
 <span class="normal">165</span>
 <span class="normal">166</span>
 <span class="normal">167</span>
-<span class="normal">168</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">add_song</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">168</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">add_song</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Adds a song to the list of songs.</span>
 
@@ -2693,7 +2693,7 @@ <h3 id="spotdl.download.progress_handler.ProgressHandler.close" class="doc doc-h
 <span class="normal">244</span>
 <span class="normal">245</span>
 <span class="normal">246</span>
-<span class="normal">247</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">close</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">247</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">close</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Close the Tui Progress Handler.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2742,7 +2742,7 @@ <h6 id="spotdl.download.progress_handler.ProgressHandler.get_new_tracker--return
 <span class="normal">234</span>
 <span class="normal">235</span>
 <span class="normal">236</span>
-<span class="normal">237</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_new_tracker</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;SongTracker&quot;</span><span class="p">:</span>
+<span class="normal">237</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_new_tracker</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;SongTracker&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get a new progress tracker.</span>
 
@@ -2800,7 +2800,7 @@ <h6 id="spotdl.download.progress_handler.ProgressHandler.set_song_count--argumen
 <span class="normal">199</span>
 <span class="normal">200</span>
 <span class="normal">201</span>
-<span class="normal">202</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">set_song_count</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">count</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">202</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">set_song_count</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">count</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Set the number of songs to download.</span>
 
@@ -2856,7 +2856,7 @@ <h6 id="spotdl.download.progress_handler.ProgressHandler.set_songs--arguments">A
 <span class="normal">176</span>
 <span class="normal">177</span>
 <span class="normal">178</span>
-<span class="normal">179</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">set_songs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">179</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">set_songs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Sets the list of songs to be downloaded.</span>
 
@@ -2907,7 +2907,7 @@ <h3 id="spotdl.download.progress_handler.ProgressHandler.update_overall" class="
 <span class="normal">221</span>
 <span class="normal">222</span>
 <span class="normal">223</span>
-<span class="normal">224</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update_overall</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">224</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">update_overall</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Update the overall progress bar.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3035,7 +3035,7 @@ <h5 id="spotdl.download.progress_handler.SizedTextColumn--arguments">Arguments<a
 <span class="normal">74</span>
 <span class="normal">75</span>
 <span class="normal">76</span>
-<span class="normal">77</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">77</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">text_format</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">style</span><span class="p">:</span> <span class="n">StyleType</span> <span class="o">=</span> <span class="s2">&quot;none&quot;</span><span class="p">,</span>
@@ -3124,7 +3124,7 @@ <h6 id="spotdl.download.progress_handler.SizedTextColumn.render--returns">Return
 <span class="normal">96</span>
 <span class="normal">97</span>
 <span class="normal">98</span>
-<span class="normal">99</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">render</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">task</span><span class="p">:</span> <span class="n">Task</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Text</span><span class="p">:</span>
+<span class="normal">99</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">render</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">task</span><span class="p">:</span> <span class="n">Task</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Text</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Render the Column.</span>
 
@@ -3217,7 +3217,7 @@ <h5 id="spotdl.download.progress_handler.SongTracker--arguments">Arguments<a cla
 <span class="normal">283</span>
 <span class="normal">284</span>
 <span class="normal">285</span>
-<span class="normal">286</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">286</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initialize the Tui Song Tracker.</span>
 
@@ -3296,7 +3296,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook--argum
 <span class="normal">416</span>
 <span class="normal">417</span>
 <span class="normal">418</span>
-<span class="normal">419</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">ffmpeg_progress_hook</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">progress</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">419</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">ffmpeg_progress_hook</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">progress</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Updates the progress.</span>
 
@@ -3344,7 +3344,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.notify_complete--arguments"
 <span class="normal">390</span>
 <span class="normal">391</span>
 <span class="normal">392</span>
-<span class="normal">393</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">notify_complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Done&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">393</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">notify_complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Done&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Notifies the progress handler that the song has been downloaded and converted.</span>
 
@@ -3388,7 +3388,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.notify_conversion_complete-
 <span class="normal">379</span>
 <span class="normal">380</span>
 <span class="normal">381</span>
-<span class="normal">382</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">notify_conversion_complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Embedding metadata&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">382</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">notify_conversion_complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Embedding metadata&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Notifies the progress handler that the song has been converted.</span>
 
@@ -3432,7 +3432,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.notify_download_complete--a
 <span class="normal">368</span>
 <span class="normal">369</span>
 <span class="normal">370</span>
-<span class="normal">371</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">notify_download_complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Converting&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">371</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">notify_download_complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Converting&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Notifies the progress handler that the song has been downloaded.</span>
 
@@ -3476,7 +3476,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.notify_download_skip--argum
 <span class="normal">401</span>
 <span class="normal">402</span>
 <span class="normal">403</span>
-<span class="normal">404</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">notify_download_skip</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Skipped&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">404</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">notify_download_skip</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;Skipped&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Notifies the progress handler that the song has been skipped.</span>
 
@@ -3532,7 +3532,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.notify_error--arguments">Ar
 <span class="normal">357</span>
 <span class="normal">358</span>
 <span class="normal">359</span>
-<span class="normal">360</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">notify_error</span><span class="p">(</span>
+<span class="normal">360</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">notify_error</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">traceback</span><span class="p">:</span> <span class="ne">Exception</span><span class="p">,</span> <span class="n">finish</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3628,7 +3628,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.update--arguments">Argument
 <span class="normal">336</span>
 <span class="normal">337</span>
 <span class="normal">338</span>
-<span class="normal">339</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
+<span class="normal">339</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Called at every event.</span>
 
@@ -3724,7 +3724,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook--argum
 <span class="normal">437</span>
 <span class="normal">438</span>
 <span class="normal">439</span>
-<span class="normal">440</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">yt_dlp_progress_hook</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">440</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">yt_dlp_progress_hook</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Updates the progress.</span>
 
@@ -3821,7 +3821,7 @@ <h6 id="spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook--argum
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/index.html b/reference/index.html
index 67974d5e4..e8bb51533 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -18,11 +18,11 @@
         <link rel="prev" href="../CONTRIBUTING/">
       
       
-        <link rel="next" href="download/">
+        <link rel="next" href="providers/">
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -881,11 +881,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="download/" class="md-nav__link ">
+            <a href="providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -901,7 +901,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -911,56 +911,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -972,32 +922,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="types/" class="md-nav__link ">
+            <a href="providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1008,53 +958,11 @@
   
   
     <li class="md-nav__item">
-      <a href="types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="types/album/" class="md-nav__link">
+      <a href="providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -1071,11 +979,11 @@
   
   
     <li class="md-nav__item">
-      <a href="types/saved/" class="md-nav__link">
+      <a href="providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1092,11 +1000,11 @@
   
   
     <li class="md-nav__item">
-      <a href="types/result/" class="md-nav__link">
+      <a href="providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1113,11 +1021,11 @@
   
   
     <li class="md-nav__item">
-      <a href="types/song/" class="md-nav__link">
+      <a href="providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1134,11 +1042,11 @@
   
   
     <li class="md-nav__item">
-      <a href="types/options/" class="md-nav__link">
+      <a href="providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1173,32 +1081,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="console/" class="md-nav__link ">
+            <a href="providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1209,11 +1117,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/save/" class="md-nav__link">
+      <a href="providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1230,11 +1138,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/url/" class="md-nav__link">
+      <a href="providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1251,11 +1159,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/meta/" class="md-nav__link">
+      <a href="providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1272,11 +1180,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/web/" class="md-nav__link">
+      <a href="providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1293,11 +1201,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/sync/" class="md-nav__link">
+      <a href="providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1314,11 +1222,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/download/" class="md-nav__link">
+      <a href="providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1335,11 +1243,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/entry_point/" class="md-nav__link">
+      <a href="providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1357,6 +1265,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1374,7 +1290,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1390,14 +1306,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1410,11 +1326,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/console/" class="md-nav__link">
+      <a href="utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1431,11 +1347,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/formatter/" class="md-nav__link">
+      <a href="utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1452,11 +1368,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/arguments/" class="md-nav__link">
+      <a href="utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1473,11 +1389,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/metadata/" class="md-nav__link">
+      <a href="utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1494,11 +1410,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/downloader/" class="md-nav__link">
+      <a href="utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1515,11 +1431,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/github/" class="md-nav__link">
+      <a href="utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1536,11 +1452,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/static/" class="md-nav__link">
+      <a href="utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1557,11 +1473,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/search/" class="md-nav__link">
+      <a href="utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1578,11 +1494,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/web/" class="md-nav__link">
+      <a href="utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1599,11 +1515,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/logging/" class="md-nav__link">
+      <a href="utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1620,11 +1536,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/spotify/" class="md-nav__link">
+      <a href="utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1641,11 +1557,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/matching/" class="md-nav__link">
+      <a href="utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1662,11 +1578,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/ffmpeg/" class="md-nav__link">
+      <a href="utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1683,11 +1599,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/m3u/" class="md-nav__link">
+      <a href="utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1704,11 +1620,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/config/" class="md-nav__link">
+      <a href="utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1725,11 +1641,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/lrc/" class="md-nav__link">
+      <a href="utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1746,11 +1662,11 @@
   
   
     <li class="md-nav__item">
-      <a href="utils/archive/" class="md-nav__link">
+      <a href="utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1785,32 +1701,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="providers/" class="md-nav__link ">
+            <a href="types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1820,45 +1736,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1867,11 +1779,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/lyrics/synced/" class="md-nav__link">
+      <a href="types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1888,11 +1800,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1909,11 +1821,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1930,11 +1842,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/lyrics/genius/" class="md-nav__link">
+      <a href="types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1951,11 +1863,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/lyrics/base/" class="md-nav__link">
+      <a href="types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1990,32 +1902,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="providers/audio/" class="md-nav__link ">
+            <a href="download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2026,11 +1938,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/bandcamp/" class="md-nav__link">
+      <a href="download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2047,11 +1959,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/sliderkz/" class="md-nav__link">
+      <a href="download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2061,6 +1973,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2068,11 +2034,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/piped/" class="md-nav__link">
+      <a href="console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2089,11 +2055,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/youtube/" class="md-nav__link">
+      <a href="console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2110,11 +2076,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/soundcloud/" class="md-nav__link">
+      <a href="console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2131,11 +2097,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/base/" class="md-nav__link">
+      <a href="console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2152,11 +2118,11 @@
   
   
     <li class="md-nav__item">
-      <a href="providers/audio/ytmusic/" class="md-nav__link">
+      <a href="console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2166,9 +2132,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2246,7 +2246,7 @@ <h2 id="spotdl.Spotdl" class="doc doc-heading">
 
 
         <p>Spotdl class, which simplifies the process of downloading songs from Spotify.</p>
-<div class="language-python highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">spotdl</span> <span class="kn">import</span> <span class="n">Spotdl</span>
+<div class="language-python highlight"><pre><span></span><code><span class="kn">from</span><span class="w"> </span><span class="nn">spotdl</span><span class="w"> </span><span class="kn">import</span> <span class="n">Spotdl</span>
 
 <span class="n">spotdl</span> <span class="o">=</span> <span class="n">Spotdl</span><span class="p">(</span><span class="n">client_id</span><span class="o">=</span><span class="s1">&#39;your-client-id&#39;</span><span class="p">,</span> <span class="n">client_secret</span><span class="o">=</span><span class="s1">&#39;your-client-secret&#39;</span><span class="p">)</span>
 
@@ -2320,7 +2320,7 @@ <h5 id="spotdl.Spotdl--arguments">Arguments<a class="headerlink" href="#spotdl.S
 <span class="normal">83</span>
 <span class="normal">84</span>
 <span class="normal">85</span>
-<span class="normal">86</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">86</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">client_secret</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2414,7 +2414,7 @@ <h6 id="spotdl.Spotdl.download--returns">Returns<a class="headerlink" href="#spo
 <span class="normal">152</span>
 <span class="normal">153</span>
 <span class="normal">154</span>
-<span class="normal">155</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
+<span class="normal">155</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Download and convert song to the output format.</span>
 
@@ -2466,7 +2466,7 @@ <h6 id="spotdl.Spotdl.download_songs--returns">Returns<a class="headerlink" href
 <span class="normal">165</span>
 <span class="normal">166</span>
 <span class="normal">167</span>
-<span class="normal">168</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download_songs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]]:</span>
+<span class="normal">168</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download_songs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="n">Song</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Download and convert songs to the output format.</span>
 
@@ -2540,7 +2540,7 @@ <h6 id="spotdl.Spotdl.get_download_urls--notes">Notes<a class="headerlink" href=
 <span class="normal">139</span>
 <span class="normal">140</span>
 <span class="normal">141</span>
-<span class="normal">142</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_download_urls</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
+<span class="normal">142</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_download_urls</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the download urls for a list of songs.</span>
 
@@ -2626,7 +2626,7 @@ <h6 id="spotdl.Spotdl.search--notes">Notes<a class="headerlink" href="#spotdl.Sp
 <span class="normal">108</span>
 <span class="normal">109</span>
 <span class="normal">110</span>
-<span class="normal">111</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
+<span class="normal">111</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for songs.</span>
 
@@ -2693,7 +2693,7 @@ <h2 id="spotdl.console_entry_point" class="doc doc-heading">
 <span class="normal">50</span>
 <span class="normal">51</span>
 <span class="normal">52</span>
-<span class="normal">53</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">console_entry_point</span><span class="p">():</span>
+<span class="normal">53</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">console_entry_point</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Entry point for the console. With profile flag, it runs the code with cProfile.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2775,7 +2775,7 @@ <h2 id="spotdl.console_entry_point" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/bandcamp/index.html b/reference/providers/audio/bandcamp/index.html
index 0079296e4..d9ac2a6a1 100644
--- a/reference/providers/audio/bandcamp/index.html
+++ b/reference/providers/audio/bandcamp/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/audio/bandcamp/">
       
       
-        <link rel="prev" href="../">
+        <link rel="prev" href="../soundcloud/">
       
       
-        <link rel="next" href="../sliderkz/">
+        <link rel="next" href="../ytmusic/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1041,18 +953,153 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    bandcamp
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp" class="md-nav__link">
+    <span class="md-ellipsis">
+      bandcamp
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.BandCamp" class="md-nav__link">
+    <span class="md-ellipsis">
+      BandCamp
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="BandCamp">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.BandCamp.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.BandCamp.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.BandCamp.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.BandCampTrack" class="md-nav__link">
+    <span class="md-ellipsis">
+      BandCampTrack
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.search" class="md-nav__link">
+    <span class="md-ellipsis">
+      search
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="search">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.search--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.bandcamp.search--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1065,11 +1112,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1133,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1154,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1176,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1201,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1217,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1237,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1258,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1279,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1300,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1321,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1342,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1363,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1384,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1405,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1426,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1447,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1468,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1489,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1510,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1531,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1552,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1573,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1599,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1608,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1647,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1690,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1711,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1800,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1809,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1799,162 +1846,114 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../../download/downloader/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    progress_handler
   </span>
   
 
       </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
       
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+    
+    
+    
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp" class="md-nav__link">
-    <span class="md-ellipsis">
-      bandcamp
-    </span>
-  </a>
-  
-</li>
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.BandCamp" class="md-nav__link">
-    <span class="md-ellipsis">
-      BandCamp
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="BandCamp">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.BandCamp--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.BandCamp.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.BandCamp.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.BandCamp.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    console
+  </span>
   
-</li>
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.BandCampTrack" class="md-nav__link">
-    <span class="md-ellipsis">
-      BandCampTrack
-    </span>
-  </a>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.search" class="md-nav__link">
-    <span class="md-ellipsis">
-      search
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="search">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.search--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.bandcamp.search--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/save/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    save
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1967,11 +1966,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sliderkz/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1988,11 +1987,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../piped/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2009,11 +2008,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../youtube/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2030,11 +2029,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../soundcloud/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2051,11 +2050,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2072,11 +2071,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ytmusic/" class="md-nav__link">
+      <a href="../../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2100,14 +2099,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2171,15 +2162,6 @@ <h2 id="spotdl.providers.audio.bandcamp.BandCamp" class="doc doc-heading">
 
         <p>SoundCloud audio provider class</p>
 
-        <h5 id="spotdl.providers.audio.bandcamp.BandCamp--arguments">Arguments<a class="headerlink" href="#spotdl.providers.audio.bandcamp.BandCamp--arguments" title="Permanent link">¤</a></h5>
-<ul>
-<li>output_directory: The directory to save the downloaded songs to.</li>
-<li>output_format: The format to save the downloaded songs in.</li>
-<li>cookie_file: The path to a file containing cookies to be used by YTDL.</li>
-<li>search_query: The query to use when searching for songs.</li>
-<li>filter_results: Whether to filter results.</li>
-</ul>
-
 
 
 
@@ -2234,7 +2216,7 @@ <h5 id="spotdl.providers.audio.bandcamp.BandCamp--arguments">Arguments<a class="
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2362,7 +2344,7 @@ <h6 id="spotdl.providers.audio.bandcamp.BandCamp.get_results--returns">Returns<a
 <span class="normal">208</span>
 <span class="normal">209</span>
 <span class="normal">210</span>
-<span class="normal">211</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">211</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from slider.kz</span>
 
@@ -2542,7 +2524,7 @@ <h2 id="spotdl.providers.audio.bandcamp.BandCampTrack" class="doc doc-heading">
 <span class="normal">124</span>
 <span class="normal">125</span>
 <span class="normal">126</span>
-<span class="normal">127</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">artist_id</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">track_id</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+<span class="normal">127</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">artist_id</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">track_id</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
     <span class="c1"># object info</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="s2">&quot;track&quot;</span>
 
@@ -2726,7 +2708,7 @@ <h5 id="spotdl.providers.audio.bandcamp.search--returns">Returns<a class="header
 <span class="normal">157</span>
 <span class="normal">158</span>
 <span class="normal">159</span>
-<span class="normal">160</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search</span><span class="p">(</span><span class="n">search_string</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">):</span>
+<span class="normal">160</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span><span class="n">search_string</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    I got this api url from the iOS app</span>
 <span class="sd">    needs a way of removing characters</span>
@@ -2825,7 +2807,7 @@ <h5 id="spotdl.providers.audio.bandcamp.search--returns">Returns<a class="header
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/base/index.html b/reference/providers/audio/base/index.html
index 26d7dbd1f..552232b46 100644
--- a/reference/providers/audio/base/index.html
+++ b/reference/providers/audio/base/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/audio/base/">
       
       
-        <link rel="prev" href="../soundcloud/">
+        <link rel="prev" href="../ytmusic/">
       
       
-        <link rel="next" href="../ytmusic/">
+        <link rel="next" href="../sliderkz/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +977,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1083,72 +995,389 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
-        
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    entry_point
+    base
   </span>
   
 
       </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
       
-    </li>
-  
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    
-    
-    
-      
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base" class="md-nav__link">
+    <span class="md-ellipsis">
+      base
+    </span>
+  </a>
+  
+</li>
       
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider" class="md-nav__link">
+    <span class="md-ellipsis">
+      AudioProvider
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="AudioProvider">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.name" class="md-nav__link">
+    <span class="md-ellipsis">
+      name
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="name">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.name--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_best_result" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_best_result
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_best_result">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_best_result--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_best_result--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_download_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_download_metadata
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_download_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_download_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_download_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_views" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_views
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_views">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_views--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.get_views--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.search" class="md-nav__link">
+    <span class="md-ellipsis">
+      search
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="search">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.search--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProvider.search--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.AudioProviderError" class="md-nav__link">
+    <span class="md-ellipsis">
+      AudioProviderError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.YTDLLogger" class="md-nav__link">
+    <span class="md-ellipsis">
+      YTDLLogger
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="YTDLLogger">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.YTDLLogger.debug" class="md-nav__link">
+    <span class="md-ellipsis">
+      debug
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.YTDLLogger.error" class="md-nav__link">
+    <span class="md-ellipsis">
+      error
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.base.YTDLLogger.warning" class="md-nav__link">
+    <span class="md-ellipsis">
+      warning
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../sliderkz/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    sliderkz
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
-        
-          
+          
           
           <div class="md-nav__link md-nav__container">
             <a href="../../../utils/" class="md-nav__link ">
@@ -1162,14 +1391,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1411,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1432,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1453,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1474,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1495,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1516,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1537,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1558,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1579,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1600,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1621,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1642,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1663,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1684,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1705,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1726,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1747,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1773,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1782,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1821,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+      </a>
+    </li>
+  
+
               
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    lyrics
+    saved
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1641,11 +1864,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1885,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1906,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1927,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1948,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1974,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1983,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +2023,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1823,11 +2044,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sliderkz/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1837,22 +2058,9 @@
 
               
             
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../piped/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    piped
-  </span>
-  
-
-      </a>
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1864,367 +2072,146 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../youtube/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
         
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    youtube
+    console
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
+            </a>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../soundcloud/" class="md-nav__link">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-  
-  <span class="md-ellipsis">
-    soundcloud
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    base
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    base
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base" class="md-nav__link">
-    <span class="md-ellipsis">
-      base
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider" class="md-nav__link">
-    <span class="md-ellipsis">
-      AudioProvider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AudioProvider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.name" class="md-nav__link">
-    <span class="md-ellipsis">
-      name
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="name">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.name--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_best_result" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_best_result
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_best_result">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_best_result--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_best_result--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/save/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_download_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_download_metadata
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    save
+  </span>
   
-    <nav class="md-nav" aria-label="get_download_metadata">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_download_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_download_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/url/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    url
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_views" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_views
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label="get_views">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_views--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.get_views--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.search" class="md-nav__link">
-    <span class="md-ellipsis">
-      search
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="search">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.search--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProvider.search--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    entry_point
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.AudioProviderError" class="md-nav__link">
-    <span class="md-ellipsis">
-      AudioProviderError
-    </span>
-  </a>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.YTDLLogger" class="md-nav__link">
-    <span class="md-ellipsis">
-      YTDLLogger
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="YTDLLogger">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.YTDLLogger.debug" class="md-nav__link">
-    <span class="md-ellipsis">
-      debug
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/sync/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.YTDLLogger.error" class="md-nav__link">
-    <span class="md-ellipsis">
-      error
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.base.YTDLLogger.warning" class="md-nav__link">
-    <span class="md-ellipsis">
-      warning
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    sync
+  </span>
   
-</li>
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/meta/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    meta
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -2237,11 +2224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ytmusic/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2251,9 +2238,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2398,7 +2398,7 @@ <h5 id="spotdl.providers.audio.base.AudioProvider--arguments">Arguments<a class=
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2464,7 +2464,7 @@ <h5 id="spotdl.providers.audio.base.AudioProvider--arguments">Arguments<a class=
 
 
 <h3 id="spotdl.providers.audio.base.AudioProvider.name" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span></code>
+            <code class="highlight language-python"><span class="n">name</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2565,7 +2565,7 @@ <h6 id="spotdl.providers.audio.base.AudioProvider.get_best_result--returns">Retu
 <span class="normal">373</span>
 <span class="normal">374</span>
 <span class="normal">375</span>
-<span class="normal">376</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_best_result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">results</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">]:</span>
+<span class="normal">376</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_best_result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">results</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the best match from the results</span>
 <span class="sd">    using views and average match</span>
@@ -2670,7 +2670,7 @@ <h6 id="spotdl.providers.audio.base.AudioProvider.get_download_metadata--returns
 <span class="normal">395</span>
 <span class="normal">396</span>
 <span class="normal">397</span>
-<span class="normal">398</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
+<span class="normal">398</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for a download using yt-dlp.</span>
 
@@ -2688,7 +2688,7 @@ <h6 id="spotdl.providers.audio.base.AudioProvider.get_download_metadata--returns
             <span class="k">return</span> <span class="n">data</span>
     <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exception</span><span class="p">:</span>
         <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">exception</span><span class="p">)</span>
-        <span class="k">raise</span> <span class="n">AudioProviderError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;YT-DLP download error - </span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="kn">from</span> <span class="nn">exception</span>
+        <span class="k">raise</span> <span class="n">AudioProviderError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;YT-DLP download error - </span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exception</span>
 
     <span class="k">raise</span> <span class="n">AudioProviderError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;No metadata found for the provided url </span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
@@ -2733,7 +2733,7 @@ <h6 id="spotdl.providers.audio.base.AudioProvider.get_results--returns">Returns<
 <span class="normal">130</span>
 <span class="normal">131</span>
 <span class="normal">132</span>
-<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from audio provider.</span>
 
@@ -2788,7 +2788,7 @@ <h6 id="spotdl.providers.audio.base.AudioProvider.get_views--returns">Returns<a
 <span class="normal">145</span>
 <span class="normal">146</span>
 <span class="normal">147</span>
-<span class="normal">148</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_views</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+<span class="normal">148</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_views</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the number of views for a video.</span>
 
@@ -3000,7 +3000,7 @@ <h6 id="spotdl.providers.audio.base.AudioProvider.search--returns">Returns<a cla
 <span class="normal">316</span>
 <span class="normal">317</span>
 <span class="normal">318</span>
-<span class="normal">319</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">only_verified</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">319</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">only_verified</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for a song and return best match.</span>
 
@@ -3266,7 +3266,7 @@ <h3 id="spotdl.providers.audio.base.YTDLLogger.debug" class="doc doc-heading">
 <span class="normal">40</span>
 <span class="normal">41</span>
 <span class="normal">42</span>
-<span class="normal">43</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">debug</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
+<span class="normal">43</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">debug</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    YTDL uses this to print debug messages.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3298,7 +3298,7 @@ <h3 id="spotdl.providers.audio.base.YTDLLogger.error" class="doc doc-heading">
 <span class="normal">54</span>
 <span class="normal">55</span>
 <span class="normal">56</span>
-<span class="normal">57</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
+<span class="normal">57</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    YTDL uses this to print errors.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3330,7 +3330,7 @@ <h3 id="spotdl.providers.audio.base.YTDLLogger.warning" class="doc doc-heading">
 <span class="normal">47</span>
 <span class="normal">48</span>
 <span class="normal">49</span>
-<span class="normal">50</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">warning</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
+<span class="normal">50</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">warning</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    YTDL uses this to print warnings.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3413,7 +3413,7 @@ <h3 id="spotdl.providers.audio.base.YTDLLogger.warning" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/index.html b/reference/providers/audio/index.html
index e59237d84..d85347006 100644
--- a/reference/providers/audio/index.html
+++ b/reference/providers/audio/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/audio/">
       
       
-        <link rel="prev" href="../lyrics/base/">
+        <link rel="prev" href="../lyrics/genius/">
       
       
-        <link rel="next" href="bandcamp/">
+        <link rel="next" href="piped/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="./" class="md-nav__link md-nav__link--active">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +977,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +998,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1019,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1041,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1066,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1082,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1102,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1123,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1144,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1165,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1186,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1207,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1228,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1249,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1270,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1291,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1312,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1354,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1375,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1396,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1464,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1473,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1512,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1555,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1576,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1597,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1618,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1639,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1665,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1674,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="./" class="md-nav__link md-nav__link--active">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +1714,11 @@
   
   
     <li class="md-nav__item">
-      <a href="bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1823,11 +1735,86 @@
   
   
     <li class="md-nav__item">
-      <a href="sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -1844,11 +1831,11 @@
   
   
     <li class="md-nav__item">
-      <a href="piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -1865,11 +1852,11 @@
   
   
     <li class="md-nav__item">
-      <a href="youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1886,11 +1873,11 @@
   
   
     <li class="md-nav__item">
-      <a href="soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -1907,11 +1894,11 @@
   
   
     <li class="md-nav__item">
-      <a href="base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -1928,11 +1915,11 @@
   
   
     <li class="md-nav__item">
-      <a href="ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -1942,9 +1929,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2089,7 +2089,7 @@ <h5 id="spotdl.providers.audio.AudioProvider--arguments">Arguments<a class="head
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2155,7 +2155,7 @@ <h5 id="spotdl.providers.audio.AudioProvider--arguments">Arguments<a class="head
 
 
 <h3 id="spotdl.providers.audio.AudioProvider.name" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span></code>
+            <code class="highlight language-python"><span class="n">name</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2256,7 +2256,7 @@ <h6 id="spotdl.providers.audio.AudioProvider.get_best_result--returns">Returns<a
 <span class="normal">373</span>
 <span class="normal">374</span>
 <span class="normal">375</span>
-<span class="normal">376</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_best_result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">results</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">]:</span>
+<span class="normal">376</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_best_result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">results</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the best match from the results</span>
 <span class="sd">    using views and average match</span>
@@ -2361,7 +2361,7 @@ <h6 id="spotdl.providers.audio.AudioProvider.get_download_metadata--returns">Ret
 <span class="normal">395</span>
 <span class="normal">396</span>
 <span class="normal">397</span>
-<span class="normal">398</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
+<span class="normal">398</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for a download using yt-dlp.</span>
 
@@ -2379,7 +2379,7 @@ <h6 id="spotdl.providers.audio.AudioProvider.get_download_metadata--returns">Ret
             <span class="k">return</span> <span class="n">data</span>
     <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exception</span><span class="p">:</span>
         <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">exception</span><span class="p">)</span>
-        <span class="k">raise</span> <span class="n">AudioProviderError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;YT-DLP download error - </span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="kn">from</span> <span class="nn">exception</span>
+        <span class="k">raise</span> <span class="n">AudioProviderError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;YT-DLP download error - </span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exception</span>
 
     <span class="k">raise</span> <span class="n">AudioProviderError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;No metadata found for the provided url </span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
@@ -2424,7 +2424,7 @@ <h6 id="spotdl.providers.audio.AudioProvider.get_results--returns">Returns<a cla
 <span class="normal">130</span>
 <span class="normal">131</span>
 <span class="normal">132</span>
-<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from audio provider.</span>
 
@@ -2479,7 +2479,7 @@ <h6 id="spotdl.providers.audio.AudioProvider.get_views--returns">Returns<a class
 <span class="normal">145</span>
 <span class="normal">146</span>
 <span class="normal">147</span>
-<span class="normal">148</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_views</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+<span class="normal">148</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_views</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the number of views for a video.</span>
 
@@ -2691,7 +2691,7 @@ <h6 id="spotdl.providers.audio.AudioProvider.search--returns">Returns<a class="h
 <span class="normal">316</span>
 <span class="normal">317</span>
 <span class="normal">318</span>
-<span class="normal">319</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">only_verified</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">319</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">only_verified</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for a song and return best match.</span>
 
@@ -2920,15 +2920,6 @@ <h2 id="spotdl.providers.audio.BandCamp" class="doc doc-heading">
 
         <p>SoundCloud audio provider class</p>
 
-        <h5 id="spotdl.providers.audio.BandCamp--arguments">Arguments<a class="headerlink" href="#spotdl.providers.audio.BandCamp--arguments" title="Permanent link">¤</a></h5>
-<ul>
-<li>output_directory: The directory to save the downloaded songs to.</li>
-<li>output_format: The format to save the downloaded songs in.</li>
-<li>cookie_file: The path to a file containing cookies to be used by YTDL.</li>
-<li>search_query: The query to use when searching for songs.</li>
-<li>filter_results: Whether to filter results.</li>
-</ul>
-
 
 
 
@@ -2983,7 +2974,7 @@ <h5 id="spotdl.providers.audio.BandCamp--arguments">Arguments<a class="headerlin
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -3111,7 +3102,7 @@ <h6 id="spotdl.providers.audio.BandCamp.get_results--returns">Returns<a class="h
 <span class="normal">208</span>
 <span class="normal">209</span>
 <span class="normal">210</span>
-<span class="normal">211</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">211</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from slider.kz</span>
 
@@ -3246,7 +3237,7 @@ <h5 id="spotdl.providers.audio.Piped--arguments">Arguments<a class="headerlink"
 <span class="normal">85</span>
 <span class="normal">86</span>
 <span class="normal">87</span>
-<span class="normal">88</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>  <span class="c1"># pylint: disable=super-init-not-called</span>
+<span class="normal">88</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>  <span class="c1"># pylint: disable=super-init-not-called</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -3375,7 +3366,7 @@ <h6 id="spotdl.providers.audio.Piped.get_download_metadata--returns">Returns<a c
 <span class="normal">192</span>
 <span class="normal">193</span>
 <span class="normal">194</span>
-<span class="normal">195</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
+<span class="normal">195</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for a download using yt-dlp.</span>
 
@@ -3509,7 +3500,7 @@ <h6 id="spotdl.providers.audio.Piped.get_results--returns">Returns<a class="head
 <span class="normal">147</span>
 <span class="normal">148</span>
 <span class="normal">149</span>
-<span class="normal">150</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">150</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from YouTube Music API and simplify them</span>
 
@@ -3624,7 +3615,7 @@ <h5 id="spotdl.providers.audio.SoundCloud--arguments">Arguments<a class="headerl
 <span class="normal">36</span>
 <span class="normal">37</span>
 <span class="normal">38</span>
-<span class="normal">39</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">39</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initialize the SoundCloud API</span>
 
@@ -3729,7 +3720,7 @@ <h6 id="spotdl.providers.audio.SoundCloud.get_results--returns">Returns<a class=
 <span class="normal">92</span>
 <span class="normal">93</span>
 <span class="normal">94</span>
-<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from slider.kz</span>
 
@@ -3852,7 +3843,7 @@ <h3 id="spotdl.providers.audio.YTDLLogger.debug" class="doc doc-heading">
 <span class="normal">40</span>
 <span class="normal">41</span>
 <span class="normal">42</span>
-<span class="normal">43</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">debug</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
+<span class="normal">43</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">debug</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    YTDL uses this to print debug messages.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3884,7 +3875,7 @@ <h3 id="spotdl.providers.audio.YTDLLogger.error" class="doc doc-heading">
 <span class="normal">54</span>
 <span class="normal">55</span>
 <span class="normal">56</span>
-<span class="normal">57</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
+<span class="normal">57</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    YTDL uses this to print errors.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3916,7 +3907,7 @@ <h3 id="spotdl.providers.audio.YTDLLogger.warning" class="doc doc-heading">
 <span class="normal">47</span>
 <span class="normal">48</span>
 <span class="normal">49</span>
-<span class="normal">50</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">warning</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
+<span class="normal">50</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">warning</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">msg</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    YTDL uses this to print warnings.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3953,15 +3944,6 @@ <h2 id="spotdl.providers.audio.YouTube" class="doc doc-heading">
 
         <p>YouTube audio provider class</p>
 
-        <h5 id="spotdl.providers.audio.YouTube--arguments">Arguments<a class="headerlink" href="#spotdl.providers.audio.YouTube--arguments" title="Permanent link">¤</a></h5>
-<ul>
-<li>output_directory: The directory to save the downloaded songs to.</li>
-<li>output_format: The format to save the downloaded songs in.</li>
-<li>cookie_file: The path to a file containing cookies to be used by YTDL.</li>
-<li>search_query: The query to use when searching for songs.</li>
-<li>filter_results: Whether to filter results.</li>
-</ul>
-
 
 
 
@@ -4016,7 +3998,7 @@ <h5 id="spotdl.providers.audio.YouTube--arguments">Arguments<a class="headerlink
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -4151,7 +4133,7 @@ <h6 id="spotdl.providers.audio.YouTube.get_results--returns">Returns<a class="he
 <span class="normal">68</span>
 <span class="normal">69</span>
 <span class="normal">70</span>
-<span class="normal">71</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span>
+<span class="normal">71</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>  <span class="c1"># pylint: disable=W0221</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -4254,7 +4236,7 @@ <h5 id="spotdl.providers.audio.YouTubeMusic--arguments">Arguments<a class="heade
 <span class="normal">35</span>
 <span class="normal">36</span>
 <span class="normal">37</span>
-<span class="normal">38</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">38</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initialize the YouTube Music API</span>
 
@@ -4358,7 +4340,7 @@ <h6 id="spotdl.providers.audio.YouTubeMusic.get_results--returns">Returns<a clas
 <span class="normal">90</span>
 <span class="normal">91</span>
 <span class="normal">92</span>
-<span class="normal">93</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">93</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from YouTube Music API and simplify them</span>
 
@@ -4489,7 +4471,7 @@ <h6 id="spotdl.providers.audio.YouTubeMusic.get_results--returns">Returns<a clas
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/piped/index.html b/reference/providers/audio/piped/index.html
index d75b0aa1b..8aae1164b 100644
--- a/reference/providers/audio/piped/index.html
+++ b/reference/providers/audio/piped/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/audio/piped/">
       
       
-        <link rel="prev" href="../sliderkz/">
+        <link rel="prev" href="../">
       
       
         <link rel="next" href="../youtube/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -978,18 +890,153 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    piped
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped" class="md-nav__link">
+    <span class="md-ellipsis">
+      piped
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped" class="md-nav__link">
+    <span class="md-ellipsis">
+      Piped
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Piped">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped.get_download_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_download_metadata
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_download_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped.get_download_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped.get_download_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.piped.Piped.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1002,11 +1049,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +1070,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1091,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1112,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1133,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1154,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1176,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1201,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1217,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1237,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1258,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1279,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1300,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1321,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1342,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1363,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1384,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1405,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1426,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1447,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1468,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1489,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1510,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1531,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1552,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1573,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1599,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1608,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1647,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1690,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1711,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1800,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1809,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +1849,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1823,11 +1870,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sliderkz/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1837,157 +1884,118 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+    
+    
+    
       
       
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
       
-        <label class="md-nav__link md-nav__link--active" for="__toc">
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
           
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    piped
+    console
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
+    </li>
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped" class="md-nav__link">
-    <span class="md-ellipsis">
-      piped
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped" class="md-nav__link">
-    <span class="md-ellipsis">
-      Piped
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Piped">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped.get_download_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_download_metadata
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="get_download_metadata">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../../../console/url/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped.get_download_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped.get_download_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    url
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.piped.Piped.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    entry_point
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -2000,11 +2008,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../youtube/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2021,11 +2029,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../soundcloud/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2042,11 +2050,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2063,11 +2071,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ytmusic/" class="md-nav__link">
+      <a href="../../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2091,14 +2099,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2225,7 +2225,7 @@ <h5 id="spotdl.providers.audio.piped.Piped--arguments">Arguments<a class="header
 <span class="normal">85</span>
 <span class="normal">86</span>
 <span class="normal">87</span>
-<span class="normal">88</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>  <span class="c1"># pylint: disable=super-init-not-called</span>
+<span class="normal">88</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>  <span class="c1"># pylint: disable=super-init-not-called</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2354,7 +2354,7 @@ <h6 id="spotdl.providers.audio.piped.Piped.get_download_metadata--returns">Retur
 <span class="normal">192</span>
 <span class="normal">193</span>
 <span class="normal">194</span>
-<span class="normal">195</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
+<span class="normal">195</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_download_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">download</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for a download using yt-dlp.</span>
 
@@ -2488,7 +2488,7 @@ <h6 id="spotdl.providers.audio.piped.Piped.get_results--returns">Returns<a class
 <span class="normal">147</span>
 <span class="normal">148</span>
 <span class="normal">149</span>
-<span class="normal">150</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">150</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from YouTube Music API and simplify them</span>
 
@@ -2626,7 +2626,7 @@ <h6 id="spotdl.providers.audio.piped.Piped.get_results--returns">Returns<a class
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/sliderkz/index.html b/reference/providers/audio/sliderkz/index.html
index 38bb302ba..92ee481ad 100644
--- a/reference/providers/audio/sliderkz/index.html
+++ b/reference/providers/audio/sliderkz/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/audio/sliderkz/">
       
       
-        <link rel="prev" href="../bandcamp/">
+        <link rel="prev" href="../base/">
       
       
-        <link rel="next" href="../piped/">
+        <link rel="next" href="../../../utils/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +977,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +998,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1104,18 +1016,119 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    sliderkz
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.sliderkz" class="md-nav__link">
+    <span class="md-ellipsis">
+      sliderkz
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.sliderkz.SliderKZ" class="md-nav__link">
+    <span class="md-ellipsis">
+      SliderKZ
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="SliderKZ">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.sliderkz.SliderKZ.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.sliderkz.SliderKZ.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.sliderkz.SliderKZ.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1146,7 +1159,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1175,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1195,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1216,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1237,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1258,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1279,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1300,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1321,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1342,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1363,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1384,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1405,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1426,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1447,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1468,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1489,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1510,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1531,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1557,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1566,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1605,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
               
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    lyrics
+    saved
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1641,11 +1648,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1669,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1690,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1711,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1758,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1767,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +1807,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1820,120 +1825,93 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    sliderkz
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
       </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
       
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+    
+    
+    
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.sliderkz" class="md-nav__link">
-    <span class="md-ellipsis">
-      sliderkz
-    </span>
-  </a>
-  
-</li>
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.sliderkz.SliderKZ" class="md-nav__link">
-    <span class="md-ellipsis">
-      SliderKZ
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="SliderKZ">
-      <ul class="md-nav__list">
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.sliderkz.SliderKZ--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.sliderkz.SliderKZ.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.sliderkz.SliderKZ.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.sliderkz.SliderKZ.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    console
+  </span>
   
-</li>
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-      </ul>
-    </nav>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
   
-</li>
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/save/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    save
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1946,11 +1924,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../piped/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -1967,11 +1945,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../youtube/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1988,11 +1966,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../soundcloud/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2009,11 +1987,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2030,11 +2008,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ytmusic/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2044,9 +2022,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2129,15 +2120,6 @@ <h2 id="spotdl.providers.audio.sliderkz.SliderKZ" class="doc doc-heading">
 
         <p>Slider.kz audio provider class</p>
 
-        <h5 id="spotdl.providers.audio.sliderkz.SliderKZ--arguments">Arguments<a class="headerlink" href="#spotdl.providers.audio.sliderkz.SliderKZ--arguments" title="Permanent link">¤</a></h5>
-<ul>
-<li>output_directory: The directory to save the downloaded songs to.</li>
-<li>output_format: The format to save the downloaded songs in.</li>
-<li>cookie_file: The path to a file containing cookies to be used by YTDL.</li>
-<li>search_query: The query to use when searching for songs.</li>
-<li>filter_results: Whether to filter results.</li>
-</ul>
-
 
 
 
@@ -2192,7 +2174,7 @@ <h5 id="spotdl.providers.audio.sliderkz.SliderKZ--arguments">Arguments<a class="
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2343,7 +2325,7 @@ <h6 id="spotdl.providers.audio.sliderkz.SliderKZ.get_results--returns">Returns<a
 <span class="normal">95</span>
 <span class="normal">96</span>
 <span class="normal">97</span>
-<span class="normal">98</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">98</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from slider.kz</span>
 
@@ -2484,7 +2466,7 @@ <h6 id="spotdl.providers.audio.sliderkz.SliderKZ.get_results--returns">Returns<a
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/soundcloud/index.html b/reference/providers/audio/soundcloud/index.html
index b723c8691..cd096c440 100644
--- a/reference/providers/audio/soundcloud/index.html
+++ b/reference/providers/audio/soundcloud/index.html
@@ -18,11 +18,11 @@
         <link rel="prev" href="../youtube/">
       
       
-        <link rel="next" href="../base/">
+        <link rel="next" href="../bandcamp/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1020,18 +932,120 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    soundcloud
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.soundcloud" class="md-nav__link">
+    <span class="md-ellipsis">
+      soundcloud
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.soundcloud.SoundCloud" class="md-nav__link">
+    <span class="md-ellipsis">
+      SoundCloud
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="SoundCloud">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.soundcloud.SoundCloud--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.soundcloud.SoundCloud.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.soundcloud.SoundCloud.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.soundcloud.SoundCloud.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1044,11 +1058,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1079,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1143,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1168,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1184,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1204,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1225,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1246,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1267,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1288,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1309,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1330,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1351,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1372,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1393,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1414,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1435,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1456,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1477,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1498,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1519,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1540,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1566,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1575,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1614,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+      </a>
+    </li>
+  
+
               
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    lyrics
+    saved
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1641,11 +1657,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1678,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1699,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1720,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1741,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1767,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1776,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +1816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1823,11 +1837,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sliderkz/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1837,26 +1851,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../piped/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
         
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    piped
+    console
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1865,11 +1912,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../youtube/" class="md-nav__link">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    save
   </span>
   
 
@@ -1883,120 +1930,60 @@
                 
   
   
-    
-  
-  
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    soundcloud
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    url
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.soundcloud" class="md-nav__link">
-    <span class="md-ellipsis">
-      soundcloud
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../../../console/entry_point/" class="md-nav__link">
+        
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.soundcloud.SoundCloud" class="md-nav__link">
-    <span class="md-ellipsis">
-      SoundCloud
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    entry_point
+  </span>
   
-    <nav class="md-nav" aria-label="SoundCloud">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.soundcloud.SoundCloud--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.soundcloud.SoundCloud.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.soundcloud.SoundCloud.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.soundcloud.SoundCloud.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/sync/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    sync
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -2009,11 +1996,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2030,11 +2017,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ytmusic/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2044,9 +2031,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2152,7 +2152,7 @@ <h5 id="spotdl.providers.audio.soundcloud.SoundCloud--arguments">Arguments<a cla
 <span class="normal">36</span>
 <span class="normal">37</span>
 <span class="normal">38</span>
-<span class="normal">39</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">39</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initialize the SoundCloud API</span>
 
@@ -2257,7 +2257,7 @@ <h6 id="spotdl.providers.audio.soundcloud.SoundCloud.get_results--returns">Retur
 <span class="normal">92</span>
 <span class="normal">93</span>
 <span class="normal">94</span>
-<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from slider.kz</span>
 
@@ -2389,7 +2389,7 @@ <h6 id="spotdl.providers.audio.soundcloud.SoundCloud.get_results--returns">Retur
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/youtube/index.html b/reference/providers/audio/youtube/index.html
index 56d7086ca..c7e1261c6 100644
--- a/reference/providers/audio/youtube/index.html
+++ b/reference/providers/audio/youtube/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -932,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -941,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -999,18 +911,111 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    youtube
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.youtube" class="md-nav__link">
+    <span class="md-ellipsis">
+      youtube
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.youtube.YouTube" class="md-nav__link">
+    <span class="md-ellipsis">
+      YouTube
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="YouTube">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.youtube.YouTube.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.youtube.YouTube.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.youtube.YouTube.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1023,11 +1028,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1049,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1070,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1091,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1112,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1134,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1159,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1175,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1195,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1216,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1237,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1258,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1279,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1300,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1321,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1342,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1363,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1384,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1405,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1426,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1447,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1468,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1489,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1510,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1531,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1557,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1566,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1605,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
               
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    lyrics
+    saved
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1641,11 +1648,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1669,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1690,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1711,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1751,8 +1758,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1762,36 +1767,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +1807,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1823,11 +1828,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sliderkz/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1837,22 +1842,9 @@
 
               
             
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../piped/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    piped
-  </span>
-  
-
-      </a>
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1862,120 +1854,106 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+    
+    
+    
       
       
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
       
-        <label class="md-nav__link md-nav__link--active" for="__toc">
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
           
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    youtube
+    console
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    save
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.youtube" class="md-nav__link">
-    <span class="md-ellipsis">
-      youtube
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../../../console/url/" class="md-nav__link">
+        
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.youtube.YouTube" class="md-nav__link">
-    <span class="md-ellipsis">
-      YouTube
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    url
+  </span>
   
-    <nav class="md-nav" aria-label="YouTube">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.youtube.YouTube--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.youtube.YouTube.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.youtube.YouTube.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.youtube.YouTube.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    entry_point
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1988,11 +1966,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../soundcloud/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2009,11 +1987,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2030,11 +2008,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ytmusic/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2044,9 +2022,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2129,15 +2120,6 @@ <h2 id="spotdl.providers.audio.youtube.YouTube" class="doc doc-heading">
 
         <p>YouTube audio provider class</p>
 
-        <h5 id="spotdl.providers.audio.youtube.YouTube--arguments">Arguments<a class="headerlink" href="#spotdl.providers.audio.youtube.YouTube--arguments" title="Permanent link">¤</a></h5>
-<ul>
-<li>output_directory: The directory to save the downloaded songs to.</li>
-<li>output_format: The format to save the downloaded songs in.</li>
-<li>cookie_file: The path to a file containing cookies to be used by YTDL.</li>
-<li>search_query: The query to use when searching for songs.</li>
-<li>filter_results: Whether to filter results.</li>
-</ul>
-
 
 
 
@@ -2192,7 +2174,7 @@ <h5 id="spotdl.providers.audio.youtube.YouTube--arguments">Arguments<a class="he
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
-<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">119</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;mp3&quot;</span><span class="p">,</span>
     <span class="n">cookie_file</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -2327,7 +2309,7 @@ <h6 id="spotdl.providers.audio.youtube.YouTube.get_results--returns">Returns<a c
 <span class="normal">68</span>
 <span class="normal">69</span>
 <span class="normal">70</span>
-<span class="normal">71</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span>
+<span class="normal">71</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="n">_args</span><span class="p">,</span> <span class="o">**</span><span class="n">_kwargs</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>  <span class="c1"># pylint: disable=W0221</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -2452,7 +2434,7 @@ <h6 id="spotdl.providers.audio.youtube.YouTube.get_results--returns">Returns<a c
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/audio/ytmusic/index.html b/reference/providers/audio/ytmusic/index.html
index 9540b8ff1..4060524dc 100644
--- a/reference/providers/audio/ytmusic/index.html
+++ b/reference/providers/audio/ytmusic/index.html
@@ -15,12 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/audio/ytmusic/">
       
       
-        <link rel="prev" href="../base/">
+        <link rel="prev" href="../bandcamp/">
       
       
+        <link rel="next" href="../base/">
+      
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -28,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -192,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -341,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -633,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -642,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -668,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -742,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../../lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -778,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../../lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -841,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../../lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -862,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../../lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -883,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../../lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -904,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../../lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -930,6 +842,8 @@
                 
   
   
+    
+  
   
   
     
@@ -939,36 +853,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -979,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1000,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1021,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1042,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1060,92 +974,202 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
-        
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    download
+    ytmusic
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    entry_point
+    ytmusic
   </span>
   
 
       </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
       
-    </li>
-  
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    
-    
-    
-      
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.ytmusic" class="md-nav__link">
+    <span class="md-ellipsis">
+      ytmusic
+    </span>
+  </a>
+  
+</li>
       
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
-        
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic" class="md-nav__link">
+    <span class="md-ellipsis">
+      YouTubeMusic
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="YouTubeMusic">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../sliderkz/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    sliderkz
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        
           
           
           <div class="md-nav__link md-nav__container">
@@ -1160,14 +1184,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1180,11 +1204,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1201,11 +1225,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1222,11 +1246,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1243,11 +1267,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1264,11 +1288,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1285,11 +1309,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1306,11 +1330,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1327,11 +1351,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1348,11 +1372,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1369,11 +1393,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1390,11 +1414,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1411,11 +1435,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1432,11 +1456,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1453,11 +1477,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1474,11 +1498,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1495,11 +1519,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1516,11 +1540,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1542,8 +1566,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1553,36 +1575,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1592,45 +1614,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
+      </a>
+    </li>
+  
+
+              
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1639,11 +1657,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1660,11 +1678,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1681,11 +1699,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1702,11 +1720,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1723,11 +1741,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../lyrics/base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1749,8 +1767,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1760,36 +1776,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1800,11 +1816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1821,11 +1837,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../sliderkz/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1835,26 +1851,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../piped/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
         
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    piped
+    console
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1863,11 +1912,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../youtube/" class="md-nav__link">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    save
   </span>
   
 
@@ -1884,11 +1933,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../soundcloud/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    url
   </span>
   
 
@@ -1905,11 +1954,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    entry_point
   </span>
   
 
@@ -1923,128 +1972,81 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../../console/sync/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    ytmusic
+    sync
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.ytmusic" class="md-nav__link">
-    <span class="md-ellipsis">
-      ytmusic
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../../../console/download/" class="md-nav__link">
+        
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic" class="md-nav__link">
-    <span class="md-ellipsis">
-      YouTubeMusic
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    download
+  </span>
   
-    <nav class="md-nav" aria-label="YouTubeMusic">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../console/web/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
+  <span class="md-ellipsis">
+    web
+  </span>
   
 
-              
-            
-          </ul>
-        </nav>
-      
+      </a>
     </li>
   
 
@@ -2151,7 +2153,7 @@ <h5 id="spotdl.providers.audio.ytmusic.YouTubeMusic--arguments">Arguments<a clas
 <span class="normal">35</span>
 <span class="normal">36</span>
 <span class="normal">37</span>
-<span class="normal">38</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">38</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initialize the YouTube Music API</span>
 
@@ -2255,7 +2257,7 @@ <h6 id="spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--returns">Return
 <span class="normal">90</span>
 <span class="normal">91</span>
 <span class="normal">92</span>
-<span class="normal">93</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
+<span class="normal">93</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get results from YouTube Music API and simplify them</span>
 
@@ -2386,7 +2388,7 @@ <h6 id="spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--returns">Return
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/index.html b/reference/providers/index.html
index 04d34fd9b..6d072543d 100644
--- a/reference/providers/index.html
+++ b/reference/providers/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/">
       
       
-        <link rel="prev" href="../utils/archive/">
+        <link rel="prev" href="../">
       
       
         <link rel="next" href="lyrics/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,36 +646,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../download/" class="md-nav__link ">
+            <a href="./" class="md-nav__link md-nav__link--active">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +685,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +696,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../types/" class="md-nav__link ">
+            <a href="lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +732,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/album/" class="md-nav__link">
+      <a href="lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +753,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/saved/" class="md-nav__link">
+      <a href="lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +774,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/result/" class="md-nav__link">
+      <a href="lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +795,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/song/" class="md-nav__link">
+      <a href="lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +816,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/options/" class="md-nav__link">
+      <a href="lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +855,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../console/" class="md-nav__link ">
+            <a href="audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +891,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/save/" class="md-nav__link">
+      <a href="audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +912,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/url/" class="md-nav__link">
+      <a href="audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +933,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/meta/" class="md-nav__link">
+      <a href="audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +954,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/web/" class="md-nav__link">
+      <a href="audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +975,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/sync/" class="md-nav__link">
+      <a href="audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +996,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/download/" class="md-nav__link">
+      <a href="audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1017,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/entry_point/" class="md-nav__link">
+      <a href="audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1039,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/console/" class="md-nav__link">
+      <a href="../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/formatter/" class="md-nav__link">
+      <a href="../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/arguments/" class="md-nav__link">
+      <a href="../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/metadata/" class="md-nav__link">
+      <a href="../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/downloader/" class="md-nav__link">
+      <a href="../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/github/" class="md-nav__link">
+      <a href="../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/static/" class="md-nav__link">
+      <a href="../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/search/" class="md-nav__link">
+      <a href="../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1268,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/web/" class="md-nav__link">
+      <a href="../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1289,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/logging/" class="md-nav__link">
+      <a href="../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1310,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/spotify/" class="md-nav__link">
+      <a href="../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1331,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/matching/" class="md-nav__link">
+      <a href="../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1352,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/ffmpeg/" class="md-nav__link">
+      <a href="../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1373,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/m3u/" class="md-nav__link">
+      <a href="../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1394,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/config/" class="md-nav__link">
+      <a href="../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1415,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/lrc/" class="md-nav__link">
+      <a href="../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1436,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/archive/" class="md-nav__link">
+      <a href="../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1462,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1471,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="./" class="md-nav__link md-nav__link--active">
+            <a href="../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1510,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="lyrics/synced/" class="md-nav__link">
+      <a href="../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1574,11 @@
   
   
     <li class="md-nav__item">
-      <a href="lyrics/musixmatch/" class="md-nav__link">
+      <a href="../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1595,11 @@
   
   
     <li class="md-nav__item">
-      <a href="lyrics/azlyrics/" class="md-nav__link">
+      <a href="../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1616,11 @@
   
   
     <li class="md-nav__item">
-      <a href="lyrics/genius/" class="md-nav__link">
+      <a href="../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1637,11 @@
   
   
     <li class="md-nav__item">
-      <a href="lyrics/base/" class="md-nav__link">
+      <a href="../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1764,32 +1676,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="audio/" class="md-nav__link ">
+            <a href="../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1800,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/bandcamp/" class="md-nav__link">
+      <a href="../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1821,11 +1733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/sliderkz/" class="md-nav__link">
+      <a href="../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1835,6 +1747,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1842,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/piped/" class="md-nav__link">
+      <a href="../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1863,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/youtube/" class="md-nav__link">
+      <a href="../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1884,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/soundcloud/" class="md-nav__link">
+      <a href="../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1905,11 +1871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/base/" class="md-nav__link">
+      <a href="../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1926,11 +1892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="audio/ytmusic/" class="md-nav__link">
+      <a href="../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1940,9 +1906,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2071,7 +2071,7 @@ <h1>providers</h1>
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/lyrics/azlyrics/index.html b/reference/providers/lyrics/azlyrics/index.html
index 441dd136b..48318d078 100644
--- a/reference/providers/lyrics/azlyrics/index.html
+++ b/reference/providers/lyrics/azlyrics/index.html
@@ -18,11 +18,11 @@
         <link rel="prev" href="../musixmatch/">
       
       
-        <link rel="next" href="../genius/">
+        <link rel="next" href="../base/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,55 +683,7 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
@@ -740,36 +694,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +734,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
+      <a href="../synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    synced
   </span>
   
 
@@ -801,11 +755,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
+      <a href="../musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    musixmatch
   </span>
   
 
@@ -819,60 +773,168 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    album
+    azlyrics
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      azlyrics
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      AzLyrics
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="AzLyrics">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      extract_lyrics
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    saved
-  </span>
+    <nav class="md-nav" aria-label="extract_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    result
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_x_code
+    </span>
+  </a>
   
-
-      </a>
+    <nav class="md-nav" aria-label="get_x_code">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -885,11 +947,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +968,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +1007,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../../audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1043,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../../audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +1064,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../../audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +1085,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../../audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1106,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../../audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1127,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../../audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1148,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../../audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1169,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../../audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1191,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1216,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1232,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1252,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1273,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1294,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1315,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1336,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1357,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1378,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1399,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1420,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1441,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1462,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1483,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1504,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1525,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1546,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1567,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1588,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1614,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1623,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1592,49 +1660,85 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" checked>
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+      </a>
+    </li>
+  
+
               
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    lyrics
+    saved
   </span>
   
 
-            </a>
+      </a>
+    </li>
+  
+
+              
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/artist/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    artist
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/result/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    result
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1643,11 +1747,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../synced/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    playlist
   </span>
   
 
@@ -1664,11 +1768,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../musixmatch/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    song
   </span>
   
 
@@ -1682,172 +1786,76 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    album
   </span>
   
 
       </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
       
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+    
+    
+    
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      azlyrics
-    </span>
-  </a>
-  
-</li>
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      AzLyrics
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AzLyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      extract_lyrics
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="extract_lyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_x_code
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_x_code">
-      <ul class="md-nav__list">
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
         
-      </ul>
-    </nav>
-  
-</li>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../download/" class="md-nav__link ">
+              
   
-</nav>
-      
-    </li>
+  <span class="md-ellipsis">
+    download
+  </span>
   
 
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1856,11 +1864,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../genius/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1877,11 +1885,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1916,32 +1924,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../audio/" class="md-nav__link ">
+            <a href="../../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1952,11 +1960,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/bandcamp/" class="md-nav__link">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1973,11 +1981,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/sliderkz/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1994,11 +2002,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/piped/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2015,11 +2023,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/youtube/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2036,11 +2044,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/soundcloud/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2057,11 +2065,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/base/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2078,11 +2086,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/ytmusic/" class="md-nav__link">
+      <a href="../../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2106,14 +2114,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2190,7 +2190,7 @@ <h2 id="spotdl.providers.lyrics.azlyrics.AzLyrics" class="doc doc-heading">
 <span class="normal">23</span>
 <span class="normal">24</span>
 <span class="normal">25</span>
-<span class="normal">26</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">26</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
     <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
 
     <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">Session</span><span class="p">()</span>
@@ -2260,7 +2260,7 @@ <h6 id="spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--returns">Retur
 <span class="normal">118</span>
 <span class="normal">119</span>
 <span class="normal">120</span>
-<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2383,7 +2383,7 @@ <h6 id="spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--returns">Returns<
 <span class="normal">92</span>
 <span class="normal">93</span>
 <span class="normal">94</span>
-<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2500,7 +2500,7 @@ <h6 id="spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code--returns">Returns<a
 <span class="normal">144</span>
 <span class="normal">145</span>
 <span class="normal">146</span>
-<span class="normal">147</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_x_code</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">147</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_x_code</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the x_code used by AZLyrics.</span>
 
@@ -2602,7 +2602,7 @@ <h6 id="spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code--returns">Returns<a
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/lyrics/base/index.html b/reference/providers/lyrics/base/index.html
index dc1e4351e..8abe80326 100644
--- a/reference/providers/lyrics/base/index.html
+++ b/reference/providers/lyrics/base/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/base/">
       
       
-        <link rel="prev" href="../genius/">
+        <link rel="prev" href="../azlyrics/">
       
       
-        <link rel="next" href="../../audio/">
+        <link rel="next" href="../genius/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,55 +683,7 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
@@ -740,36 +694,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +734,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
+      <a href="../synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    synced
   </span>
   
 
@@ -801,11 +755,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
+      <a href="../musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    musixmatch
   </span>
   
 
@@ -822,11 +776,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    azlyrics
   </span>
   
 
@@ -840,60 +794,186 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    saved
+    base
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base" class="md-nav__link">
+    <span class="md-ellipsis">
+      base
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider" class="md-nav__link">
+    <span class="md-ellipsis">
+      LyricsProvider
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="LyricsProvider">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.name" class="md-nav__link">
+    <span class="md-ellipsis">
+      name
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    result
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      extract_lyrics
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+    <nav class="md-nav" aria-label="extract_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_lyrics
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    song
-  </span>
+</li>
+        
+      </ul>
+    </nav>
   
-
-      </a>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -906,11 +986,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +1025,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../../audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1061,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../../audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +1082,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../../audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +1103,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../../audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1124,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../../audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1145,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../../audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1166,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../../audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1187,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../../audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1209,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1234,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1250,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1270,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1291,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1312,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1354,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1375,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1396,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1459,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1480,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1501,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1522,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1543,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1564,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1585,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1606,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1632,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1641,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1592,49 +1678,85 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" checked>
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
               
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    lyrics
+    saved
   </span>
   
 
-            </a>
+      </a>
+    </li>
+  
+
+              
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/artist/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    artist
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/result/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    result
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1643,11 +1765,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../synced/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    playlist
   </span>
   
 
@@ -1664,11 +1786,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../musixmatch/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    song
   </span>
   
 
@@ -1685,19 +1807,73 @@
   
   
     <li class="md-nav__item">
-      <a href="../azlyrics/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    album
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../download/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    azlyrics
+    download
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1706,11 +1882,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../genius/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1724,186 +1900,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    base
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base" class="md-nav__link">
-    <span class="md-ellipsis">
-      base
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider" class="md-nav__link">
-    <span class="md-ellipsis">
-      LyricsProvider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="LyricsProvider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.name" class="md-nav__link">
-    <span class="md-ellipsis">
-      name
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      extract_lyrics
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="extract_lyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_lyrics
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_lyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.base.LyricsProvider.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1934,32 +1942,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../audio/" class="md-nav__link ">
+            <a href="../../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1970,11 +1978,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/bandcamp/" class="md-nav__link">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1991,11 +1999,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/sliderkz/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2012,11 +2020,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/piped/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2033,11 +2041,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/youtube/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2054,11 +2062,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/soundcloud/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2075,11 +2083,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/base/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2096,11 +2104,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/ytmusic/" class="md-nav__link">
+      <a href="../../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2124,14 +2132,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2217,7 +2217,7 @@ <h2 id="spotdl.providers.lyrics.base.LyricsProvider" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider searchand set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2253,7 +2253,7 @@ <h2 id="spotdl.providers.lyrics.base.LyricsProvider" class="doc doc-heading">
 
 
 <h3 id="spotdl.providers.lyrics.base.LyricsProvider.name" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span></code>
+            <code class="highlight language-python"><span class="n">name</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2307,7 +2307,7 @@ <h6 id="spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--returns">Ret
 <span class="normal">63</span>
 <span class="normal">64</span>
 <span class="normal">65</span>
-<span class="normal">66</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">66</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2407,7 +2407,7 @@ <h6 id="spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--returns">Returns
 <span class="normal">121</span>
 <span class="normal">122</span>
 <span class="normal">123</span>
-<span class="normal">124</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">124</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the lyrics for the given song.</span>
 
@@ -2508,7 +2508,7 @@ <h6 id="spotdl.providers.lyrics.base.LyricsProvider.get_results--returns">Return
 <span class="normal">49</span>
 <span class="normal">50</span>
 <span class="normal">51</span>
-<span class="normal">52</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">52</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2599,7 +2599,7 @@ <h6 id="spotdl.providers.lyrics.base.LyricsProvider.get_results--returns">Return
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/lyrics/genius/index.html b/reference/providers/lyrics/genius/index.html
index d2023a7fb..b331bd9ca 100644
--- a/reference/providers/lyrics/genius/index.html
+++ b/reference/providers/lyrics/genius/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/genius/">
       
       
-        <link rel="prev" href="../azlyrics/">
+        <link rel="prev" href="../base/">
       
       
-        <link rel="next" href="../base/">
+        <link rel="next" href="../../audio/">
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,55 +683,7 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
@@ -740,36 +694,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +734,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
+      <a href="../synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    synced
   </span>
   
 
@@ -801,11 +755,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
+      <a href="../musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    musixmatch
   </span>
   
 
@@ -822,11 +776,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+      <a href="../azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    azlyrics
   </span>
   
 
@@ -843,11 +797,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    base
   </span>
   
 
@@ -861,60 +815,144 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    genius
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    result
+    genius
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius" class="md-nav__link">
+    <span class="md-ellipsis">
+      genius
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius" class="md-nav__link">
+    <span class="md-ellipsis">
+      Genius
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Genius">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius.extract_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      extract_lyrics
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    song
-  </span>
+    <nav class="md-nav" aria-label="extract_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius.extract_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius.extract_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.genius.Genius.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    options
-  </span>
+</li>
+      
+    </ul>
   
-
-      </a>
+</nav>
+      
     </li>
   
 
@@ -945,32 +983,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../../audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1019,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../../audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +1040,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../../audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +1061,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../../audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1082,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../../audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1103,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../../audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1124,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../../audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1145,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../../audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1167,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1192,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1208,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1228,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1249,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1270,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1291,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1312,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1354,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1375,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1396,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1459,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1480,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1501,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1522,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1543,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1564,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1590,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1599,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1592,49 +1636,43 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" checked>
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1643,11 +1681,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../synced/" class="md-nav__link">
+      <a href="../../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1664,11 +1702,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1685,11 +1723,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1703,144 +1741,114 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../../types/song/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    album
   </span>
   
 
       </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
       
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+    
+    
+    
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius" class="md-nav__link">
-    <span class="md-ellipsis">
-      genius
-    </span>
-  </a>
-  
-</li>
       
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius" class="md-nav__link">
-    <span class="md-ellipsis">
-      Genius
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Genius">
-      <ul class="md-nav__list">
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius.extract_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      extract_lyrics
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="extract_lyrics">
-      <ul class="md-nav__list">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius.extract_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius.extract_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../download/" class="md-nav__link ">
+              
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    download
+  </span>
   
-</li>
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.genius.Genius.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    downloader
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1853,11 +1861,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1892,32 +1900,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../audio/" class="md-nav__link ">
+            <a href="../../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1928,11 +1936,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/bandcamp/" class="md-nav__link">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1949,11 +1957,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/sliderkz/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1970,11 +1978,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/piped/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1991,11 +1999,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/youtube/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2012,11 +2020,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/soundcloud/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2033,11 +2041,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/base/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2054,11 +2062,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/ytmusic/" class="md-nav__link">
+      <a href="../../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2082,14 +2090,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2176,7 +2176,7 @@ <h2 id="spotdl.providers.lyrics.genius.Genius" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">access_token</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">access_token</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider search and set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2297,7 +2297,7 @@ <h6 id="spotdl.providers.lyrics.genius.Genius.extract_lyrics--returns">Returns<a
 <span class="normal">131</span>
 <span class="normal">132</span>
 <span class="normal">133</span>
-<span class="normal">134</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">134</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2422,7 +2422,7 @@ <h6 id="spotdl.providers.lyrics.genius.Genius.get_results--returns">Returns<a cl
 <span class="normal">64</span>
 <span class="normal">65</span>
 <span class="normal">66</span>
-<span class="normal">67</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">67</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2528,7 +2528,7 @@ <h6 id="spotdl.providers.lyrics.genius.Genius.get_results--returns">Returns<a cl
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/lyrics/index.html b/reference/providers/lyrics/index.html
index f5fb89460..4e469ab97 100644
--- a/reference/providers/lyrics/index.html
+++ b/reference/providers/lyrics/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,55 +683,7 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
@@ -740,36 +694,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="./" class="md-nav__link md-nav__link--active">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +734,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +755,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +776,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +797,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +818,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +857,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +893,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +977,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +998,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1019,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1041,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1066,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1082,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1102,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1123,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1144,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1165,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1186,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1207,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1228,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1249,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1270,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1291,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1312,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1354,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1375,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1396,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1464,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1473,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1592,49 +1510,43 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" checked>
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="./" class="md-nav__link md-nav__link--active">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1643,11 +1555,11 @@
   
   
     <li class="md-nav__item">
-      <a href="synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1664,11 +1576,11 @@
   
   
     <li class="md-nav__item">
-      <a href="musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1685,11 +1597,11 @@
   
   
     <li class="md-nav__item">
-      <a href="azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1706,11 +1618,11 @@
   
   
     <li class="md-nav__item">
-      <a href="genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1727,11 +1639,11 @@
   
   
     <li class="md-nav__item">
-      <a href="base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1766,32 +1678,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1802,11 +1714,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1823,11 +1735,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1837,6 +1749,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1844,11 +1810,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/piped/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1865,11 +1831,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/youtube/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1886,11 +1852,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1907,11 +1873,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/base/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1928,11 +1894,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1942,9 +1908,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2040,7 +2040,7 @@ <h2 id="spotdl.providers.lyrics.AzLyrics" class="doc doc-heading">
 <span class="normal">23</span>
 <span class="normal">24</span>
 <span class="normal">25</span>
-<span class="normal">26</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">26</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
     <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
 
     <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">Session</span><span class="p">()</span>
@@ -2110,7 +2110,7 @@ <h6 id="spotdl.providers.lyrics.AzLyrics.extract_lyrics--returns">Returns<a clas
 <span class="normal">118</span>
 <span class="normal">119</span>
 <span class="normal">120</span>
-<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2233,7 +2233,7 @@ <h6 id="spotdl.providers.lyrics.AzLyrics.get_results--returns">Returns<a class="
 <span class="normal">92</span>
 <span class="normal">93</span>
 <span class="normal">94</span>
-<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2350,7 +2350,7 @@ <h6 id="spotdl.providers.lyrics.AzLyrics.get_x_code--returns">Returns<a class="h
 <span class="normal">144</span>
 <span class="normal">145</span>
 <span class="normal">146</span>
-<span class="normal">147</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_x_code</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">147</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_x_code</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the x_code used by AZLyrics.</span>
 
@@ -2429,7 +2429,7 @@ <h2 id="spotdl.providers.lyrics.Genius" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">access_token</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">access_token</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider search and set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2550,7 +2550,7 @@ <h6 id="spotdl.providers.lyrics.Genius.extract_lyrics--returns">Returns<a class=
 <span class="normal">131</span>
 <span class="normal">132</span>
 <span class="normal">133</span>
-<span class="normal">134</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">134</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2675,7 +2675,7 @@ <h6 id="spotdl.providers.lyrics.Genius.get_results--returns">Returns<a class="he
 <span class="normal">64</span>
 <span class="normal">65</span>
 <span class="normal">66</span>
-<span class="normal">67</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">67</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2757,7 +2757,7 @@ <h2 id="spotdl.providers.lyrics.LyricsProvider" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider searchand set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2793,7 +2793,7 @@ <h2 id="spotdl.providers.lyrics.LyricsProvider" class="doc doc-heading">
 
 
 <h3 id="spotdl.providers.lyrics.LyricsProvider.name" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span></code>
+            <code class="highlight language-python"><span class="n">name</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2847,7 +2847,7 @@ <h6 id="spotdl.providers.lyrics.LyricsProvider.extract_lyrics--returns">Returns<
 <span class="normal">63</span>
 <span class="normal">64</span>
 <span class="normal">65</span>
-<span class="normal">66</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">66</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2947,7 +2947,7 @@ <h6 id="spotdl.providers.lyrics.LyricsProvider.get_lyrics--returns">Returns<a cl
 <span class="normal">121</span>
 <span class="normal">122</span>
 <span class="normal">123</span>
-<span class="normal">124</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">124</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the lyrics for the given song.</span>
 
@@ -3048,7 +3048,7 @@ <h6 id="spotdl.providers.lyrics.LyricsProvider.get_results--returns">Returns<a c
 <span class="normal">49</span>
 <span class="normal">50</span>
 <span class="normal">51</span>
-<span class="normal">52</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">52</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -3117,7 +3117,7 @@ <h2 id="spotdl.providers.lyrics.MusixMatch" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider searchand set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3197,7 +3197,7 @@ <h6 id="spotdl.providers.lyrics.MusixMatch.extract_lyrics--returns">Returns<a cl
 <span class="normal">42</span>
 <span class="normal">43</span>
 <span class="normal">44</span>
-<span class="normal">45</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">45</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -3305,7 +3305,7 @@ <h6 id="spotdl.providers.lyrics.MusixMatch.get_results--returns">Returns<a class
 <span class="normal"> 97</span>
 <span class="normal"> 98</span>
 <span class="normal"> 99</span>
-<span class="normal">100</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">100</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -3415,7 +3415,7 @@ <h2 id="spotdl.providers.lyrics.Synced" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider searchand set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3484,7 +3484,7 @@ <h6 id="spotdl.providers.lyrics.Synced.extract_lyrics--returns">Returns<a class=
 <span class="normal">45</span>
 <span class="normal">46</span>
 <span class="normal">47</span>
-<span class="normal">48</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">48</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -3556,7 +3556,7 @@ <h6 id="spotdl.providers.lyrics.Synced.get_lyrics--returns">Returns<a class="hea
 <span class="normal">75</span>
 <span class="normal">76</span>
 <span class="normal">77</span>
-<span class="normal">78</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">78</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Try to get lyrics using syncedlyrics</span>
 
@@ -3629,7 +3629,7 @@ <h6 id="spotdl.providers.lyrics.Synced.get_results--returns">Returns<a class="he
 <span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
-<span class="normal">34</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">34</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -3720,7 +3720,7 @@ <h6 id="spotdl.providers.lyrics.Synced.get_results--returns">Returns<a class="he
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/lyrics/musixmatch/index.html b/reference/providers/lyrics/musixmatch/index.html
index c0fee5d72..897e3446c 100644
--- a/reference/providers/lyrics/musixmatch/index.html
+++ b/reference/providers/lyrics/musixmatch/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,55 +683,7 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
@@ -740,36 +694,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +734,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
+      <a href="../synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    synced
   </span>
   
 
@@ -798,60 +752,144 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    musixmatch
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    playlist
+    musixmatch
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch" class="md-nav__link">
+    <span class="md-ellipsis">
+      musixmatch
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch" class="md-nav__link">
+    <span class="md-ellipsis">
+      MusixMatch
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="MusixMatch">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      extract_lyrics
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    album
-  </span>
+    <nav class="md-nav" aria-label="extract_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    saved
-  </span>
+</li>
+      
+    </ul>
   
-
-      </a>
+</nav>
+      
     </li>
   
 
@@ -864,11 +902,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +923,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +944,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +983,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../../audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1019,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../../audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +1040,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../../audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +1061,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../../audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1082,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../../audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1103,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../../audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1124,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../../audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1145,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../../audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1167,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1192,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1208,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1228,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1249,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1270,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1291,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1312,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1354,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1375,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1396,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1459,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1480,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1501,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1522,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1543,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1564,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,8 +1590,6 @@
                 
   
   
-    
-  
   
   
     
@@ -1555,36 +1599,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1592,49 +1636,22 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" checked>
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1643,11 +1660,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../synced/" class="md-nav__link">
+      <a href="../../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    saved
   </span>
   
 
@@ -1661,144 +1678,81 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../../types/artist/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    musixmatch
+    artist
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
+    </li>
   
+
+              
+            
+              
+                
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch" class="md-nav__link">
-    <span class="md-ellipsis">
-      musixmatch
-    </span>
-  </a>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch" class="md-nav__link">
-    <span class="md-ellipsis">
-      MusixMatch
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="MusixMatch">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      extract_lyrics
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="extract_lyrics">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    playlist
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../types/song/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    song
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1811,11 +1765,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../azlyrics/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    album
   </span>
   
 
@@ -1825,6 +1779,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../download/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1832,11 +1840,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../genius/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1853,11 +1861,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1892,32 +1900,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../audio/" class="md-nav__link ">
+            <a href="../../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1928,11 +1936,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/bandcamp/" class="md-nav__link">
+      <a href="../../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1949,11 +1957,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/sliderkz/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1970,11 +1978,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/piped/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1991,11 +1999,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/youtube/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2012,11 +2020,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/soundcloud/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2033,11 +2041,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/base/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2054,11 +2062,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/ytmusic/" class="md-nav__link">
+      <a href="../../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2082,14 +2090,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2177,7 +2177,7 @@ <h2 id="spotdl.providers.lyrics.musixmatch.MusixMatch" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider searchand set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2257,7 +2257,7 @@ <h6 id="spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--returns">R
 <span class="normal">42</span>
 <span class="normal">43</span>
 <span class="normal">44</span>
-<span class="normal">45</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">45</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">_</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2365,7 +2365,7 @@ <h6 id="spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--returns">Retu
 <span class="normal"> 97</span>
 <span class="normal"> 98</span>
 <span class="normal"> 99</span>
-<span class="normal">100</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">100</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2496,7 +2496,7 @@ <h6 id="spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--returns">Retu
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/providers/lyrics/synced/index.html b/reference/providers/lyrics/synced/index.html
index 68b0f5bd6..fd2fb1e7c 100644
--- a/reference/providers/lyrics/synced/index.html
+++ b/reference/providers/lyrics/synced/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -635,6 +635,8 @@
                 
   
   
+    
+  
   
   
     
@@ -644,20 +646,20 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../download/" class="md-nav__link ">
+            <a href="../../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -670,10 +672,10 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -681,55 +683,7 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
@@ -740,36 +694,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../types/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -777,60 +731,177 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/artist/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    synced
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    artist
+    synced
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../../types/playlist/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced" class="md-nav__link">
+    <span class="md-ellipsis">
+      synced
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced" class="md-nav__link">
+    <span class="md-ellipsis">
+      Synced
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Synced">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.extract_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      extract_lyrics
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    playlist
-  </span>
+    <nav class="md-nav" aria-label="extract_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.extract_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.extract_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.get_lyrics" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_lyrics
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_lyrics">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.get_lyrics--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.get_lyrics--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../../types/album/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    album
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.get_results" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_results
+    </span>
+  </a>
   
-
-      </a>
+    <nav class="md-nav" aria-label="get_results">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.get_results--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.providers.lyrics.synced.Synced.get_results--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -843,11 +914,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/saved/" class="md-nav__link">
+      <a href="../musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/result/" class="md-nav__link">
+      <a href="../azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/song/" class="md-nav__link">
+      <a href="../base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +977,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../types/options/" class="md-nav__link">
+      <a href="../genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +1016,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../../console/" class="md-nav__link ">
+            <a href="../../audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1052,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/save/" class="md-nav__link">
+      <a href="../../audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +1073,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/url/" class="md-nav__link">
+      <a href="../../audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +1094,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/meta/" class="md-nav__link">
+      <a href="../../audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +1115,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/web/" class="md-nav__link">
+      <a href="../../audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +1136,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/sync/" class="md-nav__link">
+      <a href="../../audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +1157,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/download/" class="md-nav__link">
+      <a href="../../audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1178,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../console/entry_point/" class="md-nav__link">
+      <a href="../../audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1200,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1146,7 +1225,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1162,14 +1241,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1182,11 +1261,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/console/" class="md-nav__link">
+      <a href="../../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1203,11 +1282,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/formatter/" class="md-nav__link">
+      <a href="../../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1224,11 +1303,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/arguments/" class="md-nav__link">
+      <a href="../../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1245,11 +1324,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/metadata/" class="md-nav__link">
+      <a href="../../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1266,11 +1345,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/downloader/" class="md-nav__link">
+      <a href="../../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1287,11 +1366,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/github/" class="md-nav__link">
+      <a href="../../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1308,11 +1387,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/static/" class="md-nav__link">
+      <a href="../../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1329,11 +1408,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/search/" class="md-nav__link">
+      <a href="../../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1350,11 +1429,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/web/" class="md-nav__link">
+      <a href="../../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1371,11 +1450,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/logging/" class="md-nav__link">
+      <a href="../../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1392,11 +1471,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/spotify/" class="md-nav__link">
+      <a href="../../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1413,11 +1492,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/matching/" class="md-nav__link">
+      <a href="../../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1434,11 +1513,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1455,11 +1534,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/m3u/" class="md-nav__link">
+      <a href="../../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1476,11 +1555,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/config/" class="md-nav__link">
+      <a href="../../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1497,11 +1576,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/lrc/" class="md-nav__link">
+      <a href="../../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1518,11 +1597,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../utils/archive/" class="md-nav__link">
+      <a href="../../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1544,56 +1623,6 @@
                 
   
   
-    
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" checked>
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
   
   
     
@@ -1603,214 +1632,97 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced" class="md-nav__link">
-    <span class="md-ellipsis">
-      synced
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced" class="md-nav__link">
-    <span class="md-ellipsis">
-      Synced
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Synced">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.extract_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      extract_lyrics
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="extract_lyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.extract_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.extract_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.get_lyrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_lyrics
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="get_lyrics">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.get_lyrics--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../../types/options/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.get_lyrics--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    options
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.get_results" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_results
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label="get_results">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.get_results--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.providers.lyrics.synced.Synced.get_results--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/saved/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../types/artist/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    artist
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1823,11 +1735,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../musixmatch/" class="md-nav__link">
+      <a href="../../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1844,11 +1756,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../azlyrics/" class="md-nav__link">
+      <a href="../../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1865,11 +1777,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../genius/" class="md-nav__link">
+      <a href="../../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1886,11 +1798,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
+      <a href="../../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1925,32 +1837,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../audio/" class="md-nav__link ">
+            <a href="../../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1961,11 +1873,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/bandcamp/" class="md-nav__link">
+      <a href="../../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1982,11 +1894,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/sliderkz/" class="md-nav__link">
+      <a href="../../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -2003,11 +1990,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/piped/" class="md-nav__link">
+      <a href="../../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -2024,11 +2011,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/youtube/" class="md-nav__link">
+      <a href="../../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -2045,11 +2032,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/soundcloud/" class="md-nav__link">
+      <a href="../../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2066,11 +2053,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/base/" class="md-nav__link">
+      <a href="../../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2087,11 +2074,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../audio/ytmusic/" class="md-nav__link">
+      <a href="../../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2101,9 +2088,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2211,7 +2211,7 @@ <h2 id="spotdl.providers.lyrics.synced.Synced" class="doc doc-heading">
 <span class="normal">34</span>
 <span class="normal">35</span>
 <span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Init the lyrics provider searchand set headers.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2280,7 +2280,7 @@ <h6 id="spotdl.providers.lyrics.synced.Synced.extract_lyrics--returns">Returns<a
 <span class="normal">45</span>
 <span class="normal">46</span>
 <span class="normal">47</span>
-<span class="normal">48</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">48</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">extract_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Extracts the lyrics from the given url.</span>
 
@@ -2352,7 +2352,7 @@ <h6 id="spotdl.providers.lyrics.synced.Synced.get_lyrics--returns">Returns<a cla
 <span class="normal">75</span>
 <span class="normal">76</span>
 <span class="normal">77</span>
-<span class="normal">78</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="normal">78</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_lyrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Try to get lyrics using syncedlyrics</span>
 
@@ -2425,7 +2425,7 @@ <h6 id="spotdl.providers.lyrics.synced.Synced.get_results--returns">Returns<a cl
 <span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
-<span class="normal">34</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
+<span class="normal">34</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns the results for the given song.</span>
 
@@ -2516,7 +2516,7 @@ <h6 id="spotdl.providers.lyrics.synced.Synced.get_results--returns">Returns<a cl
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/album/index.html b/reference/types/album/index.html
index 2eda83889..8a8079ae6 100644
--- a/reference/types/album/index.html
+++ b/reference/types/album/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/album/">
       
       
-        <link rel="prev" href="../playlist/">
+        <link rel="prev" href="../song/">
       
       
-        <link rel="next" href="../saved/">
+        <link rel="next" href="../../download/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,58 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
     
     
     
@@ -742,36 +690,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,159 +730,15 @@
   
   
     <li class="md-nav__item">
-      <a href="../artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    album
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.album" class="md-nav__link">
-    <span class="md-ellipsis">
-      album
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.album.Album" class="md-nav__link">
-    <span class="md-ellipsis">
-      Album
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Album">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.album.Album.get_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_metadata
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_metadata">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.album.Album.get_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.album.Album.get_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.album.AlbumError" class="md-nav__link">
-    <span class="md-ellipsis">
-      AlbumError
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -947,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -968,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -989,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1010,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1049,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1085,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1106,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1127,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1148,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1169,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1190,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1211,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1233,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1250,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1266,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1286,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1307,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1328,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1349,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1370,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1391,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1412,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1433,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1454,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1475,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1496,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1517,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1538,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1559,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1580,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1601,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1622,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1648,6 +1460,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1657,36 +1471,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1696,45 +1510,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1743,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1764,11 +1574,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1785,11 +1595,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1806,11 +1616,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1824,18 +1634,120 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    album
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
       </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.album" class="md-nav__link">
+    <span class="md-ellipsis">
+      album
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.album.Album" class="md-nav__link">
+    <span class="md-ellipsis">
+      Album
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Album">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.album.Album.get_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_metadata
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="get_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.album.Album.get_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.album.Album.get_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.album.AlbumError" class="md-nav__link">
+    <span class="md-ellipsis">
+      AlbumError
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1866,32 +1778,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1902,11 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1923,11 +1835,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1937,6 +1849,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1944,11 +1910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1965,11 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1986,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2007,11 +1973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2028,11 +1994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2042,9 +2008,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2267,7 +2267,7 @@ <h6 id="spotdl.types.album.Album.get_metadata--returns">Returns<a class="headerl
 <span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@staticmethod</span>
-<span class="k">def</span> <span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for album.</span>
 
@@ -2462,7 +2462,7 @@ <h2 id="spotdl.types.album.AlbumError" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/artist/index.html b/reference/types/artist/index.html
index 2d4de4eee..696ed840f 100644
--- a/reference/types/artist/index.html
+++ b/reference/types/artist/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/artist/">
       
       
-        <link rel="prev" href="../">
+        <link rel="prev" href="../saved/">
       
       
-        <link rel="next" href="../playlist/">
+        <link rel="next" href="../result/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -731,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -742,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -779,120 +886,18 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.artist" class="md-nav__link">
-    <span class="md-ellipsis">
-      artist
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.artist.Artist" class="md-nav__link">
-    <span class="md-ellipsis">
-      Artist
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Artist">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.artist.Artist.get_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_metadata
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_metadata">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.artist.Artist.get_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.artist.Artist.get_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.artist.ArtistError" class="md-nav__link">
-    <span class="md-ellipsis">
-      ArtistError
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -905,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -926,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -947,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -968,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -989,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1010,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -1032,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1049,32 +1062,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1085,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1106,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1127,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1148,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1169,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1190,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1211,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1225,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1286,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1307,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1328,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1349,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1370,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1412,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1433,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1454,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1468,6 +1448,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    types
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1475,11 +1511,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    options
   </span>
   
 
@@ -1496,11 +1532,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    saved
   </span>
   
 
@@ -1514,39 +1550,120 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    artist
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    matching
+    artist
   </span>
   
 
       </a>
-    </li>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.artist" class="md-nav__link">
+    <span class="md-ellipsis">
+      artist
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.artist.Artist" class="md-nav__link">
+    <span class="md-ellipsis">
+      Artist
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="Artist">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.artist.Artist.get_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_metadata
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.artist.Artist.get_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.artist.Artist.get_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    ffmpeg
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.artist.ArtistError" class="md-nav__link">
+    <span class="md-ellipsis">
+      ArtistError
+    </span>
+  </a>
   
-
-      </a>
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1559,11 +1676,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1580,11 +1697,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1601,11 +1718,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1622,11 +1739,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1661,78 +1778,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1743,74 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1827,11 +1835,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1866,32 +1874,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1902,11 +1910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1923,11 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1944,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1965,11 +1973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -1986,11 +1994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2007,11 +2015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2028,11 +2036,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2056,14 +2064,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2252,7 +2252,7 @@ <h6 id="spotdl.types.artist.Artist.get_metadata--returns">Returns<a class="heade
 <span class="normal">104</span>
 <span class="normal">105</span>
 <span class="normal">106</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@staticmethod</span>
-<span class="k">def</span> <span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for artist.</span>
 
@@ -2430,7 +2430,7 @@ <h2 id="spotdl.types.artist.ArtistError" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/index.html b/reference/types/index.html
index 1db0ca21a..71ea22627 100644
--- a/reference/types/index.html
+++ b/reference/types/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/">
       
       
-        <link rel="prev" href="../download/progress_handler/">
+        <link rel="prev" href="../utils/formatter/">
       
       
-        <link rel="next" href="artist/">
+        <link rel="next" href="options/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../download/" class="md-nav__link ">
+            <a href="../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,58 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
     
     
     
@@ -742,36 +690,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="./" class="md-nav__link md-nav__link--active">
+            <a href="../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="album/" class="md-nav__link">
+      <a href="../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -845,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="saved/" class="md-nav__link">
+      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -866,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="result/" class="md-nav__link">
+      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -887,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="song/" class="md-nav__link">
+      <a href="../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -908,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="options/" class="md-nav__link">
+      <a href="../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -947,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../console/" class="md-nav__link ">
+            <a href="../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -983,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/save/" class="md-nav__link">
+      <a href="../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1004,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/url/" class="md-nav__link">
+      <a href="../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1025,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/meta/" class="md-nav__link">
+      <a href="../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1046,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/web/" class="md-nav__link">
+      <a href="../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1067,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/sync/" class="md-nav__link">
+      <a href="../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1088,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/download/" class="md-nav__link">
+      <a href="../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1109,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/entry_point/" class="md-nav__link">
+      <a href="../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1131,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1062,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1164,14 +1078,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/console/" class="md-nav__link">
+      <a href="../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/formatter/" class="md-nav__link">
+      <a href="../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/arguments/" class="md-nav__link">
+      <a href="../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/metadata/" class="md-nav__link">
+      <a href="../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/downloader/" class="md-nav__link">
+      <a href="../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/github/" class="md-nav__link">
+      <a href="../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/static/" class="md-nav__link">
+      <a href="../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/search/" class="md-nav__link">
+      <a href="../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/web/" class="md-nav__link">
+      <a href="../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1373,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/logging/" class="md-nav__link">
+      <a href="../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1394,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/spotify/" class="md-nav__link">
+      <a href="../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1415,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/matching/" class="md-nav__link">
+      <a href="../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1436,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/ffmpeg/" class="md-nav__link">
+      <a href="../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1457,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/m3u/" class="md-nav__link">
+      <a href="../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1478,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/config/" class="md-nav__link">
+      <a href="../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1499,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/lrc/" class="md-nav__link">
+      <a href="../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1520,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../utils/archive/" class="md-nav__link">
+      <a href="../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1546,6 +1460,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1555,36 +1471,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/" class="md-nav__link ">
+            <a href="./" class="md-nav__link md-nav__link--active">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1510,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/synced/" class="md-nav__link">
+      <a href="artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1574,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1595,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1616,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/genius/" class="md-nav__link">
+      <a href="song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1637,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/base/" class="md-nav__link">
+      <a href="album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1764,32 +1676,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/audio/" class="md-nav__link ">
+            <a href="../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1800,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1821,11 +1733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1835,6 +1747,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1842,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/piped/" class="md-nav__link">
+      <a href="../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1863,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/youtube/" class="md-nav__link">
+      <a href="../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1884,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1905,11 +1871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/base/" class="md-nav__link">
+      <a href="../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1926,11 +1892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1940,9 +1906,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2071,7 +2071,7 @@ <h1>types</h1>
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/options/index.html b/reference/types/options/index.html
index 025bd7ca7..44cb3a2eb 100644
--- a/reference/types/options/index.html
+++ b/reference/types/options/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/options/">
       
       
-        <link rel="prev" href="../song/">
+        <link rel="prev" href="../">
       
       
-        <link rel="next" href="../../console/">
+        <link rel="next" href="../saved/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -731,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -742,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -803,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -824,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -845,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -866,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -887,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -905,134 +1012,25 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    options
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options" class="md-nav__link">
-    <span class="md-ellipsis">
-      options
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.DownloaderOptionalOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      DownloaderOptionalOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.DownloaderOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      DownloaderOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.SpotDLOptionalOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpotDLOptionalOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.SpotDLOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpotDLOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.SpotifyOptionalOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpotifyOptionalOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.SpotifyOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpotifyOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.WebOptionalOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      WebOptionalOptions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.options.WebOptions" class="md-nav__link">
-    <span class="md-ellipsis">
-      WebOptions
-    </span>
-  </a>
+    sliderkz
+  </span>
   
-</li>
-      
-    </ul>
+
+      </a>
+    </li>
   
-</nav>
+
+              
+            
+          </ul>
+        </nav>
       
     </li>
   
@@ -1064,32 +1062,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1100,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1121,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1142,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1163,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1184,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1205,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1226,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1240,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1301,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1322,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1343,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1364,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1385,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1427,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1448,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1469,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1483,43 +1448,195 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
+    
+  
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
         
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    options
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    options
   </span>
   
 
       </a>
-    </li>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options" class="md-nav__link">
+    <span class="md-ellipsis">
+      options
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.DownloaderOptionalOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      DownloaderOptionalOptions
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.DownloaderOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      DownloaderOptions
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.SpotDLOptionalOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      SpotDLOptionalOptions
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.SpotDLOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      SpotDLOptions
+    </span>
+  </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.SpotifyOptionalOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      SpotifyOptionalOptions
+    </span>
+  </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.SpotifyOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      SpotifyOptions
+    </span>
+  </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.WebOptionalOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      WebOptionalOptions
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
-        
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.options.WebOptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      WebOptions
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    spotify
-  </span>
+</li>
+      
+    </ul>
   
-
-      </a>
+</nav>
+      
     </li>
   
 
@@ -1532,11 +1649,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1553,11 +1670,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1574,11 +1691,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1595,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1616,11 +1733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1637,11 +1754,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1676,78 +1793,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1758,74 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1842,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1881,32 +1889,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1917,11 +1925,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1938,11 +1946,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1959,11 +1967,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1980,11 +1988,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2001,11 +2009,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2022,11 +2030,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2043,11 +2051,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2071,14 +2079,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2543,7 +2543,7 @@ <h2 id="spotdl.types.options.WebOptions" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/playlist/index.html b/reference/types/playlist/index.html
index c5bea150a..5e870a6b8 100644
--- a/reference/types/playlist/index.html
+++ b/reference/types/playlist/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/playlist/">
       
       
-        <link rel="prev" href="../artist/">
+        <link rel="prev" href="../result/">
       
       
-        <link rel="next" href="../album/">
+        <link rel="next" href="../song/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -731,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -742,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -800,120 +907,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    playlist
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.playlist" class="md-nav__link">
-    <span class="md-ellipsis">
-      playlist
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.playlist.Playlist" class="md-nav__link">
-    <span class="md-ellipsis">
-      Playlist
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Playlist">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.playlist.Playlist.get_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_metadata
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_metadata">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.playlist.Playlist.get_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.playlist.Playlist.get_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.playlist.PlaylistError" class="md-nav__link">
-    <span class="md-ellipsis">
-      PlaylistError
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -926,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -947,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -968,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -989,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1010,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -1032,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1049,32 +1062,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1085,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1106,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1127,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1148,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1169,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1190,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1211,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1225,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1286,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1307,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1328,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1349,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1370,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1412,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1433,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1454,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1468,6 +1448,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    types
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1475,11 +1511,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    options
   </span>
   
 
@@ -1496,11 +1532,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    saved
   </span>
   
 
@@ -1517,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+      <a href="../artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    artist
   </span>
   
 
@@ -1538,11 +1574,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    result
   </span>
   
 
@@ -1556,39 +1592,120 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    playlist
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    m3u
+    playlist
   </span>
   
-
-      </a>
-    </li>
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.playlist" class="md-nav__link">
+    <span class="md-ellipsis">
+      playlist
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.playlist.Playlist" class="md-nav__link">
+    <span class="md-ellipsis">
+      Playlist
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="Playlist">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.playlist.Playlist.get_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_metadata
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.playlist.Playlist.get_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.playlist.Playlist.get_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    config
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.playlist.PlaylistError" class="md-nav__link">
+    <span class="md-ellipsis">
+      PlaylistError
+    </span>
+  </a>
   
-
-      </a>
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1601,11 +1718,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1622,11 +1739,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1661,78 +1778,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1743,74 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1827,11 +1835,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1866,32 +1874,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1902,11 +1910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1923,11 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1944,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1965,11 +1973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -1986,11 +1994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2007,11 +2015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2028,11 +2036,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2056,14 +2064,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2288,7 +2288,7 @@ <h6 id="spotdl.types.playlist.Playlist.get_metadata--returns">Returns<a class="h
 <span class="normal">143</span>
 <span class="normal">144</span>
 <span class="normal">145</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@staticmethod</span>
-<span class="k">def</span> <span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for a playlist.</span>
 
@@ -2504,7 +2504,7 @@ <h2 id="spotdl.types.playlist.PlaylistError" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/result/index.html b/reference/types/result/index.html
index 648c4e7af..4e00b06a5 100644
--- a/reference/types/result/index.html
+++ b/reference/types/result/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/result/">
       
       
-        <link rel="prev" href="../saved/">
+        <link rel="prev" href="../artist/">
       
       
-        <link rel="next" href="../song/">
+        <link rel="next" href="../playlist/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -731,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -742,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -803,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -824,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -845,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -863,168 +970,18 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    result
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.result" class="md-nav__link">
-    <span class="md-ellipsis">
-      result
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result" class="md-nav__link">
-    <span class="md-ellipsis">
-      Result
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Result">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.json" class="md-nav__link">
-    <span class="md-ellipsis">
-      json
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="json">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.json--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.from_data_dump" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_data_dump
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_data_dump">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.from_data_dump--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.from_data_dump--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.from_dict" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_dict
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_dict">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.from_dict--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.result.Result.from_dict--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -1037,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1058,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -1080,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1097,32 +1062,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1133,11 +1098,53 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../utils/m3u/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    m3u
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../utils/metadata/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    metadata
   </span>
   
 
@@ -1154,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    logging
   </span>
   
 
@@ -1175,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    static
   </span>
   
 
@@ -1196,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    matching
   </span>
   
 
@@ -1217,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    search
   </span>
   
 
@@ -1238,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    downloader
   </span>
   
 
@@ -1259,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    archive
   </span>
   
 
@@ -1273,59 +1280,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    lrc
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1334,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    config
   </span>
   
 
@@ -1355,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    arguments
   </span>
   
 
@@ -1376,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    console
   </span>
   
 
@@ -1397,11 +1371,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    github
   </span>
   
 
@@ -1418,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    web
   </span>
   
 
@@ -1439,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    ffmpeg
   </span>
   
 
@@ -1460,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    formatter
   </span>
   
 
@@ -1474,26 +1448,61 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
         
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    search
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1502,11 +1511,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    options
   </span>
   
 
@@ -1523,11 +1532,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    saved
   </span>
   
 
@@ -1544,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+      <a href="../artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    artist
   </span>
   
 
@@ -1562,60 +1571,168 @@
                 
   
   
+    
+  
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    result
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    matching
+    result
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.result" class="md-nav__link">
+    <span class="md-ellipsis">
+      result
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result" class="md-nav__link">
+    <span class="md-ellipsis">
+      Result
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Result">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.json" class="md-nav__link">
+    <span class="md-ellipsis">
+      json
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="json">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.json--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.from_data_dump" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_data_dump
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="from_data_dump">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.from_data_dump--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.from_data_dump--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    ffmpeg
-  </span>
-  
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.from_dict" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_dict
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="from_dict">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.from_dict--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.result.Result.from_dict--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    m3u
-  </span>
+</li>
+      
+    </ul>
   
-
-      </a>
+</nav>
+      
     </li>
   
 
@@ -1628,11 +1745,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1649,11 +1766,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1670,11 +1787,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1709,78 +1826,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1791,74 +1862,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1875,11 +1883,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1914,32 +1922,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1950,11 +1958,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1971,11 +1979,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1992,11 +2000,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2013,11 +2021,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2034,11 +2042,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2055,11 +2063,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2076,11 +2084,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2104,14 +2112,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2200,7 +2200,7 @@ <h2 id="spotdl.types.result.Result" class="doc doc-heading">
 
 
 <h3 id="spotdl.types.result.Result.json" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">json</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span></code>
+            <code class="highlight language-python"><span class="n">json</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2266,7 +2266,7 @@ <h6 id="spotdl.types.result.Result.from_data_dump--returns">Returns<a class="hea
 <span class="normal">59</span>
 <span class="normal">60</span>
 <span class="normal">61</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_data_dump</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Result&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_data_dump</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Result&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a Result object from a data dump.</span>
 
@@ -2329,7 +2329,7 @@ <h6 id="spotdl.types.result.Result.from_dict--returns">Returns<a class="headerli
 <span class="normal">74</span>
 <span class="normal">75</span>
 <span class="normal">76</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_dict</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="s2">&quot;Result&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_dict</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="s2">&quot;Result&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a Song object from a dictionary.</span>
 
@@ -2419,7 +2419,7 @@ <h6 id="spotdl.types.result.Result.from_dict--returns">Returns<a class="headerli
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/saved/index.html b/reference/types/saved/index.html
index caef0c16e..86f6e2211 100644
--- a/reference/types/saved/index.html
+++ b/reference/types/saved/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/saved/">
       
       
-        <link rel="prev" href="../album/">
+        <link rel="prev" href="../options/">
       
       
-        <link rel="next" href="../result/">
+        <link rel="next" href="../artist/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -731,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -742,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -803,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -824,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -842,120 +949,18 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    saved
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.saved" class="md-nav__link">
-    <span class="md-ellipsis">
-      saved
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.saved.Saved" class="md-nav__link">
-    <span class="md-ellipsis">
-      Saved
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Saved">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.saved.Saved.get_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_metadata
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="get_metadata">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.saved.Saved.get_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.saved.Saved.get_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.saved.SavedError" class="md-nav__link">
-    <span class="md-ellipsis">
-      SavedError
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
     </li>
   
 
@@ -968,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -989,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1010,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -1032,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1049,32 +1062,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../utils/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1085,11 +1098,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1106,11 +1119,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1127,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1148,11 +1161,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1169,11 +1182,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1190,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1211,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1225,59 +1238,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1286,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    archive
   </span>
   
 
@@ -1307,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/formatter/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    lrc
   </span>
   
 
@@ -1328,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    config
   </span>
   
 
@@ -1349,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    arguments
   </span>
   
 
@@ -1370,11 +1350,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../../utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1412,11 +1392,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../../utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1433,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1454,11 +1434,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+      <a href="../../utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1468,6 +1448,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    types
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1475,11 +1511,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+      <a href="../options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    options
   </span>
   
 
@@ -1493,39 +1529,120 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    spotify
+    saved
   </span>
   
 
       </a>
-    </li>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.saved" class="md-nav__link">
+    <span class="md-ellipsis">
+      saved
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.saved.Saved" class="md-nav__link">
+    <span class="md-ellipsis">
+      Saved
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="Saved">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.saved.Saved.get_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_metadata
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.saved.Saved.get_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.saved.Saved.get_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    matching
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.saved.SavedError" class="md-nav__link">
+    <span class="md-ellipsis">
+      SavedError
+    </span>
+  </a>
   
-
-      </a>
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1538,11 +1655,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+      <a href="../artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1559,11 +1676,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+      <a href="../result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1580,11 +1697,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+      <a href="../playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1601,11 +1718,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+      <a href="../song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1622,11 +1739,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1661,78 +1778,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1743,74 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1827,11 +1835,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1866,32 +1874,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1902,11 +1910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1923,11 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1944,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1965,11 +1973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -1986,11 +1994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2007,11 +2015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2028,11 +2036,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2056,14 +2064,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2252,7 +2252,7 @@ <h6 id="spotdl.types.saved.Saved.get_metadata--returns">Returns<a class="headerl
 <span class="normal"> 98</span>
 <span class="normal"> 99</span>
 <span class="normal">100</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@staticmethod</span>
-<span class="k">def</span> <span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;saved&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;saved&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns metadata for a saved list.</span>
 
@@ -2431,7 +2431,7 @@ <h2 id="spotdl.types.saved.SavedError" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/types/song/index.html b/reference/types/song/index.html
index ecb491f12..57aa7abcc 100644
--- a/reference/types/song/index.html
+++ b/reference/types/song/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/types/song/">
       
       
-        <link rel="prev" href="../result/">
+        <link rel="prev" href="../playlist/">
       
       
-        <link rel="next" href="../options/">
+        <link rel="next" href="../album/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -731,8 +840,6 @@
                 
   
   
-    
-  
   
   
     
@@ -742,36 +849,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -782,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -803,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -824,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -845,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -866,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -884,537 +991,143 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../../providers/audio/base/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    sliderkz
   </span>
   
 
       </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
       
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
   
+
+              
+            
+              
+                
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.song" class="md-nav__link">
-    <span class="md-ellipsis">
-      song
-    </span>
-  </a>
   
-</li>
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
       
-        <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song" class="md-nav__link">
-    <span class="md-ellipsis">
-      Song
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Song">
-      <ul class="md-nav__list">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.display_name" class="md-nav__link">
-    <span class="md-ellipsis">
-      display_name
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="display_name">
-      <ul class="md-nav__list">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.display_name--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.json" class="md-nav__link">
-    <span class="md-ellipsis">
-      json
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="json">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.json--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_data_dump" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_data_dump
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_data_dump">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_data_dump--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_data_dump--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_dict" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_dict
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_dict">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_dict--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_dict--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_missing_data" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_missing_data
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_missing_data">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_missing_data--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_missing_data--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_search_term" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_search_term
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_search_term">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_search_term--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_search_term--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_url" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_url
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="from_url">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_url--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.from_url--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.list_from_search_term" class="md-nav__link">
-    <span class="md-ellipsis">
-      list_from_search_term
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="list_from_search_term">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.list_from_search_term--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.list_from_search_term--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.search" class="md-nav__link">
-    <span class="md-ellipsis">
-      search
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="search">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.search--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.Song.search--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongError" class="md-nav__link">
-    <span class="md-ellipsis">
-      SongError
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList" class="md-nav__link">
-    <span class="md-ellipsis">
-      SongList
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="SongList">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.json" class="md-nav__link">
-    <span class="md-ellipsis">
-      json
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="json">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.json--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.length" class="md-nav__link">
-    <span class="md-ellipsis">
-      length
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="length">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.length--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.from_search_term" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_search_term
-    </span>
-  </a>
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../utils/" class="md-nav__link ">
+              
   
-    <nav class="md-nav" aria-label="from_search_term">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.from_search_term--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    utils
+  </span>
   
-</li>
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.from_search_term--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
+            <span class="md-nav__icon md-icon"></span>
+            utils
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.from_url" class="md-nav__link">
-    <span class="md-ellipsis">
-      from_url
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="from_url">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.from_url--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../../utils/spotify/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.from_url--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    spotify
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.get_metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_metadata
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label="get_metadata">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.get_metadata--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongList.get_metadata--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.types.song.SongListError" class="md-nav__link">
-    <span class="md-ellipsis">
-      SongListError
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../../utils/m3u/" class="md-nav__link">
+        
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    m3u
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1427,11 +1140,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../options/" class="md-nav__link">
+      <a href="../../utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    metadata
   </span>
   
 
@@ -1441,9 +1154,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../utils/logging/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    logging
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -1455,45 +1181,20 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+    <li class="md-nav__item">
+      <a href="../../utils/static/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    console
+    static
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            console
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1502,11 +1203,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    matching
   </span>
   
 
@@ -1523,11 +1224,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    search
   </span>
   
 
@@ -1544,11 +1245,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    downloader
   </span>
   
 
@@ -1565,11 +1266,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1586,11 +1287,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    lrc
   </span>
   
 
@@ -1607,11 +1308,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    config
   </span>
   
 
@@ -1628,11 +1329,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    arguments
   </span>
   
 
@@ -1642,9 +1343,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../utils/console/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -1656,45 +1370,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+    <li class="md-nav__item">
+      <a href="../../utils/github/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../utils/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    github
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../utils/web/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1703,11 +1413,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/console/" class="md-nav__link">
+      <a href="../../utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    ffmpeg
   </span>
   
 
@@ -1738,6 +1448,62 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    types
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1745,11 +1511,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/arguments/" class="md-nav__link">
+      <a href="../options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    options
   </span>
   
 
@@ -1766,11 +1532,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/metadata/" class="md-nav__link">
+      <a href="../saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    saved
   </span>
   
 
@@ -1787,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/downloader/" class="md-nav__link">
+      <a href="../artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    artist
   </span>
   
 
@@ -1808,11 +1574,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/github/" class="md-nav__link">
+      <a href="../result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    result
   </span>
   
 
@@ -1829,11 +1595,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/static/" class="md-nav__link">
+      <a href="../playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    playlist
   </span>
   
 
@@ -1847,186 +1613,537 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/search/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    song
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    search
+    song
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../../utils/web/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.song" class="md-nav__link">
+    <span class="md-ellipsis">
+      song
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song" class="md-nav__link">
+    <span class="md-ellipsis">
+      Song
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Song">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.display_name" class="md-nav__link">
+    <span class="md-ellipsis">
+      display_name
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    web
-  </span>
+    <nav class="md-nav" aria-label="display_name">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.display_name--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.json" class="md-nav__link">
+    <span class="md-ellipsis">
+      json
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="json">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.json--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_data_dump" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_data_dump
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="from_data_dump">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_data_dump--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../utils/logging/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_data_dump--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    logging
-  </span>
+</li>
+        
+      </ul>
+    </nav>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_dict" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_dict
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="from_dict">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_dict--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_dict--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_missing_data" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_missing_data
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="from_missing_data">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_missing_data--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_missing_data--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_search_term" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_search_term
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="from_search_term">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_search_term--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../utils/spotify/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_search_term--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    spotify
-  </span>
+</li>
+        
+      </ul>
+    </nav>
   
-
-      </a>
-    </li>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_url
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="from_url">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_url--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.from_url--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.list_from_search_term" class="md-nav__link">
+    <span class="md-ellipsis">
+      list_from_search_term
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../utils/matching/" class="md-nav__link">
+    <nav class="md-nav" aria-label="list_from_search_term">
+      <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.list_from_search_term--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    matching
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.list_from_search_term--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.search" class="md-nav__link">
+    <span class="md-ellipsis">
+      search
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="search">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.search--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.Song.search--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../utils/ffmpeg/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    ffmpeg
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongError" class="md-nav__link">
+    <span class="md-ellipsis">
+      SongError
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList" class="md-nav__link">
+    <span class="md-ellipsis">
+      SongList
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+    <nav class="md-nav" aria-label="SongList">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.json" class="md-nav__link">
+    <span class="md-ellipsis">
+      json
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="json">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.json--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.length" class="md-nav__link">
+    <span class="md-ellipsis">
+      length
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../utils/m3u/" class="md-nav__link">
+    <nav class="md-nav" aria-label="length">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.length--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    m3u
-  </span>
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.from_search_term" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_search_term
+    </span>
+  </a>
   
-
-      </a>
-    </li>
+    <nav class="md-nav" aria-label="from_search_term">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.from_search_term--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.from_search_term--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.from_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      from_url
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="from_url">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.from_url--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
-    <li class="md-nav__item">
-      <a href="../../utils/config/" class="md-nav__link">
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.from_url--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    config
-  </span>
-  
-
-      </a>
-    </li>
+</li>
+        
+      </ul>
+    </nav>
   
-
-              
-            
-              
-                
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.get_metadata" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_metadata
+    </span>
+  </a>
   
+    <nav class="md-nav" aria-label="get_metadata">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.get_metadata--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongList.get_metadata--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
+</li>
+        
+      </ul>
+    </nav>
   
-    <li class="md-nav__item">
-      <a href="../../utils/lrc/" class="md-nav__link">
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    lrc
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.types.song.SongListError" class="md-nav__link">
+    <span class="md-ellipsis">
+      SongListError
+    </span>
+  </a>
   
-
-      </a>
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -2039,11 +2156,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../utils/archive/" class="md-nav__link">
+      <a href="../album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -2078,78 +2195,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2160,74 +2231,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -2244,11 +2252,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -2283,32 +2291,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2319,11 +2327,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2340,11 +2348,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2361,11 +2369,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2382,11 +2390,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2403,11 +2411,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2424,11 +2432,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2445,11 +2453,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2473,14 +2481,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2567,7 +2567,7 @@ <h2 id="spotdl.types.song.Song" class="doc doc-heading">
 
 
 <h3 id="spotdl.types.song.Song.display_name" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">display_name</span><span class="p">:</span> <span class="nb">str</span></code>
+            <code class="highlight language-python"><span class="n">display_name</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2592,7 +2592,7 @@ <h6 id="spotdl.types.song.Song.display_name--returns">Returns<a class="headerlin
 
 
 <h3 id="spotdl.types.song.Song.json" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">json</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span></code>
+            <code class="highlight language-python"><span class="n">json</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -2658,7 +2658,7 @@ <h6 id="spotdl.types.song.Song.from_data_dump--returns">Returns<a class="headerl
 <span class="normal">220</span>
 <span class="normal">221</span>
 <span class="normal">222</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_data_dump</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_data_dump</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a Song object from a data dump.</span>
 
@@ -2721,7 +2721,7 @@ <h6 id="spotdl.types.song.Song.from_dict--returns">Returns<a class="headerlink"
 <span class="normal">235</span>
 <span class="normal">236</span>
 <span class="normal">237</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_dict</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_dict</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a Song object from a dictionary.</span>
 
@@ -2788,7 +2788,7 @@ <h6 id="spotdl.types.song.Song.from_missing_data--returns">Returns<a class="head
 <span class="normal">255</span>
 <span class="normal">256</span>
 <span class="normal">257</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_missing_data</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_missing_data</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a Song object from a dictionary with missing data.</span>
 <span class="sd">    For example, data dict doesn&#39;t contain all the required</span>
@@ -2860,7 +2860,7 @@ <h6 id="spotdl.types.song.Song.from_search_term--returns">Returns<a class="heade
 <span class="normal">177</span>
 <span class="normal">178</span>
 <span class="normal">179</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_search_term</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_search_term</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Creates a list of Song objects from a search term.</span>
 
@@ -2987,7 +2987,7 @@ <h6 id="spotdl.types.song.Song.from_url--returns">Returns<a class="headerlink" h
 <span class="normal">136</span>
 <span class="normal">137</span>
 <span class="normal">138</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_url</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_url</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;Song&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Creates a Song object from a URL.</span>
 
@@ -3117,7 +3117,7 @@ <h6 id="spotdl.types.song.Song.list_from_search_term--returns">Returns<a class="
 <span class="normal">202</span>
 <span class="normal">203</span>
 <span class="normal">204</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">list_from_search_term</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;List[Song]&quot;</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">list_from_search_term</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;List[Song]&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Creates a list of Song objects from a search term.</span>
 
@@ -3191,7 +3191,7 @@ <h6 id="spotdl.types.song.Song.search--returns">Returns<a class="headerlink" hre
 <span class="normal">155</span>
 <span class="normal">156</span>
 <span class="normal">157</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@staticmethod</span>
-<span class="k">def</span> <span class="nf">search</span><span class="p">(</span><span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span><span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Searches for Songs from a search term.</span>
 
@@ -3290,7 +3290,7 @@ <h2 id="spotdl.types.song.SongList" class="doc doc-heading">
 
 
 <h3 id="spotdl.types.song.SongList.json" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">json</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span></code>
+            <code class="highlight language-python"><span class="n">json</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -3315,7 +3315,7 @@ <h6 id="spotdl.types.song.SongList.json--returns">Returns<a class="headerlink" h
 
 
 <h3 id="spotdl.types.song.SongList.length" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">length</span><span class="p">:</span> <span class="nb">int</span></code>
+            <code class="highlight language-python"><span class="n">length</span></code>
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
@@ -3399,7 +3399,7 @@ <h6 id="spotdl.types.song.SongList.from_search_term--returns">Returns<a class="h
 <span class="normal">346</span>
 <span class="normal">347</span>
 <span class="normal">348</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_search_term</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">):</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_search_term</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Creates a SongList object from a search term.</span>
 
@@ -3487,7 +3487,7 @@ <h6 id="spotdl.types.song.SongList.from_url--returns">Returns<a class="headerlin
 <span class="normal">310</span>
 <span class="normal">311</span>
 <span class="normal">312</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">from_url</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">):</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">from_url</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a SongList object from a url.</span>
 
@@ -3552,7 +3552,7 @@ <h6 id="spotdl.types.song.SongList.get_metadata--returns">Returns<a class="heade
 <span class="normal">382</span>
 <span class="normal">383</span>
 <span class="normal">384</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@staticmethod</span>
-<span class="k">def</span> <span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_metadata</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get metadata for a song list.</span>
 
@@ -3669,7 +3669,7 @@ <h2 id="spotdl.types.song.SongListError" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/archive/index.html b/reference/utils/archive/index.html
index 3fbddfcde..2c922bc81 100644
--- a/reference/utils/archive/index.html
+++ b/reference/utils/archive/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/archive/">
       
       
-        <link rel="prev" href="../lrc/">
+        <link rel="prev" href="../downloader/">
       
       
-        <link rel="next" href="../../providers/">
+        <link rel="next" href="../lrc/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1349,60 +1265,135 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
-        
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    logging
+    archive
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
-  
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
-    <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
-        
   
-  <span class="md-ellipsis">
-    spotify
-  </span>
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.archive" class="md-nav__link">
+    <span class="md-ellipsis">
+      archive
+    </span>
+  </a>
   
-
-      </a>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.archive.Archive" class="md-nav__link">
+    <span class="md-ellipsis">
+      Archive
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Archive">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.archive.Archive.load" class="md-nav__link">
+    <span class="md-ellipsis">
+      load
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="load">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.archive.Archive.load--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.archive.Archive.load--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.archive.Archive.save" class="md-nav__link">
+    <span class="md-ellipsis">
+      save
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="save">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.archive.Archive.save--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1415,11 +1406,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    lrc
   </span>
   
 
@@ -1436,11 +1427,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    config
   </span>
   
 
@@ -1457,11 +1448,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    arguments
   </span>
   
 
@@ -1478,11 +1469,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    console
   </span>
   
 
@@ -1499,11 +1490,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    github
   </span>
   
 
@@ -1517,135 +1508,60 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    archive
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    web
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
+    </li>
   
+
+              
+            
+              
+                
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.archive" class="md-nav__link">
-    <span class="md-ellipsis">
-      archive
-    </span>
-  </a>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.archive.Archive" class="md-nav__link">
-    <span class="md-ellipsis">
-      Archive
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Archive">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../ffmpeg/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.archive.Archive.load" class="md-nav__link">
-    <span class="md-ellipsis">
-      load
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="load">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.archive.Archive.load--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.archive.Archive.load--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.archive.Archive.save" class="md-nav__link">
-    <span class="md-ellipsis">
-      save
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="save">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.archive.Archive.save--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../formatter/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    formatter
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1676,32 +1592,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1711,45 +1627,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1758,11 +1670,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1779,11 +1691,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1800,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1821,11 +1733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1842,11 +1754,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1881,32 +1793,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1917,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1938,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1952,6 +1864,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1959,11 +1925,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1980,11 +1946,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2001,11 +1967,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2022,11 +1988,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2043,11 +2009,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2057,9 +2023,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2203,7 +2203,7 @@ <h6 id="spotdl.utils.archive.Archive.load--returns">Returns<a class="headerlink"
 <span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
-<span class="normal">35</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">load</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="normal">35</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">load</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Imports the archive from the file.</span>
 
@@ -2259,7 +2259,7 @@ <h6 id="spotdl.utils.archive.Archive.save--arguments">Arguments<a class="headerl
 <span class="normal">46</span>
 <span class="normal">47</span>
 <span class="normal">48</span>
-<span class="normal">49</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">save</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="normal">49</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">save</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Exports the current archive to the file.</span>
 
@@ -2349,7 +2349,7 @@ <h6 id="spotdl.utils.archive.Archive.save--arguments">Arguments<a class="headerl
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/arguments/index.html b/reference/utils/arguments/index.html
index e32b2c052..720bccba4 100644
--- a/reference/utils/arguments/index.html
+++ b/reference/utils/arguments/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/arguments/">
       
       
-        <link rel="prev" href="../formatter/">
+        <link rel="prev" href="../config/">
       
       
-        <link rel="next" href="../metadata/">
+        <link rel="next" href="../console/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -744,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -801,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -822,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -843,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -864,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -885,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -928,10 +1037,20 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
+    
+  
   
   
     
@@ -941,36 +1060,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1002,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1023,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1044,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1065,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1086,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1107,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1121,9 +1240,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../downloader/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    downloader
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -1133,49 +1265,22 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+    <li class="md-nav__item">
+      <a href="../archive/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    archive
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1184,11 +1289,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    lrc
   </span>
   
 
@@ -1205,11 +1310,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    config
   </span>
   
 
@@ -1526,32 +1631,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    console
   </span>
   
 
@@ -1589,11 +1673,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1610,11 +1694,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1631,11 +1715,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1645,26 +1729,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1673,11 +1790,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    options
   </span>
   
 
@@ -1694,11 +1811,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1715,11 +1832,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1736,11 +1853,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1757,11 +1874,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1778,11 +1895,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1799,11 +1916,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1838,78 +1955,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1920,74 +1991,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -2004,11 +2012,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -2043,32 +2051,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2079,11 +2087,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2100,11 +2108,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2121,11 +2129,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2142,11 +2150,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2163,11 +2171,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2184,11 +2192,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2205,11 +2213,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2233,14 +2241,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2398,7 +2398,7 @@ <h5 id="spotdl.utils.arguments.create_parser--returns">Returns<a class="headerli
 <span class="normal">855</span>
 <span class="normal">856</span>
 <span class="normal">857</span>
-<span class="normal">858</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_parser</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">ArgumentParser</span><span class="p">:</span>
+<span class="normal">858</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_parser</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">ArgumentParser</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse arguments from the command line.</span>
 
@@ -2490,7 +2490,7 @@ <h5 id="spotdl.utils.arguments.parse_arguments--returns">Returns<a class="header
 <span class="normal">873</span>
 <span class="normal">874</span>
 <span class="normal">875</span>
-<span class="normal">876</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_arguments</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Namespace</span><span class="p">:</span>
+<span class="normal">876</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_arguments</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Namespace</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse arguments from the command line.</span>
 
@@ -2592,7 +2592,7 @@ <h5 id="spotdl.utils.arguments.parse_ffmpeg_options--arguments">Arguments<a clas
 <span class="normal">322</span>
 <span class="normal">323</span>
 <span class="normal">324</span>
-<span class="normal">325</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_ffmpeg_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">325</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_ffmpeg_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse ffmpeg options from the command line.</span>
 
@@ -2816,7 +2816,7 @@ <h5 id="spotdl.utils.arguments.parse_main_options--arguments">Arguments<a class=
 <span class="normal">175</span>
 <span class="normal">176</span>
 <span class="normal">177</span>
-<span class="normal">178</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_main_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">178</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_main_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse main options from the command line.</span>
 
@@ -3009,7 +3009,7 @@ <h5 id="spotdl.utils.arguments.parse_misc_options--arguments">Arguments<a class=
 <span class="normal">766</span>
 <span class="normal">767</span>
 <span class="normal">768</span>
-<span class="normal">769</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_misc_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">769</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_misc_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse misc options from the command line.</span>
 
@@ -3101,7 +3101,7 @@ <h5 id="spotdl.utils.arguments.parse_other_options--arguments">Arguments<a class
 <span class="normal">805</span>
 <span class="normal">806</span>
 <span class="normal">807</span>
-<span class="normal">808</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_other_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">808</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_other_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse other options from the command line.</span>
 
@@ -3463,7 +3463,7 @@ <h5 id="spotdl.utils.arguments.parse_output_options--arguments">Arguments<a clas
 <span class="normal">625</span>
 <span class="normal">626</span>
 <span class="normal">627</span>
-<span class="normal">628</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_output_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">628</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_output_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse output options from the command line.</span>
 
@@ -3869,7 +3869,7 @@ <h5 id="spotdl.utils.arguments.parse_spotify_options--arguments">Arguments<a cla
 <span class="normal">258</span>
 <span class="normal">259</span>
 <span class="normal">260</span>
-<span class="normal">261</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_spotify_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">261</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_spotify_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse spotify options from the command line.</span>
 
@@ -4080,7 +4080,7 @@ <h5 id="spotdl.utils.arguments.parse_web_options--arguments">Arguments<a class="
 <span class="normal">733</span>
 <span class="normal">734</span>
 <span class="normal">735</span>
-<span class="normal">736</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_web_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
+<span class="normal">736</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_web_options</span><span class="p">(</span><span class="n">parser</span><span class="p">:</span> <span class="n">_ArgumentGroup</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse web options from the command line.</span>
 
@@ -4254,7 +4254,7 @@ <h5 id="spotdl.utils.arguments.parse_web_options--arguments">Arguments<a class="
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/config/index.html b/reference/utils/config/index.html
index b1655f4b6..bd1e1ceed 100644
--- a/reference/utils/config/index.html
+++ b/reference/utils/config/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/config/">
       
       
-        <link rel="prev" href="../m3u/">
+        <link rel="prev" href="../lrc/">
       
       
-        <link rel="next" href="../lrc/">
+        <link rel="next" href="../arguments/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1268,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1373,11 +1289,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1391,122 +1307,38 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
-        
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    matching
+    config
   </span>
   
 
       </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    ffmpeg
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    m3u
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    config
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    config
-  </span>
-  
-
-      </a>
-      
-        
+      
+        
 
 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
@@ -1904,11 +1736,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    arguments
   </span>
   
 
@@ -1925,11 +1757,95 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    console
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../ffmpeg/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../formatter/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    formatter
   </span>
   
 
@@ -1964,32 +1880,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1999,45 +1915,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -2046,11 +1958,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -2067,11 +1979,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -2088,11 +2000,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -2109,11 +2021,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -2130,11 +2042,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -2169,32 +2081,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2205,11 +2117,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2226,11 +2138,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -2247,11 +2234,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -2268,11 +2255,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -2289,11 +2276,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2310,11 +2297,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2331,11 +2318,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2345,9 +2332,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2502,7 +2502,7 @@ <h3 id="spotdl.utils.config.GlobalConfig.get_parameter" class="doc doc-heading">
 <span class="normal">290</span>
 <span class="normal">291</span>
 <span class="normal">292</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">get_parameter</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_parameter</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get a parameter from the download config</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2540,7 +2540,7 @@ <h3 id="spotdl.utils.config.GlobalConfig.set_parameter" class="doc doc-heading">
 <span class="normal">282</span>
 <span class="normal">283</span>
 <span class="normal">284</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">set_parameter</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">set_parameter</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Set a parameter for the download config</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2623,7 +2623,7 @@ <h5 id="spotdl.utils.config.create_settings--returns">Returns<a class="headerlin
 <span class="normal">250</span>
 <span class="normal">251</span>
 <span class="normal">252</span>
-<span class="normal">253</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_settings</span><span class="p">(</span>
+<span class="normal">253</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_settings</span><span class="p">(</span>
     <span class="n">arguments</span><span class="p">:</span> <span class="n">Namespace</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">SpotifyOptions</span><span class="p">,</span> <span class="n">DownloaderOptions</span><span class="p">,</span> <span class="n">WebOptions</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -2722,7 +2722,7 @@ <h5 id="spotdl.utils.config.create_settings_type--returns">Returns<a class="head
 <span class="normal">211</span>
 <span class="normal">212</span>
 <span class="normal">213</span>
-<span class="normal">214</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_settings_type</span><span class="p">(</span>
+<span class="normal">214</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_settings_type</span><span class="p">(</span>
     <span class="n">arguments</span><span class="p">:</span> <span class="n">Namespace</span><span class="p">,</span>
     <span class="n">config</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
     <span class="n">default</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">SpotifyOptions</span><span class="p">,</span> <span class="n">DownloaderOptions</span><span class="p">,</span> <span class="n">WebOptions</span><span class="p">],</span>
@@ -2786,7 +2786,7 @@ <h5 id="spotdl.utils.config.get_cache_path--returns">Returns<a class="headerlink
 <span class="normal">91</span>
 <span class="normal">92</span>
 <span class="normal">93</span>
-<span class="normal">94</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_cache_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">94</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_cache_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the cache folder.</span>
 
@@ -2844,7 +2844,7 @@ <h5 id="spotdl.utils.config.get_config--errors">Errors<a class="headerlink" href
 <span class="normal">178</span>
 <span class="normal">179</span>
 <span class="normal">180</span>
-<span class="normal">181</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_config</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
+<span class="normal">181</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_config</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the config.</span>
 
@@ -2898,7 +2898,7 @@ <h5 id="spotdl.utils.config.get_config_file--returns">Returns<a class="headerlin
 <span class="normal">80</span>
 <span class="normal">81</span>
 <span class="normal">82</span>
-<span class="normal">83</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_config_file</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">83</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_config_file</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get config file path</span>
 
@@ -2952,7 +2952,7 @@ <h5 id="spotdl.utils.config.get_errors_path--notes">Notes<a class="headerlink" h
 <span class="normal">136</span>
 <span class="normal">137</span>
 <span class="normal">138</span>
-<span class="normal">139</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_errors_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">139</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_errors_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the errors folder.</span>
 
@@ -3020,7 +3020,7 @@ <h5 id="spotdl.utils.config.get_spotdl_path--notes">Notes<a class="headerlink" h
 <span class="normal">69</span>
 <span class="normal">70</span>
 <span class="normal">71</span>
-<span class="normal">72</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_spotdl_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">72</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_spotdl_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the spotdl folder.</span>
 
@@ -3076,7 +3076,7 @@ <h5 id="spotdl.utils.config.get_spotify_cache_path--returns">Returns<a class="he
 <span class="normal">102</span>
 <span class="normal">103</span>
 <span class="normal">104</span>
-<span class="normal">105</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_spotify_cache_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">105</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_spotify_cache_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the spotify cache folder.</span>
 
@@ -3122,7 +3122,7 @@ <h5 id="spotdl.utils.config.get_temp_path--returns">Returns<a class="headerlink"
 <span class="normal">117</span>
 <span class="normal">118</span>
 <span class="normal">119</span>
-<span class="normal">120</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_temp_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">120</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_temp_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the temp folder.</span>
 
@@ -3180,7 +3180,7 @@ <h5 id="spotdl.utils.config.get_web_ui_path--notes">Notes<a class="headerlink" h
 <span class="normal">155</span>
 <span class="normal">156</span>
 <span class="normal">157</span>
-<span class="normal">158</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_web_ui_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">158</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_web_ui_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the web-ui folder.</span>
 
@@ -3234,7 +3234,7 @@ <h5 id="spotdl.utils.config.modernize_settings--arguments">Arguments<a class="he
 <span class="normal">265</span>
 <span class="normal">266</span>
 <span class="normal">267</span>
-<span class="normal">268</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">modernize_settings</span><span class="p">(</span><span class="n">options</span><span class="p">:</span> <span class="n">DownloaderOptions</span><span class="p">):</span>
+<span class="normal">268</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">modernize_settings</span><span class="p">(</span><span class="n">options</span><span class="p">:</span> <span class="n">DownloaderOptions</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Handle deprecated values in config file.</span>
 
 <span class="sd">    ### Arguments</span>
@@ -3315,7 +3315,7 @@ <h5 id="spotdl.utils.config.modernize_settings--arguments">Arguments<a class="he
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/console/index.html b/reference/utils/console/index.html
index f7506a070..690ca2623 100644
--- a/reference/utils/console/index.html
+++ b/reference/utils/console/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/console/">
       
       
-        <link rel="prev" href="../">
+        <link rel="prev" href="../arguments/">
       
       
-        <link rel="next" href="../formatter/">
+        <link rel="next" href="../github/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -744,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -801,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -822,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -843,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -864,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -885,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -928,10 +1037,20 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
+    
+  
   
   
     
@@ -941,36 +1060,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1002,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1023,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1044,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1065,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1086,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1107,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1121,9 +1240,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../downloader/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    downloader
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -1133,49 +1265,85 @@
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+    <li class="md-nav__item">
+      <a href="../archive/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    archive
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
               
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../lrc/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    utils
+    lrc
   </span>
   
 
-            </a>
+      </a>
+    </li>
+  
+
+              
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    config
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arguments/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    arguments
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1333,90 +1501,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    formatter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    arguments
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../github/" class="md-nav__link">
         
@@ -1439,11 +1523,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1460,11 +1544,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1481,11 +1565,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1495,26 +1579,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1523,11 +1640,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    options
   </span>
   
 
@@ -1544,11 +1661,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1565,11 +1682,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1586,11 +1703,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1607,11 +1724,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1628,11 +1745,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1649,11 +1766,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1688,78 +1805,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1770,74 +1841,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1854,11 +1862,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1893,32 +1901,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1929,11 +1937,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1950,11 +1958,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1971,11 +1979,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1992,11 +2000,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2013,11 +2021,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2034,11 +2042,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2055,11 +2063,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2083,14 +2091,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2160,7 +2160,7 @@ <h2 id="spotdl.utils.console.check_for_updates" class="doc doc-heading">
 <span class="normal">85</span>
 <span class="normal">86</span>
 <span class="normal">87</span>
-<span class="normal">88</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">check_for_updates</span><span class="p">():</span>
+<span class="normal">88</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">check_for_updates</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check for updates to the current version.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2213,7 +2213,7 @@ <h2 id="spotdl.utils.console.download_ffmpeg" class="doc doc-heading">
 <span class="normal">112</span>
 <span class="normal">113</span>
 <span class="normal">114</span>
-<span class="normal">115</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download_ffmpeg</span><span class="p">():</span>
+<span class="normal">115</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download_ffmpeg</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Handle ffmpeg download process and print the result.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2281,7 +2281,7 @@ <h2 id="spotdl.utils.console.generate_config" class="doc doc-heading">
 <span class="normal">75</span>
 <span class="normal">76</span>
 <span class="normal">77</span>
-<span class="normal">78</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">generate_config</span><span class="p">():</span>
+<span class="normal">78</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">generate_config</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Generate the config file if it doesn&#39;t exist</span>
 <span class="sd">    This is done before the argument parser so it doesn&#39;t requires `operation`</span>
@@ -2331,7 +2331,7 @@ <h2 id="spotdl.utils.console.generate_initial_config" class="doc doc-heading">
 <span class="normal">52</span>
 <span class="normal">53</span>
 <span class="normal">54</span>
-<span class="normal">55</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">generate_initial_config</span><span class="p">():</span>
+<span class="normal">55</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">generate_initial_config</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Generate the initial config file if it doesn&#39;t exist.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2375,7 +2375,7 @@ <h5 id="spotdl.utils.console.is_executable--returns">Returns<a class="headerlink
 <span class="normal">41</span>
 <span class="normal">42</span>
 <span class="normal">43</span>
-<span class="normal">44</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">is_executable</span><span class="p">():</span>
+<span class="normal">44</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">is_executable</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if the application is an prebuilt executable.</span>
 <span class="sd">    And has been launched with double click.</span>
@@ -2418,7 +2418,7 @@ <h5 id="spotdl.utils.console.is_frozen--returns">Returns<a class="headerlink" hr
 <span class="normal">29</span>
 <span class="normal">30</span>
 <span class="normal">31</span>
-<span class="normal">32</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">is_frozen</span><span class="p">():</span>
+<span class="normal">32</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">is_frozen</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if the application is frozen.</span>
 
@@ -2495,7 +2495,7 @@ <h5 id="spotdl.utils.console.is_frozen--returns">Returns<a class="headerlink" hr
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/downloader/index.html b/reference/utils/downloader/index.html
index 5b0455a5a..161f3be91 100644
--- a/reference/utils/downloader/index.html
+++ b/reference/utils/downloader/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/downloader/">
       
       
-        <link rel="prev" href="../metadata/">
+        <link rel="prev" href="../search/">
       
       
-        <link rel="next" href="../github/">
+        <link rel="next" href="../archive/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../static/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    static
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../matching/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    matching
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../search/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    search
   </span>
   
 
@@ -1358,11 +1337,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    archive
   </span>
   
 
@@ -1379,11 +1358,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    lrc
   </span>
   
 
@@ -1400,11 +1379,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    config
   </span>
   
 
@@ -1421,11 +1400,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    arguments
   </span>
   
 
@@ -1442,11 +1421,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    console
   </span>
   
 
@@ -1463,11 +1442,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    github
   </span>
   
 
@@ -1484,11 +1463,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    web
   </span>
   
 
@@ -1526,11 +1505,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    formatter
   </span>
   
 
@@ -1540,26 +1519,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
         
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    config
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1568,11 +1580,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    options
   </span>
   
 
@@ -1589,11 +1601,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    saved
   </span>
   
 
@@ -1603,59 +1615,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+    <li class="md-nav__item">
+      <a href="../../types/artist/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    providers
+    artist
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1663,45 +1642,20 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/result/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    result
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1710,11 +1664,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    playlist
   </span>
   
 
@@ -1731,11 +1685,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    song
   </span>
   
 
@@ -1752,11 +1706,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    album
   </span>
   
 
@@ -1766,6 +1720,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../download/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1773,11 +1781,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1794,11 +1802,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1833,32 +1841,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1869,11 +1877,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -1890,11 +1898,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -1911,11 +1919,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -1932,11 +1940,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -1953,11 +1961,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -1974,11 +1982,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -1995,11 +2003,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2023,14 +2031,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2113,7 +2113,7 @@ <h5 id="spotdl.utils.downloader.check_ytmusic_connection--returns">Returns<a cla
 <span class="normal">22</span>
 <span class="normal">23</span>
 <span class="normal">24</span>
-<span class="normal">25</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">check_ytmusic_connection</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="normal">25</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">check_ytmusic_connection</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if we can connect to YouTube Music API</span>
 
@@ -2197,7 +2197,7 @@ <h5 id="spotdl.utils.downloader.check_ytmusic_connection--returns">Returns<a cla
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/ffmpeg/index.html b/reference/utils/ffmpeg/index.html
index 433c67043..19b386243 100644
--- a/reference/utils/ffmpeg/index.html
+++ b/reference/utils/ffmpeg/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/ffmpeg/">
       
       
-        <link rel="prev" href="../matching/">
+        <link rel="prev" href="../web/">
       
       
-        <link rel="next" href="../m3u/">
+        <link rel="next" href="../formatter/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1268,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1373,11 +1289,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1394,11 +1310,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1415,11 +1331,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1433,43 +1349,106 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    ffmpeg
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
   
     <label class="md-nav__title" for="__toc">
       <span class="md-nav__icon md-icon"></span>
@@ -1709,11 +1688,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    formatter
   </span>
   
 
@@ -1723,26 +1702,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    config
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1751,11 +1763,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    options
   </span>
   
 
@@ -1772,11 +1784,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    saved
   </span>
   
 
@@ -1786,59 +1798,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+    <li class="md-nav__item">
+      <a href="../../types/artist/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    providers
+    artist
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1846,45 +1825,20 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/result/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    result
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1893,11 +1847,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    playlist
   </span>
   
 
@@ -1914,11 +1868,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    song
   </span>
   
 
@@ -1935,11 +1889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    album
   </span>
   
 
@@ -1949,6 +1903,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../download/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+            download
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1956,11 +1964,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1977,11 +1985,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -2016,32 +2024,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2052,11 +2060,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2073,11 +2081,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2094,11 +2102,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2115,11 +2123,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2136,11 +2144,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2157,11 +2165,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2178,11 +2186,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2206,14 +2214,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2479,7 +2479,7 @@ <h5 id="spotdl.utils.ffmpeg.convert--notes">Notes<a class="headerlink" href="#sp
 <span class="normal">404</span>
 <span class="normal">405</span>
 <span class="normal">406</span>
-<span class="normal">407</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">convert</span><span class="p">(</span>
+<span class="normal">407</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">convert</span><span class="p">(</span>
     <span class="n">input_file</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">Path</span><span class="p">,</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]],</span>
     <span class="n">output_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>
     <span class="n">ffmpeg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;ffmpeg&quot;</span><span class="p">,</span>
@@ -2712,7 +2712,7 @@ <h5 id="spotdl.utils.ffmpeg.download_ffmpeg--notes">Notes<a class="headerlink" h
 <span class="normal">245</span>
 <span class="normal">246</span>
 <span class="normal">247</span>
-<span class="normal">248</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download_ffmpeg</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">248</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download_ffmpeg</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Download ffmpeg binary to spotdl directory.</span>
 
@@ -2797,7 +2797,7 @@ <h5 id="spotdl.utils.ffmpeg.get_ffmpeg_path--returns">Returns<a class="headerlin
 <span class="normal">118</span>
 <span class="normal">119</span>
 <span class="normal">120</span>
-<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_ffmpeg_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]:</span>
+<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_ffmpeg_path</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get path to global ffmpeg binary or a local ffmpeg binary.</span>
 
@@ -2904,7 +2904,7 @@ <h5 id="spotdl.utils.ffmpeg.get_ffmpeg_version--errors">Errors<a class="headerli
 <span class="normal">179</span>
 <span class="normal">180</span>
 <span class="normal">181</span>
-<span class="normal">182</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_ffmpeg_version</span><span class="p">(</span><span class="n">ffmpeg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;ffmpeg&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Optional</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]]:</span>
+<span class="normal">182</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_ffmpeg_version</span><span class="p">(</span><span class="n">ffmpeg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;ffmpeg&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Optional</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get ffmpeg version.</span>
 
@@ -3003,7 +3003,7 @@ <h5 id="spotdl.utils.ffmpeg.get_local_ffmpeg--returns">Returns<a class="headerli
 <span class="normal">197</span>
 <span class="normal">198</span>
 <span class="normal">199</span>
-<span class="normal">200</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_local_ffmpeg</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]:</span>
+<span class="normal">200</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_local_ffmpeg</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get local ffmpeg binary path.</span>
 
@@ -3073,7 +3073,7 @@ <h5 id="spotdl.utils.ffmpeg.is_ffmpeg_installed--returns">Returns<a class="heade
 <span class="normal">101</span>
 <span class="normal">102</span>
 <span class="normal">103</span>
-<span class="normal">104</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">is_ffmpeg_installed</span><span class="p">(</span><span class="n">ffmpeg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;ffmpeg&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="normal">104</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">is_ffmpeg_installed</span><span class="p">(</span><span class="n">ffmpeg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;ffmpeg&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if ffmpeg is installed.</span>
 
@@ -3167,7 +3167,7 @@ <h5 id="spotdl.utils.ffmpeg.is_ffmpeg_installed--returns">Returns<a class="heade
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/formatter/index.html b/reference/utils/formatter/index.html
index 0026b113a..14cd8d538 100644
--- a/reference/utils/formatter/index.html
+++ b/reference/utils/formatter/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/formatter/">
       
       
-        <link rel="prev" href="../console/">
+        <link rel="prev" href="../ffmpeg/">
       
       
-        <link rel="next" href="../arguments/">
+        <link rel="next" href="../../types/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,53 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    lyrics
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
+            <span class="md-nav__icon md-icon"></span>
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -684,11 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    synced
   </span>
   
 
@@ -705,11 +751,74 @@
   
   
     <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    progress_handler
+    musixmatch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    azlyrics
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    base
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    genius
   </span>
   
 
@@ -744,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            types
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    artist
+    piped
   </span>
   
 
@@ -801,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    playlist
+    youtube
   </span>
   
 
@@ -822,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    soundcloud
   </span>
   
 
@@ -843,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    bandcamp
   </span>
   
 
@@ -864,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    ytmusic
   </span>
   
 
@@ -885,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    sliderkz
   </span>
   
 
@@ -928,10 +1037,20 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
+    
+  
   
   
     
@@ -941,36 +1060,36 @@
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    utils
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
-            console
+            utils
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    spotify
   </span>
   
 
@@ -1002,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    m3u
   </span>
   
 
@@ -1023,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    metadata
   </span>
   
 
@@ -1044,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    logging
   </span>
   
 
@@ -1065,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    static
   </span>
   
 
@@ -1086,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    matching
   </span>
   
 
@@ -1107,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    search
   </span>
   
 
@@ -1121,61 +1240,26 @@
 
               
             
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
               
                 
   
   
-    
-  
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+    <li class="md-nav__item">
+      <a href="../downloader/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    utils
+    downloader
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
-            <span class="md-nav__icon md-icon"></span>
-            utils
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1184,7 +1268,91 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    archive
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../lrc/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    lrc
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    config
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arguments/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    arguments
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1202,6 +1370,69 @@
                 
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../ffmpeg/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
     
   
   
@@ -1720,22 +1951,9 @@
 
               
             
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    arguments
-  </span>
-  
-
-      </a>
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1747,20 +1965,45 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    metadata
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1769,11 +2012,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    options
   </span>
   
 
@@ -1790,11 +2033,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    saved
   </span>
   
 
@@ -1811,11 +2054,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    artist
   </span>
   
 
@@ -1832,11 +2075,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    result
   </span>
   
 
@@ -1853,11 +2096,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    playlist
   </span>
   
 
@@ -1874,11 +2117,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    song
   </span>
   
 
@@ -1895,11 +2138,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    album
   </span>
   
 
@@ -1909,22 +2152,9 @@
 
               
             
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    matching
-  </span>
-  
-
-      </a>
+          </ul>
+        </nav>
+      
     </li>
   
 
@@ -1936,165 +2166,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    ffmpeg
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    m3u
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    config
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    lrc
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    archive
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -2106,32 +2177,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2142,74 +2213,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -2226,11 +2234,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -2265,32 +2273,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2301,11 +2309,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2322,11 +2330,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2343,11 +2351,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2364,11 +2372,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2385,11 +2393,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2406,11 +2414,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2427,11 +2435,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2455,14 +2463,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2552,7 +2552,7 @@ <h5 id="spotdl.utils.formatter.args_to_ytdlp_options--returns">Returns<a class="
 <span class="normal">624</span>
 <span class="normal">625</span>
 <span class="normal">626</span>
-<span class="normal">627</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">args_to_ytdlp_options</span><span class="p">(</span>
+<span class="normal">627</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">args_to_ytdlp_options</span><span class="p">(</span>
     <span class="n">argument_list</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">defaults</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -2741,7 +2741,7 @@ <h5 id="spotdl.utils.formatter.create_file_name--returns">Returns<a class="heade
 <span class="normal">431</span>
 <span class="normal">432</span>
 <span class="normal">433</span>
-<span class="normal">434</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_file_name</span><span class="p">(</span>
+<span class="normal">434</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_file_name</span><span class="p">(</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span>
     <span class="n">template</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">file_extension</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2934,7 +2934,7 @@ <h5 id="spotdl.utils.formatter.create_path_object--returns">Returns<a class="hea
 <span class="normal">605</span>
 <span class="normal">606</span>
 <span class="normal">607</span>
-<span class="normal">608</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_path_object</span><span class="p">(</span><span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">608</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_path_object</span><span class="p">(</span><span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a Path object from a string.</span>
 <span class="sd">    Sanitizes the filename part of the Path object.</span>
@@ -3018,7 +3018,7 @@ <h5 id="spotdl.utils.formatter.create_search_query--returns">Returns<a class="he
 <span class="normal">290</span>
 <span class="normal">291</span>
 <span class="normal">292</span>
-<span class="normal">293</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_search_query</span><span class="p">(</span>
+<span class="normal">293</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_search_query</span><span class="p">(</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span>
     <span class="n">template</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">santitize</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span>
@@ -3099,7 +3099,7 @@ <h5 id="spotdl.utils.formatter.create_song_title--notes">Notes<a class="headerli
 <span class="normal">95</span>
 <span class="normal">96</span>
 <span class="normal">97</span>
-<span class="normal">98</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_song_title</span><span class="p">(</span><span class="n">song_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">song_artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">98</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_song_title</span><span class="p">(</span><span class="n">song_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">song_artists</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create the song title.</span>
 
@@ -3249,7 +3249,7 @@ <h5 id="spotdl.utils.formatter.format_query--returns">Returns<a class="headerlin
 <span class="normal">261</span>
 <span class="normal">262</span>
 <span class="normal">263</span>
-<span class="normal">264</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">format_query</span><span class="p">(</span>
+<span class="normal">264</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">format_query</span><span class="p">(</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span>
     <span class="n">template</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">santitize</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span>
@@ -3397,7 +3397,7 @@ <h5 id="spotdl.utils.formatter.parse_duration--returns">Returns<a class="headerl
 <span class="normal">456</span>
 <span class="normal">457</span>
 <span class="normal">458</span>
-<span class="normal">459</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_duration</span><span class="p">(</span><span class="n">duration</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">459</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_duration</span><span class="p">(</span><span class="n">duration</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Convert string value of time (duration: &quot;25:36:59&quot;) to a float value of seconds (92219.0)</span>
 
@@ -3470,7 +3470,7 @@ <h5 id="spotdl.utils.formatter.ratio--returns">Returns<a class="headerlink" href
 <span class="normal">544</span>
 <span class="normal">545</span>
 <span class="normal">546</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@lru_cache</span><span class="p">()</span>
-<span class="k">def</span> <span class="nf">ratio</span><span class="p">(</span><span class="n">string1</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">string2</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">ratio</span><span class="p">(</span><span class="n">string1</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">string2</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Wrapper for fuzz.ratio</span>
 <span class="sd">    with lru_cache</span>
@@ -3543,7 +3543,7 @@ <h5 id="spotdl.utils.formatter.restrict_filename--notes">Notes<a class="headerli
 <span class="normal">526</span>
 <span class="normal">527</span>
 <span class="normal">528</span>
-<span class="normal">529</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">restrict_filename</span><span class="p">(</span><span class="n">pathobj</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">strict</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
+<span class="normal">529</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">restrict_filename</span><span class="p">(</span><span class="n">pathobj</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">strict</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Path</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Sanitizes the filename part of a Path object. Returns modified object.</span>
 
@@ -3618,7 +3618,7 @@ <h5 id="spotdl.utils.formatter.sanitize_string--returns">Returns<a class="header
 <span class="normal">118</span>
 <span class="normal">119</span>
 <span class="normal">120</span>
-<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">sanitize_string</span><span class="p">(</span><span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">121</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">sanitize_string</span><span class="p">(</span><span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Sanitize the filename to be used in the file system.</span>
 
@@ -3714,7 +3714,7 @@ <h5 id="spotdl.utils.formatter.slugify--returns">Returns<a class="headerlink" hr
 <span class="normal">163</span>
 <span class="normal">164</span>
 <span class="normal">165</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@lru_cache</span><span class="p">()</span>
-<span class="k">def</span> <span class="nf">slugify</span><span class="p">(</span><span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">slugify</span><span class="p">(</span><span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Slugify the string.</span>
 
@@ -3821,7 +3821,7 @@ <h5 id="spotdl.utils.formatter.smart_split--returns">Returns<a class="headerlink
 <span class="normal">578</span>
 <span class="normal">579</span>
 <span class="normal">580</span>
-<span class="normal">581</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">smart_split</span><span class="p">(</span>
+<span class="normal">581</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">smart_split</span><span class="p">(</span>
     <span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">max_length</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">separators</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3931,7 +3931,7 @@ <h5 id="spotdl.utils.formatter.to_ms--notes">Notes<a class="headerlink" href="#s
 <span class="normal">498</span>
 <span class="normal">499</span>
 <span class="normal">500</span>
-<span class="normal">501</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">to_ms</span><span class="p">(</span>
+<span class="normal">501</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">to_ms</span><span class="p">(</span>
     <span class="n">string</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">precision</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -4039,7 +4039,7 @@ <h5 id="spotdl.utils.formatter.to_ms--notes">Notes<a class="headerlink" href="#s
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/github/index.html b/reference/utils/github/index.html
index 104c30e38..07282ff25 100644
--- a/reference/utils/github/index.html
+++ b/reference/utils/github/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/github/">
       
       
-        <link rel="prev" href="../downloader/">
+        <link rel="prev" href="../console/">
       
       
-        <link rel="next" href="../static/">
+        <link rel="next" href="../web/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1286,58 +1202,226 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../matching/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    search
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.github" class="md-nav__link">
-    <span class="md-ellipsis">
-      github
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../downloader/" class="md-nav__link">
+        
   
-</li>
+  <span class="md-ellipsis">
+    downloader
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../archive/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    archive
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../lrc/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    lrc
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    config
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arguments/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    arguments
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.github" class="md-nav__link">
+    <span class="md-ellipsis">
+      github
+    </span>
+  </a>
+  
+</li>
       
         <li class="md-nav__item">
   <a href="#spotdl.utils.github.RateLimitError" class="md-nav__link">
@@ -1529,11 +1613,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    web
   </span>
   
 
@@ -1550,11 +1634,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    ffmpeg
   </span>
   
 
@@ -1571,11 +1655,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    formatter
   </span>
   
 
@@ -1585,26 +1669,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    logging
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -1613,11 +1730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    options
   </span>
   
 
@@ -1634,11 +1751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    saved
   </span>
   
 
@@ -1655,11 +1772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    artist
   </span>
   
 
@@ -1676,11 +1793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    result
   </span>
   
 
@@ -1697,11 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    playlist
   </span>
   
 
@@ -1718,11 +1835,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    song
   </span>
   
 
@@ -1739,11 +1856,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    album
   </span>
   
 
@@ -1778,78 +1895,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    providers
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1860,74 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -1944,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -1983,32 +1991,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2019,11 +2027,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2040,11 +2048,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2061,11 +2069,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2082,11 +2090,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2103,11 +2111,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2124,11 +2132,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2145,11 +2153,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2173,14 +2181,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2329,7 +2329,7 @@ <h5 id="spotdl.utils.github.check_for_updates--returns">Returns<a class="headerl
 <span class="normal">143</span>
 <span class="normal">144</span>
 <span class="normal">145</span>
-<span class="normal">146</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">check_for_updates</span><span class="p">(</span><span class="n">repo</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">REPO</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">146</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">check_for_updates</span><span class="p">(</span><span class="n">repo</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">REPO</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check for updates to the current version.</span>
 
@@ -2444,7 +2444,7 @@ <h5 id="spotdl.utils.github.create_github_url--notes">Notes<a class="headerlink"
 <span class="normal">182</span>
 <span class="normal">183</span>
 <span class="normal">184</span>
-<span class="normal">185</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_github_url</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">WEB_APP_URL</span><span class="p">):</span>
+<span class="normal">185</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_github_url</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">WEB_APP_URL</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    From the given url, produce a URL that is compatible with Github&#39;s REST API.</span>
 
@@ -2573,7 +2573,7 @@ <h5 id="spotdl.utils.github.download_github_dir--notes">Notes<a class="headerlin
 <span class="normal">246</span>
 <span class="normal">247</span>
 <span class="normal">248</span>
-<span class="normal">249</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">download_github_dir</span><span class="p">(</span>
+<span class="normal">249</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">download_github_dir</span><span class="p">(</span>
     <span class="n">repo_url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">WEB_APP_URL</span><span class="p">,</span> <span class="n">flatten</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> <span class="n">output_dir</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;./&quot;</span>
 <span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -2689,7 +2689,7 @@ <h5 id="spotdl.utils.github.get_latest_version--returns">Returns<a class="header
 <span class="normal">91</span>
 <span class="normal">92</span>
 <span class="normal">93</span>
-<span class="normal">94</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_latest_version</span><span class="p">(</span><span class="n">repo</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">REPO</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">94</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_latest_version</span><span class="p">(</span><span class="n">repo</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">REPO</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the latest version of spotdl.</span>
 
@@ -2777,7 +2777,7 @@ <h5 id="spotdl.utils.github.get_status--returns">Returns<a class="headerlink" hr
 <span class="normal">63</span>
 <span class="normal">64</span>
 <span class="normal">65</span>
-<span class="normal">66</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_status</span><span class="p">(</span><span class="n">start</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">end</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">repo</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">REPO</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]:</span>
+<span class="normal">66</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_status</span><span class="p">(</span><span class="n">start</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">end</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">repo</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">REPO</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the status of a commit range.</span>
 
@@ -2877,7 +2877,7 @@ <h5 id="spotdl.utils.github.get_status--returns">Returns<a class="headerlink" hr
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/index.html b/reference/utils/index.html
index 89e44f7fb..eb9ca5ffe 100644
--- a/reference/utils/index.html
+++ b/reference/utils/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/">
       
       
-        <link rel="prev" href="../console/entry_point/">
+        <link rel="prev" href="../providers/audio/sliderkz/">
       
       
-        <link rel="next" href="console/">
+        <link rel="next" href="spotify/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../download/" class="md-nav__link ">
+            <a href="../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../types/" class="md-nav__link ">
+            <a href="../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../types/album/" class="md-nav__link">
+      <a href="../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/saved/" class="md-nav__link">
+      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/result/" class="md-nav__link">
+      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/song/" class="md-nav__link">
+      <a href="../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../types/options/" class="md-nav__link">
+      <a href="../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../console/" class="md-nav__link ">
+            <a href="../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/save/" class="md-nav__link">
+      <a href="../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/url/" class="md-nav__link">
+      <a href="../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/meta/" class="md-nav__link">
+      <a href="../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/web/" class="md-nav__link">
+      <a href="../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/sync/" class="md-nav__link">
+      <a href="../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/download/" class="md-nav__link">
+      <a href="../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/entry_point/" class="md-nav__link">
+      <a href="../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link md-nav__link--active" for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link md-nav__link--active" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="console/" class="md-nav__link">
+      <a href="spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="formatter/" class="md-nav__link">
+      <a href="m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="arguments/" class="md-nav__link">
+      <a href="metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="metadata/" class="md-nav__link">
+      <a href="logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="downloader/" class="md-nav__link">
+      <a href="static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="github/" class="md-nav__link">
+      <a href="matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="static/" class="md-nav__link">
+      <a href="search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="search/" class="md-nav__link">
+      <a href="downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1268,11 @@
   
   
     <li class="md-nav__item">
-      <a href="web/" class="md-nav__link">
+      <a href="archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1373,11 +1289,11 @@
   
   
     <li class="md-nav__item">
-      <a href="logging/" class="md-nav__link">
+      <a href="lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1394,11 +1310,11 @@
   
   
     <li class="md-nav__item">
-      <a href="spotify/" class="md-nav__link">
+      <a href="config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1415,11 +1331,11 @@
   
   
     <li class="md-nav__item">
-      <a href="matching/" class="md-nav__link">
+      <a href="arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1436,11 +1352,11 @@
   
   
     <li class="md-nav__item">
-      <a href="ffmpeg/" class="md-nav__link">
+      <a href="console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1457,11 +1373,11 @@
   
   
     <li class="md-nav__item">
-      <a href="m3u/" class="md-nav__link">
+      <a href="github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1478,11 +1394,11 @@
   
   
     <li class="md-nav__item">
-      <a href="config/" class="md-nav__link">
+      <a href="web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1499,11 +1415,11 @@
   
   
     <li class="md-nav__item">
-      <a href="lrc/" class="md-nav__link">
+      <a href="ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1520,11 +1436,11 @@
   
   
     <li class="md-nav__item">
-      <a href="archive/" class="md-nav__link">
+      <a href="formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1559,32 +1475,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/" class="md-nav__link ">
+            <a href="../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1594,45 +1510,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1641,11 +1553,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1662,11 +1574,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1683,11 +1595,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1704,11 +1616,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1725,11 +1637,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/lyrics/base/" class="md-nav__link">
+      <a href="../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1764,32 +1676,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../providers/audio/" class="md-nav__link ">
+            <a href="../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1800,11 +1712,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1821,11 +1733,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1835,6 +1747,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1842,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/piped/" class="md-nav__link">
+      <a href="../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1863,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/youtube/" class="md-nav__link">
+      <a href="../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -1884,11 +1850,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -1905,11 +1871,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/base/" class="md-nav__link">
+      <a href="../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -1926,11 +1892,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -1940,9 +1906,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2072,7 +2072,7 @@ <h1>utils</h1>
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/logging/index.html b/reference/utils/logging/index.html
index 1c0b18696..abd9a438e 100644
--- a/reference/utils/logging/index.html
+++ b/reference/utils/logging/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/logging/">
       
       
-        <link rel="prev" href="../web/">
+        <link rel="prev" href="../metadata/">
       
       
-        <link rel="next" href="../spotify/">
+        <link rel="next" href="../static/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,32 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    console
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    spotify
   </span>
   
 
@@ -1226,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    m3u
   </span>
   
 
@@ -1265,111 +1160,6 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    github
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    static
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    search
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    web
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
     
   
   
@@ -1514,15 +1304,141 @@
   
 </li>
         
-      </ul>
-    </nav>
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../static/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    static
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../matching/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    matching
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../search/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    search
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../downloader/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    downloader
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../archive/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    archive
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../lrc/" class="md-nav__link">
+        
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    lrc
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1535,11 +1451,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1556,11 +1472,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1577,11 +1493,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1598,11 +1514,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1619,11 +1535,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1640,11 +1556,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1661,11 +1577,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1700,32 +1616,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1735,45 +1651,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1782,11 +1694,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1803,11 +1715,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1824,11 +1736,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1845,11 +1757,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1866,11 +1778,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1905,32 +1817,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1941,11 +1853,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1962,11 +1874,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -1983,11 +1970,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -2004,11 +1991,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -2025,11 +2012,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2046,11 +2033,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2067,11 +2054,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2081,9 +2068,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2226,7 +2226,7 @@ <h3 id="spotdl.utils.logging.SpotdlFormatter.format" class="doc doc-heading">
 <span class="normal">117</span>
 <span class="normal">118</span>
 <span class="normal">119</span>
-<span class="normal">120</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">format</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">:</span> <span class="n">logging</span><span class="o">.</span><span class="n">LogRecord</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">120</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">format</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">:</span> <span class="n">logging</span><span class="o">.</span><span class="n">LogRecord</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Format a log record.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2358,7 +2358,7 @@ <h6 id="spotdl.utils.logging.SpotdlHandler.render_message--returns">Returns<a cl
 <span class="normal">156</span>
 <span class="normal">157</span>
 <span class="normal">158</span>
-<span class="normal">159</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">render_message</span><span class="p">(</span>
+<span class="normal">159</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">render_message</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">:</span> <span class="n">logging</span><span class="o">.</span><span class="n">LogRecord</span><span class="p">,</span> <span class="n">message</span><span class="p">:</span> <span class="nb">str</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;ConsoleRenderable&quot;</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Render message text in to Text.</span>
@@ -2480,7 +2480,7 @@ <h5 id="spotdl.utils.logging.init_logging--arguments">Arguments<a class="headerl
 <span class="normal">216</span>
 <span class="normal">217</span>
 <span class="normal">218</span>
-<span class="normal">219</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">init_logging</span><span class="p">(</span><span class="n">log_level</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">log_format</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">):</span>
+<span class="normal">219</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">init_logging</span><span class="p">(</span><span class="n">log_level</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">log_format</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initialize logging for spotdl.</span>
 
@@ -2606,7 +2606,7 @@ <h5 id="spotdl.utils.logging.init_logging--arguments">Arguments<a class="headerl
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/lrc/index.html b/reference/utils/lrc/index.html
index 38784da42..ac388f56d 100644
--- a/reference/utils/lrc/index.html
+++ b/reference/utils/lrc/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/lrc/">
       
       
-        <link rel="prev" href="../config/">
+        <link rel="prev" href="../archive/">
       
       
-        <link rel="next" href="../archive/">
+        <link rel="next" href="../config/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1352,11 +1268,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1370,60 +1286,120 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    spotify
+    lrc
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.lrc" class="md-nav__link">
+    <span class="md-ellipsis">
+      lrc
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.lrc.generate_lrc" class="md-nav__link">
+    <span class="md-ellipsis">
+      generate_lrc
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="generate_lrc">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.lrc.generate_lrc--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
         
+      </ul>
+    </nav>
   
-  <span class="md-ellipsis">
-    matching
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.lrc.remomve_lrc" class="md-nav__link">
+    <span class="md-ellipsis">
+      remomve_lrc
+    </span>
+  </a>
   
-
-      </a>
+    <nav class="md-nav" aria-label="remomve_lrc">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.lrc.remomve_lrc--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.lrc.remomve_lrc--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1436,11 +1412,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    config
   </span>
   
 
@@ -1457,11 +1433,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    arguments
   </span>
   
 
@@ -1478,11 +1454,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    console
   </span>
   
 
@@ -1496,120 +1472,60 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    lrc
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    github
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.lrc" class="md-nav__link">
-    <span class="md-ellipsis">
-      lrc
-    </span>
-  </a>
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.lrc.generate_lrc" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate_lrc
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    web
+  </span>
   
-    <nav class="md-nav" aria-label="generate_lrc">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.lrc.generate_lrc--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.lrc.remomve_lrc" class="md-nav__link">
-    <span class="md-ellipsis">
-      remomve_lrc
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="remomve_lrc">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.lrc.remomve_lrc--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.lrc.remomve_lrc--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../ffmpeg/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1622,11 +1538,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1661,32 +1577,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1696,45 +1612,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1743,11 +1655,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1764,11 +1676,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1785,11 +1697,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1806,11 +1718,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1827,11 +1739,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1866,32 +1778,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1902,11 +1814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1923,11 +1835,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -1944,11 +1931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -1965,11 +1952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1986,11 +1973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2007,11 +1994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2028,11 +2015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2042,9 +2029,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2154,7 +2154,7 @@ <h5 id="spotdl.utils.lrc.generate_lrc--arguments">Arguments<a class="headerlink"
 <span class="normal">39</span>
 <span class="normal">40</span>
 <span class="normal">41</span>
-<span class="normal">42</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">generate_lrc</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">output_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">):</span>
+<span class="normal">42</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">generate_lrc</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">output_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Generates an LRC file for the current song</span>
 
@@ -2218,7 +2218,7 @@ <h5 id="spotdl.utils.lrc.remomve_lrc--returns">Returns<a class="headerlink" href
 <span class="normal">53</span>
 <span class="normal">54</span>
 <span class="normal">55</span>
-<span class="normal">56</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">remomve_lrc</span><span class="p">(</span><span class="n">lyrics</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">56</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">remomve_lrc</span><span class="p">(</span><span class="n">lyrics</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Removes lrc tags from lyrics</span>
 
@@ -2298,7 +2298,7 @@ <h5 id="spotdl.utils.lrc.remomve_lrc--returns">Returns<a class="headerlink" href
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/m3u/index.html b/reference/utils/m3u/index.html
index ab8e6cc85..28ac235f8 100644
--- a/reference/utils/m3u/index.html
+++ b/reference/utils/m3u/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/m3u/">
       
       
-        <link rel="prev" href="../ffmpeg/">
+        <link rel="prev" href="../spotify/">
       
       
-        <link rel="next" href="../config/">
+        <link rel="next" href="../metadata/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1202,39 +1118,153 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    m3u
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u" class="md-nav__link">
+    <span class="md-ellipsis">
+      m3u
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.create_m3u_content" class="md-nav__link">
+    <span class="md-ellipsis">
+      create_m3u_content
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="create_m3u_content">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.create_m3u_content--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
         
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.create_m3u_content--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    arguments
-  </span>
+</li>
+        
+      </ul>
+    </nav>
   
-
-      </a>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.create_m3u_file" class="md-nav__link">
+    <span class="md-ellipsis">
+      create_m3u_file
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="create_m3u_file">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.create_m3u_file--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.create_m3u_file--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.gen_m3u_files" class="md-nav__link">
+    <span class="md-ellipsis">
+      gen_m3u_files
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="gen_m3u_files">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.m3u.gen_m3u_files--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1268,11 +1298,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    logging
   </span>
   
 
@@ -1289,11 +1319,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    static
   </span>
   
 
@@ -1310,11 +1340,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    matching
   </span>
   
 
@@ -1352,11 +1382,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    downloader
   </span>
   
 
@@ -1373,11 +1403,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    archive
   </span>
   
 
@@ -1394,11 +1424,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    lrc
   </span>
   
 
@@ -1415,11 +1445,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    config
   </span>
   
 
@@ -1436,11 +1466,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    arguments
   </span>
   
 
@@ -1454,153 +1484,39 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    m3u
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    console
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u" class="md-nav__link">
-    <span class="md-ellipsis">
-      m3u
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.create_m3u_content" class="md-nav__link">
-    <span class="md-ellipsis">
-      create_m3u_content
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="create_m3u_content">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.create_m3u_content--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.create_m3u_content--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.create_m3u_file" class="md-nav__link">
-    <span class="md-ellipsis">
-      create_m3u_file
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="create_m3u_file">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.create_m3u_file--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.create_m3u_file--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.gen_m3u_files" class="md-nav__link">
-    <span class="md-ellipsis">
-      gen_m3u_files
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="gen_m3u_files">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.m3u.gen_m3u_files--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+  
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    github
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1613,11 +1529,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1634,11 +1550,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1655,11 +1571,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1694,32 +1610,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1729,45 +1645,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1776,11 +1688,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1797,11 +1709,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1818,11 +1730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1839,11 +1751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1860,11 +1772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1899,32 +1811,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1935,11 +1847,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1956,11 +1868,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -1970,6 +1882,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -1977,11 +1943,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -1998,11 +1964,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2019,11 +1985,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2040,11 +2006,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2061,11 +2027,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2075,9 +2041,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2163,6 +2163,7 @@ <h5 id="spotdl.utils.m3u.create_m3u_content--arguments">Arguments<a class="heade
 <li>file_extension: the file extension to use</li>
 <li>restrict: sanitization to apply to the filename</li>
 <li>short: whether to use the short version of the template</li>
+<li>detect_formats: the formats to detect for existing files</li>
 </ul>
 <h5 id="spotdl.utils.m3u.create_m3u_content--returns">Returns<a class="headerlink" href="#spotdl.utils.m3u.create_m3u_content--returns" title="Permanent link">¤</a></h5>
 <ul>
@@ -2214,7 +2215,14 @@ <h5 id="spotdl.utils.m3u.create_m3u_content--returns">Returns<a class="headerlin
 <span class="normal">58</span>
 <span class="normal">59</span>
 <span class="normal">60</span>
-<span class="normal">61</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_m3u_content</span><span class="p">(</span>
+<span class="normal">61</span>
+<span class="normal">62</span>
+<span class="normal">63</span>
+<span class="normal">64</span>
+<span class="normal">65</span>
+<span class="normal">66</span>
+<span class="normal">67</span>
+<span class="normal">68</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_m3u_content</span><span class="p">(</span>
     <span class="n">song_list</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">],</span>
     <span class="n">template</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">file_extension</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2231,13 +2239,20 @@ <h5 id="spotdl.utils.m3u.create_m3u_content--returns">Returns<a class="headerlin
 <span class="sd">    - file_extension: the file extension to use</span>
 <span class="sd">    - restrict: sanitization to apply to the filename</span>
 <span class="sd">    - short: whether to use the short version of the template</span>
+<span class="sd">    - detect_formats: the formats to detect for existing files</span>
 
 <span class="sd">    ### Returns</span>
 <span class="sd">    - the m3u content as a string</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="n">text</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span>
+    <span class="n">text</span> <span class="o">=</span> <span class="s2">&quot;#EXTM3U</span><span class="se">\n</span><span class="s2">&quot;</span>
+
     <span class="k">for</span> <span class="n">song</span> <span class="ow">in</span> <span class="n">song_list</span><span class="p">:</span>
+        <span class="n">metadata</span> <span class="o">=</span> <span class="n">create_file_name</span><span class="p">(</span>
+            <span class="n">song</span><span class="p">,</span> <span class="s2">&quot;#EXTINF:</span><span class="si">{duration}</span><span class="s2">,{album-artist} - </span><span class="si">{title}</span><span class="s2">&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span>
+        <span class="p">)</span>
+        <span class="n">text</span> <span class="o">+=</span> <span class="nb">str</span><span class="p">(</span><span class="n">metadata</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
+
         <span class="k">if</span> <span class="ow">not</span> <span class="n">detect_formats</span><span class="p">:</span>
             <span class="n">file_name</span> <span class="o">=</span> <span class="n">create_file_name</span><span class="p">(</span>
                 <span class="n">song</span><span class="p">,</span> <span class="n">template</span><span class="p">,</span> <span class="n">file_extension</span><span class="p">,</span> <span class="n">restrict</span><span class="p">,</span> <span class="n">short</span>
@@ -2247,14 +2262,14 @@ <h5 id="spotdl.utils.m3u.create_m3u_content--returns">Returns<a class="headerlin
         <span class="k">else</span><span class="p">:</span>
             <span class="k">for</span> <span class="n">file_ext</span> <span class="ow">in</span> <span class="n">detect_formats</span><span class="p">:</span>
                 <span class="n">file_name</span> <span class="o">=</span> <span class="n">create_file_name</span><span class="p">(</span><span class="n">song</span><span class="p">,</span> <span class="n">template</span><span class="p">,</span> <span class="n">file_ext</span><span class="p">,</span> <span class="n">restrict</span><span class="p">,</span> <span class="n">short</span><span class="p">)</span>
+
                 <span class="k">if</span> <span class="n">file_name</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
                     <span class="n">text</span> <span class="o">+=</span> <span class="nb">str</span><span class="p">(</span><span class="n">file_name</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
                     <span class="k">break</span>
-            <span class="k">else</span><span class="p">:</span>
+
                 <span class="n">file_name</span> <span class="o">=</span> <span class="n">create_file_name</span><span class="p">(</span>
                     <span class="n">song</span><span class="p">,</span> <span class="n">template</span><span class="p">,</span> <span class="n">file_extension</span><span class="p">,</span> <span class="n">restrict</span><span class="p">,</span> <span class="n">short</span>
                 <span class="p">)</span>
-
                 <span class="n">text</span> <span class="o">+=</span> <span class="nb">str</span><span class="p">(</span><span class="n">file_name</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
 
     <span class="k">return</span> <span class="n">text</span>
@@ -2293,13 +2308,7 @@ <h5 id="spotdl.utils.m3u.create_m3u_file--returns">Returns<a class="headerlink"
 
             <details class="quote">
               <summary>Source code in <code>spotdl/utils/m3u.py</code></summary>
-              <div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">152</span>
-<span class="normal">153</span>
-<span class="normal">154</span>
-<span class="normal">155</span>
-<span class="normal">156</span>
-<span class="normal">157</span>
-<span class="normal">158</span>
+              <div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">158</span>
 <span class="normal">159</span>
 <span class="normal">160</span>
 <span class="normal">161</span>
@@ -2334,7 +2343,13 @@ <h5 id="spotdl.utils.m3u.create_m3u_file--returns">Returns<a class="headerlink"
 <span class="normal">190</span>
 <span class="normal">191</span>
 <span class="normal">192</span>
-<span class="normal">193</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_m3u_file</span><span class="p">(</span>
+<span class="normal">193</span>
+<span class="normal">194</span>
+<span class="normal">195</span>
+<span class="normal">196</span>
+<span class="normal">197</span>
+<span class="normal">198</span>
+<span class="normal">199</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_m3u_file</span><span class="p">(</span>
     <span class="n">file_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">song_list</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">],</span>
     <span class="n">template</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2396,9 +2411,8 @@ <h2 id="spotdl.utils.m3u.gen_m3u_files" class="doc doc-heading">
         <p>Create an m3u8 filename from the query.</p>
 <h5 id="spotdl.utils.m3u.gen_m3u_files--arguments">Arguments<a class="headerlink" href="#spotdl.utils.m3u.gen_m3u_files--arguments" title="Permanent link">¤</a></h5>
 <ul>
-<li>query: the query</li>
+<li>songs: the list of songs</li>
 <li>file_name: the file name to use</li>
-<li>song_list: the list of songs</li>
 <li>template: the output file template to use</li>
 <li>file_extension: the file extension to use</li>
 <li>restrict: sanitization to apply to the filename</li>
@@ -2408,14 +2422,7 @@ <h5 id="spotdl.utils.m3u.gen_m3u_files--arguments">Arguments<a class="headerlink
 
             <details class="quote">
               <summary>Source code in <code>spotdl/utils/m3u.py</code></summary>
-              <div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 64</span>
-<span class="normal"> 65</span>
-<span class="normal"> 66</span>
-<span class="normal"> 67</span>
-<span class="normal"> 68</span>
-<span class="normal"> 69</span>
-<span class="normal"> 70</span>
-<span class="normal"> 71</span>
+              <div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 71</span>
 <span class="normal"> 72</span>
 <span class="normal"> 73</span>
 <span class="normal"> 74</span>
@@ -2493,7 +2500,13 @@ <h5 id="spotdl.utils.m3u.gen_m3u_files--arguments">Arguments<a class="headerlink
 <span class="normal">146</span>
 <span class="normal">147</span>
 <span class="normal">148</span>
-<span class="normal">149</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">gen_m3u_files</span><span class="p">(</span>
+<span class="normal">149</span>
+<span class="normal">150</span>
+<span class="normal">151</span>
+<span class="normal">152</span>
+<span class="normal">153</span>
+<span class="normal">154</span>
+<span class="normal">155</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">gen_m3u_files</span><span class="p">(</span>
     <span class="n">songs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">],</span>
     <span class="n">file_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">template</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2506,9 +2519,8 @@ <h5 id="spotdl.utils.m3u.gen_m3u_files--arguments">Arguments<a class="headerlink
 <span class="sd">    Create an m3u8 filename from the query.</span>
 
 <span class="sd">    ### Arguments</span>
-<span class="sd">    - query: the query</span>
+<span class="sd">    - songs: the list of songs</span>
 <span class="sd">    - file_name: the file name to use</span>
-<span class="sd">    - song_list: the list of songs</span>
 <span class="sd">    - template: the output file template to use</span>
 <span class="sd">    - file_extension: the file extension to use</span>
 <span class="sd">    - restrict: sanitization to apply to the filename</span>
@@ -2647,7 +2659,7 @@ <h5 id="spotdl.utils.m3u.gen_m3u_files--arguments">Arguments<a class="headerlink
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/matching/index.html b/reference/utils/matching/index.html
index a4a698d51..bc6537ac8 100644
--- a/reference/utils/matching/index.html
+++ b/reference/utils/matching/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/matching/">
       
       
-        <link rel="prev" href="../spotify/">
+        <link rel="prev" href="../static/">
       
       
-        <link rel="next" href="../ffmpeg/">
+        <link rel="next" href="../search/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1286,182 +1202,56 @@
                 
   
   
+    
   
   
-    <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
-        
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    static
+    matching
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    search
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    web
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    spotify
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    matching
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    matching
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.matching" class="md-nav__link">
-    <span class="md-ellipsis">
-      matching
-    </span>
-  </a>
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.matching" class="md-nav__link">
+    <span class="md-ellipsis">
+      matching
+    </span>
+  </a>
   
 </li>
       
@@ -2066,11 +1856,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    search
   </span>
   
 
@@ -2087,11 +1877,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    downloader
   </span>
   
 
@@ -2108,11 +1898,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    archive
   </span>
   
 
@@ -2150,11 +1940,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    config
   </span>
   
 
@@ -2164,9 +1954,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arguments/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    arguments
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2178,45 +1981,112 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
+    <li class="md-nav__item">
+      <a href="../console/" class="md-nav__link">
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+      </a>
+    </li>
+  
+
               
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../web/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    providers
+    web
   </span>
   
 
-            </a>
+      </a>
+    </li>
+  
+
+              
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../ffmpeg/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../formatter/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    formatter
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
             
               
                 
@@ -2235,32 +2105,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2271,11 +2141,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    options
   </span>
   
 
@@ -2292,11 +2162,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    saved
   </span>
   
 
@@ -2313,11 +2183,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    artist
   </span>
   
 
@@ -2334,11 +2204,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    result
   </span>
   
 
@@ -2355,11 +2225,53 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    playlist
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/song/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    song
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/album/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    album
   </span>
   
 
@@ -2394,32 +2306,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2430,11 +2342,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2451,11 +2363,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2465,6 +2377,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2472,11 +2438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2493,11 +2459,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2514,11 +2480,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2535,11 +2501,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2556,11 +2522,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2570,9 +2536,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2733,7 +2733,7 @@ <h5 id="spotdl.utils.matching.artists_match_fixup1--returns">Returns<a class="he
 <span class="normal">460</span>
 <span class="normal">461</span>
 <span class="normal">462</span>
-<span class="normal">463</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">artists_match_fixup1</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">score</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">463</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">artists_match_fixup1</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">score</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Multiple fixes to the artists score for</span>
 <span class="sd">    not verified results to improve the accuracy</span>
@@ -2890,7 +2890,7 @@ <h5 id="spotdl.utils.matching.artists_match_fixup2--returns">Returns<a class="he
 <span class="normal">519</span>
 <span class="normal">520</span>
 <span class="normal">521</span>
-<span class="normal">522</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">artists_match_fixup2</span><span class="p">(</span>
+<span class="normal">522</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">artists_match_fixup2</span><span class="p">(</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">score</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">search_query</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3018,7 +3018,7 @@ <h5 id="spotdl.utils.matching.artists_match_fixup3--returns">Returns<a class="he
 <span class="normal">560</span>
 <span class="normal">561</span>
 <span class="normal">562</span>
-<span class="normal">563</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">artists_match_fixup3</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">score</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">563</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">artists_match_fixup3</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">score</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Calculate match percentage based result&#39;s name</span>
 <span class="sd">    and song&#39;s title if the result has exactly one artist</span>
@@ -3112,7 +3112,7 @@ <h5 id="spotdl.utils.matching.based_sort--returns">Returns<a class="headerlink"
 <span class="normal">176</span>
 <span class="normal">177</span>
 <span class="normal">178</span>
-<span class="normal">179</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">based_sort</span><span class="p">(</span><span class="n">strings</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">based_on</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
+<span class="normal">179</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">based_sort</span><span class="p">(</span><span class="n">strings</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">based_on</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Sort strings in list based on the order of strings in `based_on` list</span>
 
@@ -3183,7 +3183,7 @@ <h5 id="spotdl.utils.matching.calc_album_match--returns">Returns<a class="header
 <span class="normal">647</span>
 <span class="normal">648</span>
 <span class="normal">649</span>
-<span class="normal">650</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">calc_album_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">650</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">calc_album_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Calculate album match percentage</span>
 
@@ -3261,7 +3261,7 @@ <h5 id="spotdl.utils.matching.calc_artists_match--returns">Returns<a class="head
 <span class="normal">389</span>
 <span class="normal">390</span>
 <span class="normal">391</span>
-<span class="normal">392</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">calc_artists_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">392</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">calc_artists_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if all artists are present in list of artists</span>
 
@@ -3390,7 +3390,7 @@ <h5 id="spotdl.utils.matching.calc_main_artist_match--returns">Returns<a class="
 <span class="normal">354</span>
 <span class="normal">355</span>
 <span class="normal">356</span>
-<span class="normal">357</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">calc_main_artist_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">357</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">calc_main_artist_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if main artist is present in list of artists</span>
 
@@ -3536,7 +3536,7 @@ <h5 id="spotdl.utils.matching.calc_name_match--returns">Returns<a class="headerl
 <span class="normal">612</span>
 <span class="normal">613</span>
 <span class="normal">614</span>
-<span class="normal">615</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">calc_name_match</span><span class="p">(</span>
+<span class="normal">615</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">calc_name_match</span><span class="p">(</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">search_query</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3630,7 +3630,7 @@ <h5 id="spotdl.utils.matching.calc_time_match--returns">Returns<a class="headerl
 <span class="normal">629</span>
 <span class="normal">630</span>
 <span class="normal">631</span>
-<span class="normal">632</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">calc_time_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="normal">632</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">calc_time_match</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Calculate time difference between song and result</span>
 
@@ -3694,7 +3694,7 @@ <h5 id="spotdl.utils.matching.check_common_word--returns">Returns<a class="heade
 <span class="normal">198</span>
 <span class="normal">199</span>
 <span class="normal">200</span>
-<span class="normal">201</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">check_common_word</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="normal">201</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">check_common_word</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if a word is present in a sentence</span>
 
@@ -3764,7 +3764,7 @@ <h5 id="spotdl.utils.matching.check_forbidden_words--returns">Returns<a class="h
 <span class="normal">221</span>
 <span class="normal">222</span>
 <span class="normal">223</span>
-<span class="normal">224</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">check_forbidden_words</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">bool</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
+<span class="normal">224</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">check_forbidden_words</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">bool</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if a forbidden word is present in the result name</span>
 
@@ -3849,7 +3849,7 @@ <h5 id="spotdl.utils.matching.create_clean_string--returns">Returns<a class="hea
 <span class="normal">130</span>
 <span class="normal">131</span>
 <span class="normal">132</span>
-<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_clean_string</span><span class="p">(</span>
+<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_clean_string</span><span class="p">(</span>
     <span class="n">words</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">string</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">sort</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> <span class="n">join_str</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;-&quot;</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3945,7 +3945,7 @@ <h5 id="spotdl.utils.matching.create_match_strings--returns">Returns<a class="he
 <span class="normal">257</span>
 <span class="normal">258</span>
 <span class="normal">259</span>
-<span class="normal">260</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_match_strings</span><span class="p">(</span>
+<span class="normal">260</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_match_strings</span><span class="p">(</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span> <span class="n">search_query</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -4012,7 +4012,7 @@ <h5 id="spotdl.utils.matching.debug--arguments">Arguments<a class="headerlink" h
 <span class="normal">68</span>
 <span class="normal">69</span>
 <span class="normal">70</span>
-<span class="normal">71</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">debug</span><span class="p">(</span><span class="n">song_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">result_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">message</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="normal">71</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">debug</span><span class="p">(</span><span class="n">song_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">result_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">message</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Log a message with MATCH level</span>
 
@@ -4079,7 +4079,7 @@ <h5 id="spotdl.utils.matching.fill_string--returns">Returns<a class="headerlink"
 <span class="normal">96</span>
 <span class="normal">97</span>
 <span class="normal">98</span>
-<span class="normal">99</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">fill_string</span><span class="p">(</span><span class="n">strings</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">main_string</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">string_to_check</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">99</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">fill_string</span><span class="p">(</span><span class="n">strings</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">main_string</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">string_to_check</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Create a string with strings from `strings` list</span>
 <span class="sd">    if they are not yet present in main_string</span>
@@ -4160,7 +4160,7 @@ <h5 id="spotdl.utils.matching.get_best_matches--returns">Returns<a class="header
 <span class="normal">285</span>
 <span class="normal">286</span>
 <span class="normal">287</span>
-<span class="normal">288</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_best_matches</span><span class="p">(</span>
+<span class="normal">288</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_best_matches</span><span class="p">(</span>
     <span class="n">results</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">],</span> <span class="n">score_threshold</span><span class="p">:</span> <span class="nb">float</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="n">Result</span><span class="p">,</span> <span class="nb">float</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -4413,7 +4413,7 @@ <h5 id="spotdl.utils.matching.order_results--returns">Returns<a class="headerlin
 <span class="normal">846</span>
 <span class="normal">847</span>
 <span class="normal">848</span>
-<span class="normal">849</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">order_results</span><span class="p">(</span>
+<span class="normal">849</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">order_results</span><span class="p">(</span>
     <span class="n">results</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Result</span><span class="p">],</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span>
     <span class="n">search_query</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
@@ -4655,7 +4655,7 @@ <h5 id="spotdl.utils.matching.sort_string--returns">Returns<a class="headerlink"
 <span class="normal">148</span>
 <span class="normal">149</span>
 <span class="normal">150</span>
-<span class="normal">151</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">sort_string</span><span class="p">(</span><span class="n">strings</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">join_str</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="normal">151</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">sort_string</span><span class="p">(</span><span class="n">strings</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">join_str</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Sort strings in list and join them with `join` string</span>
 
@@ -4739,7 +4739,7 @@ <h5 id="spotdl.utils.matching.sort_string--returns">Returns<a class="headerlink"
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/metadata/index.html b/reference/utils/metadata/index.html
index aed54e1fb..7f2a60ece 100644
--- a/reference/utils/metadata/index.html
+++ b/reference/utils/metadata/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/metadata/">
       
       
-        <link rel="prev" href="../arguments/">
+        <link rel="prev" href="../m3u/">
       
       
-        <link rel="next" href="../downloader/">
+        <link rel="next" href="../logging/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,32 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    console
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    spotify
   </span>
   
 
@@ -1226,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    m3u
   </span>
   
 
@@ -1460,11 +1355,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    logging
   </span>
   
 
@@ -1481,11 +1376,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    static
   </span>
   
 
@@ -1502,11 +1397,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    matching
   </span>
   
 
@@ -1544,11 +1439,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    downloader
   </span>
   
 
@@ -1565,11 +1460,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    archive
   </span>
   
 
@@ -1586,11 +1481,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    lrc
   </span>
   
 
@@ -1607,11 +1502,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    config
   </span>
   
 
@@ -1628,11 +1523,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    arguments
   </span>
   
 
@@ -1649,11 +1544,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    console
   </span>
   
 
@@ -1670,11 +1565,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    github
   </span>
   
 
@@ -1691,11 +1586,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    web
   </span>
   
 
@@ -1712,11 +1607,32 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    ffmpeg
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../formatter/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    formatter
   </span>
   
 
@@ -1751,32 +1667,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1786,45 +1702,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1833,11 +1745,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1854,11 +1766,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1875,11 +1787,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1896,11 +1808,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1917,11 +1829,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1956,32 +1868,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1992,11 +1904,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2013,11 +1925,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2027,6 +1939,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2034,11 +2000,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2055,11 +2021,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2076,11 +2042,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2097,11 +2063,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2118,11 +2084,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2132,9 +2098,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2316,7 +2316,7 @@ <h5 id="spotdl.utils.metadata.embed_cover--arguments">Arguments<a class="headerl
 <span class="normal">336</span>
 <span class="normal">337</span>
 <span class="normal">338</span>
-<span class="normal">339</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">embed_cover</span><span class="p">(</span><span class="n">audio_file</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">encoding</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="normal">339</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">embed_cover</span><span class="p">(</span><span class="n">audio_file</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">encoding</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Embed the album art in the audio file.</span>
 
@@ -2461,7 +2461,7 @@ <h5 id="spotdl.utils.metadata.embed_lyrics--arguments">Arguments<a class="header
 <span class="normal">395</span>
 <span class="normal">396</span>
 <span class="normal">397</span>
-<span class="normal">398</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">embed_lyrics</span><span class="p">(</span><span class="n">audio_file</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">encoding</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="normal">398</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">embed_lyrics</span><span class="p">(</span><span class="n">audio_file</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span> <span class="n">encoding</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Detect lyrics type (lrc or txt) and embed them in the audio file.</span>
 
@@ -2658,7 +2658,7 @@ <h5 id="spotdl.utils.metadata.embed_metadata--arguments">Arguments<a class="head
 <span class="normal">272</span>
 <span class="normal">273</span>
 <span class="normal">274</span>
-<span class="normal">275</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">embed_metadata</span><span class="p">(</span>
+<span class="normal">275</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">embed_metadata</span><span class="p">(</span>
     <span class="n">output_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>
     <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">,</span>
     <span class="n">id3_separator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="p">,</span>
@@ -2692,7 +2692,7 @@ <h5 id="spotdl.utils.metadata.embed_metadata--arguments">Arguments<a class="head
                 <span class="sa">f</span><span class="s2">&quot;Unrecognized file format for </span><span class="si">{</span><span class="n">output_file</span><span class="si">}</span><span class="s2"> from </span><span class="si">{</span><span class="n">song</span><span class="o">.</span><span class="n">url</span><span class="si">}</span><span class="s2">&quot;</span>
             <span class="p">)</span>
     <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exc</span><span class="p">:</span>
-        <span class="k">raise</span> <span class="n">MetadataError</span><span class="p">(</span><span class="s2">&quot;Unable to load file.&quot;</span><span class="p">)</span> <span class="kn">from</span> <span class="nn">exc</span>
+        <span class="k">raise</span> <span class="n">MetadataError</span><span class="p">(</span><span class="s2">&quot;Unable to load file.&quot;</span><span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exc</span>
 
     <span class="c1"># Embed basic metadata</span>
     <span class="n">audio_file</span><span class="p">[</span><span class="n">tag_preset</span><span class="p">[</span><span class="s2">&quot;artist&quot;</span><span class="p">]]</span> <span class="o">=</span> <span class="n">song</span><span class="o">.</span><span class="n">artists</span>
@@ -2798,11 +2798,7 @@ <h5 id="spotdl.utils.metadata.embed_wav_file--arguments">Arguments<a class="head
 
             <details class="quote">
               <summary>Source code in <code>spotdl/utils/metadata.py</code></summary>
-              <div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">568</span>
-<span class="normal">569</span>
-<span class="normal">570</span>
-<span class="normal">571</span>
-<span class="normal">572</span>
+              <div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">572</span>
 <span class="normal">573</span>
 <span class="normal">574</span>
 <span class="normal">575</span>
@@ -2886,7 +2882,11 @@ <h5 id="spotdl.utils.metadata.embed_wav_file--arguments">Arguments<a class="head
 <span class="normal">653</span>
 <span class="normal">654</span>
 <span class="normal">655</span>
-<span class="normal">656</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">embed_wav_file</span><span class="p">(</span><span class="n">output_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
+<span class="normal">656</span>
+<span class="normal">657</span>
+<span class="normal">658</span>
+<span class="normal">659</span>
+<span class="normal">660</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">embed_wav_file</span><span class="p">(</span><span class="n">output_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Embeds the song metadata into the wav file</span>
 
@@ -3173,7 +3173,11 @@ <h5 id="spotdl.utils.metadata.get_file_metadata--raises">Raises<a class="headerl
 <span class="normal">562</span>
 <span class="normal">563</span>
 <span class="normal">564</span>
-<span class="normal">565</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_file_metadata</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">id3_separator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
+<span class="normal">565</span>
+<span class="normal">566</span>
+<span class="normal">567</span>
+<span class="normal">568</span>
+<span class="normal">569</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_file_metadata</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">id3_separator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get song metadata.</span>
 
@@ -3220,7 +3224,11 @@ <h5 id="spotdl.utils.metadata.get_file_metadata--raises">Raises<a class="headerl
                 <span class="k">continue</span>
 
             <span class="k">if</span> <span class="n">path</span><span class="o">.</span><span class="n">suffix</span> <span class="o">==</span> <span class="s2">&quot;.flac&quot;</span><span class="p">:</span>
-                <span class="n">song_meta</span><span class="p">[</span><span class="s2">&quot;album_art&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">audio_file</span><span class="o">.</span><span class="n">pictures</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">data</span>
+                <span class="k">if</span> <span class="n">audio_file</span><span class="o">.</span><span class="n">pictures</span><span class="p">:</span>
+                    <span class="n">song_meta</span><span class="p">[</span><span class="s2">&quot;album_art&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">audio_file</span><span class="o">.</span><span class="n">pictures</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">data</span>
+                <span class="k">else</span><span class="p">:</span>
+                    <span class="n">song_meta</span><span class="p">[</span><span class="s2">&quot;album_art&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
+
                 <span class="k">continue</span>
 
             <span class="k">if</span> <span class="n">path</span><span class="o">.</span><span class="n">suffix</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;.ogg&quot;</span><span class="p">,</span> <span class="s2">&quot;.opus&quot;</span><span class="p">]:</span>
@@ -3406,7 +3414,7 @@ <h5 id="spotdl.utils.metadata.get_file_metadata--raises">Raises<a class="headerl
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/search/index.html b/reference/utils/search/index.html
index a0c361fe6..c65faf2c4 100644
--- a/reference/utils/search/index.html
+++ b/reference/utils/search/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/search/">
       
       
-        <link rel="prev" href="../static/">
+        <link rel="prev" href="../matching/">
       
       
-        <link rel="next" href="../web/">
+        <link rel="next" href="../downloader/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,32 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    console
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    spotify
   </span>
   
 
@@ -1226,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    m3u
   </span>
   
 
@@ -1268,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    logging
   </span>
   
 
@@ -1289,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    static
   </span>
   
 
@@ -1310,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    matching
   </span>
   
 
@@ -1841,11 +1736,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    downloader
   </span>
   
 
@@ -1862,11 +1757,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    archive
   </span>
   
 
@@ -1883,11 +1778,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    lrc
   </span>
   
 
@@ -1904,11 +1799,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    config
   </span>
   
 
@@ -1925,11 +1820,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    arguments
   </span>
   
 
@@ -1946,11 +1841,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    console
   </span>
   
 
@@ -1967,11 +1862,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    github
   </span>
   
 
@@ -1988,11 +1883,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    web
   </span>
   
 
@@ -2009,11 +1904,32 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    ffmpeg
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../formatter/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    formatter
   </span>
   
 
@@ -2048,32 +1964,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2083,45 +1999,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -2130,11 +2042,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -2151,11 +2063,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -2172,11 +2084,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -2193,11 +2105,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -2214,11 +2126,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -2253,32 +2165,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2289,11 +2201,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2310,11 +2222,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -2331,11 +2318,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -2352,11 +2339,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -2373,11 +2360,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2394,11 +2381,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2415,11 +2402,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2429,9 +2416,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2601,7 +2601,7 @@ <h5 id="spotdl.utils.search.create_ytm_album--returns">Returns<a class="headerli
 <span class="normal">678</span>
 <span class="normal">679</span>
 <span class="normal">680</span>
-<span class="normal">681</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_ytm_album</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Album</span><span class="p">:</span>
+<span class="normal">681</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_ytm_album</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Album</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Creates a list of Song objects from an album query.</span>
 
@@ -2761,7 +2761,7 @@ <h5 id="spotdl.utils.search.create_ytm_playlist--returns">Returns<a class="heade
 <span class="normal">761</span>
 <span class="normal">762</span>
 <span class="normal">763</span>
-<span class="normal">764</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">create_ytm_playlist</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Playlist</span><span class="p">:</span>
+<span class="normal">764</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">create_ytm_playlist</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">fetch_songs</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Playlist</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Returns a playlist object from a youtube playlist url</span>
 
@@ -2908,7 +2908,7 @@ <h5 id="spotdl.utils.search.gather_known_songs--returns">Returns<a class="header
 <span class="normal">625</span>
 <span class="normal">626</span>
 <span class="normal">627</span>
-<span class="normal">628</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">gather_known_songs</span><span class="p">(</span><span class="n">output</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
+<span class="normal">628</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">gather_known_songs</span><span class="p">(</span><span class="n">output</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">output_format</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Gather all known songs from the output directory</span>
 
@@ -3012,7 +3012,7 @@ <h5 id="spotdl.utils.search.get_all_saved_playlists--returns">Returns<a class="h
 <span class="normal">531</span>
 <span class="normal">532</span>
 <span class="normal">533</span>
-<span class="normal">534</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_all_saved_playlists</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Playlist</span><span class="p">]:</span>
+<span class="normal">534</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_all_saved_playlists</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Playlist</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get all user playlists.</span>
 
@@ -3129,7 +3129,7 @@ <h5 id="spotdl.utils.search.get_all_user_playlists--returns">Returns<a class="he
 <span class="normal">424</span>
 <span class="normal">425</span>
 <span class="normal">426</span>
-<span class="normal">427</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_all_user_playlists</span><span class="p">(</span><span class="n">user_url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Playlist</span><span class="p">]:</span>
+<span class="normal">427</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_all_user_playlists</span><span class="p">(</span><span class="n">user_url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Playlist</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get all user playlists.</span>
 
@@ -3219,7 +3219,7 @@ <h5 id="spotdl.utils.search.get_search_results--returns">Returns<a class="header
 <span class="normal">73</span>
 <span class="normal">74</span>
 <span class="normal">75</span>
-<span class="normal">76</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_search_results</span><span class="p">(</span><span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
+<span class="normal">76</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_search_results</span><span class="p">(</span><span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Creates a list of Song objects from a search term.</span>
 
@@ -3496,7 +3496,7 @@ <h5 id="spotdl.utils.search.get_simple_songs--returns">Returns<a class="headerli
 <span class="normal">352</span>
 <span class="normal">353</span>
 <span class="normal">354</span>
-<span class="normal">355</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_simple_songs</span><span class="p">(</span>
+<span class="normal">355</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_simple_songs</span><span class="p">(</span>
     <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">use_ytm_data</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
     <span class="n">playlist_numbering</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
@@ -3778,7 +3778,7 @@ <h5 id="spotdl.utils.search.get_song_from_file_metadata--returns">Returns<a clas
 <span class="normal">586</span>
 <span class="normal">587</span>
 <span class="normal">588</span>
-<span class="normal">589</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_song_from_file_metadata</span><span class="p">(</span><span class="n">file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">id3_separator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
+<span class="normal">589</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_song_from_file_metadata</span><span class="p">(</span><span class="n">file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">id3_separator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get song based on the file metadata or file name</span>
 
@@ -3851,7 +3851,7 @@ <h5 id="spotdl.utils.search.get_user_followed_artists--returns">Returns<a class=
 <span class="normal">491</span>
 <span class="normal">492</span>
 <span class="normal">493</span>
-<span class="normal">494</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_user_followed_artists</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Artist</span><span class="p">]:</span>
+<span class="normal">494</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_user_followed_artists</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Artist</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get all user playlists</span>
 
@@ -3938,7 +3938,7 @@ <h5 id="spotdl.utils.search.get_user_saved_albums--returns">Returns<a class="hea
 <span class="normal">457</span>
 <span class="normal">458</span>
 <span class="normal">459</span>
-<span class="normal">460</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_user_saved_albums</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Album</span><span class="p">]:</span>
+<span class="normal">460</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_user_saved_albums</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Album</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get all user saved albums</span>
 
@@ -4006,7 +4006,7 @@ <h5 id="spotdl.utils.search.get_ytm_client--returns">Returns<a class="headerlink
 <span class="normal">53</span>
 <span class="normal">54</span>
 <span class="normal">55</span>
-<span class="normal">56</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_ytm_client</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">YTMusic</span><span class="p">:</span>
+<span class="normal">56</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_ytm_client</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">YTMusic</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Lazily initialize the YTMusic client.</span>
 
@@ -4086,7 +4086,7 @@ <h5 id="spotdl.utils.search.parse_query--returns">Returns<a class="headerlink" h
 <span class="normal">113</span>
 <span class="normal">114</span>
 <span class="normal">115</span>
-<span class="normal">116</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">parse_query</span><span class="p">(</span>
+<span class="normal">116</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">parse_query</span><span class="p">(</span>
     <span class="n">query</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
     <span class="n">threads</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
     <span class="n">use_ytm_data</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
@@ -4187,7 +4187,7 @@ <h5 id="spotdl.utils.search.reinit_song--returns">Returns<a class="headerlink" h
 <span class="normal">567</span>
 <span class="normal">568</span>
 <span class="normal">569</span>
-<span class="normal">570</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">reinit_song</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Song</span><span class="p">:</span>
+<span class="normal">570</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">reinit_song</span><span class="p">(</span><span class="n">song</span><span class="p">:</span> <span class="n">Song</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Song</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Update song object with new data</span>
 <span class="sd">    from Spotify</span>
@@ -4267,7 +4267,7 @@ <h5 id="spotdl.utils.search.songs_from_albums--returns">Returns<a class="headerl
 <span class="normal">372</span>
 <span class="normal">373</span>
 <span class="normal">374</span>
-<span class="normal">375</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">songs_from_albums</span><span class="p">(</span><span class="n">albums</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]):</span>
+<span class="normal">375</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">songs_from_albums</span><span class="p">(</span><span class="n">albums</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get all songs from albums ids/urls/etc.</span>
 
@@ -4353,7 +4353,7 @@ <h5 id="spotdl.utils.search.songs_from_albums--returns">Returns<a class="headerl
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/spotify/index.html b/reference/utils/spotify/index.html
index a4f472efc..855bd70e6 100644
--- a/reference/utils/spotify/index.html
+++ b/reference/utils/spotify/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/spotify/">
       
       
-        <link rel="prev" href="../logging/">
+        <link rel="prev" href="../">
       
       
-        <link rel="next" href="../matching/">
+        <link rel="next" href="../m3u/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1181,81 +1097,192 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    console
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
+    
   
   
   
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
-        
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
   
   <span class="md-ellipsis">
-    formatter
+    spotify
   </span>
   
 
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
         
   
   <span class="md-ellipsis">
-    arguments
+    spotify
   </span>
   
 
       </a>
-    </li>
-  
+      
+        
 
-              
-            
-              
-                
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
-        
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify" class="md-nav__link">
+    <span class="md-ellipsis">
+      spotify
+    </span>
+  </a>
   
-  <span class="md-ellipsis">
-    metadata
-  </span>
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.Singleton" class="md-nav__link">
+    <span class="md-ellipsis">
+      Singleton
+    </span>
+  </a>
   
-
-      </a>
+    <nav class="md-nav" aria-label="Singleton">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.Singleton.__call__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __call__
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="__call__">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.Singleton.__call__--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.Singleton.init" class="md-nav__link">
+    <span class="md-ellipsis">
+      init
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="init">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.Singleton.init--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.Singleton.init--returns" class="md-nav__link">
+    <span class="md-ellipsis">
+      Returns
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.SpotifyClient" class="md-nav__link">
+    <span class="md-ellipsis">
+      SpotifyClient
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="SpotifyClient">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.SpotifyClient--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.SpotifyError" class="md-nav__link">
+    <span class="md-ellipsis">
+      SpotifyError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.save_spotify_cache" class="md-nav__link">
+    <span class="md-ellipsis">
+      save_spotify_cache
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="save_spotify_cache">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#spotdl.utils.spotify.save_spotify_cache--arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      Arguments
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
     </li>
   
 
@@ -1268,11 +1295,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    m3u
   </span>
   
 
@@ -1289,11 +1316,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    metadata
   </span>
   
 
@@ -1310,11 +1337,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    logging
   </span>
   
 
@@ -1331,11 +1358,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    static
   </span>
   
 
@@ -1352,11 +1379,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    matching
   </span>
   
 
@@ -1373,11 +1400,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    search
   </span>
   
 
@@ -1391,192 +1418,81 @@
                 
   
   
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
   
-  <span class="md-ellipsis">
-    spotify
-  </span>
   
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+    <li class="md-nav__item">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    downloader
   </span>
   
 
       </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
+    </li>
   
+
+              
+            
+              
+                
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify" class="md-nav__link">
-    <span class="md-ellipsis">
-      spotify
-    </span>
-  </a>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.Singleton" class="md-nav__link">
-    <span class="md-ellipsis">
-      Singleton
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Singleton">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../archive/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.Singleton.__call__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __call__
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="__call__">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.Singleton.__call__--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    archive
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.Singleton.init" class="md-nav__link">
-    <span class="md-ellipsis">
-      init
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="init">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.Singleton.init--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.Singleton.init--returns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Returns
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../lrc/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.SpotifyClient" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpotifyClient
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="SpotifyClient">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.SpotifyClient--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    lrc
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.SpotifyError" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpotifyError
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.save_spotify_cache" class="md-nav__link">
-    <span class="md-ellipsis">
-      save_spotify_cache
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="save_spotify_cache">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#spotdl.utils.spotify.save_spotify_cache--arguments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Arguments
-    </span>
-  </a>
   
-</li>
+  
+    <li class="md-nav__item">
+      <a href="../config/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    config
+  </span>
   
-</nav>
-      
+
+      </a>
     </li>
   
 
@@ -1589,11 +1505,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1610,11 +1526,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1631,11 +1547,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1652,11 +1568,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1673,11 +1589,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1694,11 +1610,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1733,32 +1649,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1768,45 +1684,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1815,11 +1727,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1836,11 +1748,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1857,11 +1769,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1878,11 +1790,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1899,11 +1811,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1938,32 +1850,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1974,11 +1886,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1995,11 +1907,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -2016,11 +2003,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -2037,11 +2024,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -2058,11 +2045,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -2079,11 +2066,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -2100,11 +2087,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -2114,9 +2101,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2166,7 +2166,7 @@ <h1>spotify</h1>
 
         <p>Module for interacting with Spotify API.
 To use this module, you must have a Spotify API key and Spotify API secret.</p>
-<div class="language-python highlight"><pre><span></span><code><span class="kn">import</span> <span class="nn">spotdl.utils.spotify</span>
+<div class="language-python highlight"><pre><span></span><code><span class="kn">import</span><span class="w"> </span><span class="nn">spotdl.utils.spotify</span>
 <span class="n">spotify</span><span class="o">.</span><span class="n">Spotify</span><span class="o">.</span><span class="n">init</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">)</span>
 </code></pre></div>
 
@@ -2256,7 +2256,7 @@ <h6 id="spotdl.utils.spotify.Singleton.__call__--returns">Returns<a class="heade
 <span class="normal">56</span>
 <span class="normal">57</span>
 <span class="normal">58</span>
-<span class="normal">59</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>  <span class="c1"># pylint: disable=bad-mcs-method-argument</span>
+<span class="normal">59</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>  <span class="c1"># pylint: disable=bad-mcs-method-argument</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Call method for Singleton metaclass.</span>
 
@@ -2377,7 +2377,7 @@ <h6 id="spotdl.utils.spotify.Singleton.init--returns">Returns<a class="headerlin
 <span class="normal">130</span>
 <span class="normal">131</span>
 <span class="normal">132</span>
-<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">init</span><span class="p">(</span>  <span class="c1"># pylint: disable=bad-mcs-method-argument</span>
+<span class="normal">133</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">init</span><span class="p">(</span>  <span class="c1"># pylint: disable=bad-mcs-method-argument</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">client_secret</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2516,7 +2516,7 @@ <h5 id="spotdl.utils.spotify.SpotifyClient--arguments">Arguments<a class="header
 <span class="normal">163</span>
 <span class="normal">164</span>
 <span class="normal">165</span>
-<span class="normal">166</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<span class="normal">166</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Initializes the SpotifyClient.</span>
 
@@ -2628,7 +2628,7 @@ <h5 id="spotdl.utils.spotify.save_spotify_cache--arguments">Arguments<a class="h
 <span class="normal">224</span>
 <span class="normal">225</span>
 <span class="normal">226</span>
-<span class="normal">227</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">save_spotify_cache</span><span class="p">(</span><span class="n">cache</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">]]):</span>
+<span class="normal">227</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">save_spotify_cache</span><span class="p">(</span><span class="n">cache</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">]]):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Saves the Spotify cache to a file.</span>
 
@@ -2717,7 +2717,7 @@ <h5 id="spotdl.utils.spotify.save_spotify_cache--arguments">Arguments<a class="h
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/static/index.html b/reference/utils/static/index.html
index 160106caf..e8b9d261c 100644
--- a/reference/utils/static/index.html
+++ b/reference/utils/static/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/static/">
       
       
-        <link rel="prev" href="../github/">
+        <link rel="prev" href="../logging/">
       
       
-        <link rel="next" href="../search/">
+        <link rel="next" href="../matching/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,32 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    console
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    spotify
   </span>
   
 
@@ -1226,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    m3u
   </span>
   
 
@@ -1268,32 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    logging
   </span>
   
 
@@ -1376,11 +1250,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    matching
   </span>
   
 
@@ -1397,11 +1271,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../web/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    search
   </span>
   
 
@@ -1418,11 +1292,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    downloader
   </span>
   
 
@@ -1439,11 +1313,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    archive
   </span>
   
 
@@ -1460,11 +1334,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    lrc
   </span>
   
 
@@ -1481,11 +1355,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    config
   </span>
   
 
@@ -1502,11 +1376,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    arguments
   </span>
   
 
@@ -1523,11 +1397,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    console
   </span>
   
 
@@ -1544,11 +1418,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    github
   </span>
   
 
@@ -1565,11 +1439,53 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    web
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../ffmpeg/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    ffmpeg
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../formatter/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    formatter
   </span>
   
 
@@ -1604,32 +1520,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
+            <a href="../../types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1639,45 +1555,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../../types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1686,11 +1598,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1707,11 +1619,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1728,11 +1640,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1749,11 +1661,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1770,11 +1682,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1809,32 +1721,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1845,11 +1757,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -1866,11 +1778,86 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/save/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    save
   </span>
   
 
@@ -1887,11 +1874,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    url
   </span>
   
 
@@ -1908,11 +1895,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    entry_point
   </span>
   
 
@@ -1929,11 +1916,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    sync
   </span>
   
 
@@ -1950,11 +1937,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    meta
   </span>
   
 
@@ -1971,11 +1958,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    download
   </span>
   
 
@@ -1985,9 +1972,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2118,7 +2118,7 @@ <h1>static</h1>
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/reference/utils/web/index.html b/reference/utils/web/index.html
index 672f08a47..48d9e5f3b 100644
--- a/reference/utils/web/index.html
+++ b/reference/utils/web/index.html
@@ -15,14 +15,14 @@
         <link rel="canonical" href="https://spotdl.github.io/spotify-downloader/reference/utils/web/">
       
       
-        <link rel="prev" href="../search/">
+        <link rel="prev" href="../github/">
       
       
-        <link rel="next" href="../logging/">
+        <link rel="next" href="../ffmpeg/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -653,11 +653,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../download/" class="md-nav__link ">
+            <a href="../../providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -673,7 +673,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -683,56 +683,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../../download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -744,32 +694,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../types/" class="md-nav__link ">
+            <a href="../../providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -780,53 +730,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../types/album/" class="md-nav__link">
+      <a href="../../providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -843,11 +751,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/saved/" class="md-nav__link">
+      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -864,11 +772,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/result/" class="md-nav__link">
+      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -885,11 +793,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/song/" class="md-nav__link">
+      <a href="../../providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -906,11 +814,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../types/options/" class="md-nav__link">
+      <a href="../../providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -945,32 +853,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../console/" class="md-nav__link ">
+            <a href="../../providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -981,11 +889,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/save/" class="md-nav__link">
+      <a href="../../providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1002,11 +910,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/url/" class="md-nav__link">
+      <a href="../../providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1023,11 +931,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/meta/" class="md-nav__link">
+      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1044,11 +952,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/web/" class="md-nav__link">
+      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1065,11 +973,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/sync/" class="md-nav__link">
+      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1086,11 +994,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/download/" class="md-nav__link">
+      <a href="../../providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1107,11 +1015,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../console/entry_point/" class="md-nav__link">
+      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1129,6 +1037,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1148,7 +1064,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
         
           
           
@@ -1164,14 +1080,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1184,11 +1100,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../console/" class="md-nav__link">
+      <a href="../spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1205,11 +1121,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../formatter/" class="md-nav__link">
+      <a href="../m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1226,11 +1142,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../arguments/" class="md-nav__link">
+      <a href="../metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1247,11 +1163,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../metadata/" class="md-nav__link">
+      <a href="../logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1268,11 +1184,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../downloader/" class="md-nav__link">
+      <a href="../static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1289,11 +1205,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../github/" class="md-nav__link">
+      <a href="../matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1310,11 +1226,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../static/" class="md-nav__link">
+      <a href="../search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1331,11 +1247,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../search/" class="md-nav__link">
+      <a href="../downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1349,48 +1265,174 @@
                 
   
   
-    
-  
   
   
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
+    <li class="md-nav__item">
+      <a href="../archive/" class="md-nav__link">
+        
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    lrc
   </span>
   
 
       </a>
-      
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+              
+            
+              
+                
   
   
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
+    <li class="md-nav__item">
+      <a href="../config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    config
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arguments/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    arguments
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../console/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../github/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    github
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
@@ -1982,11 +2024,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
+      <a href="../ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    ffmpeg
   </span>
   
 
@@ -2003,11 +2045,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../spotify/" class="md-nav__link">
+      <a href="../formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    formatter
   </span>
   
 
@@ -2017,26 +2059,59 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
   
   
   
-    <li class="md-nav__item">
-      <a href="../matching/" class="md-nav__link">
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
         
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../types/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
-    matching
+    types
   </span>
   
 
-      </a>
-    </li>
-  
-
+            </a>
+            
               
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+            types
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
             
               
                 
@@ -2045,11 +2120,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../ffmpeg/" class="md-nav__link">
+      <a href="../../types/options/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    options
   </span>
   
 
@@ -2066,11 +2141,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../m3u/" class="md-nav__link">
+      <a href="../../types/saved/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    saved
   </span>
   
 
@@ -2087,11 +2162,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
+      <a href="../../types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    artist
   </span>
   
 
@@ -2108,11 +2183,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../lrc/" class="md-nav__link">
+      <a href="../../types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    result
   </span>
   
 
@@ -2129,11 +2204,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../archive/" class="md-nav__link">
+      <a href="../../types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    playlist
   </span>
   
 
@@ -2143,9 +2218,22 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../types/song/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    song
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2157,45 +2245,28 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+    <li class="md-nav__item">
+      <a href="../../types/album/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../../providers/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    providers
+    album
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
-            <span class="md-nav__icon md-icon"></span>
-            providers
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
             
               
                 
@@ -2214,32 +2285,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/lyrics/" class="md-nav__link ">
+            <a href="../../download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    lyrics
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            lyrics
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2250,74 +2321,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/synced/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    synced
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/musixmatch/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    musixmatch
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/azlyrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    azlyrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../providers/lyrics/genius/" class="md-nav__link">
+      <a href="../../download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    downloader
   </span>
   
 
@@ -2334,11 +2342,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/lyrics/base/" class="md-nav__link">
+      <a href="../../download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    progress_handler
   </span>
   
 
@@ -2373,32 +2381,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../providers/audio/" class="md-nav__link ">
+            <a href="../../console/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    console
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            console
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2409,11 +2417,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../../console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    save
   </span>
   
 
@@ -2430,11 +2438,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../../console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    url
   </span>
   
 
@@ -2451,11 +2459,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/piped/" class="md-nav__link">
+      <a href="../../console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    entry_point
   </span>
   
 
@@ -2472,11 +2480,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/youtube/" class="md-nav__link">
+      <a href="../../console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    sync
   </span>
   
 
@@ -2493,11 +2501,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../../console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    meta
   </span>
   
 
@@ -2514,11 +2522,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/base/" class="md-nav__link">
+      <a href="../../console/download/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    download
   </span>
   
 
@@ -2535,11 +2543,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../../console/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    web
   </span>
   
 
@@ -2563,14 +2571,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
   </ul>
 </nav>
@@ -2715,7 +2715,7 @@ <h2 id="spotdl.utils.web.Client" class="doc doc-heading">
 <span class="normal">138</span>
 <span class="normal">139</span>
 <span class="normal">140</span>
-<span class="normal">141</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+<span class="normal">141</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">websocket</span><span class="p">:</span> <span class="n">WebSocket</span><span class="p">,</span>
     <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -2786,7 +2786,7 @@ <h3 id="spotdl.utils.web.Client.connect" class="doc doc-heading">
 <span class="normal">149</span>
 <span class="normal">150</span>
 <span class="normal">151</span>
-<span class="normal">152</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span> <span class="nf">connect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">152</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">connect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Called when a new client connects to the websocket.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2848,7 +2848,7 @@ <h6 id="spotdl.utils.web.Client.get_instance--returns">Returns<a class="headerli
 <span class="normal">199</span>
 <span class="normal">200</span>
 <span class="normal">201</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">get_instance</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="s2">&quot;Client&quot;</span><span class="p">]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_instance</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="s2">&quot;Client&quot;</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the WebSocket instance for a client.</span>
 
@@ -2903,7 +2903,7 @@ <h6 id="spotdl.utils.web.Client.send_update--arguments">Arguments<a class="heade
 <span class="normal">159</span>
 <span class="normal">160</span>
 <span class="normal">161</span>
-<span class="normal">162</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span> <span class="nf">send_update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">update</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]):</span>
+<span class="normal">162</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">send_update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">update</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Send an update to the client.</span>
 
@@ -2955,7 +2955,7 @@ <h6 id="spotdl.utils.web.Client.song_update--arguments">Arguments<a class="heade
 <span class="normal">178</span>
 <span class="normal">179</span>
 <span class="normal">180</span>
-<span class="normal">181</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">song_update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">progress_handler</span><span class="p">:</span> <span class="n">SongTracker</span><span class="p">,</span> <span class="n">message</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="normal">181</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">song_update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">progress_handler</span><span class="p">:</span> <span class="n">SongTracker</span><span class="p">,</span> <span class="n">message</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Called when a song updates.</span>
 
@@ -3073,7 +3073,7 @@ <h6 id="spotdl.utils.web.SPAStaticFiles.get_response--returns">Returns<a class="
 <span class="normal">103</span>
 <span class="normal">104</span>
 <span class="normal">105</span>
-<span class="normal">106</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span> <span class="nf">get_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">scope</span><span class="p">:</span> <span class="n">Scope</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Response</span><span class="p">:</span>
+<span class="normal">106</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">get_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">scope</span><span class="p">:</span> <span class="n">Scope</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Response</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Serve static files from the SPA.</span>
 
@@ -3153,7 +3153,7 @@ <h5 id="spotdl.utils.web.check_update--returns">Returns<a class="headerlink" hre
 <span class="normal">539</span>
 <span class="normal">540</span>
 <span class="normal">541</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/check_update&quot;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">check_update</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">check_update</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check for update.</span>
 
@@ -3241,7 +3241,7 @@ <h5 id="spotdl.utils.web.download_file--returns">Returns<a class="headerlink" hr
 <span class="normal">459</span>
 <span class="normal">460</span>
 <span class="normal">461</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/download/file&quot;</span><span class="p">)</span>
-<span class="k">async</span> <span class="k">def</span> <span class="nf">download_file</span><span class="p">(</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">download_file</span><span class="p">(</span>
     <span class="n">file</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">client</span><span class="p">:</span> <span class="n">Client</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_client</span><span class="p">),</span>
     <span class="n">state</span><span class="p">:</span> <span class="n">ApplicationState</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_current_state</span><span class="p">),</span>
@@ -3355,7 +3355,7 @@ <h5 id="spotdl.utils.web.download_url--returns">Returns<a class="headerlink" hre
 <span class="normal">425</span>
 <span class="normal">426</span>
 <span class="normal">427</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">post</span><span class="p">(</span><span class="s2">&quot;/api/download/url&quot;</span><span class="p">)</span>
-<span class="k">async</span> <span class="k">def</span> <span class="nf">download_url</span><span class="p">(</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">download_url</span><span class="p">(</span>
     <span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
     <span class="n">client</span><span class="p">:</span> <span class="n">Client</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_client</span><span class="p">),</span>
     <span class="n">state</span><span class="p">:</span> <span class="n">ApplicationState</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_current_state</span><span class="p">),</span>
@@ -3403,7 +3403,7 @@ <h5 id="spotdl.utils.web.download_url--returns">Returns<a class="headerlink" hre
 
         <span class="k">raise</span> <span class="n">HTTPException</span><span class="p">(</span>
             <span class="n">status_code</span><span class="o">=</span><span class="mi">500</span><span class="p">,</span> <span class="n">detail</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Error downloading: </span><span class="si">{</span><span class="n">exception</span><span class="si">}</span><span class="s2">&quot;</span>
-        <span class="p">)</span> <span class="kn">from</span> <span class="nn">exception</span>
+        <span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exception</span>
 </code></pre></div></td></tr></table></div>
             </details>
     </div>
@@ -3455,7 +3455,7 @@ <h2 id="spotdl.utils.web.fix_mime_types" class="doc doc-heading">
 <span class="normal">641</span>
 <span class="normal">642</span>
 <span class="normal">643</span>
-<span class="normal">644</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">fix_mime_types</span><span class="p">():</span>
+<span class="normal">644</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">fix_mime_types</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Fix incorrect entries in the `mimetypes` registry.</span>
 <span class="sd">    On Windows, the Python standard library&#39;s `mimetypes` reads in</span>
 <span class="sd">    mappings from file extension to MIME type from the Windows</span>
@@ -3524,7 +3524,7 @@ <h5 id="spotdl.utils.web.get_client--returns">Returns<a class="headerlink" href=
 <span class="normal">248</span>
 <span class="normal">249</span>
 <span class="normal">250</span>
-<span class="normal">251</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_client</span><span class="p">(</span><span class="n">client_id</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="kc">None</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">))</span> <span class="o">-&gt;</span> <span class="n">Client</span><span class="p">:</span>
+<span class="normal">251</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_client</span><span class="p">(</span><span class="n">client_id</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="kc">None</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">))</span> <span class="o">-&gt;</span> <span class="n">Client</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the client&#39;s state.</span>
 
@@ -3576,7 +3576,7 @@ <h5 id="spotdl.utils.web.get_current_state--returns">Returns<a class="headerlink
 <span class="normal">227</span>
 <span class="normal">228</span>
 <span class="normal">229</span>
-<span class="normal">230</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_current_state</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">ApplicationState</span><span class="p">:</span>
+<span class="normal">230</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_current_state</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">ApplicationState</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the current state of the application.</span>
 
@@ -3687,7 +3687,7 @@ <h5 id="spotdl.utils.web.get_options--returns">Returns<a class="headerlink" href
 <span class="normal">618</span>
 <span class="normal">619</span>
 <span class="normal">620</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/options_model&quot;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">get_options</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_options</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get options model (possible settings).</span>
 
@@ -3807,7 +3807,7 @@ <h5 id="spotdl.utils.web.get_settings--returns">Returns<a class="headerlink" hre
 <span class="normal">476</span>
 <span class="normal">477</span>
 <span class="normal">478</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/settings&quot;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">get_settings</span><span class="p">(</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_settings</span><span class="p">(</span>
     <span class="n">client</span><span class="p">:</span> <span class="n">Client</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_client</span><span class="p">),</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DownloaderOptions</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
@@ -3863,7 +3863,7 @@ <h5 id="spotdl.utils.web.query_search--returns">Returns<a class="headerlink" hre
 <span class="normal">373</span>
 <span class="normal">374</span>
 <span class="normal">375</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/songs/search&quot;</span><span class="p">,</span> <span class="n">response_model</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">query_search</span><span class="p">(</span><span class="n">query</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">query_search</span><span class="p">(</span><span class="n">query</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Parse search term and return list of Song objects.</span>
 
@@ -3914,7 +3914,7 @@ <h2 id="spotdl.utils.web.shutdown_event" class="doc doc-heading">
 <span class="normal">358</span>
 <span class="normal">359</span>
 <span class="normal">360</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">on_event</span><span class="p">(</span><span class="s2">&quot;shutdown&quot;</span><span class="p">)</span>
-<span class="k">async</span> <span class="k">def</span> <span class="nf">shutdown_event</span><span class="p">():</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">shutdown_event</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Called when the server is shutting down.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -3969,7 +3969,7 @@ <h5 id="spotdl.utils.web.song_from_url--returns">Returns<a class="headerlink" hr
 <span class="normal">303</span>
 <span class="normal">304</span>
 <span class="normal">305</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/song/url&quot;</span><span class="p">,</span> <span class="n">response_model</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">song_from_url</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Song</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">song_from_url</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Song</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for a song on spotify using url.</span>
 
@@ -4033,7 +4033,7 @@ <h5 id="spotdl.utils.web.songs_from_url--returns">Returns<a class="headerlink" h
 <span class="normal">328</span>
 <span class="normal">329</span>
 <span class="normal">330</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/url&quot;</span><span class="p">,</span> <span class="n">response_model</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">songs_from_url</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">songs_from_url</span><span class="p">(</span><span class="n">url</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Song</span><span class="p">]:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Search for a song, playlist, artist or album on spotify using url.</span>
 
@@ -4122,7 +4122,7 @@ <h5 id="spotdl.utils.web.update_settings--returns">Returns<a class="headerlink"
 <span class="normal">514</span>
 <span class="normal">515</span>
 <span class="normal">516</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">post</span><span class="p">(</span><span class="s2">&quot;/api/settings/update&quot;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">update_settings</span><span class="p">(</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">update_settings</span><span class="p">(</span>
     <span class="n">settings</span><span class="p">:</span> <span class="n">DownloaderOptionalOptions</span><span class="p">,</span>
     <span class="n">client</span><span class="p">:</span> <span class="n">Client</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_client</span><span class="p">),</span>
     <span class="n">state</span><span class="p">:</span> <span class="n">ApplicationState</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">get_current_state</span><span class="p">),</span>
@@ -4196,7 +4196,7 @@ <h5 id="spotdl.utils.web.version--returns">Returns<a class="headerlink" href="#s
 <span class="normal">342</span>
 <span class="normal">343</span>
 <span class="normal">344</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/api/version&quot;</span><span class="p">,</span> <span class="n">response_model</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">version</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">version</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the current version</span>
 <span class="sd">    This method is created to ensure backward compatibility of the web app,</span>
@@ -4272,7 +4272,7 @@ <h5 id="spotdl.utils.web.websocket_endpoint--arguments">Arguments<a class="heade
 <span class="normal">287</span>
 <span class="normal">288</span>
 <span class="normal">289</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="nd">@router</span><span class="o">.</span><span class="n">websocket</span><span class="p">(</span><span class="s2">&quot;/api/ws&quot;</span><span class="p">)</span>
-<span class="k">async</span> <span class="k">def</span> <span class="nf">websocket_endpoint</span><span class="p">(</span><span class="n">websocket</span><span class="p">:</span> <span class="n">WebSocket</span><span class="p">,</span> <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">websocket_endpoint</span><span class="p">(</span><span class="n">websocket</span><span class="p">:</span> <span class="n">WebSocket</span><span class="p">,</span> <span class="n">client_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Websocket endpoint.</span>
 
@@ -4375,7 +4375,7 @@ <h5 id="spotdl.utils.web.websocket_endpoint--arguments">Arguments<a class="heade
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/search/search_index.json b/search/search_index.json
index de0d35251..b925f13fe 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#spotdl-v4","title":"spotDL v4","text":"<p>spotDL finds songs from Spotify playlists on YouTube and downloads them - along with album art, lyrics and metadata.</p> <p> </p> <p>spotDL: The fastest, easiest and most accurate command-line music downloader.</p> <p>Read the documentation on ReadTheDocs!</p>"},{"location":"#installation","title":"Installation","text":"<p>Refer to our Installation Guide for more details.</p>"},{"location":"#python-recommended-method","title":"Python (Recommended Method)","text":"<ul> <li>spotDL can be installed by running <code>pip install spotdl</code>.</li> <li>To update spotDL run <code>pip install --upgrade spotdl</code> <p>On some systems you might have to change <code>pip</code> to <code>pip3</code>.</p> </li> </ul>"},{"location":"#other-options","title":"Other options","text":"<ul> <li>Prebuilt executable</li> <li>You can download the latest version from the     Releases Tab</li> <li>On Termux</li> <li><code>curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh</code></li> <li>Arch</li> <li>There is an Arch User Repository (AUR) package for     spotDL.</li> <li>Docker</li> <li> <p>Build image:</p> <pre><code>docker build -t spotdl .\n</code></pre> </li> <li> <p>Launch container with spotDL parameters (see section below). You need to create mapped     volume to access song files</p> <pre><code>docker run --rm -v $(pwd):/music spotdl download [trackUrl]\n</code></pre> </li> <li> <p>Build from source     <pre><code>git clone /~https://github.com/spotDL/spotify-downloader &amp;&amp; cd spotify-downloader\npip install poetry\npoetry install\npython3 scripts/build.py\n</code></pre>     An executable is created in <code>spotify-downloader/dist/</code>.</p> </li> </ul>"},{"location":"#installing-ffmpeg","title":"Installing FFmpeg","text":"<p>FFmpeg is required for spotDL. If using FFmpeg only for spotDL, you can simply install FFmpeg to your spotDL installation directory: <code>spotdl --download-ffmpeg</code></p> <p>We recommend the above option, but if you want to install FFmpeg system-wide, follow these instructions</p> <ul> <li>Windows Tutorial</li> <li>OSX - <code>brew install ffmpeg</code></li> <li>Linux - <code>sudo apt install ffmpeg</code> or use your distro's package manager</li> </ul>"},{"location":"#usage","title":"Usage","text":"<p>Using SpotDL without options:: <pre><code>spotdl [urls]\n</code></pre> You can run spotDL as a package if running it as a script doesn't work: <pre><code>python -m spotdl [urls]\n</code></pre></p> <p>General usage: <pre><code>spotdl [operation] [options] QUERY\n</code></pre> When downloading songs, the song's Spotify Popularity variable (described here) is stored in metadata as a comment, so you can sort your downloaded songs by popularity.</p> <p>There are different operations spotDL can perform. The default is <code>download</code>, which simply downloads the songs from YouTube and embeds metadata.</p> <p>The query for spotDL is usually a list of Spotify URLs, but for some operations like sync, only a single link or file is required. For a list of all options use <code>spotdl -h</code></p>"},{"location":"#supported-operations","title":"Supported operations","text":"<ul> <li> <p><code>save</code>: Saves only the metadata from Spotify without downloading anything.</p> <ul> <li>Usage:     <code>spotdl save [query] --save-file {filename}.spotdl</code></li> </ul> </li> <li> <p><code>web</code>: Starts a web interface instead of using the command line. However, it has limited features and only supports downloading single songs.</p> <ul> <li>Usage:     <code>spotdl web</code></li> </ul> </li> <li> <p><code>url</code>: Get direct download link for each song from the query.</p> <ul> <li>Usage:     <code>spotdl url [query]</code></li> </ul> </li> <li> <p><code>sync</code>: Updates directories. Compares the directory with the current state of the playlist. Newly added songs will be downloaded and removed songs will be deleted. No other songs will be downloaded and no other files will be deleted.</p> <ul> <li> <p>Usage:     <code>spotdl sync [query] --save-file {filename}.spotdl</code></p> <p>This create a new sync file, to update the directory in the future, use:</p> <p><code>spotdl sync {filename}.spotdl</code></p> </li> </ul> </li> <li> <p><code>meta</code>: Updates metadata for the provided song files. </p> </li> </ul>"},{"location":"#music-sourcing-and-audio-quality","title":"Music Sourcing and Audio Quality","text":"<p>spotDL uses YouTube as a source for music downloads. This method is used to avoid any issues related to downloading music from Spotify.</p> <p>Note Users are responsible for their actions and potential legal consequences. We do not support unauthorized downloading of copyrighted material and take no responsibility for user actions.</p>"},{"location":"#audio-quality","title":"Audio Quality","text":"<p>spotDL downloads music from YouTube and is designed to always download the highest possible bitrate; which is 128 kbps for regular users and 256 kbps for YouTube Music premium users.</p> <p>Check the Audio Formats page for more info.</p>"},{"location":"#contributing","title":"Contributing","text":"<p>Interested in contributing? Check out our CONTRIBUTING.md to find resources around contributing along with a guide on how to set up a development environment.</p>"},{"location":"#donate","title":"Donate","text":"<p>help support the development and maintenance of the software \u2764\ufe0f</p> <p> </p>"},{"location":"#license","title":"License","text":"<p>This project is Licensed under the MIT License.</p>"},{"location":"CODE_OF_CONDUCT/","title":"Contributor Covenant Code of Conduct","text":""},{"location":"CODE_OF_CONDUCT/#our-pledge","title":"Our Pledge","text":"<p>We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.</p> <p>We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.</p>"},{"location":"CODE_OF_CONDUCT/#our-standards","title":"Our Standards","text":"<p>Examples of behavior that contributes to a positive environment for our community include:</p> <ul> <li>Demonstrating empathy and kindness toward other people</li> <li>Being respectful of differing opinions, viewpoints, and experiences</li> <li>Giving and gracefully accepting constructive feedback</li> <li>Accepting responsibility and apologizing to those affected by our mistakes, and learning from   the experience</li> <li>Focusing on what is best not just for us as individuals, but for the overall community</li> </ul> <p>Examples of unacceptable behavior include:</p> <ul> <li>The use of sexualized language or imagery, and sexual attention or advances of any kind</li> <li>Trolling, insulting or derogatory comments, and personal or political attacks</li> <li>Public or private harassment</li> <li>Publishing others' private information, such as a physical or email address, without their   explicit permission</li> <li>Other conduct which could reasonably be considered inappropriate in a professional setting</li> </ul>"},{"location":"CODE_OF_CONDUCT/#enforcement-responsibilities","title":"Enforcement Responsibilities","text":"<p>Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.</p> <p>Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.</p>"},{"location":"CODE_OF_CONDUCT/#scope","title":"Scope","text":"<p>This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.</p>"},{"location":"CODE_OF_CONDUCT/#enforcement","title":"Enforcement","text":"<p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at spotdladmins@googlegroups.com. All complaints will be reviewed and investigated promptly and fairly.</p> <p>All community leaders are obligated to respect the privacy and security of the reporter of any incident.</p>"},{"location":"CODE_OF_CONDUCT/#enforcement-guidelines","title":"Enforcement Guidelines","text":"<p>Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:</p>"},{"location":"CODE_OF_CONDUCT/#1-correction","title":"1. Correction","text":"<p>Community Impact: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.</p> <p>Consequence: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.</p>"},{"location":"CODE_OF_CONDUCT/#2-warning","title":"2. Warning","text":"<p>Community Impact: A violation through a single incident or series of actions.</p> <p>Consequence: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.</p>"},{"location":"CODE_OF_CONDUCT/#3-temporary-ban","title":"3. Temporary Ban","text":"<p>Community Impact: A serious violation of community standards, including sustained inappropriate behavior.</p> <p>Consequence: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.</p>"},{"location":"CODE_OF_CONDUCT/#4-permanent-ban","title":"4. Permanent Ban","text":"<p>Community Impact: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.</p> <p>Consequence: A permanent ban from any sort of public interaction within the community.</p>"},{"location":"CODE_OF_CONDUCT/#attribution","title":"Attribution","text":"<p>This Code of Conduct is adapted from the Contributor Covenant, version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.</p> <p>Community Impact Guidelines were inspired by Mozilla's code of conduct enforcement ladder.</p> <p>For answers to common questions about this code of conduct, see the FAQ at https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.</p>"},{"location":"CONTRIBUTING/","title":"Contributing","text":""},{"location":"CONTRIBUTING/#contributing-to-spotdl","title":"Contributing to spotdl","text":"<p>First off, thanks for taking the time to contribute! \u2764\ufe0f</p> <p>All types of contributions are encouraged and valued. See the Table of Contents for different ways to help and details about how this project handles them. Please make sure to read the relevant section before making your contribution. It will make it a lot easier for us maintainers and smooth out the experience for everyone involved. The community looks forward to your contributions. \ud83c\udf89</p> <p>And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about:</p> <ul> <li>Star the project</li> <li>Tweet about it</li> <li>Refer this project in your project's readme</li> <li>Mention the project at local meetups and tell your friends/colleagues</li> </ul>"},{"location":"CONTRIBUTING/#table-of-contents","title":"Table of Contents","text":"<ul> <li>I Have a Question</li> <li>I Want To Contribute</li> <li>Reporting Bugs</li> <li>Suggesting Enhancements</li> <li>Linting, Formatting and Type-checking</li> <li>Python Documentation</li> <li>Overview of the Project Structure</li> <li>Join The Project Team</li> </ul>"},{"location":"CONTRIBUTING/#i-have-a-question","title":"I Have a Question","text":"<p>If you want to ask a question, we assume that you have read the available Documentation.</p> <p>Before you ask a question, it is best to search for existing Issues that might help you. In case you have found a suitable issue and still need clarification, you can write your question in this issue. It is also advisable to search the internet for answers first.</p> <p>If you then still feel the need to ask a question and need clarification, we recommend the following:</p> <ul> <li>Open an Issue.</li> <li>Provide as much context as you can about what you're running into.</li> <li>Provide project and platform versions (nodejs, npm, etc), depending on what seems relevant.</li> </ul> <p>We will then take care of the issue as soon as possible.</p>"},{"location":"CONTRIBUTING/#i-want-to-contribute","title":"I Want To Contribute","text":""},{"location":"CONTRIBUTING/#legal-notice","title":"Legal Notice","text":"<p>When contributing to this project, you must agree that you have authored 100% of the content, that you have the necessary rights to the content and that the content you contribute may be provided under the project license.</p>"},{"location":"CONTRIBUTING/#reporting-bugs","title":"Reporting Bugs","text":""},{"location":"CONTRIBUTING/#before-submitting-a-bug-report","title":"Before Submitting a Bug Report","text":"<p>A good bug report shouldn't leave others needing to chase you up for more information. Therefore, we ask you to investigate carefully, collect information and describe the issue in detail in your report. Please complete the following steps in advance to help us fix any potential bug as fast as possible.</p> <ul> <li>Make sure that you are using the latest version.</li> <li>Determine if your bug is really a bug and not an error on your side e.g. using incompatible   environment components/versions (Make sure that you have read the   documentation. If you are looking for   support, you might want to check this section).</li> <li>To see if other users have experienced (and potentially already solved) the same issue you   are having, check if there is not already a bug report existing for your bug or error in the   bug tracker.</li> <li>Also make sure to search the internet (including Stack Overflow) to see if users outside of   the GitHub community have discussed the issue.</li> <li>Collect information about the bug:</li> <li>Stack trace (Traceback)</li> <li>OS, Platform and Version (Windows, Linux, macOS, x86, ARM)</li> <li>Version of the interpreter, compiler, SDK, runtime environment, package manager, depending on   what seems relevant.</li> <li>Possibly your input and the output</li> <li>Can you reliably reproduce the issue? And can you also reproduce it with older versions?</li> </ul>"},{"location":"CONTRIBUTING/#how-do-i-submit-a-good-bug-report","title":"How Do I Submit a Good Bug Report?","text":"<p>You must never report security related issues, vulnerabilities or bugs to the issue tracker, or elsewhere in public. Instead sensitive bugs must be sent by discord to xnetcat#8144.</p> <p>We use GitHub issues to track bugs and errors. If you run into an issue with the project:</p> <ul> <li>Open an Issue. (Since we can't be   sure at this point whether it is a bug or not, we ask you not to talk about a bug yet and not   to label the issue.)</li> <li>Explain the behavior you would expect and the actual behavior.</li> <li>Please provide as much context as possible and describe the reproduction steps that someone   else can follow to recreate the issue on their own. This usually includes your code. For good   bug reports you should isolate the problem and create a reduced test case.</li> <li>Provide the information you collected in the previous section.</li> </ul> <p>Once it's filed:</p> <ul> <li>The project team will label the issue accordingly.</li> <li>A team member will try to reproduce the issue with your provided steps. If there are no   reproduction steps or no obvious way to reproduce the issue, the team will ask you for those   steps and mark the issue as <code>needs-repro</code>. Bugs with the <code>needs-repro</code> tag will not be   addressed until they are reproduced.</li> <li>If the team is able to reproduce the issue, it will be marked <code>needs-fix</code>, as well as   possibly other tags (such as <code>critical</code>), and the issue will be left to be   implemented by someone.</li> </ul>"},{"location":"CONTRIBUTING/#suggesting-enhancements","title":"Suggesting Enhancements","text":"<p>This section guides you through submitting an enhancement suggestion for spotdl, including completely new features and minor improvements to existing functionality. Following these guidelines will help maintainers and the community to understand your suggestion and find related suggestions.</p>"},{"location":"CONTRIBUTING/#before-submitting-an-enhancement","title":"Before Submitting an Enhancement","text":"<ul> <li>Make sure that you are using the latest version.</li> <li>Read the documentation carefully and find   out if the functionality is already covered, maybe by an individual configuration.</li> <li>Perform a search to see if the   enhancement has already been suggested. If it has, add a comment to the existing issue   instead of opening a new one.</li> <li>Find out whether your idea fits with the scope and aims of the project. It's up to you to   make a strong case to convince the project's developers of the merits of this feature. Keep   in mind that we want features that will be useful to the majority of our users and not just a   small subset. If you're just targeting a minority of users, consider writing an add-on/plugin   library.</li> </ul>"},{"location":"CONTRIBUTING/#how-do-i-submit-a-good-enhancement-suggestion","title":"How Do I Submit a Good Enhancement Suggestion?","text":"<p>Enhancement suggestions are tracked as GitHub issues.</p> <ul> <li>Use a clear and descriptive title for the issue to identify the suggestion.</li> <li>Provide a step-by-step description of the suggested enhancement in as many details as   possible.</li> <li>Describe the current behavior and explain which behavior you expected to see instead   and why. At this point you can also tell which alternatives do not work for you.</li> <li>You may want to include screenshots and animated GIFs which help you demonstrate the   steps or point out the part which the suggestion is related to. You can use   this tool to record GIFs on macOS and Windows, and   this tool or   this tool on Linux.       </li> <li>Explain why this enhancement would be useful to most spotdl users. You may also want to   point out the other projects that solved it better and which could serve as inspiration.</li> </ul>"},{"location":"CONTRIBUTING/#developing","title":"Developing","text":"<p>Fork the repository on Github and then clone it.</p> <pre><code>git clone [your username]/spotify-downloader\ncd spotify-downloader\n</code></pre> <p>Install poetry</p> <pre><code>pip install poetry\n</code></pre> <p>Then, to install spotDL in-place, run the following</p> <pre><code>poetry install\n</code></pre> <p>Then, to activate virtual environment run the following</p> <pre><code>poetry shell\n</code></pre> <p>All changes will now affect the poetry installation of the spotDL cli.</p>"},{"location":"CONTRIBUTING/#linting-formatting-and-type-checking","title":"Linting, Formatting and Type-checking","text":"<ul> <li>We use <code>pylint</code> for linting and expect a score above <code>9</code></li> </ul> <pre><code>pylint --limit-inference-results 0 --fail-under 9 ./spotdl\n</code></pre> <ul> <li>We use <code>black</code> for code formatting</li> </ul> <pre><code>black ./spotdl\n</code></pre> <ul> <li>We use <code>mypy</code> for type-checking and expect no errors at all</li> </ul> <p>To install type-stubs the first time around</p> <pre><code>mypy --ignore-missing-imports --follow-imports silent --install-types --non-interactive ./spotdl\n</code></pre> <pre><code>mypy ./spotdl\n</code></pre> <ul> <li>You can install these basic tools with</li> </ul> <pre><code>pip install --force-reinstall --upgrade mypy black pylint\n</code></pre>"},{"location":"CONTRIBUTING/#python-documentation","title":"Python Documentation","text":"<p>Any submitted code is expected to have accompanying documentation</p>"},{"location":"CONTRIBUTING/#mkdocs-generating-documentation","title":"mkdocs: generating documentation","text":"<ul> <li>We generate our documentation with <code>mkdocs</code></li> </ul> <pre><code>pip install mkdocs\n</code></pre> <p><code>mkdocs</code> requires that all development packages are installed</p> <pre><code>poetry install\n</code></pre> <p>generate docs with</p> <pre><code>mkdocs build --strict\n</code></pre> <p>view docs live-time while editing with</p> <pre><code>mkdocs serve\n</code></pre>"},{"location":"CONTRIBUTING/#docstring-formats","title":"DocString Formats","text":"<ul> <li>For functions</li> </ul> <pre><code>one-liner about functions purpose\n\n### Args (optional)\n- arg_name: description\n\n### Returns (optional)\n- return value description\n\n### Errors (only if there are known unhandled Errors/thrown Errors)\n- known errors\n\n### Notes (optional)\n- notes if any\n</code></pre> <ul> <li>For Classes</li> </ul> <pre><code>one-liner about class purpose\n\n### Attributes\n- attribute: description\n\n### Notes (optional)\n- notes if any\n</code></pre> <ul> <li>For modules/package <code>__init__</code></li> </ul> <pre><code>at max 3 lines about module/package purpose\n\noptional usage example for module/package preferably showcasing most commonly used functionality\n</code></pre>"},{"location":"CONTRIBUTING/#notes-about-docstrings","title":"Notes about docstrings","text":"<ul> <li>DocStrings are Inherited</li> </ul> <pre><code>class A:\n    def test(self):\n        \"\"\"Docstring for A.\"\"\"\n        pass\n\nclass B(A):\n    def test(self):\n        pass\n</code></pre>"},{"location":"CONTRIBUTING/#overview-of-the-project-structure","title":"Overview of the Project Structure","text":"sub-package purpose <code>utils</code> Contains commonly used functions <code>types</code> Custom data types used in the spotdl project <code>providers</code> Different Providers to obtain info (like song details) from <code>download</code> Download manager <code>console</code> Different user-facing operations like download, preload and web-ui <code>__init__</code> Contains spotdl class that simplifies the download process"},{"location":"CONTRIBUTING/#join-the-project-team","title":"Join The Project Team","text":""},{"location":"CONTRIBUTING/#attribution","title":"Attribution","text":"<p>This guide is based on the contributing-gen. Make your own!</p>"},{"location":"installation/","title":"spotDL Installation Guide","text":"<p>spotDL is a free and open source tool that downloads your Spotify playlists &amp; music</p> <p>The fastest, easiest, and most accurate command-line music downloader</p>"},{"location":"installation/#install-via-python","title":"Install via Python","text":"<p>This is our recommended installation method.</p> <p>If you are on Windows, Install Visual C++ Redistributable (link below) and then proceed to install Python &amp; FFmpeg</p>"},{"location":"installation/#prerequisites-to-spotdl","title":"Prerequisites to spotDL","text":"<ul> <li>Visual C++ 2019 redistributable   (on Windows)</li> <li>Python 3.7 or above (added to PATH)</li> <li>FFmpeg 4.2 or above (added to PATH)</li> </ul>"},{"location":"installation/#install-python-to-path","title":"Install Python to PATH","text":"<p>We recommend installing the latest version of Python</p> <p>When installing Python, ensure to select \"Add to PATH\".</p> <p></p>"},{"location":"installation/#installing-spotdl","title":"Installing spotDL","text":"<p>If you are not on Windows (e.g. OSX/UNIX), replace <code>pip</code> with <code>pip3</code> and <code>python</code> with <code>python3</code> in all commands.</p> <p>Firstly, open a terminal. On Windows: Command Prompt, OSX: \"Terminal\", *UNIX: Bash or Zsh.</p> <p>Verify you have installed Python correctly via <code>python -V</code>. Ensure you have v3.7 or greater.</p> <p>Next, install spotDL by typing the following</p> <pre><code>pip install spotdl\n</code></pre>"},{"location":"installation/#installing-ffmpeg","title":"Installing FFmpeg","text":"<p>If using FFmpeg only for spotDL, you can install FFmpeg to your local directory. <code>spotdl --download-ffmpeg</code> will download FFmpeg to your spotDL installation directory.</p> <p>We recommend the above option, but if you want to install FFmpeg system-wide,</p> <ul> <li>Windows Tutorial</li> <li>OSX - <code>brew install ffmpeg</code></li> <li>Linux - <code>sudo apt install ffmpeg</code> or use your distro's package manager</li> </ul> <p>If you require further help, ask in our Discord Server</p> <p></p>"},{"location":"installation/#using-prebuilt-executable","title":"Using Prebuilt Executable","text":""},{"location":"installation/#download-the-executable","title":"Download the executable","text":"<p>You can download the latest version from the Releases Tab</p>"},{"location":"installation/#running-web-ui","title":"Running Web UI","text":"<p>Web UI will start by default if no arguments are passed to the command line (after double-clicking for example)</p> <p></p>"},{"location":"installation/#running-the-cli","title":"Running the CLI","text":"<p>To use the command line interface just open your terminal and run <code>./spotdl-vX.X.X operation [urls]</code></p>"},{"location":"installation/#docker-setup","title":"Docker Setup","text":"<p>spotDL provides a Docker image.</p> <p>Install Docker: https://docs.docker.com/engine/installation/</p> <p>Install Docker Compose: https://docs.docker.com/compose/install/</p> <p>Docker documentation: https://docs.docker.com/</p>"},{"location":"installation/#built-in-docker-image","title":"Built-in Docker Image","text":"<ul> <li>Build docker image <code>docker build -t spotdl .</code></li> <li>List spotdl options: <code>docker run --rm spotdl --help</code></li> <li>Download a song:   <code>docker run --rm -v $(pwd):/music spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b</code></li> </ul>"},{"location":"installation/#docker-hub-image","title":"Docker Hub Image","text":"<ul> <li> <p>Pull docker image from Docker hub: <code>docker pull spotdl/spotify-downloader</code></p> </li> <li> <p>Download a song using Docker image:   <code>docker run --rm -v $(pwd):/music spotdl/spotify-downloader download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b</code></p> </li> <li> <p>Create a Docker container</p> </li> </ul> <pre><code>docker create \\\n  --name=spotdl \\\n  -v &lt;path to data&gt;:/music \\\n  spotdl/spotify-downloader\n</code></pre>"},{"location":"installation/#docker-compose","title":"Docker Compose","text":"<ul> <li>Create a container using Docker Compose: <code>docker-compose up --no-start</code></li> <li>Download a song using Docker compose:   <code>docker-compose run --rm spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b</code></li> </ul>"},{"location":"installation/#other-installation-methods","title":"Other Installation Methods","text":""},{"location":"installation/#termux","title":"Termux","text":"<p>We have a dedicated Termux installation script <code>curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh</code></p>"},{"location":"installation/#arch-user-repository-aur-package","title":"Arch User Repository (AUR) package","text":"<p>You can find the AUR Package here</p>"},{"location":"installation/#where-does-spotdl-download-songs","title":"Where does spotDL download songs?","text":"<p>spotDL downloads files to the folder where you ran spotDL from.</p> <p>Open pwsh/powershell/cmd/terminal/similar in the folder you want files to download to, or cd to desired folder.</p> <p>Windows Shortcut: Navigate to the folder you want the files to download to. <code>SHIFT + RIGHT CLICK</code>, then select \"Open PowerShell window here\"</p> <p></p>"},{"location":"installation/#we-have-a-public-discord-server-at-discordggxca23pwjwy","title":"We have a public Discord server at discord.gg/xCa23pwJWY!","text":""},{"location":"troubleshooting/","title":"Troubleshooting / FAQ Guide","text":"<p>As common issues or questions are encountered solutions will be added to this guide.</p> 'spotdl' is not recognized <p>Python/(site packages) is not added to PATH correctly. You need to install Python from https://www.python.org/downloads/</p> <p>Or you are using python from microsoft store. If so uninstall it and restart cmd. If this doesn't work reinstall python.</p> spotdl: command not found <p>If you see this error after installing spotdl, that means that the bin (Binaries) folder is not on <code>$PATH</code></p> pkg_resources.DistributionNotFound <p>Sometimes not all packages are installed but are required by yt-dlp for example: <code>brotli</code> or <code>websockets</code></p> HTTP Error 404 <p>/~https://github.com/plamere/spotipy/issues/795#issuecomment-1100321148</p> ssl.SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] <p>https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error</p> RecursionError <p>/~https://github.com/spotDL/spotify-downloader/issues/1493</p> RuntimeWarning <p>This happens when running spotdl using <code>python -m</code>.</p> Not found '_raw_ecb.so' <p>This error is specific for M1 Macs only.</p> <p>https://discord.com/channels/771628785447337985/871006150357823498 https://discord.com/channels/771628785447337985/939475659238043738</p>"},{"location":"troubleshooting/#error-message","title":"Error message","text":"<pre><code>'spotdl' is not recognized as an internal or external command,\noperable program or batch file.\n</code></pre>"},{"location":"troubleshooting/#solution","title":"Solution","text":"<p>Ensure to add to PATH when installing: </p>"},{"location":"troubleshooting/#solution_1","title":"Solution","text":""},{"location":"troubleshooting/#bashrc","title":"<code>.bashrc</code>","text":"<p>Add <code>export PATH=~/.local/bin:$PATH</code> at the bottom of <code>~/.bashrc</code></p> <p>Then run <code>source ~/.bashrc</code></p>"},{"location":"troubleshooting/#zshrc","title":"<code>.zshrc</code>","text":"<p>Add <code>export PATH=~/.local/bin:$PATH</code> at the bottom of <code>~/.zshrc</code> Then run <code>source ~/.zshrc</code></p>"},{"location":"troubleshooting/#error-message_1","title":"Error Message","text":"<p><code>pkg_resources.DistributionNotFound: The 'websockets' distribution was not found and is required by yt-dlp</code></p>"},{"location":"troubleshooting/#solution_2","title":"Solution","text":"<p><code>pip install brotli websockets yt-dlp -U</code></p>"},{"location":"troubleshooting/#error-message_2","title":"Error Message","text":"<p><code>HTTP Error for GET to URL with Params: {} returned 404 due to None</code></p>"},{"location":"troubleshooting/#solution_3","title":"Solution","text":"<p>Update spotdl to the latest version which contains workaround.</p> <p><code>pip install -U spotdl</code></p>"},{"location":"troubleshooting/#error-message_3","title":"Error Message","text":"<p><code>urllib.error.URLError: &lt;urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:847)&gt;</code></p>"},{"location":"troubleshooting/#solution_4","title":"Solution","text":"<p>https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error</p>"},{"location":"troubleshooting/#error-message_4","title":"Error Message","text":"<p><code>RecursionError: maximum recursion depth exceeded</code></p>"},{"location":"troubleshooting/#solution_5","title":"Solution","text":"<p>Update spotdl</p> <p><code>pip install spotdl -U</code></p>"},{"location":"troubleshooting/#error-message_5","title":"Error Message","text":"<pre><code>RuntimeWarning: 'spotdl.__main__' found in sys.modules after import of package 'spotdl',\nbut prior to execution of 'spotdl.__main__'; this may result in unpredictable behaviour\nwarn(RuntimeWarning(msg))\n</code></pre>"},{"location":"troubleshooting/#solution_6","title":"Solution","text":"<p>You can ignore this error or just run spotdl directly</p>"},{"location":"troubleshooting/#error-message_6","title":"Error Message","text":"<pre><code>aise OSError(\"Cannot load native module '%s': %s\" % (name, \", \".join(attempts)))\nOSError: Cannot load native module 'Cryptodome.Cipher._raw_ecb': Not found '_raw_ecb.cpython-39-darwin.so',\nCannot load '_raw_ecb.abi3.so': dlopen(/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Util/../Cipher/_raw_ecb.abi3.so, 6): no suitable image found.  Did find:\n/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Util/../Cipher/_raw_ecb.abi3.so: mach-o, but wrong architecture\n/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Cipher/_raw_ecb.abi3.so: mach-o, but wrong architecture, Not found '_raw_ecb.so'\n</code></pre>"},{"location":"troubleshooting/#solution_7","title":"Solution","text":"<p>Possible solutions:</p> <p>https://discord.com/channels/771628785447337985/871006150357823498 https://discord.com/channels/771628785447337985/939475659238043738</p>"},{"location":"usage/","title":"spotDL usage examples","text":""},{"location":"usage/#downloading","title":"Downloading","text":"Song <p>To download a song, run</p> <pre><code>spotdl download [trackUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b\n</code></pre> Album <p>To download an album, run</p> <pre><code>spotdl download [albumUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj\n</code></pre> Playlist <p>To download a playlist, run</p> <pre><code>spotdl download [playlistUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID\n</code></pre> Artist <p>To download all songs from an artist run</p> <pre><code>spotdl download [artistUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\n</code></pre> Search <p>To search for and download a song, run, with quotation marks</p> <pre><code>spotdl download '[songQuery]'\n</code></pre> <p>example:</p> <pre><code>spotdl download 'The Weeknd - Blinding Lights'\n</code></pre> YouTube link with Spotify metadata <p>To download YouTube video with metadata from Spotify, run</p> <p>Noting the quote <code>\"</code> are required</p> <pre><code>spotdl download \"YouTubeURL|SpotifyURL\"\n</code></pre> <p>example:</p> <pre><code>spotdl download \"https://www.youtube.com/watch?v=XXYlFuWEuKI|https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b?si=b5c0790edc8f4904\"\n</code></pre> Liked songs <p>To download liked Spotify songs run</p> <p><code>--user-auth</code> is required</p> <pre><code>spotdl download saved --user-auth\n</code></pre> All user playlists <p>To download all user playlists run</p> <p><code>--user-auth</code> is required</p> <pre><code>spotdl download all-user-playlists --user-auth\n</code></pre> All user saved albums <p>To download all user saved albums run</p> <p><code>--user-auth</code> is required</p> <pre><code>spotdl download all-user-saved-albums --user-auth\n</code></pre> <p>You can queue up multiple download tasks by separating the arguments with spaces</p> <pre><code>spotdl download [songQuery1] [albumUrl] [songQuery2] ... (order does not matter)\n</code></pre> <p>example:</p> <pre><code>spotdl download 'The Weeknd - Blinding Lights' https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID ...\n</code></pre>"},{"location":"usage/#audio-formats-and-quality","title":"Audio Formats and Quality","text":"<p>Files are downloaded in MP3 format for the best compatibility across different platforms/players, but spotDL also supports other output formats like M4A and OPUS.</p> <p>Note: spotDL never downloads songs in a bitrate higher than 128kbps, except for those with YTMusic Premium, where 256 kbps is available for M4A format.</p> <p>Note that using the <code>--bitrate</code> flag will convert the file to the specified bitrate, so it may result in larger file sizes with no significant change in quality. If you prefer smaller file sizes, consider using the default bitrate or a lower value.</p> <p>Converting files might not be ideal for some users who prefer the files in their original quality.</p> <p>Alternatively, you can use the <code>--bitrate disable</code> option to skip the conversion step for certain file formats such as M4A/OPUS.</p>"},{"location":"usage/#youtube-music-premium","title":"YouTube Music Premium","text":"<p>YouTube Music Premium users can use their account to download songs with a higher bitrate (256kbps).</p> <p>To download music in higher quality follow the steps below:</p> <ol> <li> <p>Change quality in YouTube Music settings to highest possible.</p> </li> <li> <p>Get cookies.txt for https://music.youtube.com.</p> <p>You can use Get cookies.txt extension or cookies.txt for this. More info here</p> </li> <li> <p>Add <code>--cookie-file cookies.txt</code> option to your spotDL command line options</p> <p>Replace cookies.txt with the actual name of your cookies file</p> </li> <li> <p>Change the audio format to either M4A or OPUS to get the raw HQ file</p> </li> </ol> <p>Note To get the best audio possible you should use M4A/OPUS audio format with <code>--bitrate disable</code></p>"},{"location":"usage/#syncing","title":"Syncing","text":"<p>Sync function for the console. Keep local files up to date with playlists/albums/etc. This will download new songs and remove the ones that are no longer present in the playlists/albums/etc</p> Initialize Synchronization <p>To create the sync file run</p> <pre><code>spotdl sync [query] --save-file [fileName]\n</code></pre> <p>example:</p> <pre><code>spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file \"the-weeknd.sync.spotdl\"\n</code></pre> <p>Note: The sync file has to end with .spotdl</p> Syncing <p>To sync the songs run</p> <pre><code>spotdl sync [fileName]\n</code></pre> <p>example:</p> <pre><code>spotdl sync \"the-weeknd.sync.spotdl\"\n</code></pre>"},{"location":"usage/#saving","title":"Saving","text":"<p>Saves the songs metadata to a file for further use.</p> <pre><code>spotdl save [query] --save-file [fileName]\n</code></pre> <p>example:</p> <pre><code>spotdl save 'The Weeknd - Blinding Lights' --save-file 'the-weeknd.spotdl'\n</code></pre> Preloading <p>Preload the download url to speed up the download process.</p> <pre><code>spotdl save [query] --save-file [fileName] --preload\n</code></pre> <p>example:</p> <pre><code>spotdl save 'The Weeknd - Blinding Lights' --save-file 'the-weeknd.spotdl' --preload\n</code></pre>"},{"location":"usage/#web-ui-user-interface","title":"Web UI (User Interface)","text":"<p>To start the web UI, run</p> <pre><code>spotdl web\n</code></pre>"},{"location":"usage/#download-location","title":"Download Location","text":"<p>By default, the web UI downloads files to a special directory, to overwrite this behavior add option <code>--web-use-output-dir</code>, which will make output directory follow <code>--output</code></p>"},{"location":"usage/#config-file","title":"Config file","text":""},{"location":"usage/#config-file-location","title":"Config file location","text":"<p>The config file is located at <code>C:\\Users\\user\\.spotdl\\config.json</code> or <code>~/.spotdl/config.json</code> under linux</p> <p>Note: If you want to use XDG_DATA_HOME directory, run <code>mkdir $XDG_DATA_HOME/spotdl</code>, next time you run spotdl it will be automatically used.</p>"},{"location":"usage/#generate-a-config-file","title":"Generate a config file","text":"<p>To generate a config file, run</p> <pre><code>spotdl --generate-config\n</code></pre> <p>Note: This will overwrite the existing config file.</p>"},{"location":"usage/#loading-config","title":"Loading config","text":"<p>Config file gets loaded automatically if it already exists, or if you've passed <code>--config</code> flag</p> <p>If you don't want config to load automatically change <code>load_config</code> option in config file to false</p> <pre><code>{\n    \"load_config\": false\n}\n</code></pre>"},{"location":"usage/#default-config","title":"Default config","text":"<pre><code>{\n    \"client_id\": \"f8a606e5583643beaa27ce62c48e3fc1\",\n    \"client_secret\": \"f6f4c8f73f0649939286cf417c811607\",\n    \"auth_token\": null,\n    \"user_auth\": false,\n    \"headless\": false,\n    \"cache_path\": \"/Users/username/.spotdl/.spotipy\",\n    \"no_cache\": false,\n    \"max_retries\": 3,\n    \"use_cache_file\": false,\n    \"audio_providers\": [\n        \"youtube-music\"\n    ],\n    \"lyrics_providers\": [\n        \"genius\",\n        \"azlyrics\",\n        \"musixmatch\"\n    ],\n    \"playlist_numbering\": false,\n    \"scan_for_songs\": false,\n    \"m3u\": null,\n    \"output\": \"{artists} - {title}.{output-ext}\",\n    \"m3u_output\": \"#EXTINF:{duration}, {artists} - {title}.{output-ext}\",\n    \"overwrite\": \"skip\",\n    \"search_query\": null,\n    \"ffmpeg\": \"ffmpeg\",\n    \"bitrate\": null,\n    \"ffmpeg_args\": null,\n    \"format\": \"mp3\",\n    \"save_file\": null,\n    \"filter_results\": true,\n    \"album_type\": null,\n    \"threads\": 4,\n    \"cookie_file\": null,\n    \"restrict\": null,\n    \"print_errors\": false,\n    \"sponsor_block\": false,\n    \"preload\": false,\n    \"archive\": null,\n    \"load_config\": true,\n    \"log_level\": \"INFO\",\n    \"simple_tui\": false,\n    \"fetch_albums\": false,\n    \"id3_separator\": \"/\",\n    \"ytm_data\": false,\n    \"add_unavailable\": false,\n    \"generate_lrc\": false,\n    \"force_update_metadata\": false,\n    \"only_verified_results\": false,\n    \"sync_without_deleting\": false,\n    \"max_filename_length\": null,\n    \"yt_dlp_args\": null,\n    \"detect_formats\": null,\n    \"save_errors\": null,\n    \"ignore_albums\": null,\n    \"proxy\": null,\n    \"skip_explicit\": false,\n    \"log_format\": null,\n    \"redownload\": false,\n    \"skip_album_art\": false,\n    \"create_skip_file\": false,\n    \"respect_skip_file\": false,\n    \"web_use_output_dir\": false,\n    \"port\": 8800,\n    \"host\": \"localhost\",\n    \"keep_alive\": false,\n    \"enable_tls\": false,\n    \"key_file\": null,\n    \"cert_file\": null,\n    \"ca_file\": null,\n    \"allowed_origins\": null,\n    \"keep_sessions\": false,\n    \"force_update_gui\": false,\n    \"web_gui_repo\": null,\n    \"web_gui_location\": null\n}\n</code></pre>"},{"location":"usage/#output-variables","title":"<code>output</code> variables","text":"<p>The <code>output</code> key supports several variables:</p> Variable Explanation Example <code>{title}</code> Song title Dark Horse <code>{artists}</code> Song artists Katy Perry, Juicy J <code>{artist}</code> Primary artist Katy Perry <code>{album}</code> Album name PRISM <code>{album-artist}</code> Primary artist of the album Katy Perry <code>{genre}</code> Genre dance pop <code>{disc-number}</code> Useful for multi-disc releases 1 <code>{disc-count}</code> Total number of discs in the album 1 <code>{duration}</code> Duration of the song in seconds 215.672 <code>{year}</code> Year of release 2013 <code>{original-date}</code> Date of original release 2013-01-01 <code>{track-number}</code> Track number in the album 06 <code>{tracks-count}</code> Total number of tracks in the album 13 <code>{isrc}</code> International Standard Recording Code USUM71311296 <code>{track-id}</code> Spotify song ID 4jbmgIyjGoXjY01XxatOx6 <code>{publisher}</code> Record label Capitol Records (CAP) <code>{list-length}</code> Number of items in a playlist 10 <code>{list-position}</code> Position of the song in a playlist 1 <code>{list-name}</code> Name of the playlist Saved <code>{output-ext}</code> File extension mp3"},{"location":"usage/#cli-command-line-interface","title":"CLI (Command Line Interface)","text":""},{"location":"usage/#command-line-options","title":"Command line options","text":"<pre><code>options:\n  -h, --help            show this help message and exit\n\nMain options:\n  {download,save,web,sync,meta,url}\n                        The operation to perform.\n                        download: Download the songs to the disk and embed metadata.\n                        save: Saves the songs metadata to a file for further use.\n                        web: Starts a web interface to simplify the download process.\n                        sync: Removes songs that are no longer present, downloads new ones\n                        meta: Update your audio files with metadata\n                        url: Get the download URL for songs\n\n  query                 Spotify/YouTube URL for a song/playlist/album/artist/etc. to download.\n\n                        For album/playlist/artist searching, include 'album:', 'playlist:', 'artist:'\n                        (ie. 'album:the album name' you can mix these options to get more accurate results).\n\n                        To download liked songs use 'saved' as the query, to download all user playlists\n                        use 'all-user-playlists, to download playlists that the user has created\n                        use 'all-saved-playlists', to download all user liked playlists\n                        use 'all-user-followed-artists', to download all user saved albums use 'all-user-saved-albums'\n\n                        For manual audio matching, you can use the format 'YouTubeURL|SpotifyURL'\n                        You can only use album/playlist/tracks urls when downloading/matching youtube urls.\n                        When using youtube url without spotify url, you won't be able to use `--fetch-albums` option.\n\n  --audio [{youtube,youtube-music,slider-kz,soundcloud,bandcamp,piped} ...]\n                        The audio provider to use. You can provide more than one for fallback.\n  --lyrics [{genius,musixmatch,azlyrics,synced} ...]\n                        The lyrics provider to use. You can provide more than one for fallback. Synced lyrics might not work correctly with some music players. For such cases it's better\n                        to use `--generate-lrc` option.\n  --genius-access-token GENIUS_TOKEN\n                        Lets you choose your own Genius access token.\n  --config              Use the config file to download songs. It's located under C:\\Users\\user\\.spotdl\\config.json or ~/.spotdl/config.json under linux\n  --search-query SEARCH_QUERY\n                        The search query to use, available variables: {title}, {artists}, {artist}, {album}, {album-artist}, {genre}, {disc-number}, {disc-count}, {duration}, {year},\n                        {original-date}, {track-number}, {tracks-count}, {isrc}, {track-id}, {publisher}, {list-length}, {list-position}, {list-name}, {output-ext}\n  --dont-filter-results\n                        Disable filtering results.\n  --album-type {single,album}\n                        Type of the album to search for. (album, single)\n  --only-verified-results\n                        Use only verified results. (Not all providers support this)\n\nSpotify options:\n  --user-auth           Login to Spotify using OAuth.\n  --client-id CLIENT_ID\n                        The client id to use when logging in to Spotify.\n  --client-secret CLIENT_SECRET\n                        The client secret to use when logging in to Spotify.\n  --auth-token AUTH_TOKEN\n                        The authorization token to use directly to log in to Spotify.\n  --cache-path CACHE_PATH\n                        The path where spotipy cache file will be stored.\n  --no-cache            Disable caching (both requests and token).\n  --max-retries MAX_RETRIES\n                        The maximum number of retries to perform when getting metadata.\n  --headless            Run in headless mode.\n  --use-cache-file      Use the cache file to get metadata. It's located under C:\\Users\\user\\.spotdl\\.spotify_cache or ~/.spotdl/.spotify_cache under linux. It only caches tracks and\n                        gets updated whenever spotDL gets metadata from Spotify. (It may provide outdated metadata use with caution)\n\nFFmpeg options:\n  --ffmpeg FFMPEG       The ffmpeg executable to use.\n  --threads THREADS     The number of threads to use when downloading songs.\n  --bitrate {auto,disable,8k,16k,24k,32k,40k,48k,64k,80k,96k,112k,128k,160k,192k,224k,256k,320k,0,1,2,3,4,5,6,7,8,9}\n                        The constant/variable bitrate to use for the output file. Values from 0 to 9 are variable bitrates. Auto will use the bitrate of the original file. Disable will\n                        disable the bitrate option. (In case of m4a and opus files, auto and disable will skip the conversion)\n  --ffmpeg-args FFMPEG_ARGS\n                        Additional ffmpeg arguments passed as a string.\n\nOutput options:\n  --format {mp3,flac,ogg,opus,m4a,wav}\n                        The format to download the song in.\n  --save-file SAVE_FILE\n                        The file to save/load the songs data from/to. It has to end with .spotdl. If combined with the download operation, it will save the songs data to the file.\n                        Required for save/sync (use - to print to stdout when using save).\n  --preload             Preload the download url to speed up the download process.\n  --output OUTPUT       Specify the downloaded file name format, available variables: {title}, {artists}, {artist}, {album}, {album-artist}, {genre}, {disc-number}, {disc-count},\n                        {duration}, {year}, {original-date}, {track-number}, {tracks-count}, {isrc}, {track-id}, {publisher}, {list-length}, {list-position}, {list-name}, {output-ext}\n  --m3u [M3U]           Name of the m3u file to save the songs to. Defaults to {list[0]}.m3u8 If you want to generate a m3u for each list in the query use {list}, If you want to generate\n                        a m3u file based on the first list in the query use {list[0]}, (0 is the first list in the query, 1 is the second, etc. songs don't count towards the list number)\n  --cookie-file COOKIE_FILE\n                        Path to cookies file.\n  --overwrite {skip,metadata,force}\n                        How to handle existing/duplicate files. (When combined with --scan-for-songs force will remove all duplicates, and metadata will only apply metadata to the latest\n                        song and will remove the rest. )\n  --restrict [{strict,ascii,none}]\n                        Restrict filenames to a sanitized set of characters for better compatibility\n  --print-errors        Print errors (wrong songs, failed downloads etc) on exit, useful for long playlist\n  --save-errors SAVE_ERRORS\n                        Save errors (wrong songs, failed downloads etc) to a file\n  --sponsor-block       Use the sponsor block to download songs from yt/ytm.\n  --archive ARCHIVE     Specify the file name for an archive of already downloaded songs\n  --playlist-numbering  Sets each track in a playlist to have the playlist's name as its album, and album art as the playlist's icon\n  --playlist-retain-track-cover\n                        Sets each track in a playlist to have the playlist's name as its album, while retaining album art of each track\n  --scan-for-songs      Scan the output directory for existing files. This option should be combined with the --overwrite option to control how existing files are handled. (Output\n                        directory is the last directory that is not a template variable in the output template)\n  --fetch-albums        Fetch all albums from songs in query\n  --id3-separator ID3_SEPARATOR\n                        Change the separator used in the id3 tags. Only supported for mp3 files.\n  --ytm-data            Use ytm data instead of spotify data when downloading using ytm link.\n  --add-unavailable     Add unavailable songs to the m3u/archive files when downloading\n  --generate-lrc        Generate lrc files for downloaded songs. Requires `synced` provider to be present in the lyrics providers list.\n  --force-update-metadata\n                        Force update metadata for songs that already have metadata.\n  --sync-without-deleting\n                        Sync without deleting songs that are not in the query.\n  --max-filename-length MAX_FILENAME_LENGTH\n                        Max file name length. (This won't override the max file name length enforced by the OS)\n  --yt-dlp-args YT_DLP_ARGS\n                        Arguments to pass to yt-dlp\n  --detect-formats [{mp3,flac,ogg,opus,m4a,wav} ...]\n                        Detect already downloaded songs with file format different from the --format option (When combined with --m3u option, only first detected format will be added to\n                        m3u file)\n  --redownload          to redownload the local song in diffrent format using --format for meta operation\n  --skip-album-art      skip downloading album art for meta operation\n  --ignore-albums [IGNORE_ALBUMS ...]\n                        ignores the song of the given albums\n  --skip-explicit       Skip explicit songs\n  --proxy PROXY         Http(s) proxy server for download song. Example: http://host:port\n  --create-skip-file    Create skip file for successfully downloaded file\n  --respect-skip-file   If a file with the extension .skip exists, skip download\n  --sync-remove-lrc     Remove lrc files when using sync operation when downloading songs\n\nWeb options:\n  --host HOST           The host to use for the web server.\n  --port PORT           The port to run the web server on.\n  --keep-alive          Keep the web server alive even when no clients are connected.\n  --allowed-origins [ALLOWED_ORIGINS ...]\n                        The allowed origins for the web server.\n  --web-use-output-dir  Use the output directory instead of the session directory for downloads. (This might cause issues if you have multiple users using the web-ui at the same time)\n  --keep-sessions       Keep the session directory after the web server is closed.\n  --force-update-gui    Refresh the web server directory with a fresh git checkout\n  --web-gui-repo WEB_GUI_REPO\n                        Custom web gui repo to use for the web server. Example: /~https://github.com/spotdl/web-ui/tree/master/dist\n  --web-gui-location WEB_GUI_LOCATION\n                        Path to the web gui directory to use for the web server.\n  --enable-tls          Enable TLS on the web server.\n  --cert-file CERT_FILE\n                        File Path to the TLS Certificate (PEM format).\n  --key-file KEY_FILE   File Path to the TLS Private Key (PEM format).\n  --ca-file CA_FILE     File Path to the TLS Certificate Authority File (PEM format).\n\nMisc options:\n  --log-level {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,MATCH,DEBUG,NOTSET}\n                        Select log level.\n  --simple-tui          Use a simple tui.\n  --log-format LOG_FORMAT\n                        Custom logging format to use. More info: https://docs.python.org/3/library/logging.html#logrecord-attributes\n\nOther options:\n  --download-ffmpeg     Download ffmpeg to spotdl directory.\n  --generate-config     Generate a config file. This will overwrite current config if present.\n  --check-for-updates   Check for new version.\n  --profile             Run in profile mode. Useful for debugging.\n  --version, -v         Show the version number and exit.\n</code></pre>"},{"location":"reference/","title":"__init__","text":"<p>Init module for spotdl. This module contains the main entry point for spotdl. And Spotdl class</p>"},{"location":"reference/#spotdl.Spotdl","title":"<code>Spotdl(client_id, client_secret, user_auth=False, cache_path=None, no_cache=False, headless=False, downloader_settings=None, loop=None)</code>","text":"<p>Spotdl class, which simplifies the process of downloading songs from Spotify.</p> <pre><code>from spotdl import Spotdl\n\nspotdl = Spotdl(client_id='your-client-id', client_secret='your-client-secret')\n\nsongs = spotdl.search(['joji - test drive',\n    'https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT'])\n\nresults = spotdl.download_songs(songs)\nsong, path = spotdl.download(songs[0])\n</code></pre>"},{"location":"reference/#spotdl.Spotdl--arguments","title":"Arguments","text":"<ul> <li>client_id: Spotify client id</li> <li>client_secret: Spotify client secret</li> <li>user_auth: If true, user will be prompted to authenticate</li> <li>cache_path: Path to cache directory</li> <li>no_cache: If true, no cache will be used</li> <li>headless: If true, no browser will be opened</li> <li>downloader_settings: Settings for the downloader</li> <li>loop: Event loop to use</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def __init__(\n    self,\n    client_id: str,\n    client_secret: str,\n    user_auth: bool = False,\n    cache_path: Optional[str] = None,\n    no_cache: bool = False,\n    headless: bool = False,\n    downloader_settings: Optional[\n        Union[DownloaderOptionalOptions, DownloaderOptions]\n    ] = None,\n    loop: Optional[asyncio.AbstractEventLoop] = None,\n):\n    \"\"\"\n    Initialize the Spotdl class\n\n    ### Arguments\n    - client_id: Spotify client id\n    - client_secret: Spotify client secret\n    - user_auth: If true, user will be prompted to authenticate\n    - cache_path: Path to cache directory\n    - no_cache: If true, no cache will be used\n    - headless: If true, no browser will be opened\n    - downloader_settings: Settings for the downloader\n    - loop: Event loop to use\n    \"\"\"\n\n    if downloader_settings is None:\n        downloader_settings = {}\n\n    # Initialize spotify client\n    SpotifyClient.init(\n        client_id=client_id,\n        client_secret=client_secret,\n        user_auth=user_auth,\n        cache_path=cache_path,\n        no_cache=no_cache,\n        headless=headless,\n    )\n\n    # Initialize downloader\n    self.downloader = Downloader(\n        settings=downloader_settings,\n        loop=loop,\n    )\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.download","title":"<code>download(song)</code>","text":"<p>Download and convert song to the output format.</p>"},{"location":"reference/#spotdl.Spotdl.download--arguments","title":"Arguments","text":"<ul> <li>song: Song object</li> </ul>"},{"location":"reference/#spotdl.Spotdl.download--returns","title":"Returns","text":"<ul> <li>A tuple containing the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def download(self, song: Song) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Download and convert song to the output format.\n\n    ### Arguments\n    - song: Song object\n\n    ### Returns\n    - A tuple containing the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    return self.downloader.download_song(song)\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.download_songs","title":"<code>download_songs(songs)</code>","text":"<p>Download and convert songs to the output format.</p>"},{"location":"reference/#spotdl.Spotdl.download_songs--arguments","title":"Arguments","text":"<ul> <li>songs: List of Song objects</li> </ul>"},{"location":"reference/#spotdl.Spotdl.download_songs--returns","title":"Returns","text":"<ul> <li>A list of tuples containing the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def download_songs(self, songs: List[Song]) -&gt; List[Tuple[Song, Optional[Path]]]:\n    \"\"\"\n    Download and convert songs to the output format.\n\n    ### Arguments\n    - songs: List of Song objects\n\n    ### Returns\n    - A list of tuples containing the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    return self.downloader.download_multiple_songs(songs)\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.get_download_urls","title":"<code>get_download_urls(songs)</code>","text":"<p>Get the download urls for a list of songs.</p>"},{"location":"reference/#spotdl.Spotdl.get_download_urls--arguments","title":"Arguments","text":"<ul> <li>songs: List of Song objects</li> </ul>"},{"location":"reference/#spotdl.Spotdl.get_download_urls--returns","title":"Returns","text":"<ul> <li>A list of urls if successful.</li> </ul>"},{"location":"reference/#spotdl.Spotdl.get_download_urls--notes","title":"Notes","text":"<ul> <li>This function is multi-threaded.</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def get_download_urls(self, songs: List[Song]) -&gt; List[Optional[str]]:\n    \"\"\"\n    Get the download urls for a list of songs.\n\n    ### Arguments\n    - songs: List of Song objects\n\n    ### Returns\n    - A list of urls if successful.\n\n    ### Notes\n    - This function is multi-threaded.\n    \"\"\"\n\n    urls: List[Optional[str]] = []\n    with concurrent.futures.ThreadPoolExecutor(\n        max_workers=self.downloader.settings[\"threads\"]\n    ) as executor:\n        future_to_song = {\n            executor.submit(self.downloader.search, song): song for song in songs\n        }\n        for future in concurrent.futures.as_completed(future_to_song):\n            song = future_to_song[future]\n            try:\n                data = future.result()\n                urls.append(data)\n            except Exception as exc:\n                logger.error(\"%s generated an exception: %s\", song, exc)\n\n    return urls\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.search","title":"<code>search(query)</code>","text":"<p>Search for songs.</p>"},{"location":"reference/#spotdl.Spotdl.search--arguments","title":"Arguments","text":"<ul> <li>query: List of search queries</li> </ul>"},{"location":"reference/#spotdl.Spotdl.search--returns","title":"Returns","text":"<ul> <li>A list of Song objects</li> </ul>"},{"location":"reference/#spotdl.Spotdl.search--notes","title":"Notes","text":"<ul> <li>query can be a list of song titles, urls, uris</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def search(self, query: List[str]) -&gt; List[Song]:\n    \"\"\"\n    Search for songs.\n\n    ### Arguments\n    - query: List of search queries\n\n    ### Returns\n    - A list of Song objects\n\n    ### Notes\n    - query can be a list of song titles, urls, uris\n    \"\"\"\n\n    return parse_query(\n        query=query,\n        threads=self.downloader.settings[\"threads\"],\n        use_ytm_data=self.downloader.settings[\"ytm_data\"],\n        playlist_numbering=self.downloader.settings[\"playlist_numbering\"],\n        album_type=self.downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=self.downloader.settings[\n            \"playlist_retain_track_cover\"\n        ],\n    )\n</code></pre>"},{"location":"reference/#spotdl.console_entry_point","title":"<code>console_entry_point()</code>","text":"<p>Entry point for the console. With profile flag, it runs the code with cProfile.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def console_entry_point():\n    \"\"\"\n    Entry point for the console. With profile flag, it runs the code with cProfile.\n    \"\"\"\n\n    if \"--profile\" in sys.argv:\n        with cProfile.Profile() as profile:\n            entry_point()\n\n        stats = pstats.Stats(profile)\n        stats.sort_stats(pstats.SortKey.TIME)\n        stats.dump_stats(\"spotdl.profile\")\n    else:\n        entry_point()\n</code></pre>"},{"location":"reference/SUMMARY/","title":"SUMMARY","text":"<ul> <li>__init__</li> <li>download<ul> <li>downloader</li> <li>progress_handler</li> </ul> </li> <li>types<ul> <li>artist</li> <li>playlist</li> <li>album</li> <li>saved</li> <li>result</li> <li>song</li> <li>options</li> </ul> </li> <li>console<ul> <li>save</li> <li>url</li> <li>meta</li> <li>web</li> <li>sync</li> <li>download</li> <li>entry_point</li> </ul> </li> <li>utils<ul> <li>console</li> <li>formatter</li> <li>arguments</li> <li>metadata</li> <li>downloader</li> <li>github</li> <li>static</li> <li>search</li> <li>web</li> <li>logging</li> <li>spotify</li> <li>matching</li> <li>ffmpeg</li> <li>m3u</li> <li>config</li> <li>lrc</li> <li>archive</li> </ul> </li> <li>providers<ul> <li>lyrics<ul> <li>synced</li> <li>musixmatch</li> <li>azlyrics</li> <li>genius</li> <li>base</li> </ul> </li> <li>audio<ul> <li>bandcamp</li> <li>sliderkz</li> <li>piped</li> <li>youtube</li> <li>soundcloud</li> <li>base</li> <li>ytmusic</li> </ul> </li> </ul> </li> </ul>"},{"location":"reference/console/","title":"console","text":"<p>Console module, contains the console entry point and different subcommands.</p>"},{"location":"reference/console/#spotdl.console.console_entry_point","title":"<code>console_entry_point()</code>","text":"<p>Entry point for the console. With profile flag, it runs the code with cProfile.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def console_entry_point():\n    \"\"\"\n    Entry point for the console. With profile flag, it runs the code with cProfile.\n    \"\"\"\n\n    if \"--profile\" in sys.argv:\n        with cProfile.Profile() as profile:\n            entry_point()\n\n        stats = pstats.Stats(profile)\n        stats.sort_stats(pstats.SortKey.TIME)\n        stats.dump_stats(\"spotdl.profile\")\n    else:\n        entry_point()\n</code></pre>"},{"location":"reference/console/download/","title":"download","text":"<p>Download module for the console.</p>"},{"location":"reference/console/download/#spotdl.console.download.download","title":"<code>download(query, downloader)</code>","text":"<p>Find songs with the provided audio provider and save them to the disk.</p>"},{"location":"reference/console/download/#spotdl.console.download.download--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> </ul> Source code in <code>spotdl/console/download.py</code> <pre><code>def download(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Find songs with the provided audio provider and save them to the disk.\n\n    ### Arguments\n    - query: list of strings to search for.\n    \"\"\"\n\n    # Parse the query\n    songs = get_simple_songs(\n        query,\n        use_ytm_data=downloader.settings[\"ytm_data\"],\n        playlist_numbering=downloader.settings[\"playlist_numbering\"],\n        albums_to_ignore=downloader.settings[\"ignore_albums\"],\n        album_type=downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=downloader.settings[\"playlist_retain_track_cover\"],\n    )\n\n    # Download the songs\n    downloader.download_multiple_songs(songs)\n</code></pre>"},{"location":"reference/console/entry_point/","title":"entry_point","text":"<p>Module that holds the entry point for the console.</p>"},{"location":"reference/console/entry_point/#spotdl.console.entry_point.console_entry_point","title":"<code>console_entry_point()</code>","text":"<p>Entry point for the console. With profile flag, it runs the code with cProfile.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def console_entry_point():\n    \"\"\"\n    Entry point for the console. With profile flag, it runs the code with cProfile.\n    \"\"\"\n\n    if \"--profile\" in sys.argv:\n        with cProfile.Profile() as profile:\n            entry_point()\n\n        stats = pstats.Stats(profile)\n        stats.sort_stats(pstats.SortKey.TIME)\n        stats.dump_stats(\"spotdl.profile\")\n    else:\n        entry_point()\n</code></pre>"},{"location":"reference/console/entry_point/#spotdl.console.entry_point.entry_point","title":"<code>entry_point()</code>","text":"<p>Console entry point for spotdl. This is where the magic happens.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def entry_point():\n    \"\"\"\n    Console entry point for spotdl. This is where the magic happens.\n    \"\"\"\n\n    # Create config file if it doesn't exist\n    generate_initial_config()\n\n    # Check if sys.argv contains an action\n    # If it does, we run the action and exit\n    try:\n        action_to_run = next(\n            action for action_name, action in ACTIONS.items() if action_name in sys.argv\n        )\n    except StopIteration:\n        action_to_run = None\n\n    if action_to_run:\n        action_to_run()\n        return None\n\n    # Parse the arguments\n    arguments = parse_arguments()\n\n    # Create settings dicts\n    spotify_settings, downloader_settings, web_settings = create_settings(arguments)\n\n    init_logging(downloader_settings[\"log_level\"], downloader_settings[\"log_format\"])\n\n    # If the application is frozen, we check for ffmpeg\n    # if it's not present download it create config file\n    if is_executable():\n        if is_ffmpeg_installed() is False:\n            download_ffmpeg()\n\n    # Check if ffmpeg is installed\n    if is_ffmpeg_installed(downloader_settings[\"ffmpeg\"]) is False:\n        raise FFmpegError(\n            \"FFmpeg is not installed. Please run `spotdl --download-ffmpeg` to install it, \"\n            \"or `spotdl --ffmpeg /path/to/ffmpeg` to specify the path to ffmpeg.\"\n        )\n\n    # Check if we are not blocked by ytm\n    if \"youtube-music\" in downloader_settings[\"audio_providers\"]:\n        if not check_ytmusic_connection():\n            raise DownloaderError(\n                \"You are blocked by YouTube Music. \"\n                \"Please use a VPN, change youtube-music to piped, or use other audio providers\"\n            )\n\n    # Initialize spotify client\n    SpotifyClient.init(**spotify_settings)\n    spotify_client = SpotifyClient()\n\n    # If the application is frozen start web ui\n    # or if the operation is `web`\n    if is_executable() or arguments.operation == \"web\":\n\n        # Default to the current directory when running a frozen application\n        if is_executable():\n            web_settings[\"web_use_output_dir\"] = True\n\n        # Start web ui\n        web(web_settings, downloader_settings)\n\n        return None\n\n    # Check if save file is present and if it's valid\n    if isinstance(downloader_settings[\"save_file\"], str) and (\n        not downloader_settings[\"save_file\"].endswith(\".spotdl\")\n        and not downloader_settings[\"save_file\"] == \"-\"\n    ):\n        raise DownloaderError(\"Save file has to end with .spotdl\")\n\n    # Check if the user is logged in\n    if (\n        arguments.query\n        and \"saved\" in arguments.query\n        and not spotify_settings[\"user_auth\"]\n    ):\n        raise SpotifyError(\n            \"You must be logged in to use the saved query. \"\n            \"Log in by adding the --user-auth flag\"\n        )\n\n    # Initialize the downloader\n    # for download, load and preload operations\n    downloader = Downloader(downloader_settings)\n\n    def graceful_exit(_signal, _frame):\n        if spotify_settings[\"use_cache_file\"]:\n            save_spotify_cache(spotify_client.cache)\n\n        downloader.progress_handler.close()\n        sys.exit(0)\n\n    signal.signal(signal.SIGINT, graceful_exit)\n    signal.signal(signal.SIGTERM, graceful_exit)\n\n    start_time = time.perf_counter()\n\n    try:\n        # Pick the operation to perform\n        # based on the name and run it!\n        OPERATIONS[arguments.operation](\n            query=arguments.query,\n            downloader=downloader,\n        )\n    except Exception as exc:\n        if downloader_settings[\"save_errors\"]:\n            with open(\n                downloader_settings[\"save_errors\"], \"a\", encoding=\"utf-8\"\n            ) as error_file:\n                error_file.write(\"\\n\".join([exc + \"\\n\" for exc in exc.args]))\n\n            logger.debug(\"Saved errors to %s\", downloader_settings[\"save_errors\"])\n\n        end_time = time.perf_counter()\n        logger.debug(\"Took %d seconds\", end_time - start_time)\n\n        downloader.progress_handler.close()\n        logger.exception(\"An error occurred\")\n\n        sys.exit(1)\n\n    end_time = time.perf_counter()\n    logger.debug(\"Took %d seconds\", end_time - start_time)\n\n    if spotify_settings[\"use_cache_file\"]:\n        save_spotify_cache(spotify_client.cache)\n\n    downloader.progress_handler.close()\n\n    return None\n</code></pre>"},{"location":"reference/console/meta/","title":"meta","text":"<p>Sync Lyrics module for the console</p>"},{"location":"reference/console/meta/#spotdl.console.meta.meta","title":"<code>meta(query, downloader)</code>","text":"<p>This function applies metadata to the selected songs based on the file name. If song already has metadata, missing metadata is added</p>"},{"location":"reference/console/meta/#spotdl.console.meta.meta--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> <li>downloader: Already initialized downloader instance.</li> </ul>"},{"location":"reference/console/meta/#spotdl.console.meta.meta--notes","title":"Notes","text":"<ul> <li>This function is multi-threaded.</li> </ul> Source code in <code>spotdl/console/meta.py</code> <pre><code>def meta(query: List[str], downloader: Downloader) -&gt; None:\n    \"\"\"\n    This function applies metadata to the selected songs\n    based on the file name.\n    If song already has metadata, missing metadata is added\n\n    ### Arguments\n    - query: list of strings to search for.\n    - downloader: Already initialized downloader instance.\n\n    ### Notes\n    - This function is multi-threaded.\n    \"\"\"\n\n    # Create a list of all songs from all paths in query\n    paths: List[Path] = []\n    for path in query:\n        test_path = Path(path)\n        if not test_path.exists():\n            logger.error(\"Path does not exist: %s\", path)\n            continue\n\n        if test_path.is_dir():\n            for out_format in FFMPEG_FORMATS:\n                paths.extend(test_path.glob(f\"*.{out_format}\"))\n        elif test_path.is_file():\n            if test_path.suffix.split(\".\")[-1] not in FFMPEG_FORMATS:\n                logger.error(\"File is not a supported audio format: %s\", path)\n                continue\n\n            paths.append(test_path)\n\n    def process_file(file: Path):\n        # metadata of the file, url is present in the file.\n        song_meta = get_file_metadata(file, downloader.settings[\"id3_separator\"])\n\n        # Check if song has metadata\n        # and if it has all the required fields\n        # if it has all of these fields, we can assume that the metadata is correct\n        if song_meta and not downloader.settings[\"force_update_metadata\"]:\n            if (\n                song_meta.get(\"artist\")\n                and song_meta.get(\"artists\")\n                and song_meta.get(\"name\")\n                and song_meta.get(\"lyrics\")\n                and song_meta.get(\"album_art\")\n            ):\n                logger.info(\"Song already has metadata: %s\", file.name)\n                if downloader.settings[\"generate_lrc\"]:\n                    lrc_file = file.with_suffix(\".lrc\")\n                    if lrc_file.exists():\n                        logger.info(\"Lrc file already exists for %s\", file.name)\n                        return None\n\n                    song = Song.from_missing_data(\n                        name=song_meta[\"name\"],\n                        artists=song_meta[\"artists\"],\n                        artist=song_meta[\"artist\"],\n                    )\n\n                    generate_lrc(song, file)\n                    if lrc_file.exists():\n                        logger.info(\"Saved lrc file for %s\", song.display_name)\n                    else:\n                        logger.info(\"Could not find lrc file for %s\", song.display_name)\n\n                return None\n\n        # Same as above\n        if (\n            not song_meta\n            or None\n            in [\n                song_meta.get(\"name\"),\n                song_meta.get(\"album_art\"),\n                song_meta.get(\"artist\"),\n                song_meta.get(\"artists\"),\n                song_meta.get(\"track_number\"),\n            ]\n            or downloader.settings[\"force_update_metadata\"]\n        ):\n            # Song does not have metadata, or it is missing some fields\n            # or we are forcing update of metadata\n            # so we search for it\n            logger.debug(\"Searching metadata for %s\", file.name)\n            search_results = get_search_results(file.stem)\n            if not search_results:\n                logger.error(\"Could not find metadata for %s\", file.name)\n                return None\n\n            song = search_results[0]\n        else:\n            # Song has metadata, so we use it to reinitialize the song object\n            # and fill in the missing metadata\n            try:\n                song = reinit_song(Song.from_missing_data(**song_meta))\n            except QueryError:\n                logger.error(\"Could not find metadata for %s\", file.name)\n                return None\n\n        # Check if the song has lyric\n        # if not use downloader to find lyrics\n        if song_meta is None or song_meta.get(\"lyrics\") is None:\n            logger.debug(\"Fetching lyrics for %s\", song.display_name)\n            song.lyrics = downloader.search_lyrics(song)\n            if song.lyrics:\n                logger.info(\"Found lyrics for song: %s\", song.display_name)\n        else:\n            song.lyrics = song_meta.get(\"lyrics\")\n\n        # Apply metadata to the song\n        embed_metadata(file, song, skip_album_art=downloader.settings[\"skip_album_art\"])\n\n        logger.info(\"Applied metadata to %s\", file.name)\n\n        if downloader.settings[\"generate_lrc\"]:\n            lrc_file = file.with_suffix(\".lrc\")\n            if lrc_file.exists():\n                logger.info(\"Lrc file already exists for %s\", file.name)\n                return None\n\n            generate_lrc(song, file)\n            if lrc_file.exists():\n                logger.info(\"Saved lrc file for %s\", song.display_name)\n            else:\n                logger.info(\"Could not find lrc file for %s\", song.display_name)\n        return None\n\n    async def pool_worker(file_path: Path) -&gt; None:\n        async with downloader.semaphore:\n            # The following function calls blocking code, which would block whole event loop.\n            # Therefore it has to be called in a separate thread via ThreadPoolExecutor. This\n            # is not a problem, since GIL is released for the I/O operations, so it shouldn't\n            # hurt performance.\n            await downloader.loop.run_in_executor(None, process_file, file_path)\n\n    tasks = [pool_worker(path) for path in paths]\n\n    # call all task asynchronously, and wait until all are finished\n    downloader.loop.run_until_complete(asyncio.gather(*tasks))\n\n    # to re-download the local songs\n    if downloader.settings[\"redownload\"]:\n        songs_url: List[str] = []\n        for file in paths:\n            meta_data = get_file_metadata(\n                Path(file), downloader.settings[\"id3_separator\"]\n            )\n            if meta_data and meta_data[\"url\"]:\n                songs_url.append(meta_data[\"url\"])\n\n        songs_list = parse_query(\n            query=songs_url,\n            threads=downloader.settings[\"threads\"],\n            use_ytm_data=downloader.settings[\"ytm_data\"],\n            playlist_numbering=downloader.settings[\"playlist_numbering\"],\n            album_type=downloader.settings[\"album_type\"],\n            playlist_retain_track_cover=downloader.settings[\n                \"playlist_retain_track_cover\"\n            ],\n        )\n\n        downloader.download_multiple_songs(songs_list)\n</code></pre>"},{"location":"reference/console/save/","title":"save","text":"<p>Save module for the console.</p>"},{"location":"reference/console/save/#spotdl.console.save.save","title":"<code>save(query, downloader)</code>","text":"<p>Save metadata from spotify to the disk.</p>"},{"location":"reference/console/save/#spotdl.console.save.save--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> <li>downloader: Already initialized downloader instance.</li> </ul>"},{"location":"reference/console/save/#spotdl.console.save.save--notes","title":"Notes","text":"<ul> <li>This function is multi-threaded.</li> </ul> Source code in <code>spotdl/console/save.py</code> <pre><code>def save(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Save metadata from spotify to the disk.\n\n    ### Arguments\n    - query: list of strings to search for.\n    - downloader: Already initialized downloader instance.\n\n    ### Notes\n    - This function is multi-threaded.\n    \"\"\"\n\n    save_path = downloader.settings[\"save_file\"]\n    m3u_file = downloader.settings[\"m3u\"]\n\n    to_stdout = save_path == \"-\"\n\n    if save_path is None and not to_stdout:\n        raise DownloaderError(\"Save file is not specified\")\n\n    # Parse the query\n    songs = parse_query(\n        query=query,\n        threads=downloader.settings[\"threads\"],\n        use_ytm_data=downloader.settings[\"ytm_data\"],\n        playlist_numbering=downloader.settings[\"playlist_numbering\"],\n        album_type=downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=downloader.settings[\"playlist_retain_track_cover\"],\n    )\n    save_data = [song.json for song in songs]\n\n    def process_song(song: Song):\n        download_url = None\n        if downloader.settings[\"preload\"]:\n            try:\n                download_url = downloader.search(song)\n                if download_url is None:\n                    logger.error(\"Could not find a match for %s\", song.display_name)\n                    return None\n\n                logger.info(\"Found url for %s: %s\", song.display_name, download_url)\n            except Exception as exception:\n                logger.error(\n                    \"%s generated an exception: %s\", song.display_name, exception\n                )\n                return None\n\n        lyrics = None\n        try:\n            lyrics = downloader.search_lyrics(song)\n            if lyrics is None:\n                logger.debug(\n                    \"No lyrics found for %s, lyrics providers: %s\",\n                    song.display_name,\n                    \", \".join(\n                        [lprovider.name for lprovider in downloader.lyrics_providers]\n                    ),\n                )\n        except Exception as exception:\n            logger.debug(\"Could not search for lyrics: %s\", exception)\n\n        return {**song.json, \"download_url\": download_url, \"lyrics\": lyrics}\n\n    async def pool_worker(song: Song):\n        async with downloader.semaphore:\n            # The following function calls blocking code, which would block whole event loop.\n            # Therefore it has to be called in a separate thread via ThreadPoolExecutor. This\n            # is not a problem, since GIL is released for the I/O operations, so it shouldn't\n            # hurt performance.\n            return await downloader.loop.run_in_executor(None, process_song, song)\n\n    tasks = [pool_worker(song) for song in songs]\n\n    # call all task asynchronously, and wait until all are finished\n    save_data = list(downloader.loop.run_until_complete(asyncio.gather(*tasks)))\n\n    if to_stdout:\n        # Print the songs to stdout\n        print(json.dumps(save_data, indent=4, ensure_ascii=False))\n    elif save_path:\n        # Save the songs to a file\n        with open(save_path, \"w\", encoding=\"utf-8\") as save_file:\n            json.dump(save_data, save_file, indent=4, ensure_ascii=False)\n\n    if m3u_file:\n        gen_m3u_files(\n            songs,\n            m3u_file,\n            downloader.settings[\"m3u_output\"],\n            downloader.settings[\"format\"],\n            downloader.settings[\"restrict\"],\n            False,\n        )\n\n    if not to_stdout:\n        logger.info(\n            \"Saved %s song%s to %s\",\n            len(save_data),\n            \"s\" if len(save_data) &gt; 1 else \"\",\n            save_path,\n        )\n</code></pre>"},{"location":"reference/console/sync/","title":"sync","text":"<p>Sync module for the console.</p>"},{"location":"reference/console/sync/#spotdl.console.sync.sync","title":"<code>sync(query, downloader)</code>","text":"<p>Sync function for the console. It will download the songs and remove the ones that are no longer present in the playlists/albums/etc</p>"},{"location":"reference/console/sync/#spotdl.console.sync.sync--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> <li>downloader: Already initialized downloader instance.</li> </ul> Source code in <code>spotdl/console/sync.py</code> <pre><code>def sync(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Sync function for the console.\n    It will download the songs and remove the ones that are no longer\n    present in the playlists/albums/etc\n\n\n    ### Arguments\n    - query: list of strings to search for.\n    - downloader: Already initialized downloader instance.\n    \"\"\"\n\n    save_path = downloader.settings[\"save_file\"]\n    downloader.settings[\"save_file\"] = None\n\n    m3u_file = downloader.settings[\"m3u\"]\n    downloader.settings[\"m3u\"] = None\n\n    # Query and save file\n    # Create initial sync file\n    if query and save_path:\n        if any(req for req in query if req.endswith(\".spotdl\")):\n            # If the query contains a .spotdl file, and we are about to create\n            # .spotdl file, raise an error.\n            raise ValueError(\n                \"Cannot create a sync file with a .spotdl file in the query.\"\n            )\n\n        # Parse the query\n        songs_list = parse_query(\n            query=query,\n            threads=downloader.settings[\"threads\"],\n            use_ytm_data=downloader.settings[\"ytm_data\"],\n            playlist_numbering=downloader.settings[\"playlist_numbering\"],\n            album_type=downloader.settings[\"album_type\"],\n            playlist_retain_track_cover=downloader.settings[\n                \"playlist_retain_track_cover\"\n            ],\n        )\n\n        # Create sync file\n        with open(save_path, \"w\", encoding=\"utf-8\") as save_file:\n            json.dump(\n                {\n                    \"type\": \"sync\",\n                    \"query\": query,\n                    \"songs\": [song.json for song in songs_list],\n                },\n                save_file,\n                indent=4,\n                ensure_ascii=False,\n            )\n\n        # Perform initial download\n        downloader.download_multiple_songs(songs_list)\n\n        # Create m3u file\n        if m3u_file:\n            gen_m3u_files(\n                songs_list,\n                m3u_file,\n                downloader.settings[\"m3u_output\"],\n                downloader.settings[\"format\"],\n                downloader.settings[\"restrict\"],\n                False,\n            )\n\n        return None\n\n    # If the query is a single file, download it\n    if (  # pylint: disable=R1702\n        len(query) == 1  # pylint: disable=R1702\n        and query[0].endswith(\".spotdl\")  # pylint: disable=R1702\n        and not save_path  # pylint: disable=R1702\n    ):\n        # Load the sync file\n        with open(query[0], \"r\", encoding=\"utf-8\") as sync_file:\n            sync_data = json.load(sync_file)\n\n        # Verify the sync file\n        if (\n            not isinstance(sync_data, dict)\n            or sync_data.get(\"type\") != \"sync\"\n            or sync_data.get(\"songs\") is None\n        ):\n            raise ValueError(\"Sync file is not a valid sync file.\")\n\n        # Parse the query\n        songs_playlist = parse_query(\n            query=sync_data[\"query\"],\n            threads=downloader.settings[\"threads\"],\n            use_ytm_data=downloader.settings[\"ytm_data\"],\n            playlist_numbering=downloader.settings[\"playlist_numbering\"],\n            album_type=downloader.settings[\"album_type\"],\n            playlist_retain_track_cover=downloader.settings[\n                \"playlist_retain_track_cover\"\n            ],\n        )\n\n        # Get the names and URLs of previously downloaded songs from the sync file\n        old_files = []\n        for entry in sync_data[\"songs\"]:\n            file_name = create_file_name(\n                Song.from_dict(entry),\n                downloader.settings[\"output\"],\n                downloader.settings[\"format\"],\n                downloader.settings[\"restrict\"],\n            )\n\n            old_files.append((file_name, entry[\"url\"]))\n\n        new_urls = [song.url for song in songs_playlist]\n\n        # Delete all song files whose URL is no longer part of the latest playlist\n        if not downloader.settings[\"sync_without_deleting\"]:\n            # Rename songs that have \"{list-length}\", \"{list-position}\", \"{list-name}\",\n            # in the output path so that we don't have to download them again,\n            # and to avoid mangling the directory structure.\n            to_rename: List[Tuple[Path, Path]] = []\n            to_delete = []\n            for path, url in old_files:\n                if url not in new_urls:\n                    to_delete.append(path)\n                else:\n                    new_song = songs_playlist[new_urls.index(url)]\n\n                    new_path = create_file_name(\n                        Song.from_dict(new_song.json),\n                        downloader.settings[\"output\"],\n                        downloader.settings[\"format\"],\n                        downloader.settings[\"restrict\"],\n                    )\n\n                    if path != new_path:\n                        to_rename.append((path, new_path))\n\n            # fix later Downloading duplicate songs in the same playlist\n            # will trigger a re-download of the song. To fix this we have to copy the song\n            # to the new location without removing the old one.\n            for old_path, new_path in to_rename:\n                if old_path.exists():\n                    logger.info(\"Renaming %s to %s\", f\"'{old_path}'\", f\"'{new_path}'\")\n                    if new_path.exists():\n                        old_path.unlink()\n                        continue\n\n                    try:\n                        old_path.rename(new_path)\n                    except (PermissionError, OSError) as exc:\n                        logger.debug(\n                            \"Could not rename temp file: %s, error: %s\", old_path, exc\n                        )\n                else:\n                    logger.debug(\"%s does not exist.\", old_path)\n\n                if downloader.settings[\"sync_remove_lrc\"]:\n                    lrc_file = old_path.with_suffix(\".lrc\")\n                    new_lrc_file = new_path.with_suffix(\".lrc\")\n                    if lrc_file.exists():\n                        logger.debug(\n                            \"Renaming lrc %s to %s\",\n                            f\"'{lrc_file}'\",\n                            f\"'{new_lrc_file}'\",\n                        )\n                        try:\n                            lrc_file.rename(new_lrc_file)\n                        except (PermissionError, OSError) as exc:\n                            logger.debug(\n                                \"Could not rename lrc file: %s, error: %s\",\n                                lrc_file,\n                                exc,\n                            )\n                    else:\n                        logger.debug(\"%s does not exist.\", lrc_file)\n\n            for file in to_delete:\n                if file.exists():\n                    logger.info(\"Deleting %s\", file)\n                    try:\n                        file.unlink()\n                    except (PermissionError, OSError) as exc:\n                        logger.debug(\n                            \"Could not remove temp file: %s, error: %s\", file, exc\n                        )\n                else:\n                    logger.debug(\"%s does not exist.\", file)\n\n                if downloader.settings[\"sync_remove_lrc\"]:\n                    lrc_file = file.with_suffix(\".lrc\")\n                    if lrc_file.exists():\n                        logger.debug(\"Deleting lrc %s\", lrc_file)\n                        try:\n                            lrc_file.unlink()\n                        except (PermissionError, OSError) as exc:\n                            logger.debug(\n                                \"Could not remove lrc file: %s, error: %s\",\n                                lrc_file,\n                                exc,\n                            )\n                    else:\n                        logger.debug(\"%s does not exist.\", lrc_file)\n\n            if len(to_delete) == 0:\n                logger.info(\"Nothing to delete...\")\n            else:\n                logger.info(\"%s old songs were deleted.\", len(to_delete))\n\n        if m3u_file:\n            gen_m3u_files(\n                songs_playlist,\n                m3u_file,\n                downloader.settings[\"m3u_output\"],\n                downloader.settings[\"format\"],\n                downloader.settings[\"restrict\"],\n                False,\n            )\n\n        # Write the new sync file\n        with open(query[0], \"w\", encoding=\"utf-8\") as save_file:\n            json.dump(\n                {\n                    \"type\": \"sync\",\n                    \"query\": sync_data[\"query\"],\n                    \"songs\": [song.json for song in songs_playlist],\n                },\n                save_file,\n                indent=4,\n                ensure_ascii=False,\n            )\n\n        downloader.download_multiple_songs(songs_playlist)\n\n        return None\n\n    raise ValueError(\n        \"Wrong combination of arguments. \"\n        \"Either provide a query and a save path. Or a single sync file in the query\"\n    )\n</code></pre>"},{"location":"reference/console/url/","title":"url","text":"<p>Url module for the console.</p>"},{"location":"reference/console/url/#spotdl.console.url.url","title":"<code>url(query, downloader)</code>","text":"<p>Print download url for the provided songs.</p>"},{"location":"reference/console/url/#spotdl.console.url.url--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> </ul> Source code in <code>spotdl/console/url.py</code> <pre><code>def url(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Print download url for the provided songs.\n\n    ### Arguments\n    - query: list of strings to search for.\n    \"\"\"\n\n    # Parse the query\n    songs = parse_query(\n        query=query,\n        threads=downloader.settings[\"threads\"],\n        use_ytm_data=downloader.settings[\"ytm_data\"],\n        playlist_numbering=downloader.settings[\"playlist_numbering\"],\n        album_type=downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=downloader.settings[\"playlist_retain_track_cover\"],\n    )\n\n    def process_song(song: Song):\n        try:\n            data = downloader.search(song)\n            if data is None:\n                logger.error(\"Could not find a match for %s\", song.display_name)\n\n                return None\n\n            audio_provider = downloader.audio_providers[0]\n            download_url = audio_provider.get_download_metadata(data)[\"url\"]\n\n            print(download_url)\n        except Exception as exception:\n            logger.error(\"%s generated an exception: %s\", song.display_name, exception)\n\n        return None\n\n    async def pool_worker(song: Song):\n        async with downloader.semaphore:\n            # The following function calls blocking code, which would block whole event loop.\n            # Therefore it has to be called in a separate thread via ThreadPoolExecutor. This\n            # is not a problem, since GIL is released for the I/O operations, so it shouldn't\n            # hurt performance.\n            return await downloader.loop.run_in_executor(None, process_song, song)\n\n    tasks = [pool_worker(song) for song in songs]\n    downloader.loop.run_until_complete(asyncio.gather(*tasks))\n</code></pre>"},{"location":"reference/console/web/","title":"web","text":"<p>Web module for the console.</p>"},{"location":"reference/console/web/#spotdl.console.web.web","title":"<code>web(web_settings, downloader_settings)</code>","text":"<p>Run the web server.</p>"},{"location":"reference/console/web/#spotdl.console.web.web--arguments","title":"Arguments","text":"<ul> <li>web_settings: Web server settings.</li> <li>downloader_settings: Downloader settings.</li> </ul> Source code in <code>spotdl/console/web.py</code> <pre><code>def web(web_settings: WebOptions, downloader_settings: DownloaderOptions):\n    \"\"\"\n    Run the web server.\n\n    ### Arguments\n    - web_settings: Web server settings.\n    - downloader_settings: Downloader settings.\n    \"\"\"\n\n    # Apply the fix for mime types\n    fix_mime_types()\n\n    # Set up the app loggers\n    uvicorn_logger = logging.getLogger(\"uvicorn\")\n    uvicorn_logger.propagate = False\n\n    spotipy_logger = logging.getLogger(\"spotipy\")\n    spotipy_logger.setLevel(logging.NOTSET)\n\n    # Initialize the web server settings\n    app_state.web_settings = web_settings\n    app_state.logger = uvicorn_logger\n\n    # Create the event loop\n    app_state.loop = (\n        asyncio.new_event_loop()\n        if sys.platform != \"win32\"\n        else asyncio.ProactorEventLoop()  # type: ignore\n    )\n\n    downloader_settings[\"simple_tui\"] = True\n\n    # Download web app from GitHub if not already downloaded or force flag set\n    web_app_dir = get_web_ui_path()\n    dist_dir = web_app_dir / \"dist\"\n    if (not dist_dir.exists() or web_settings[\"force_update_gui\"]) and web_settings[\n        \"web_gui_location\"\n    ] is None:\n        if web_settings[\"web_gui_repo\"] is None:\n            gui_repo = \"/~https://github.com/spotdl/web-ui/tree/master/dist\"\n        else:\n            gui_repo = web_settings[\"web_gui_repo\"]\n\n        logger.info(\"Updating web app from %s\", gui_repo)\n\n        download_github_dir(\n            gui_repo,\n            output_dir=str(web_app_dir),\n        )\n        web_app_dir = Path(os.path.join(web_app_dir, \"dist\")).resolve()\n    elif web_settings[\"web_gui_location\"]:\n        web_app_dir = Path(web_settings[\"web_gui_location\"]).resolve()\n        logger.info(\"Using custom web app location: %s\", web_app_dir)\n    else:\n        logger.info(\n            \"Using cached web app. To update use the `--force-update-gui` flag.\"\n        )\n        web_app_dir = Path(os.path.join(web_app_dir, \"dist\")).resolve()\n\n    app_state.api = FastAPI(\n        title=\"spotDL\",\n        description=\"Download music from Spotify\",\n        version=__version__,\n        dependencies=[Depends(get_current_state)],\n    )\n\n    app_state.api.include_router(router)\n\n    # Add the CORS middleware\n    app_state.api.add_middleware(\n        CORSMiddleware,\n        allow_origins=(\n            ALLOWED_ORIGINS + web_settings[\"allowed_origins\"]\n            if web_settings[\"allowed_origins\"]\n            else ALLOWED_ORIGINS\n        ),\n        allow_credentials=True,\n        allow_methods=[\"*\"],\n        allow_headers=[\"*\"],\n    )\n\n    # Add the static files\n    app_state.api.mount(\n        \"/\",\n        SPAStaticFiles(directory=web_app_dir, html=True),\n        name=\"static\",\n    )\n    protocol = \"http\"\n    config = Config(\n        app=app_state.api,\n        host=web_settings[\"host\"],\n        port=web_settings[\"port\"],\n        workers=1,\n        log_level=NAME_TO_LEVEL[downloader_settings[\"log_level\"]],\n        loop=app_state.loop,  # type: ignore\n    )\n    if web_settings[\"enable_tls\"]:\n        logger.info(\"Enabeling TLS\")\n        protocol = \"https\"\n        config.ssl_certfile = web_settings[\"cert_file\"]\n        config.ssl_keyfile = web_settings[\"key_file\"]\n        config.ssl_ca_certs = web_settings[\"ca_file\"]\n\n    app_state.server = Server(config)\n\n    app_state.downloader_settings = downloader_settings\n\n    # Open the web browser\n    webbrowser.open(f\"{protocol}://{web_settings['host']}:{web_settings['port']}/\")\n\n    if not web_settings[\"web_use_output_dir\"]:\n        logger.info(\n            \"Files are stored in temporary directory \"\n            \"and will be deleted after the program exits \"\n            \"to save them to current directory permanently \"\n            \"enable the `web_use_output_dir` option \"\n        )\n    else:\n        logger.info(\n            \"Files are stored in current directory \"\n            \"to save them to temporary directory \"\n            \"disable the `web_use_output_dir` option \"\n        )\n\n    logger.info(\"Starting web server \\n\")\n\n    # Start the web server\n    app_state.loop.run_until_complete(app_state.server.serve())\n</code></pre>"},{"location":"reference/download/","title":"download","text":"<p>Download module that holds the downloader and progress handler modules.</p>"},{"location":"reference/download/downloader/","title":"downloader","text":"<p>Downloader module, this is where all the downloading pre/post processing happens etc.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader","title":"<code>Downloader(settings=None, loop=None)</code>","text":"<p>Downloader class, this is where all the downloading pre/post processing happens etc. It handles the downloading/moving songs, multithreading, metadata embedding etc.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader--arguments","title":"Arguments","text":"<ul> <li>settings: The settings to use.</li> <li>loop: The event loop to use.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader--notes","title":"Notes","text":"<ul> <li><code>search-query</code> uses the same format as <code>output</code>.</li> <li>if <code>audio_provider</code> or <code>lyrics_provider</code> is a list, then if no match is found,     the next provider in the list will be used.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def __init__(\n    self,\n    settings: Optional[Union[DownloaderOptionalOptions, DownloaderOptions]] = None,\n    loop: Optional[asyncio.AbstractEventLoop] = None,\n):\n    \"\"\"\n    Initialize the Downloader class.\n\n    ### Arguments\n    - settings: The settings to use.\n    - loop: The event loop to use.\n\n    ### Notes\n    - `search-query` uses the same format as `output`.\n    - if `audio_provider` or `lyrics_provider` is a list, then if no match is found,\n        the next provider in the list will be used.\n    \"\"\"\n\n    if settings is None:\n        settings = {}\n\n    # Create settings dictionary, fill in missing values with defaults\n    # from spotdl.types.options.DOWNLOADER_OPTIONS\n    self.settings: DownloaderOptions = DownloaderOptions(\n        **create_settings_type(\n            Namespace(config=False), dict(settings), DOWNLOADER_OPTIONS\n        )  # type: ignore\n    )\n\n    # Handle deprecated values in config file\n    modernize_settings(self.settings)\n    logger.debug(\"Downloader settings: %s\", self.settings)\n\n    # If no audio providers specified, raise an error\n    if len(self.settings[\"audio_providers\"]) == 0:\n        raise DownloaderError(\n            \"No audio providers specified. Please specify at least one.\"\n        )\n\n    # If ffmpeg is the default value and it's not installed\n    # try to use the spotdl's ffmpeg\n    self.ffmpeg = self.settings[\"ffmpeg\"]\n    if self.ffmpeg == \"ffmpeg\" and shutil.which(\"ffmpeg\") is None:\n        ffmpeg_exec = get_ffmpeg_path()\n        if ffmpeg_exec is None:\n            raise DownloaderError(\"ffmpeg is not installed\")\n\n        self.ffmpeg = str(ffmpeg_exec.absolute())\n\n    logger.debug(\"FFmpeg path: %s\", self.ffmpeg)\n\n    self.loop = loop or (\n        asyncio.new_event_loop()\n        if sys.platform != \"win32\"\n        else asyncio.ProactorEventLoop()  # type: ignore\n    )\n\n    if loop is None:\n        asyncio.set_event_loop(self.loop)\n\n    # semaphore is required to limit concurrent asyncio executions\n    self.semaphore = asyncio.Semaphore(self.settings[\"threads\"])\n\n    self.progress_handler = ProgressHandler(self.settings[\"simple_tui\"])\n\n    # Gather already present songs\n    self.scan_formats = self.settings[\"detect_formats\"] or [self.settings[\"format\"]]\n    self.known_songs: Dict[str, List[Path]] = {}\n    if self.settings[\"scan_for_songs\"]:\n        logger.info(\"Scanning for known songs, this might take a while...\")\n        for scan_format in self.scan_formats:\n            logger.debug(\"Scanning for %s files\", scan_format)\n\n            found_files = gather_known_songs(self.settings[\"output\"], scan_format)\n\n            logger.debug(\"Found %s %s files\", len(found_files), scan_format)\n\n            for song_url, song_paths in found_files.items():\n                known_paths = self.known_songs.get(song_url)\n                if known_paths is None:\n                    self.known_songs[song_url] = song_paths\n                else:\n                    self.known_songs[song_url].extend(song_paths)\n\n    logger.debug(\"Found %s known songs\", len(self.known_songs))\n\n    # Initialize lyrics providers\n    self.lyrics_providers: List[LyricsProvider] = []\n    for lyrics_provider in self.settings[\"lyrics_providers\"]:\n        lyrics_class = LYRICS_PROVIDERS.get(lyrics_provider)\n        if lyrics_class is None:\n            raise DownloaderError(f\"Invalid lyrics provider: {lyrics_provider}\")\n        if lyrics_provider == \"genius\":\n            access_token = self.settings.get(\"genius_token\")\n            if not access_token:\n                raise DownloaderError(\"Genius token not found in settings\")\n            self.lyrics_providers.append(Genius(access_token))\n        else:\n            self.lyrics_providers.append(lyrics_class())\n\n    # Initialize audio providers\n    self.audio_providers: List[AudioProvider] = []\n    for audio_provider in self.settings[\"audio_providers\"]:\n        audio_class = AUDIO_PROVIDERS.get(audio_provider)\n        if audio_class is None:\n            raise DownloaderError(f\"Invalid audio provider: {audio_provider}\")\n\n        self.audio_providers.append(\n            audio_class(\n                output_format=self.settings[\"format\"],\n                cookie_file=self.settings[\"cookie_file\"],\n                search_query=self.settings[\"search_query\"],\n                filter_results=self.settings[\"filter_results\"],\n                yt_dlp_args=self.settings[\"yt_dlp_args\"],\n            )\n        )\n\n    # Initialize list of errors\n    self.errors: List[str] = []\n\n    # Initialize proxy server\n    proxy = self.settings[\"proxy\"]\n    proxies = None\n    if proxy:\n        if not re.match(\n            pattern=r\"^(http|https):\\/\\/(?:(\\w+)(?::(\\w+))?@)?((?:\\d{1,3})(?:\\.\\d{1,3}){3})(?::(\\d{1,5}))?$\",  # pylint: disable=C0301\n            string=proxy,\n        ):\n            raise DownloaderError(f\"Invalid proxy server: {proxy}\")\n        proxies = {\"http\": proxy, \"https\": proxy}\n        logger.info(\"Setting proxy server: %s\", proxy)\n\n    GlobalConfig.set_parameter(\"proxies\", proxies)\n\n    # Initialize archive\n    self.url_archive = Archive()\n    if self.settings[\"archive\"]:\n        self.url_archive.load(self.settings[\"archive\"])\n\n    logger.debug(\"Archive: %d urls\", len(self.url_archive))\n\n    logger.debug(\"Downloader initialized\")\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_multiple_songs","title":"<code>download_multiple_songs(songs)</code>","text":"<p>Download multiple songs to the temp directory.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_multiple_songs--arguments","title":"Arguments","text":"<ul> <li>songs: The songs to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_multiple_songs--returns","title":"Returns","text":"<ul> <li>list of tuples with the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def download_multiple_songs(\n    self, songs: List[Song]\n) -&gt; List[Tuple[Song, Optional[Path]]]:\n    \"\"\"\n    Download multiple songs to the temp directory.\n\n    ### Arguments\n    - songs: The songs to download.\n\n    ### Returns\n    - list of tuples with the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    if self.settings[\"fetch_albums\"]:\n        albums = set(song.album_id for song in songs if song.album_id is not None)\n        logger.info(\n            \"Fetching %d album%s\", len(albums), \"s\" if len(albums) &gt; 1 else \"\"\n        )\n\n        songs.extend(songs_from_albums(list(albums)))\n\n        # Remove duplicates\n        return_obj = {}\n        for song in songs:\n            return_obj[song.url] = song\n\n        songs = list(return_obj.values())\n\n    logger.debug(\"Downloading %d songs\", len(songs))\n\n    if self.settings[\"archive\"]:\n        songs = [song for song in songs if song.url not in self.url_archive]\n        logger.debug(\"Filtered %d songs with archive\", len(songs))\n\n    self.progress_handler.set_song_count(len(songs))\n\n    # Create tasks list\n    tasks = [self.pool_download(song) for song in songs]\n\n    # Call all task asynchronously, and wait until all are finished\n    results = list(self.loop.run_until_complete(asyncio.gather(*tasks)))\n\n    # Print errors\n    if self.settings[\"print_errors\"]:\n        for error in self.errors:\n            logger.error(error)\n\n    if self.settings[\"save_errors\"]:\n        with open(\n            self.settings[\"save_errors\"], \"a\", encoding=\"utf-8\"\n        ) as error_file:\n            if len(self.errors) &gt; 0:\n                error_file.write(\n                    f\"{datetime.datetime.now().strftime('%Y-%m-%d-%H-%M-%S')}\\n\"\n                )\n            for error in self.errors:\n                error_file.write(f\"{error}\\n\")\n\n        logger.info(\"Saved errors to %s\", self.settings[\"save_errors\"])\n\n    # Save archive\n    if self.settings[\"archive\"]:\n        for result in results:\n            if result[1] or self.settings[\"add_unavailable\"]:\n                self.url_archive.add(result[0].url)\n\n        self.url_archive.save(self.settings[\"archive\"])\n        logger.info(\n            \"Saved archive with %d urls to %s\",\n            len(self.url_archive),\n            self.settings[\"archive\"],\n        )\n\n    # Create m3u playlist\n    if self.settings[\"m3u\"]:\n        song_list = [\n            song\n            for song, path in results\n            if path or self.settings[\"add_unavailable\"]\n        ]\n\n        gen_m3u_files(\n            song_list,\n            self.settings[\"m3u\"],\n            self.settings[\"m3u_output\"],\n            self.settings[\"format\"],\n            self.settings[\"restrict\"],\n            False,\n            self.settings[\"detect_formats\"],\n        )\n\n    # Save results to a file\n    if self.settings[\"save_file\"]:\n        with open(self.settings[\"save_file\"], \"w\", encoding=\"utf-8\") as save_file:\n            json.dump([song.json for song, _ in results], save_file, indent=4)\n\n        logger.info(\"Saved results to %s\", self.settings[\"save_file\"])\n\n    return results\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_song","title":"<code>download_song(song)</code>","text":"<p>Download a single song.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_song--arguments","title":"Arguments","text":"<ul> <li>song: The song to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_song--returns","title":"Returns","text":"<ul> <li>tuple with the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def download_song(self, song: Song) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Download a single song.\n\n    ### Arguments\n    - song: The song to download.\n\n    ### Returns\n    - tuple with the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    self.progress_handler.set_song_count(1)\n\n    results = self.download_multiple_songs([song])\n\n    return results[0]\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download","title":"<code>pool_download(song)</code>  <code>async</code>","text":"<p>Run asynchronous task in a pool to make sure that all processes.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download--arguments","title":"Arguments","text":"<ul> <li>song: The song to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download--returns","title":"Returns","text":"<ul> <li>tuple with the song and the path to the downloaded file if successful.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download--notes","title":"Notes","text":"<ul> <li>This method calls <code>self.search_and_download</code> in a new thread.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>async def pool_download(self, song: Song) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Run asynchronous task in a pool to make sure that all processes.\n\n    ### Arguments\n    - song: The song to download.\n\n    ### Returns\n    - tuple with the song and the path to the downloaded file if successful.\n\n    ### Notes\n    - This method calls `self.search_and_download` in a new thread.\n    \"\"\"\n\n    # tasks that cannot acquire semaphore will wait here until it's free\n    # only certain amount of tasks can acquire the semaphore at the same time\n    async with self.semaphore:\n        return await self.loop.run_in_executor(None, self.search_and_download, song)\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search","title":"<code>search(song)</code>","text":"<p>Search for a song using all available providers.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search--returns","title":"Returns","text":"<ul> <li>tuple with download url and audio provider if successful.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def search(self, song: Song) -&gt; str:\n    \"\"\"\n    Search for a song using all available providers.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - tuple with download url and audio provider if successful.\n    \"\"\"\n\n    for audio_provider in self.audio_providers:\n        url = audio_provider.search(song, self.settings[\"only_verified_results\"])\n        if url:\n            return url\n\n        logger.debug(\"%s failed to find %s\", audio_provider.name, song.display_name)\n\n    raise LookupError(f\"No results found for song: {song.display_name}\")\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download","title":"<code>search_and_download(song)</code>","text":"<p>Search for the song and download it.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download--arguments","title":"Arguments","text":"<ul> <li>song: The song to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download--returns","title":"Returns","text":"<ul> <li>tuple with the song and the path to the downloaded file if successful.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download--notes","title":"Notes","text":"<ul> <li>This function is synchronous.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def search_and_download(  # pylint: disable=R0911\n    self, song: Song\n) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Search for the song and download it.\n\n    ### Arguments\n    - song: The song to download.\n\n    ### Returns\n    - tuple with the song and the path to the downloaded file if successful.\n\n    ### Notes\n    - This function is synchronous.\n    \"\"\"\n\n    # Check if song has name/artist and url/song_id\n    if not (song.name and (song.artists or song.artist)) and not (\n        song.url or song.song_id\n    ):\n        logger.error(\"Song is missing required fields: %s\", song.display_name)\n        self.errors.append(f\"Song is missing required fields: {song.display_name}\")\n\n        return song, None\n\n    reinitialized = False\n    try:\n        # Create the output file path\n        output_file = create_file_name(\n            song=song,\n            template=self.settings[\"output\"],\n            file_extension=self.settings[\"format\"],\n            restrict=self.settings[\"restrict\"],\n            file_name_length=self.settings[\"max_filename_length\"],\n        )\n\n    except Exception:\n        song = reinit_song(song)\n\n        output_file = create_file_name(\n            song=song,\n            template=self.settings[\"output\"],\n            file_extension=self.settings[\"format\"],\n            restrict=self.settings[\"restrict\"],\n            file_name_length=self.settings[\"max_filename_length\"],\n        )\n\n        reinitialized = True\n\n    if song.explicit is True and self.settings[\"skip_explicit\"] is True:\n        logger.info(\"Skipping explicit song: %s\", song.display_name)\n        return song, None\n\n    # Initialize the progress tracker\n    display_progress_tracker = self.progress_handler.get_new_tracker(song)\n\n    try:\n        # Create the temp folder path\n        temp_folder = get_temp_path()\n\n        # Check if there is an already existing song file, with the same spotify URL in its\n        # metadata, but saved under a different name. If so, save its path.\n        dup_song_paths: List[Path] = self.known_songs.get(song.url, [])\n\n        # Remove files from the list that have the same path as the output file\n        dup_song_paths = [\n            dup_song_path\n            for dup_song_path in dup_song_paths\n            if (dup_song_path.absolute() != output_file.absolute())\n            and dup_song_path.exists()\n        ]\n\n        # Checking if file already exists in all subfolders of output directory\n        file_exists = file_exists = output_file.exists() or dup_song_paths\n        if not self.settings[\"scan_for_songs\"]:\n            for file_extension in self.scan_formats:\n                ext_path = output_file.with_suffix(f\".{file_extension}\")\n                if ext_path.exists():\n                    dup_song_paths.append(ext_path)\n\n        if dup_song_paths:\n            logger.debug(\n                \"Found duplicate songs for %s at %s\",\n                song.display_name,\n                \", \".join(\n                    [f\"'{str(dup_song_path)}'\" for dup_song_path in dup_song_paths]\n                ),\n            )\n\n        # If the file already exists and we don't want to overwrite it,\n        # we can skip the download\n        if (  # pylint: disable=R1705\n            Path(str(output_file.absolute()) + \".skip\").exists()\n            and self.settings[\"respect_skip_file\"]\n        ):\n            logger.info(\n                \"Skipping %s (skip file found) %s\",\n                song.display_name,\n                \"\",\n            )\n\n            return song, output_file if output_file.exists() else None\n\n        elif file_exists and self.settings[\"overwrite\"] == \"skip\":\n            logger.info(\n                \"Skipping %s (file already exists) %s\",\n                song.display_name,\n                \"(duplicate)\" if dup_song_paths else \"\",\n            )\n\n            display_progress_tracker.notify_download_skip()\n            return song, output_file\n\n        # Check if we have all the metadata\n        # and that the song object is not a placeholder\n        # If it's None extract the current metadata\n        # And reinitialize the song object\n        # Force song reinitialization if we are fetching albums\n        # they have most metadata but not all\n        if (\n            (song.name is None and song.url)\n            or (self.settings[\"fetch_albums\"] and reinitialized is False)\n            or None\n            in [\n                song.genres,\n                song.disc_count,\n                song.tracks_count,\n                song.track_number,\n                song.album_id,\n                song.album_artist,\n            ]\n        ):\n            song = reinit_song(song)\n            reinitialized = True\n\n        # Don't skip if the file exists and overwrite is set to force\n        if file_exists and self.settings[\"overwrite\"] == \"force\":\n            logger.info(\n                \"Overwriting %s %s\",\n                song.display_name,\n                \" (duplicate)\" if dup_song_paths else \"\",\n            )\n\n            # If the duplicate song path is not None, we can delete the old file\n            for dup_song_path in dup_song_paths:\n                try:\n                    logger.info(\"Removing duplicate file: %s\", dup_song_path)\n\n                    dup_song_path.unlink()\n                except (PermissionError, OSError, Exception) as exc:\n                    logger.debug(\n                        \"Could not remove duplicate file: %s, error: %s\",\n                        dup_song_path,\n                        exc,\n                    )\n\n        # Find song lyrics and add them to the song object\n        try:\n            lyrics = self.search_lyrics(song)\n            if lyrics is None:\n                logger.debug(\n                    \"No lyrics found for %s, lyrics providers: %s\",\n                    song.display_name,\n                    \", \".join(\n                        [lprovider.name for lprovider in self.lyrics_providers]\n                    ),\n                )\n            else:\n                song.lyrics = lyrics\n        except Exception as exc:\n            logger.debug(\"Could not search for lyrics: %s\", exc)\n\n        # If the file already exists and we want to overwrite the metadata,\n        # we can skip the download\n        if file_exists and self.settings[\"overwrite\"] == \"metadata\":\n            most_recent_duplicate: Optional[Path] = None\n            if dup_song_paths:\n                # Get the most recent duplicate song path and remove the rest\n                most_recent_duplicate = max(\n                    dup_song_paths,\n                    key=lambda dup_song_path: dup_song_path.stat().st_mtime\n                    and dup_song_path.suffix == output_file.suffix,\n                )\n\n                # Remove the rest of the duplicate song paths\n                for old_song_path in dup_song_paths:\n                    if most_recent_duplicate == old_song_path:\n                        continue\n\n                    try:\n                        logger.info(\"Removing duplicate file: %s\", old_song_path)\n                        old_song_path.unlink()\n                    except (PermissionError, OSError) as exc:\n                        logger.debug(\n                            \"Could not remove duplicate file: %s, error: %s\",\n                            old_song_path,\n                            exc,\n                        )\n\n                # Move the old file to the new location\n                if (\n                    most_recent_duplicate\n                    and most_recent_duplicate.suffix == output_file.suffix\n                ):\n                    most_recent_duplicate.replace(\n                        output_file.with_suffix(f\".{self.settings['format']}\")\n                    )\n\n            if (\n                most_recent_duplicate\n                and most_recent_duplicate.suffix != output_file.suffix\n            ):\n                logger.info(\n                    \"Could not move duplicate file: %s, different file extension\",\n                    most_recent_duplicate,\n                )\n\n                display_progress_tracker.notify_complete()\n\n                return song, None\n\n            # Update the metadata\n            embed_metadata(\n                output_file=output_file,\n                song=song,\n                skip_album_art=self.settings[\"skip_album_art\"],\n            )\n\n            logger.info(\n                f\"Updated metadata for {song.display_name}\"\n                f\", moved to new location: {output_file}\"\n                if most_recent_duplicate\n                else \"\"\n            )\n\n            display_progress_tracker.notify_complete()\n\n            return song, output_file\n\n        # Create the output directory if it doesn't exist\n        output_file.parent.mkdir(parents=True, exist_ok=True)\n        if song.download_url is None:\n            download_url = self.search(song)\n        else:\n            download_url = song.download_url\n\n        # Initialize audio downloader\n        audio_downloader: Union[AudioProvider, Piped]\n        if self.settings[\"audio_providers\"][0] == \"piped\":\n            audio_downloader = Piped(\n                output_format=self.settings[\"format\"],\n                cookie_file=self.settings[\"cookie_file\"],\n                search_query=self.settings[\"search_query\"],\n                filter_results=self.settings[\"filter_results\"],\n                yt_dlp_args=self.settings[\"yt_dlp_args\"],\n            )\n        else:\n            audio_downloader = AudioProvider(\n                output_format=self.settings[\"format\"],\n                cookie_file=self.settings[\"cookie_file\"],\n                search_query=self.settings[\"search_query\"],\n                filter_results=self.settings[\"filter_results\"],\n                yt_dlp_args=self.settings[\"yt_dlp_args\"],\n            )\n\n        logger.debug(\"Downloading %s using %s\", song.display_name, download_url)\n\n        # Add progress hook to the audio provider\n        audio_downloader.audio_handler.add_progress_hook(\n            display_progress_tracker.yt_dlp_progress_hook\n        )\n\n        download_info = audio_downloader.get_download_metadata(\n            download_url, download=True\n        )\n\n        temp_file = Path(\n            temp_folder / f\"{download_info['id']}.{download_info['ext']}\"\n        )\n\n        if download_info is None:\n            logger.debug(\n                \"No download info found for %s, url: %s\",\n                song.display_name,\n                download_url,\n            )\n\n            raise DownloaderError(\n                f\"yt-dlp failed to get metadata for: {song.name} - {song.artist}\"\n            )\n\n        display_progress_tracker.notify_download_complete()\n\n        # Copy the downloaded file to the output file\n        # if the temp file and output file have the same extension\n        # and the bitrate is set to auto or disable\n        # Don't copy if the audio provider is piped\n        # unless the bitrate is set to disable\n        if (\n            self.settings[\"bitrate\"] in [\"auto\", \"disable\", None]\n            and temp_file.suffix == output_file.suffix\n        ) and not (\n            self.settings[\"audio_providers\"][0] == \"piped\"\n            and self.settings[\"bitrate\"] != \"disable\"\n        ):\n            shutil.move(str(temp_file), output_file)\n            success = True\n            result = None\n        else:\n            if self.settings[\"bitrate\"] in [\"auto\", None]:\n                # Use the bitrate from the download info if it exists\n                # otherwise use `copy`\n                bitrate = (\n                    f\"{int(download_info['abr'])}k\"\n                    if download_info.get(\"abr\")\n                    else \"copy\"\n                )\n            elif self.settings[\"bitrate\"] == \"disable\":\n                bitrate = None\n            else:\n                bitrate = str(self.settings[\"bitrate\"])\n\n            # Convert the downloaded file to the output format\n            success, result = convert(\n                input_file=temp_file,\n                output_file=output_file,\n                ffmpeg=self.ffmpeg,\n                output_format=self.settings[\"format\"],\n                bitrate=bitrate,\n                ffmpeg_args=self.settings[\"ffmpeg_args\"],\n                progress_handler=display_progress_tracker.ffmpeg_progress_hook,\n            )\n\n            if self.settings[\"create_skip_file\"]:\n                with open(\n                    str(output_file) + \".skip\", mode=\"w\", encoding=\"utf-8\"\n                ) as _:\n                    pass\n\n        # Remove the temp file\n        if temp_file.exists():\n            try:\n                temp_file.unlink()\n            except (PermissionError, OSError) as exc:\n                logger.debug(\n                    \"Could not remove temp file: %s, error: %s\", temp_file, exc\n                )\n\n                raise DownloaderError(\n                    f\"Could not remove temp file: {temp_file}, possible duplicate song\"\n                ) from exc\n\n        if not success and result:\n            # If the conversion failed and there is an error message\n            # create a file with the error message\n            # and save it in the errors directory\n            # raise an exception with file path\n            file_name = (\n                get_errors_path()\n                / f\"ffmpeg_error_{datetime.datetime.now().strftime('%Y-%m-%d-%H-%M-%S')}.txt\"\n            )\n\n            error_message = \"\"\n            for key, value in result.items():\n                error_message += f\"### {key}:\\n{str(value).strip()}\\n\\n\"\n\n            with open(file_name, \"w\", encoding=\"utf-8\") as error_path:\n                error_path.write(error_message)\n\n            # Remove the file that failed to convert\n            if output_file.exists():\n                output_file.unlink()\n\n            raise FFmpegError(\n                f\"Failed to convert {song.display_name}, \"\n                f\"you can find error here: {str(file_name.absolute())}\"\n            )\n\n        download_info[\"filepath\"] = str(output_file)\n\n        # Set the song's download url\n        if song.download_url is None:\n            song.download_url = download_url\n\n        display_progress_tracker.notify_conversion_complete()\n\n        # SponsorBlock post processor\n        if self.settings[\"sponsor_block\"]:\n            # Initialize the sponsorblock post processor\n            post_processor = SponsorBlockPP(\n                audio_downloader.audio_handler, SPONSOR_BLOCK_CATEGORIES\n            )\n\n            # Run the post processor to get the sponsor segments\n            _, download_info = post_processor.run(download_info)\n            chapters = download_info[\"sponsorblock_chapters\"]\n\n            # If there are sponsor segments, remove them\n            if len(chapters) &gt; 0:\n                logger.info(\n                    \"Removing %s sponsor segments for %s\",\n                    len(chapters),\n                    song.display_name,\n                )\n\n                # Initialize the modify chapters post processor\n                modify_chapters = ModifyChaptersPP(\n                    downloader=audio_downloader.audio_handler,\n                    remove_sponsor_segments=SPONSOR_BLOCK_CATEGORIES,\n                )\n\n                # Run the post processor to remove the sponsor segments\n                # this returns a list of files to delete\n                files_to_delete, download_info = modify_chapters.run(download_info)\n\n                # Delete the files that were created by the post processor\n                for file_to_delete in files_to_delete:\n                    Path(file_to_delete).unlink()\n\n        try:\n            embed_metadata(\n                output_file,\n                song,\n                id3_separator=self.settings[\"id3_separator\"],\n                skip_album_art=self.settings[\"skip_album_art\"],\n            )\n        except Exception as exception:\n            raise MetadataError(\n                \"Failed to embed metadata to the song\"\n            ) from exception\n\n        if self.settings[\"generate_lrc\"]:\n            generate_lrc(song, output_file)\n\n        display_progress_tracker.notify_complete()\n\n        # Add the song to the known songs\n        self.known_songs.get(song.url, []).append(output_file)\n\n        logger.info('Downloaded \"%s\": %s', song.display_name, song.download_url)\n\n        return song, output_file\n    except (Exception, UnicodeEncodeError) as exception:\n        if isinstance(exception, UnicodeEncodeError):\n            exception_cause = exception\n            exception = DownloaderError(\n                \"You may need to add PYTHONIOENCODING=utf-8 to your environment\"\n            )\n\n            exception.__cause__ = exception_cause\n\n        display_progress_tracker.notify_error(\n            traceback.format_exc(), exception, True\n        )\n        self.errors.append(\n            f\"{song.url} - {exception.__class__.__name__}: {exception}\"\n        )\n        return song, None\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_lyrics","title":"<code>search_lyrics(song)</code>","text":"<p>Search for lyrics using all available providers.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_lyrics--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_lyrics--returns","title":"Returns","text":"<ul> <li>lyrics if successful else None.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def search_lyrics(self, song: Song) -&gt; Optional[str]:\n    \"\"\"\n    Search for lyrics using all available providers.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - lyrics if successful else None.\n    \"\"\"\n\n    for lyrics_provider in self.lyrics_providers:\n        lyrics = lyrics_provider.get_lyrics(song.name, song.artists)\n        if lyrics:\n            logger.debug(\n                \"Found lyrics for %s on %s\", song.display_name, lyrics_provider.name\n            )\n\n            return lyrics\n\n        logger.debug(\n            \"%s failed to find lyrics for %s\",\n            lyrics_provider.name,\n            song.display_name,\n        )\n\n    return None\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.DownloaderError","title":"<code>DownloaderError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to downloaders.</p>"},{"location":"reference/download/progress_handler/","title":"progress_handler","text":"<p>Module that holds the ProgressHandler class and Song Tracker class.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler","title":"<code>ProgressHandler(simple_tui=False, update_callback=None, web_ui=False)</code>","text":"<p>Class for handling the progress of a download, including the progress bar.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler--arguments","title":"Arguments","text":"<ul> <li>simple_tui: Whether or not to use the simple TUI.</li> <li>update_callback: A callback to call when the progress bar is updated.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def __init__(\n    self,\n    simple_tui: bool = False,\n    update_callback: Optional[Callable[[Any, str], None]] = None,\n    web_ui: bool = False,\n):\n    \"\"\"\n    Initialize the progress handler.\n\n    ### Arguments\n    - simple_tui: Whether or not to use the simple TUI.\n    - update_callback: A callback to call when the progress bar is updated.\n    \"\"\"\n\n    self.songs: List[Song] = []\n    self.song_count: int = 0\n    self.overall_progress = 0\n    self.overall_total = 100\n    self.overall_completed_tasks = 0\n    self.update_callback = update_callback\n    self.previous_overall = self.overall_completed_tasks\n\n    self.simple_tui = simple_tui\n    self.web_ui = web_ui\n    self.quiet = logger.getEffectiveLevel() &lt; 10\n    self.overall_task_id: Optional[TaskID] = None\n\n    if not self.simple_tui:\n        console = get_console()\n\n        self.rich_progress_bar = Progress(\n            SizedTextColumn(\n                \"[white]{task.description}\",\n                overflow=\"ellipsis\",\n                width=int(console.width / 3),\n            ),\n            SizedTextColumn(\n                \"{task.fields[message]}\", width=18, style=\"nonimportant\"\n            ),\n            BarColumn(bar_width=None, finished_style=\"green\"),\n            \"[progress.percentage]{task.percentage:&gt;3.0f}%\",\n            TimeRemainingColumn(),\n            # Normally when you exit the progress context manager (or call stop())\n            # the last refreshed display remains in the terminal with the cursor on\n            # the following line. You can also make the progress display disappear on\n            # exit by setting transient=True on the Progress constructor\n            transient=True,\n        )\n\n        # Basically a wrapper for rich's: with ... as ...\n        self.rich_progress_bar.__enter__()\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.add_song","title":"<code>add_song(song)</code>","text":"<p>Adds a song to the list of songs.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.add_song--arguments","title":"Arguments","text":"<ul> <li>song: The song to add.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def add_song(self, song: Song) -&gt; None:\n    \"\"\"\n    Adds a song to the list of songs.\n\n    ### Arguments\n    - song: The song to add.\n    \"\"\"\n\n    self.songs.append(song)\n    self.set_song_count(len(self.songs))\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.close","title":"<code>close()</code>","text":"<p>Close the Tui Progress Handler.</p> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def close(self) -&gt; None:\n    \"\"\"\n    Close the Tui Progress Handler.\n    \"\"\"\n\n    if not self.simple_tui:\n        self.rich_progress_bar.stop()\n\n    logging.shutdown()\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.get_new_tracker","title":"<code>get_new_tracker(song)</code>","text":"<p>Get a new progress tracker.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--arguments","title":"Arguments","text":"<ul> <li>song: The song to track.</li> </ul>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--returns","title":"Returns","text":"<ul> <li>A new progress tracker.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def get_new_tracker(self, song: Song) -&gt; \"SongTracker\":\n    \"\"\"\n    Get a new progress tracker.\n\n    ### Arguments\n    - song: The song to track.\n\n    ### Returns\n    - A new progress tracker.\n    \"\"\"\n\n    return SongTracker(self, song)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_song_count","title":"<code>set_song_count(count)</code>","text":"<p>Set the number of songs to download.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_song_count--arguments","title":"Arguments","text":"<ul> <li>count: The number of songs to download.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def set_song_count(self, count: int) -&gt; None:\n    \"\"\"\n    Set the number of songs to download.\n\n    ### Arguments\n    - count: The number of songs to download.\n    \"\"\"\n\n    self.song_count = count\n    self.overall_total = 100 * count\n\n    if not self.simple_tui:\n        if self.song_count &gt; 4:\n            self.overall_task_id = self.rich_progress_bar.add_task(\n                description=\"Total\",\n                message=(\n                    f\"{self.overall_completed_tasks}/{int(self.overall_total / 100)} \"\n                    \"complete\"\n                ),\n                total=self.overall_total,\n                visible=(not self.quiet),\n            )\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_songs","title":"<code>set_songs(songs)</code>","text":"<p>Sets the list of songs to be downloaded.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_songs--arguments","title":"Arguments","text":"<ul> <li>songs: The list of songs to download.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def set_songs(self, songs: List[Song]) -&gt; None:\n    \"\"\"\n    Sets the list of songs to be downloaded.\n\n    ### Arguments\n    - songs: The list of songs to download.\n    \"\"\"\n\n    self.songs = songs\n    self.set_song_count(len(songs))\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.update_overall","title":"<code>update_overall()</code>","text":"<p>Update the overall progress bar.</p> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def update_overall(self) -&gt; None:\n    \"\"\"\n    Update the overall progress bar.\n    \"\"\"\n\n    if not self.simple_tui:\n        # If the overall progress bar exists\n        if self.overall_task_id is not None:\n            self.rich_progress_bar.update(\n                self.overall_task_id,\n                message=f\"{self.overall_completed_tasks}/\"\n                f\"{int(self.overall_total / 100)} \"\n                \"complete\",\n                completed=self.overall_progress,\n            )\n    else:\n        if self.previous_overall != self.overall_completed_tasks:\n            logger.info(\n                \"%s/%s complete\", self.overall_completed_tasks, self.song_count\n            )\n            self.previous_overall = self.overall_completed_tasks\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandlerError","title":"<code>ProgressHandlerError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions raised by ProgressHandler subclasses.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn","title":"<code>SizedTextColumn(text_format, style='none', justify='left', markup=True, highlighter=None, overflow=None, width=20)</code>","text":"<p>               Bases: <code>ProgressColumn</code></p> <p>Custom sized text column based on the Rich library.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn--arguments","title":"Arguments","text":"<ul> <li>text_format: The format string to use for the text.</li> <li>style: The style to use for the text.</li> <li>justify: The justification to use for the text.</li> <li>markup: Whether or not the text should be rendered as markup.</li> <li>highlighter: A Highlighter to use for highlighting the text.</li> <li>overflow: The overflow method to use for truncating the text.</li> <li>width: The maximum width of the text.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def __init__(\n    self,\n    text_format: str,\n    style: StyleType = \"none\",\n    justify: JustifyMethod = \"left\",\n    markup: bool = True,\n    highlighter: Optional[Highlighter] = None,\n    overflow: Optional[OverflowMethod] = None,\n    width: int = 20,\n) -&gt; None:\n    \"\"\"\n    A column containing text.\n\n    ### Arguments\n    - text_format: The format string to use for the text.\n    - style: The style to use for the text.\n    - justify: The justification to use for the text.\n    - markup: Whether or not the text should be rendered as markup.\n    - highlighter: A Highlighter to use for highlighting the text.\n    - overflow: The overflow method to use for truncating the text.\n    - width: The maximum width of the text.\n    \"\"\"\n\n    self.text_format = text_format\n    self.justify: JustifyMethod = justify\n    self.style = style\n    self.markup = markup\n    self.highlighter = highlighter\n    self.overflow: Optional[OverflowMethod] = overflow\n    self.width = width\n    super().__init__()\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn.render","title":"<code>render(task)</code>","text":"<p>Render the Column.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn.render--arguments","title":"Arguments","text":"<ul> <li>task: The Task to render.</li> </ul>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn.render--returns","title":"Returns","text":"<ul> <li>A Text object.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def render(self, task: Task) -&gt; Text:\n    \"\"\"\n    Render the Column.\n\n    ### Arguments\n    - task: The Task to render.\n\n    ### Returns\n    - A Text object.\n    \"\"\"\n\n    _text = self.text_format.format(task=task)\n    if self.markup:\n        text = Text.from_markup(_text, style=self.style, justify=self.justify)\n    else:\n        text = Text(_text, style=self.style, justify=self.justify)\n    if self.highlighter:\n        self.highlighter.highlight(text)\n\n    text.truncate(max_width=self.width, overflow=self.overflow, pad=True)\n    return text\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker","title":"<code>SongTracker(parent, song)</code>","text":"<p>Class to track the progress of a song.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker--arguments","title":"Arguments","text":"<ul> <li>parent: The parent Tui Progress Handler.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def __init__(self, parent, song: Song) -&gt; None:\n    \"\"\"\n    Initialize the Tui Song Tracker.\n\n    ### Arguments\n    - parent: The parent Tui Progress Handler.\n    \"\"\"\n\n    self.parent: \"ProgressHandler\" = parent\n    self.song = song\n\n    # Clean up the song name\n    # from weird unicode characters\n    self.song_name = \"\".join(\n        char\n        for char in self.song.display_name\n        if char not in [chr(i) for i in BAD_CHARS]\n    )\n\n    self.progress: int = 0\n    self.old_progress: int = 0\n    self.status = \"\"\n\n    if not self.parent.simple_tui:\n        self.task_id = self.parent.rich_progress_bar.add_task(\n            description=escape(self.song_name),\n            message=\"Processing\",\n            total=100,\n            completed=self.progress,\n            start=False,\n            visible=(not self.parent.quiet),\n        )\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook","title":"<code>ffmpeg_progress_hook(progress)</code>","text":"<p>Updates the progress.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook--arguments","title":"Arguments","text":"<ul> <li>progress: The progress to update to.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def ffmpeg_progress_hook(self, progress: int) -&gt; None:\n    \"\"\"\n    Updates the progress.\n\n    ### Arguments\n    - progress: The progress to update to.\n    \"\"\"\n\n    if self.parent.simple_tui and not self.parent.web_ui:\n        self.progress = 50\n    else:\n        self.progress = 50 + int(progress * 0.45)\n\n    self.update(\"Converting\")\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_complete","title":"<code>notify_complete(status='Done')</code>","text":"<p>Notifies the progress handler that the song has been downloaded and converted.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_complete--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_complete(self, status=\"Done\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been downloaded and converted.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 100\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_conversion_complete","title":"<code>notify_conversion_complete(status='Embedding metadata')</code>","text":"<p>Notifies the progress handler that the song has been converted.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_conversion_complete--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_conversion_complete(self, status=\"Embedding metadata\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been converted.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 95\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_complete","title":"<code>notify_download_complete(status='Converting')</code>","text":"<p>Notifies the progress handler that the song has been downloaded.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_complete--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_download_complete(self, status=\"Converting\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been downloaded.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 50\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_skip","title":"<code>notify_download_skip(status='Skipped')</code>","text":"<p>Notifies the progress handler that the song has been skipped.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_skip--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_download_skip(self, status=\"Skipped\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been skipped.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 100\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_error","title":"<code>notify_error(message, traceback, finish=False)</code>","text":"<p>Logs an error message.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_error--arguments","title":"Arguments","text":"<ul> <li>message: The message to log.</li> <li>traceback: The traceback of the error.</li> <li>finish: Whether to finish the task.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_error(\n    self, message: str, traceback: Exception, finish: bool = False\n) -&gt; None:\n    \"\"\"\n    Logs an error message.\n\n    ### Arguments\n    - message: The message to log.\n    - traceback: The traceback of the error.\n    - finish: Whether to finish the task.\n    \"\"\"\n\n    self.update(\"Error\")\n    if finish:\n        self.progress = 100\n\n    if logger.getEffectiveLevel() == logging.DEBUG:\n        logger.exception(message)\n    else:\n        logger.error(\"%s: %s\", traceback.__class__.__name__, traceback)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.update","title":"<code>update(message='')</code>","text":"<p>Called at every event.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.update--arguments","title":"Arguments","text":"<ul> <li>message: The message to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def update(self, message=\"\"):\n    \"\"\"\n    Called at every event.\n\n    ### Arguments\n    - message: The message to display.\n    \"\"\"\n\n    old_message = self.status\n    self.status = message\n\n    # The change in progress since last update\n    delta = self.progress - self.old_progress\n\n    if not self.parent.simple_tui:\n        # Update the progress bar\n        # `start_task` called everytime to ensure progress is remove from indeterminate state\n        self.parent.rich_progress_bar.start_task(self.task_id)\n        self.parent.rich_progress_bar.update(\n            self.task_id,\n            description=escape(self.song_name),\n            message=message,\n            completed=self.progress,\n        )\n\n        # If task is complete\n        if self.progress == 100 or message == \"Error\":\n            self.parent.overall_completed_tasks += 1\n            self.parent.rich_progress_bar.remove_task(self.task_id)\n    else:\n        # If task is complete\n        if self.progress == 100 or message == \"Error\":\n            self.parent.overall_completed_tasks += 1\n\n        # When running web ui print progress\n        # only one time when downloading/converting/embedding\n        if self.parent.web_ui and old_message != self.status:\n            logger.info(\"%s: %s\", self.song_name, message)\n        elif not self.parent.web_ui and delta:\n            logger.info(\"%s: %s\", self.song_name, message)\n\n    # Update the overall progress bar\n    if self.parent.song_count == self.parent.overall_completed_tasks:\n        self.parent.overall_progress = self.parent.song_count * 100\n    else:\n        self.parent.overall_progress += delta\n\n    self.parent.update_overall()\n    self.old_progress = self.progress\n\n    if self.parent.update_callback:\n        self.parent.update_callback(self, message)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook","title":"<code>yt_dlp_progress_hook(data)</code>","text":"<p>Updates the progress.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook--arguments","title":"Arguments","text":"<ul> <li>progress: The progress to update to.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def yt_dlp_progress_hook(self, data: Dict[str, Any]) -&gt; None:\n    \"\"\"\n    Updates the progress.\n\n    ### Arguments\n    - progress: The progress to update to.\n    \"\"\"\n\n    if data[\"status\"] == \"downloading\":\n        file_bytes = data.get(\"total_bytes\")\n        if file_bytes is None:\n            file_bytes = data.get(\"total_bytes_estimate\")\n\n        downloaded_bytes = data.get(\"downloaded_bytes\")\n        if self.parent.simple_tui and not self.parent.web_ui:\n            self.progress = 50\n        elif file_bytes and downloaded_bytes:\n            self.progress = downloaded_bytes / file_bytes * 50\n\n        self.update(\"Downloading\")\n</code></pre>"},{"location":"reference/providers/","title":"providers","text":"<p>Different types of data providers for spotdl.</p>"},{"location":"reference/providers/audio/","title":"audio","text":"<p>Audio providers for spotdl.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider","title":"<code>AudioProvider(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>Base class for all other providers. Provides some common functionality. Handles the yt-dlp audio handler.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.name","title":"<code>name: str</code>  <code>property</code>","text":"<p>Get the name of the provider.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.name--returns","title":"Returns","text":"<ul> <li>The name of the provider.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_best_result","title":"<code>get_best_result(results)</code>","text":"<p>Get the best match from the results using views and average match</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_best_result--arguments","title":"Arguments","text":"<ul> <li>results: A dictionary of results and their scores</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_best_result--returns","title":"Returns","text":"<ul> <li>The best match URL and its score</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_best_result(self, results: Dict[Result, float]) -&gt; Tuple[Result, float]:\n    \"\"\"\n    Get the best match from the results\n    using views and average match\n\n    ### Arguments\n    - results: A dictionary of results and their scores\n\n    ### Returns\n    - The best match URL and its score\n    \"\"\"\n\n    best_results = get_best_matches(results, 8)\n\n    # If we have only one result, return it\n    if len(best_results) == 1:\n        return best_results[0][0], best_results[0][1]\n\n    # Initial best result based on the average match\n    best_result = best_results[0]\n\n    # If the best result has a score higher than 80%\n    # and it's a isrc search, return it\n    if best_result[1] &gt; 80 and best_result[0].isrc_search:\n        return best_result[0], best_result[1]\n\n    # If we have more than one result,\n    # return the one with the highest score\n    # and most views\n    if len(best_results) &gt; 1:\n        views: List[int] = []\n        for best_result in best_results:\n            if best_result[0].views:\n                views.append(best_result[0].views)\n            else:\n                views.append(self.get_views(best_result[0].url))\n\n        highest_views = max(views)\n        lowest_views = min(views)\n\n        if highest_views in (0, lowest_views):\n            return best_result[0], best_result[1]\n\n        weighted_results: List[Tuple[Result, float]] = []\n        for index, best_result in enumerate(best_results):\n            result_views = views[index]\n            views_score = (\n                (result_views - lowest_views) / (highest_views - lowest_views)\n            ) * 15\n            score = min(best_result[1] + views_score, 100)\n            weighted_results.append((best_result[0], score))\n\n        # Now we return the result with the highest score\n        return max(weighted_results, key=lambda x: x[1])\n\n    return best_result[0], best_result[1]\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    try:\n        data = self.audio_handler.extract_info(url, download=download)\n\n        if data:\n            return data\n    except Exception as exception:\n        logger.debug(exception)\n        raise AudioProviderError(f\"YT-DLP download error - {url}\") from exception\n\n    raise AudioProviderError(f\"No metadata found for the provided url {url}\")\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from audio provider.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_results--returns","title":"Returns","text":"<ul> <li>A list of results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from audio provider.\n\n    ### Arguments\n    - search_term: The search term to use.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A list of results.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_views","title":"<code>get_views(url)</code>","text":"<p>Get the number of views for a video.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_views--arguments","title":"Arguments","text":"<ul> <li>url: The url of the video.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_views--returns","title":"Returns","text":"<ul> <li>The number of views.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_views(self, url: str) -&gt; int:\n    \"\"\"\n    Get the number of views for a video.\n\n    ### Arguments\n    - url: The url of the video.\n\n    ### Returns\n    - The number of views.\n    \"\"\"\n\n    data = self.get_download_metadata(url)\n\n    return data[\"view_count\"]\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.search","title":"<code>search(song, only_verified=False)</code>","text":"<p>Search for a song and return best match.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.search--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.search--returns","title":"Returns","text":"<ul> <li>The url of the best match or None if no match was found.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def search(self, song: Song, only_verified: bool = False) -&gt; Optional[str]:\n    \"\"\"\n    Search for a song and return best match.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - The url of the best match or None if no match was found.\n    \"\"\"\n\n    # Create initial search query\n    search_query = create_song_title(song.name, song.artists).lower()\n    if self.search_query:\n        search_query = create_search_query(\n            song, self.search_query, False, None, True\n        )\n\n    logger.debug(\"[%s] Searching for %s\", song.song_id, search_query)\n\n    isrc_urls: List[str] = []\n\n    # search for song using isrc if it's available\n    if song.isrc and self.SUPPORTS_ISRC and not self.search_query:\n        isrc_results = self.get_results(song.isrc)\n\n        if only_verified:\n            isrc_results = [result for result in isrc_results if result.verified]\n            logger.debug(\n                \"[%s] Filtered to %s verified ISRC results\",\n                song.song_id,\n                len(isrc_results),\n            )\n\n        isrc_urls = [result.url for result in isrc_results]\n        logger.debug(\n            \"[%s] Found %s results for ISRC %s\",\n            song.song_id,\n            len(isrc_results),\n            song.isrc,\n        )\n\n        if len(isrc_results) == 1 and isrc_results[0].verified:\n            # If we only have one verified result, return it\n            # What's the chance of it being wrong?\n            logger.debug(\n                \"[%s] Returning only ISRC result %s\",\n                song.song_id,\n                isrc_results[0].url,\n            )\n\n            return isrc_results[0].url\n\n        if len(isrc_results) &gt; 0:\n            sorted_isrc_results = order_results(\n                isrc_results, song, self.search_query\n            )\n\n            # get the best result, if the score is above 80 return it\n            best_isrc_results = sorted(\n                sorted_isrc_results.items(), key=lambda x: x[1], reverse=True\n            )\n\n            logger.debug(\n                \"[%s] Filtered to %s ISRC results\",\n                song.song_id,\n                len(best_isrc_results),\n            )\n\n            if len(best_isrc_results) &gt; 0:\n                best_isrc = best_isrc_results[0]\n                if best_isrc[1] &gt; 80.0:\n                    logger.debug(\n                        \"[%s] Best ISRC result is %s with score %s\",\n                        song.song_id,\n                        best_isrc[0].url,\n                        best_isrc[1],\n                    )\n\n                    return best_isrc[0].url\n\n    results: Dict[Result, float] = {}\n    for options in self.GET_RESULTS_OPTS:\n        # Query YTM by songs only first, this way if we get correct result on the first try\n        # we don't have to make another request\n        search_results = self.get_results(search_query, **options)\n\n        if only_verified:\n            search_results = [\n                result for result in search_results if result.verified\n            ]\n\n        logger.debug(\n            \"[%s] Found %s results for search query %s with options %s\",\n            song.song_id,\n            len(search_results),\n            search_query,\n            options,\n        )\n\n        # Check if any of the search results is in the\n        # first isrc results, since they are not hashable we have to check\n        # by name\n        isrc_result = next(\n            (result for result in search_results if result.url in isrc_urls),\n            None,\n        )\n\n        if isrc_result:\n            logger.debug(\n                \"[%s] Best ISRC result is %s\", song.song_id, isrc_result.url\n            )\n\n            return isrc_result.url\n\n        logger.debug(\n            \"[%s] Have to filter results: %s\", song.song_id, self.filter_results\n        )\n\n        if self.filter_results:\n            # Order results\n            new_results = order_results(search_results, song, self.search_query)\n        else:\n            new_results = {}\n            if len(search_results) &gt; 0:\n                new_results = {search_results[0]: 100.0}\n\n        logger.debug(\"[%s] Filtered to %s results\", song.song_id, len(new_results))\n\n        # song type results are always more accurate than video type,\n        # so if we get score of 80 or above\n        # we are almost 100% sure that this is the correct link\n        if len(new_results) != 0:\n            # get the result with highest score\n            best_result, best_score = self.get_best_result(new_results)\n            logger.debug(\n                \"[%s] Best result is %s with score %s\",\n                song.song_id,\n                best_result.url,\n                best_score,\n            )\n\n            if best_score &gt;= 80 and best_result.verified:\n                logger.debug(\n                    \"[%s] Returning verified best result %s with score %s\",\n                    song.song_id,\n                    best_result.url,\n                    best_score,\n                )\n\n                return best_result.url\n\n            # Update final results with new results\n            results.update(new_results)\n\n    # No matches found\n    if not results:\n        logger.debug(\"[%s] No results found\", song.song_id)\n        return None\n\n    # get the result with highest score\n    best_result, best_score = self.get_best_result(results)\n    logger.debug(\n        \"[%s] Returning best result %s with score %s\",\n        song.song_id,\n        best_result.url,\n        best_score,\n    )\n\n    return best_result.url\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProviderError","title":"<code>AudioProviderError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to audio searching/downloading.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp","title":"<code>BandCamp(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    try:\n        results = search(search_term)\n    except KeyError:\n        return []\n    except Exception as exc:\n        logger.error(\"Failed to get results from BandCamp\", exc_info=exc)\n        return []\n\n    simplified_results: List[Result] = []\n    for result in results:\n        track = BandCampTrack(int(result[0]), int(result[1]))\n\n        simplified_results.append(\n            Result(\n                source=\"bandcamp\",\n                url=track.track_url,\n                verified=False,\n                name=track.track_title,\n                duration=track.track_duration_seconds,\n                author=track.artist_title,\n                result_id=track.track_url,\n                search_query=search_term,\n                album=track.album_title,\n                artists=tuple(track.artist_title.split(\", \")),\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped","title":"<code>Piped(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def __init__(  # pylint: disable=super-init-not-called\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Pipe audio provider class\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"best[ext=m4a]/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"best[ext=webm]/best\"\n    else:\n        ytdl_format = \"best\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": f\"{get_temp_path()}/%(id)s.%(ext)s\",\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        user_options = args_to_ytdlp_options(shlex.split(yt_dlp_args))\n        yt_dlp_options.update(user_options)\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n    self.session = requests.Session()\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    url_id = url.split(\"?v=\")[1]\n    piped_response = requests.get(\n        f\"https://piped.video/streams/{url_id}\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    if piped_response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get metadata for {url} from Piped: {piped_response.text}\"\n        )\n\n    piped_data = piped_response.json()\n\n    yt_dlp_json = {\n        \"title\": piped_data[\"title\"],\n        \"id\": url_id,\n        \"view_count\": piped_data[\"views\"],\n        \"extractor\": \"Generic\",\n        \"formats\": [],\n    }\n\n    for audio_stream in piped_data[\"audioStreams\"]:\n        yt_dlp_json[\"formats\"].append(\n            {\n                \"url\": audio_stream[\"url\"],\n                \"ext\": \"webm\" if audio_stream[\"codec\"] == \"opus\" else \"m4a\",\n                \"abr\": audio_stream[\"quality\"].split(\" \")[0],\n                \"filesize\": audio_stream[\"contentLength\"],\n            }\n        )\n\n    return self.audio_handler.process_video_result(yt_dlp_json, download=download)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    if kwargs is None:\n        kwargs = {}\n\n    params = {\"q\": search_term, **kwargs}\n    if params.get(\"filter\") is None:\n        params[\"filter\"] = \"music_videos\"\n\n    response = self.session.get(\n        \"https://piped.video/search\",\n        params=params,\n        headers=HEADERS,\n        timeout=20,\n    )\n\n    if response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get results for {search_term} from Piped: {response.text}\"\n        )\n\n    search_results = response.json()\n\n    # Simplify results\n    results = []\n    for result in search_results[\"items\"]:\n        if result[\"type\"] != \"stream\":\n            continue\n\n        isrc_result = ISRC_REGEX.search(search_term)\n\n        results.append(\n            Result(\n                source=\"piped\",\n                url=f\"https://piped.video{result['url']}\",\n                verified=kwargs.get(\"filter\") == \"music_songs\",\n                name=result[\"title\"],\n                duration=result[\"duration\"],\n                author=result[\"uploaderName\"],\n                result_id=result[\"url\"].split(\"?v=\")[1],\n                artists=(\n                    (result[\"uploaderName\"],)\n                    if kwargs.get(\"filter\") == \"music_songs\"\n                    else None\n                ),\n                isrc_search=isrc_result is not None,\n                search_query=search_term,\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud","title":"<code>SoundCloud(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the SoundCloud API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n    self.client = SoundCloudClient()\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    results = list(islice(self.client.search(search_term), 20))\n    regex = r\"^(.+?)-|(\\(\\w+[\\s\\S]*\\))\"\n    # Because anyone can post on soundcloud, we do another search with an edited search\n    # The regex removes anything in brackets and the artist(s)'s name(s) if in the name\n    edited_search_term = re.sub(regex, \"\", search_term)\n    results.extend(list(islice(self.client.search(edited_search_term), 20)))\n\n    # Simplify results\n    simplified_results = []\n    for result in results:\n        if not isinstance(result, Track):\n            continue\n\n        # Ignore results that are not playable\n        if \"/preview/\" in result.media.transcodings[0].url:\n            continue\n\n        album = self.client.get_track_albums(result.id)\n\n        try:\n            album_name = next(album).title\n        except StopIteration:\n            album_name = None\n\n        simplified_results.append(\n            Result(\n                source=\"soundcloud\",\n                url=result.permalink_url,\n                name=result.title,\n                verified=result.user.verified,\n                duration=result.full_duration,\n                author=result.user.username,\n                result_id=str(result.id),\n                isrc_search=False,\n                search_query=search_term,\n                views=result.playback_count,\n                explicit=False,\n                album=album_name,\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger","title":"<code>YTDLLogger</code>","text":"<p>Custom YT-dlp logger.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger.debug","title":"<code>debug(msg)</code>","text":"<p>YTDL uses this to print debug messages.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def debug(self, msg):\n    \"\"\"\n    YTDL uses this to print debug messages.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger.error","title":"<code>error(msg)</code>","text":"<p>YTDL uses this to print errors.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def error(self, msg):\n    \"\"\"\n    YTDL uses this to print errors.\n    \"\"\"\n\n    raise AudioProviderError(msg)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger.warning","title":"<code>warning(msg)</code>","text":"<p>YTDL uses this to print warnings.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def warning(self, msg):\n    \"\"\"\n    YTDL uses this to print warnings.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube","title":"<code>YouTube(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from YouTube</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube.get_results--returns","title":"Returns","text":"<ul> <li>A list of YouTube results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/youtube.py</code> <pre><code>def get_results(\n    self, search_term: str, *_args, **_kwargs\n) -&gt; List[Result]:  # pylint: disable=W0221\n    \"\"\"\n    Get results from YouTube\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of YouTube results if found, None otherwise.\n    \"\"\"\n\n    search_results: Optional[List[PyTube]] = Search(search_term).results\n\n    if not search_results:\n        return []\n\n    results = []\n    for result in search_results:\n        if result.watch_url:\n            try:\n                duration = result.length\n            except Exception:\n                duration = 0\n\n            try:\n                views = result.views\n            except Exception:\n                views = 0\n\n            results.append(\n                Result(\n                    source=self.name,\n                    url=result.watch_url,\n                    verified=False,\n                    name=result.title,\n                    duration=duration,\n                    author=result.author,\n                    search_query=search_term,\n                    views=views,\n                    result_id=result.video_id,\n                )\n            )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic","title":"<code>YouTubeMusic(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the YouTube Music API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n\n    self.client = YTMusic(language=\"de\")\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    is_isrc_result = ISRC_REGEX.search(search_term) is not None\n    # if is_isrc_result:\n    #     print(\"FORCEFULLY SETTING FILTER TO SONGS\")\n    #     kwargs[\"filter\"] = \"songs\"\n\n    search_results = self.client.search(search_term, **kwargs)\n\n    # Simplify results\n    results = []\n    for result in search_results:\n        if (\n            result is None\n            or result.get(\"videoId\") is None\n            or result.get(\"artists\") in [[], None]\n        ):\n            continue\n\n        results.append(\n            Result(\n                source=self.name,\n                url=(\n                    f'https://{\"music\" if result[\"resultType\"] == \"song\" else \"www\"}'\n                    f\".youtube.com/watch?v={result['videoId']}\"\n                ),\n                verified=result.get(\"resultType\") == \"song\",\n                name=result[\"title\"],\n                result_id=result[\"videoId\"],\n                author=result[\"artists\"][0][\"name\"],\n                artists=tuple(map(lambda a: a[\"name\"], result[\"artists\"])),\n                duration=parse_duration(result.get(\"duration\")),\n                isrc_search=is_isrc_result,\n                search_query=search_term,\n                explicit=result.get(\"isExplicit\"),\n                album=(\n                    result.get(\"album\", {}).get(\"name\")\n                    if result.get(\"album\")\n                    else None\n                ),\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/","title":"bandcamp","text":"<p>BandCamp module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp","title":"<code>BandCamp(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    try:\n        results = search(search_term)\n    except KeyError:\n        return []\n    except Exception as exc:\n        logger.error(\"Failed to get results from BandCamp\", exc_info=exc)\n        return []\n\n    simplified_results: List[Result] = []\n    for result in results:\n        track = BandCampTrack(int(result[0]), int(result[1]))\n\n        simplified_results.append(\n            Result(\n                source=\"bandcamp\",\n                url=track.track_url,\n                verified=False,\n                name=track.track_title,\n                duration=track.track_duration_seconds,\n                author=track.artist_title,\n                result_id=track.track_url,\n                search_query=search_term,\n                album=track.album_title,\n                artists=tuple(track.artist_title.split(\", \")),\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCampTrack","title":"<code>BandCampTrack(artist_id, track_id)</code>","text":"<p>BandCamp track class based on the bandcamp_api library</p> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def __init__(self, artist_id: int, track_id: int):\n    # object info\n    self.type = \"track\"\n\n    # track information\n    self.track_id: int = 0\n    self.track_title: str = \"\"\n    self.track_number: int = 0\n    self.track_duration_seconds: float = 0.00\n    self.track_streamable: Optional[bool] = None\n    self.has_lyrics: Optional[bool] = None\n    self.lyrics: str = \"\"\n    self.is_price_set: Optional[bool] = None\n    self.price: dict = {}\n    self.require_email: Optional[bool] = None\n    self.is_purchasable: Optional[bool] = None\n    self.is_free: Optional[bool] = None\n    self.is_preorder: Optional[bool] = None\n    self.tags: list = []\n    self.track_url: str = \"\"\n\n    # art\n    self.art_id: int = 0\n    self.art_url: str = \"\"\n\n    # artist information\n    self.artist_id: int = 0\n    self.artist_title: str = \"\"\n\n    # album information\n    self.album_id: int = 0\n    self.album_title: str = \"\"\n\n    # label\n    self.label_id: int = 0\n    self.label_title: str = \"\"\n\n    # about\n    self.about: str = \"\"\n    self.credits: str = \"\"\n    self.date_released_unix: int = 0\n\n    # advanced\n    self.date_last_modified_unix: int = 0\n    self.date_published_unix: int = 0\n    self.supporters: list = []\n\n    response = requests.get(\n        url=\"https://bandcamp.com/api/mobile/25/tralbum_details?band_id=\"\n        + str(artist_id)\n        + \"&amp;tralbum_id=\"\n        + str(track_id)\n        + \"&amp;tralbum_type=t\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    result = response.json()\n    self.track_id = result[\"id\"]\n    self.track_title = result[\"title\"]\n    self.track_number = result[\"tracks\"][0][\"track_num\"]\n    self.track_duration_seconds = result[\"tracks\"][0][\"duration\"]\n    self.track_streamable = result[\"tracks\"][0][\"is_streamable\"]\n    self.has_lyrics = result[\"tracks\"][0][\"has_lyrics\"]\n\n    # getting lyrics, if there is any\n    if self.has_lyrics is True:\n        resp = requests.get(\n            \"https://bandcamp.com/api/mobile/25/tralbum_lyrics?tralbum_id=\"\n            + str(self.track_id)\n            + \"&amp;tralbum_type=t\",\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        )\n        rjson = resp.json()\n        self.lyrics = rjson[\"lyrics\"][str(self.track_id)]\n\n    self.is_price_set = result[\"is_set_price\"]\n    self.price = {\"currency\": result[\"currency\"], \"amount\": result[\"price\"]}\n    self.require_email = result[\"require_email\"]\n    self.is_purchasable = result[\"is_purchasable\"]\n    self.is_free = result[\"free_download\"]\n    self.is_preorder = result[\"is_preorder\"]\n\n    for tag in result[\"tags\"]:\n        self.tags.append(tag[\"name\"])\n\n    self.art_id = result[\"art_id\"]\n    self.art_url = \"https://f4.bcbits.com/img/a\" + str(self.art_id) + \"_0.jpg\"\n\n    self.artist_id = result[\"band\"][\"band_id\"]\n    self.artist_title = result[\"band\"][\"name\"]\n\n    self.album_id = result[\"album_id\"]\n    self.album_title = result[\"album_title\"]\n\n    self.label_id = result[\"label_id\"]\n    self.label_title = result[\"label\"]\n\n    self.about = result[\"about\"]\n    self.credits = result[\"credits\"]\n\n    self.date_released_unix = result[\"release_date\"]\n\n    self.track_url = result[\"bandcamp_url\"]\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.search","title":"<code>search(search_string='')</code>","text":"<p>I got this api url from the iOS app needs a way of removing characters that will screw up an url keep url safe characters</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.search--arguments","title":"Arguments","text":"<ul> <li>search_string: The search term to search for.</li> </ul>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.search--returns","title":"Returns","text":"<ul> <li>A list of artist and track ids if found</li> </ul> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def search(search_string: str = \"\"):\n    \"\"\"\n    I got this api url from the iOS app\n    needs a way of removing characters\n    that will screw up an url\n    keep url safe characters\n\n    ### Arguments\n    - search_string: The search term to search for.\n\n    ### Returns\n    - A list of artist and track ids if found\n    \"\"\"\n\n    response = requests.get(\n        \"https://bandcamp.com/api/fuzzysearch/2/app_autocomplete?q=\"\n        + search_string\n        + \"&amp;param_with_locations=true\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    results = response.json()[\"results\"]\n\n    return_results: List[Tuple[str, str]] = []\n\n    for item in results:\n        if item[\"type\"] == \"t\":\n            return_results.append((item[\"band_id\"], item[\"id\"]))\n\n    return return_results\n</code></pre>"},{"location":"reference/providers/audio/base/","title":"base","text":"<p>Base audio provider module.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider","title":"<code>AudioProvider(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>Base class for all other providers. Provides some common functionality. Handles the yt-dlp audio handler.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.name","title":"<code>name: str</code>  <code>property</code>","text":"<p>Get the name of the provider.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.name--returns","title":"Returns","text":"<ul> <li>The name of the provider.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_best_result","title":"<code>get_best_result(results)</code>","text":"<p>Get the best match from the results using views and average match</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_best_result--arguments","title":"Arguments","text":"<ul> <li>results: A dictionary of results and their scores</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_best_result--returns","title":"Returns","text":"<ul> <li>The best match URL and its score</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_best_result(self, results: Dict[Result, float]) -&gt; Tuple[Result, float]:\n    \"\"\"\n    Get the best match from the results\n    using views and average match\n\n    ### Arguments\n    - results: A dictionary of results and their scores\n\n    ### Returns\n    - The best match URL and its score\n    \"\"\"\n\n    best_results = get_best_matches(results, 8)\n\n    # If we have only one result, return it\n    if len(best_results) == 1:\n        return best_results[0][0], best_results[0][1]\n\n    # Initial best result based on the average match\n    best_result = best_results[0]\n\n    # If the best result has a score higher than 80%\n    # and it's a isrc search, return it\n    if best_result[1] &gt; 80 and best_result[0].isrc_search:\n        return best_result[0], best_result[1]\n\n    # If we have more than one result,\n    # return the one with the highest score\n    # and most views\n    if len(best_results) &gt; 1:\n        views: List[int] = []\n        for best_result in best_results:\n            if best_result[0].views:\n                views.append(best_result[0].views)\n            else:\n                views.append(self.get_views(best_result[0].url))\n\n        highest_views = max(views)\n        lowest_views = min(views)\n\n        if highest_views in (0, lowest_views):\n            return best_result[0], best_result[1]\n\n        weighted_results: List[Tuple[Result, float]] = []\n        for index, best_result in enumerate(best_results):\n            result_views = views[index]\n            views_score = (\n                (result_views - lowest_views) / (highest_views - lowest_views)\n            ) * 15\n            score = min(best_result[1] + views_score, 100)\n            weighted_results.append((best_result[0], score))\n\n        # Now we return the result with the highest score\n        return max(weighted_results, key=lambda x: x[1])\n\n    return best_result[0], best_result[1]\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    try:\n        data = self.audio_handler.extract_info(url, download=download)\n\n        if data:\n            return data\n    except Exception as exception:\n        logger.debug(exception)\n        raise AudioProviderError(f\"YT-DLP download error - {url}\") from exception\n\n    raise AudioProviderError(f\"No metadata found for the provided url {url}\")\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from audio provider.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_results--returns","title":"Returns","text":"<ul> <li>A list of results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from audio provider.\n\n    ### Arguments\n    - search_term: The search term to use.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A list of results.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_views","title":"<code>get_views(url)</code>","text":"<p>Get the number of views for a video.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_views--arguments","title":"Arguments","text":"<ul> <li>url: The url of the video.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_views--returns","title":"Returns","text":"<ul> <li>The number of views.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_views(self, url: str) -&gt; int:\n    \"\"\"\n    Get the number of views for a video.\n\n    ### Arguments\n    - url: The url of the video.\n\n    ### Returns\n    - The number of views.\n    \"\"\"\n\n    data = self.get_download_metadata(url)\n\n    return data[\"view_count\"]\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.search","title":"<code>search(song, only_verified=False)</code>","text":"<p>Search for a song and return best match.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.search--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.search--returns","title":"Returns","text":"<ul> <li>The url of the best match or None if no match was found.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def search(self, song: Song, only_verified: bool = False) -&gt; Optional[str]:\n    \"\"\"\n    Search for a song and return best match.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - The url of the best match or None if no match was found.\n    \"\"\"\n\n    # Create initial search query\n    search_query = create_song_title(song.name, song.artists).lower()\n    if self.search_query:\n        search_query = create_search_query(\n            song, self.search_query, False, None, True\n        )\n\n    logger.debug(\"[%s] Searching for %s\", song.song_id, search_query)\n\n    isrc_urls: List[str] = []\n\n    # search for song using isrc if it's available\n    if song.isrc and self.SUPPORTS_ISRC and not self.search_query:\n        isrc_results = self.get_results(song.isrc)\n\n        if only_verified:\n            isrc_results = [result for result in isrc_results if result.verified]\n            logger.debug(\n                \"[%s] Filtered to %s verified ISRC results\",\n                song.song_id,\n                len(isrc_results),\n            )\n\n        isrc_urls = [result.url for result in isrc_results]\n        logger.debug(\n            \"[%s] Found %s results for ISRC %s\",\n            song.song_id,\n            len(isrc_results),\n            song.isrc,\n        )\n\n        if len(isrc_results) == 1 and isrc_results[0].verified:\n            # If we only have one verified result, return it\n            # What's the chance of it being wrong?\n            logger.debug(\n                \"[%s] Returning only ISRC result %s\",\n                song.song_id,\n                isrc_results[0].url,\n            )\n\n            return isrc_results[0].url\n\n        if len(isrc_results) &gt; 0:\n            sorted_isrc_results = order_results(\n                isrc_results, song, self.search_query\n            )\n\n            # get the best result, if the score is above 80 return it\n            best_isrc_results = sorted(\n                sorted_isrc_results.items(), key=lambda x: x[1], reverse=True\n            )\n\n            logger.debug(\n                \"[%s] Filtered to %s ISRC results\",\n                song.song_id,\n                len(best_isrc_results),\n            )\n\n            if len(best_isrc_results) &gt; 0:\n                best_isrc = best_isrc_results[0]\n                if best_isrc[1] &gt; 80.0:\n                    logger.debug(\n                        \"[%s] Best ISRC result is %s with score %s\",\n                        song.song_id,\n                        best_isrc[0].url,\n                        best_isrc[1],\n                    )\n\n                    return best_isrc[0].url\n\n    results: Dict[Result, float] = {}\n    for options in self.GET_RESULTS_OPTS:\n        # Query YTM by songs only first, this way if we get correct result on the first try\n        # we don't have to make another request\n        search_results = self.get_results(search_query, **options)\n\n        if only_verified:\n            search_results = [\n                result for result in search_results if result.verified\n            ]\n\n        logger.debug(\n            \"[%s] Found %s results for search query %s with options %s\",\n            song.song_id,\n            len(search_results),\n            search_query,\n            options,\n        )\n\n        # Check if any of the search results is in the\n        # first isrc results, since they are not hashable we have to check\n        # by name\n        isrc_result = next(\n            (result for result in search_results if result.url in isrc_urls),\n            None,\n        )\n\n        if isrc_result:\n            logger.debug(\n                \"[%s] Best ISRC result is %s\", song.song_id, isrc_result.url\n            )\n\n            return isrc_result.url\n\n        logger.debug(\n            \"[%s] Have to filter results: %s\", song.song_id, self.filter_results\n        )\n\n        if self.filter_results:\n            # Order results\n            new_results = order_results(search_results, song, self.search_query)\n        else:\n            new_results = {}\n            if len(search_results) &gt; 0:\n                new_results = {search_results[0]: 100.0}\n\n        logger.debug(\"[%s] Filtered to %s results\", song.song_id, len(new_results))\n\n        # song type results are always more accurate than video type,\n        # so if we get score of 80 or above\n        # we are almost 100% sure that this is the correct link\n        if len(new_results) != 0:\n            # get the result with highest score\n            best_result, best_score = self.get_best_result(new_results)\n            logger.debug(\n                \"[%s] Best result is %s with score %s\",\n                song.song_id,\n                best_result.url,\n                best_score,\n            )\n\n            if best_score &gt;= 80 and best_result.verified:\n                logger.debug(\n                    \"[%s] Returning verified best result %s with score %s\",\n                    song.song_id,\n                    best_result.url,\n                    best_score,\n                )\n\n                return best_result.url\n\n            # Update final results with new results\n            results.update(new_results)\n\n    # No matches found\n    if not results:\n        logger.debug(\"[%s] No results found\", song.song_id)\n        return None\n\n    # get the result with highest score\n    best_result, best_score = self.get_best_result(results)\n    logger.debug(\n        \"[%s] Returning best result %s with score %s\",\n        song.song_id,\n        best_result.url,\n        best_score,\n    )\n\n    return best_result.url\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProviderError","title":"<code>AudioProviderError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to audio searching/downloading.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger","title":"<code>YTDLLogger</code>","text":"<p>Custom YT-dlp logger.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger.debug","title":"<code>debug(msg)</code>","text":"<p>YTDL uses this to print debug messages.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def debug(self, msg):\n    \"\"\"\n    YTDL uses this to print debug messages.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger.error","title":"<code>error(msg)</code>","text":"<p>YTDL uses this to print errors.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def error(self, msg):\n    \"\"\"\n    YTDL uses this to print errors.\n    \"\"\"\n\n    raise AudioProviderError(msg)\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger.warning","title":"<code>warning(msg)</code>","text":"<p>YTDL uses this to print warnings.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def warning(self, msg):\n    \"\"\"\n    YTDL uses this to print warnings.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/piped/","title":"piped","text":"<p>Piped module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped","title":"<code>Piped(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def __init__(  # pylint: disable=super-init-not-called\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Pipe audio provider class\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"best[ext=m4a]/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"best[ext=webm]/best\"\n    else:\n        ytdl_format = \"best\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": f\"{get_temp_path()}/%(id)s.%(ext)s\",\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        user_options = args_to_ytdlp_options(shlex.split(yt_dlp_args))\n        yt_dlp_options.update(user_options)\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n    self.session = requests.Session()\n</code></pre>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    url_id = url.split(\"?v=\")[1]\n    piped_response = requests.get(\n        f\"https://piped.video/streams/{url_id}\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    if piped_response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get metadata for {url} from Piped: {piped_response.text}\"\n        )\n\n    piped_data = piped_response.json()\n\n    yt_dlp_json = {\n        \"title\": piped_data[\"title\"],\n        \"id\": url_id,\n        \"view_count\": piped_data[\"views\"],\n        \"extractor\": \"Generic\",\n        \"formats\": [],\n    }\n\n    for audio_stream in piped_data[\"audioStreams\"]:\n        yt_dlp_json[\"formats\"].append(\n            {\n                \"url\": audio_stream[\"url\"],\n                \"ext\": \"webm\" if audio_stream[\"codec\"] == \"opus\" else \"m4a\",\n                \"abr\": audio_stream[\"quality\"].split(\" \")[0],\n                \"filesize\": audio_stream[\"contentLength\"],\n            }\n        )\n\n    return self.audio_handler.process_video_result(yt_dlp_json, download=download)\n</code></pre>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    if kwargs is None:\n        kwargs = {}\n\n    params = {\"q\": search_term, **kwargs}\n    if params.get(\"filter\") is None:\n        params[\"filter\"] = \"music_videos\"\n\n    response = self.session.get(\n        \"https://piped.video/search\",\n        params=params,\n        headers=HEADERS,\n        timeout=20,\n    )\n\n    if response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get results for {search_term} from Piped: {response.text}\"\n        )\n\n    search_results = response.json()\n\n    # Simplify results\n    results = []\n    for result in search_results[\"items\"]:\n        if result[\"type\"] != \"stream\":\n            continue\n\n        isrc_result = ISRC_REGEX.search(search_term)\n\n        results.append(\n            Result(\n                source=\"piped\",\n                url=f\"https://piped.video{result['url']}\",\n                verified=kwargs.get(\"filter\") == \"music_songs\",\n                name=result[\"title\"],\n                duration=result[\"duration\"],\n                author=result[\"uploaderName\"],\n                result_id=result[\"url\"].split(\"?v=\")[1],\n                artists=(\n                    (result[\"uploaderName\"],)\n                    if kwargs.get(\"filter\") == \"music_songs\"\n                    else None\n                ),\n                isrc_search=isrc_result is not None,\n                search_query=search_term,\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/sliderkz/","title":"sliderkz","text":"<p>SliderKZ module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ","title":"<code>SliderKZ(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>Slider.kz audio provider class</p>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/sliderkz.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    search_results = None\n    max_retries = 0\n\n    while not search_results and max_retries &lt; 3:\n        try:\n            search_response = requests.get(\n                url=\"https://hayqbhgr.slider.kz/vk_auth.php?q=\" + search_term,\n                headers=HEADERS,\n                timeout=5,\n                proxies=GlobalConfig.get_parameter(\"proxies\"),\n            )\n\n            # Check if the response is valid\n            if len(search_response.text) &gt; 30:\n                # Set the search results to the json response\n                # effectively breaking out of the loop\n                search_results = search_response.json()\n\n        except Exception as exc:\n            logger.debug(\n                \"Slider.kz search failed for query %s with error: %s. Retrying...\",\n                search_term,\n                exc,\n            )\n\n        max_retries += 1\n\n    if not search_results:\n        logger.debug(\"Slider.kz search failed for query %s\", search_term)\n        return []\n\n    results = []\n    for result in search_results[\"audios\"][\"\"]:\n        # urls from slider.kz sometimes are relative, so we need to add the domain\n        if \"https://\" not in result[\"url\"]:\n            result[\"url\"] = \"https://hayqbhgr.slider.kz/\" + result[\"url\"]\n\n        results.append(\n            Result(\n                source=\"slider.kz\",\n                url=result.get(\"url\"),\n                verified=False,\n                name=result.get(\"tit_art\"),\n                duration=int(result.get(\"duration\", -9999)),\n                author=\"slider.kz\",\n                result_id=result.get(\"id\"),\n                views=1,\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/soundcloud/","title":"soundcloud","text":"<p>SoundCloud module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud","title":"<code>SoundCloud(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the SoundCloud API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n    self.client = SoundCloudClient()\n</code></pre>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    results = list(islice(self.client.search(search_term), 20))\n    regex = r\"^(.+?)-|(\\(\\w+[\\s\\S]*\\))\"\n    # Because anyone can post on soundcloud, we do another search with an edited search\n    # The regex removes anything in brackets and the artist(s)'s name(s) if in the name\n    edited_search_term = re.sub(regex, \"\", search_term)\n    results.extend(list(islice(self.client.search(edited_search_term), 20)))\n\n    # Simplify results\n    simplified_results = []\n    for result in results:\n        if not isinstance(result, Track):\n            continue\n\n        # Ignore results that are not playable\n        if \"/preview/\" in result.media.transcodings[0].url:\n            continue\n\n        album = self.client.get_track_albums(result.id)\n\n        try:\n            album_name = next(album).title\n        except StopIteration:\n            album_name = None\n\n        simplified_results.append(\n            Result(\n                source=\"soundcloud\",\n                url=result.permalink_url,\n                name=result.title,\n                verified=result.user.verified,\n                duration=result.full_duration,\n                author=result.user.username,\n                result_id=str(result.id),\n                isrc_search=False,\n                search_query=search_term,\n                views=result.playback_count,\n                explicit=False,\n                album=album_name,\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/youtube/","title":"youtube","text":"<p>Youtube module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube","title":"<code>YouTube(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube audio provider class</p>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from YouTube</p>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube.get_results--returns","title":"Returns","text":"<ul> <li>A list of YouTube results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/youtube.py</code> <pre><code>def get_results(\n    self, search_term: str, *_args, **_kwargs\n) -&gt; List[Result]:  # pylint: disable=W0221\n    \"\"\"\n    Get results from YouTube\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of YouTube results if found, None otherwise.\n    \"\"\"\n\n    search_results: Optional[List[PyTube]] = Search(search_term).results\n\n    if not search_results:\n        return []\n\n    results = []\n    for result in search_results:\n        if result.watch_url:\n            try:\n                duration = result.length\n            except Exception:\n                duration = 0\n\n            try:\n                views = result.views\n            except Exception:\n                views = 0\n\n            results.append(\n                Result(\n                    source=self.name,\n                    url=result.watch_url,\n                    verified=False,\n                    name=result.title,\n                    duration=duration,\n                    author=result.author,\n                    search_query=search_term,\n                    views=views,\n                    result_id=result.video_id,\n                )\n            )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/ytmusic/","title":"ytmusic","text":"<p>YTMusic module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic","title":"<code>YouTubeMusic(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the YouTube Music API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n\n    self.client = YTMusic(language=\"de\")\n</code></pre>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    is_isrc_result = ISRC_REGEX.search(search_term) is not None\n    # if is_isrc_result:\n    #     print(\"FORCEFULLY SETTING FILTER TO SONGS\")\n    #     kwargs[\"filter\"] = \"songs\"\n\n    search_results = self.client.search(search_term, **kwargs)\n\n    # Simplify results\n    results = []\n    for result in search_results:\n        if (\n            result is None\n            or result.get(\"videoId\") is None\n            or result.get(\"artists\") in [[], None]\n        ):\n            continue\n\n        results.append(\n            Result(\n                source=self.name,\n                url=(\n                    f'https://{\"music\" if result[\"resultType\"] == \"song\" else \"www\"}'\n                    f\".youtube.com/watch?v={result['videoId']}\"\n                ),\n                verified=result.get(\"resultType\") == \"song\",\n                name=result[\"title\"],\n                result_id=result[\"videoId\"],\n                author=result[\"artists\"][0][\"name\"],\n                artists=tuple(map(lambda a: a[\"name\"], result[\"artists\"])),\n                duration=parse_duration(result.get(\"duration\")),\n                isrc_search=is_isrc_result,\n                search_query=search_term,\n                explicit=result.get(\"isExplicit\"),\n                album=(\n                    result.get(\"album\", {}).get(\"name\")\n                    if result.get(\"album\")\n                    else None\n                ),\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/","title":"lyrics","text":"<p>Lyrics providers for spotdl.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics","title":"<code>AzLyrics()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>AZLyrics lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def __init__(self):\n    super().__init__()\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n\n    self.x_code = self.get_x_code()\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    response = self.session.get(url)\n    soup = BeautifulSoup(response.content, \"html.parser\")\n\n    # Find all divs that don't have a class\n    div_tags = soup.find_all(\"div\", class_=False, id_=False)\n\n    # Find the div with the longest text\n    lyrics_div = sorted(div_tags, key=lambda x: len(x.text))[-1]\n\n    # extract lyrics from div and clean it up\n    lyrics = lyrics_div.get_text().strip()\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    if self.x_code is None:\n        self.x_code = self.get_x_code()\n\n    if self.x_code is None:\n        return {}\n\n    # Join every artist by comma in artists\n    artist_str = \", \".join(artist for artist in artists if artist)\n\n    params = {\n        \"q\": f\"{artist_str} - {name}\",\n        \"x\": self.x_code,\n    }\n\n    counter = 0\n    soup = None\n    while counter &lt; 4:\n        try:\n            response = self.session.get(\n                \"https://search.azlyrics.com/search.php\", params=params\n            )\n        except requests.ConnectionError:\n            continue\n\n        if not response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(response.content, \"html.parser\")\n        break\n\n    if soup is None:\n        return {}\n\n    td_tags = soup.find_all(\"td\")\n    if len(td_tags) == 0:\n        return {}\n\n    results = {}\n    for td_tag in td_tags:\n        a_tags = td_tag.find_all(\"a\", href=True)\n        if len(a_tags) == 0:\n            continue\n\n        a_tag = a_tags[0]\n        url = a_tag[\"href\"].strip()\n        if url == \"\":\n            continue\n\n        title = td_tag.find(\"span\").get_text().strip()\n        artist = td_tag.find(\"b\").get_text().strip()\n\n        results[f\"{artist} - {title}\"] = url\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_x_code","title":"<code>get_x_code()</code>","text":"<p>Returns the x_code used by AZLyrics.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_x_code--returns","title":"Returns","text":"<ul> <li>The x_code used by AZLyrics or None if it couldn't be retrieved.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_x_code(self) -&gt; Optional[str]:\n    \"\"\"\n    Returns the x_code used by AZLyrics.\n\n    ### Returns\n    - The x_code used by AZLyrics or None if it couldn't be retrieved.\n    \"\"\"\n\n    x_code = None\n\n    try:\n        self.session.get(\"https://www.azlyrics.com/\")\n\n        resp = self.session.get(\"https://www.azlyrics.com/geo.js\")\n\n        # extract value from js code\n        js_code = resp.text\n        start_index = js_code.find('value\"') + 9\n        end_index = js_code[start_index:].find('\");')\n\n        x_code = js_code[start_index : start_index + end_index]\n    except requests.ConnectionError:\n        pass\n\n    return x_code\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius","title":"<code>Genius(access_token)</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Genius lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def __init__(self, access_token: str):\n    \"\"\"\n    Init the lyrics provider search and set headers.\n    \"\"\"\n\n    super().__init__()\n\n    self.access_token = access_token\n\n    self.headers.update(\n        {\n            \"Authorization\": f\"Bearer {self.access_token}\",\n        }\n    )\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    url = f\"https://api.genius.com/songs/{url}\"\n    song_response = self.session.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    url = song_response.json()[\"response\"][\"song\"][\"url\"]\n\n    soup = None\n    counter = 0\n    while counter &lt; 4:\n        genius_page_response = self.session.get(\n            url,\n            headers=self.headers,\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        )\n\n        if not genius_page_response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(\n            genius_page_response.text.replace(\"&lt;br/&gt;\", \"\\n\"), \"html.parser\"\n        )\n\n        break\n\n    if soup is None:\n        return None\n\n    lyrics_div = soup.select_one(\"div.lyrics\")\n    lyrics_containers = soup.select(\"div[class^=Lyrics__Container]\")\n\n    # Get lyrics\n    if lyrics_div:\n        lyrics = lyrics_div.get_text()\n    elif lyrics_containers:\n        lyrics = \"\\n\".join(con.get_text() for con in lyrics_containers)\n    else:\n        return None\n\n    if not lyrics:\n        return None\n\n    # Clean lyrics\n    lyrics = lyrics.strip()\n\n    # Remove desc at the beginning if it exists\n    for to_remove in [\"desc\", \"Desc\"]:\n        lyrics.replace(to_remove, \"\", 1)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    artists_str = \", \".join(artists)\n    title = f\"{name} - {artists_str}\"\n\n    search_response = self.session.get(\n        \"https://api.genius.com/search\",\n        params={\"q\": title},\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    results: Dict[str, str] = {}\n    for hit in search_response.json()[\"response\"][\"hits\"]:\n        results[hit[\"result\"][\"full_title\"]] = hit[\"result\"][\"id\"]\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider","title":"<code>LyricsProvider()</code>","text":"<p>Base class for all other lyrics providers.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.name","title":"<code>name: str</code>  <code>property</code>","text":"<p>Returns the name of the lyrics provider.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Returns the lyrics for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Returns the lyrics for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n    try:\n        results = self.get_results(name, artists, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to get results for %s - %s: %s\",\n            self.name,\n            name,\n            \", \".join(artists),\n            exc,\n        )\n        return None\n\n    if not results:\n        return None\n\n    results_with_score = {}\n    for title, url in results.items():\n        result_title = slugify(title)\n        match_title = slugify(f\"{name} - {', '.join(artists)}\")\n\n        res_list, song_list = based_sort(\n            result_title.split(\"-\"), match_title.split(\"-\")\n        )\n        result_title, match_title = \"-\".join(res_list), \"-\".join(song_list)\n\n        score = ratio(result_title, match_title)\n        results_with_score[score] = url\n\n    if not results_with_score:\n        return None\n\n    # Get song url with highest title match\n    score, url = max(results_with_score.items(), key=lambda x: x[0])\n\n    # Only return lyrics if the title match is at least 55%\n    if score &lt; 55:\n        return None\n\n    try:\n        return self.extract_lyrics(url, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to extract lyrics from %s: %s\", self.name, url, exc\n        )\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch","title":"<code>MusixMatch()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>MusixMatch lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    lyrics_resp = requests.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    lyrics_soup = BeautifulSoup(lyrics_resp.text, \"html.parser\")\n    lyrics_paragraphs = lyrics_soup.select(\"p.mxm-lyrics__content\")\n    lyrics = \"\\n\".join(i.get_text() for i in lyrics_paragraphs)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    track_search = kwargs.get(\"track_search\", False)\n    artists_str = \", \".join(\n        artist for artist in artists if artist.lower() not in name.lower()\n    )\n\n    # quote the query so that it's safe to use in a url\n    # e.g \"Au/Ra\" -&gt; \"Au%2FRa\"\n    query = quote(f\"{name} - {artists_str}\", safe=\"\")\n\n    # search the `tracks page` if track_search is True\n    if track_search:\n        query += \"/tracks\"\n\n    search_url = f\"https://www.musixmatch.com/search/{query}\"\n    search_resp = requests.get(\n        search_url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    search_soup = BeautifulSoup(search_resp.text, \"html.parser\")\n    song_url_tag = search_soup.select(\"a[href^='/lyrics/']\")\n\n    if not song_url_tag:\n        # song_url_tag being None means no results were found on the\n        # All Results page, therefore, we use `track_search` to\n        # search the tracks page.\n\n        # track_serach being True means we are already searching the tracks page.\n        if track_search:\n            return {}\n\n        return self.get_results(name, artists, track_search=True)\n\n    results: Dict[str, str] = {}\n    for tag in song_url_tag:\n        results[tag.get_text()] = \"https://www.musixmatch.com\" + str(\n            tag.get(\"href\", \"\")\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced","title":"<code>Synced()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Lyrics provider for synced lyrics using the syncedlyrics library Currently supported websites: Deezer, NetEase</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Try to get lyrics using syncedlyrics</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Try to get lyrics using syncedlyrics\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    try:\n        lyrics = syncedlyrics.search(\n            f\"{name} - {artists[0]}\",\n            synced_only=not kwargs.get(\"allow_plain_format\", True),\n        )\n        return lyrics\n    except requests.exceptions.SSLError:\n        # Max retries reached\n        return None\n    except TypeError:\n        # Error at syncedlyrics.providers.musixmatch L89 -\n        #   Because `body` is occasionally an empty list instead of a dictionary.\n        # We get this error when allow_plain_format is set to True,\n        #   and there are no synced lyrics present\n        # Because its empty, we know there are no lyrics\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/","title":"azlyrics","text":"<p>AZLyrics lyrics module.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics","title":"<code>AzLyrics()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>AZLyrics lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def __init__(self):\n    super().__init__()\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n\n    self.x_code = self.get_x_code()\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    response = self.session.get(url)\n    soup = BeautifulSoup(response.content, \"html.parser\")\n\n    # Find all divs that don't have a class\n    div_tags = soup.find_all(\"div\", class_=False, id_=False)\n\n    # Find the div with the longest text\n    lyrics_div = sorted(div_tags, key=lambda x: len(x.text))[-1]\n\n    # extract lyrics from div and clean it up\n    lyrics = lyrics_div.get_text().strip()\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    if self.x_code is None:\n        self.x_code = self.get_x_code()\n\n    if self.x_code is None:\n        return {}\n\n    # Join every artist by comma in artists\n    artist_str = \", \".join(artist for artist in artists if artist)\n\n    params = {\n        \"q\": f\"{artist_str} - {name}\",\n        \"x\": self.x_code,\n    }\n\n    counter = 0\n    soup = None\n    while counter &lt; 4:\n        try:\n            response = self.session.get(\n                \"https://search.azlyrics.com/search.php\", params=params\n            )\n        except requests.ConnectionError:\n            continue\n\n        if not response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(response.content, \"html.parser\")\n        break\n\n    if soup is None:\n        return {}\n\n    td_tags = soup.find_all(\"td\")\n    if len(td_tags) == 0:\n        return {}\n\n    results = {}\n    for td_tag in td_tags:\n        a_tags = td_tag.find_all(\"a\", href=True)\n        if len(a_tags) == 0:\n            continue\n\n        a_tag = a_tags[0]\n        url = a_tag[\"href\"].strip()\n        if url == \"\":\n            continue\n\n        title = td_tag.find(\"span\").get_text().strip()\n        artist = td_tag.find(\"b\").get_text().strip()\n\n        results[f\"{artist} - {title}\"] = url\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code","title":"<code>get_x_code()</code>","text":"<p>Returns the x_code used by AZLyrics.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code--returns","title":"Returns","text":"<ul> <li>The x_code used by AZLyrics or None if it couldn't be retrieved.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_x_code(self) -&gt; Optional[str]:\n    \"\"\"\n    Returns the x_code used by AZLyrics.\n\n    ### Returns\n    - The x_code used by AZLyrics or None if it couldn't be retrieved.\n    \"\"\"\n\n    x_code = None\n\n    try:\n        self.session.get(\"https://www.azlyrics.com/\")\n\n        resp = self.session.get(\"https://www.azlyrics.com/geo.js\")\n\n        # extract value from js code\n        js_code = resp.text\n        start_index = js_code.find('value\"') + 9\n        end_index = js_code[start_index:].find('\");')\n\n        x_code = js_code[start_index : start_index + end_index]\n    except requests.ConnectionError:\n        pass\n\n    return x_code\n</code></pre>"},{"location":"reference/providers/lyrics/base/","title":"base","text":"<p>Base module for all other lyrics providers.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider","title":"<code>LyricsProvider()</code>","text":"<p>Base class for all other lyrics providers.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.name","title":"<code>name: str</code>  <code>property</code>","text":"<p>Returns the name of the lyrics provider.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Returns the lyrics for the given song.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Returns the lyrics for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n    try:\n        results = self.get_results(name, artists, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to get results for %s - %s: %s\",\n            self.name,\n            name,\n            \", \".join(artists),\n            exc,\n        )\n        return None\n\n    if not results:\n        return None\n\n    results_with_score = {}\n    for title, url in results.items():\n        result_title = slugify(title)\n        match_title = slugify(f\"{name} - {', '.join(artists)}\")\n\n        res_list, song_list = based_sort(\n            result_title.split(\"-\"), match_title.split(\"-\")\n        )\n        result_title, match_title = \"-\".join(res_list), \"-\".join(song_list)\n\n        score = ratio(result_title, match_title)\n        results_with_score[score] = url\n\n    if not results_with_score:\n        return None\n\n    # Get song url with highest title match\n    score, url = max(results_with_score.items(), key=lambda x: x[0])\n\n    # Only return lyrics if the title match is at least 55%\n    if score &lt; 55:\n        return None\n\n    try:\n        return self.extract_lyrics(url, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to extract lyrics from %s: %s\", self.name, url, exc\n        )\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/genius/","title":"genius","text":"<p>Genius Lyrics module.</p>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius","title":"<code>Genius(access_token)</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Genius lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def __init__(self, access_token: str):\n    \"\"\"\n    Init the lyrics provider search and set headers.\n    \"\"\"\n\n    super().__init__()\n\n    self.access_token = access_token\n\n    self.headers.update(\n        {\n            \"Authorization\": f\"Bearer {self.access_token}\",\n        }\n    )\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n</code></pre>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    url = f\"https://api.genius.com/songs/{url}\"\n    song_response = self.session.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    url = song_response.json()[\"response\"][\"song\"][\"url\"]\n\n    soup = None\n    counter = 0\n    while counter &lt; 4:\n        genius_page_response = self.session.get(\n            url,\n            headers=self.headers,\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        )\n\n        if not genius_page_response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(\n            genius_page_response.text.replace(\"&lt;br/&gt;\", \"\\n\"), \"html.parser\"\n        )\n\n        break\n\n    if soup is None:\n        return None\n\n    lyrics_div = soup.select_one(\"div.lyrics\")\n    lyrics_containers = soup.select(\"div[class^=Lyrics__Container]\")\n\n    # Get lyrics\n    if lyrics_div:\n        lyrics = lyrics_div.get_text()\n    elif lyrics_containers:\n        lyrics = \"\\n\".join(con.get_text() for con in lyrics_containers)\n    else:\n        return None\n\n    if not lyrics:\n        return None\n\n    # Clean lyrics\n    lyrics = lyrics.strip()\n\n    # Remove desc at the beginning if it exists\n    for to_remove in [\"desc\", \"Desc\"]:\n        lyrics.replace(to_remove, \"\", 1)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    artists_str = \", \".join(artists)\n    title = f\"{name} - {artists_str}\"\n\n    search_response = self.session.get(\n        \"https://api.genius.com/search\",\n        params={\"q\": title},\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    results: Dict[str, str] = {}\n    for hit in search_response.json()[\"response\"][\"hits\"]:\n        results[hit[\"result\"][\"full_title\"]] = hit[\"result\"][\"id\"]\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/musixmatch/","title":"musixmatch","text":"<p>MusixMatch lyrics provider.</p>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch","title":"<code>MusixMatch()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>MusixMatch lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    lyrics_resp = requests.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    lyrics_soup = BeautifulSoup(lyrics_resp.text, \"html.parser\")\n    lyrics_paragraphs = lyrics_soup.select(\"p.mxm-lyrics__content\")\n    lyrics = \"\\n\".join(i.get_text() for i in lyrics_paragraphs)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    track_search = kwargs.get(\"track_search\", False)\n    artists_str = \", \".join(\n        artist for artist in artists if artist.lower() not in name.lower()\n    )\n\n    # quote the query so that it's safe to use in a url\n    # e.g \"Au/Ra\" -&gt; \"Au%2FRa\"\n    query = quote(f\"{name} - {artists_str}\", safe=\"\")\n\n    # search the `tracks page` if track_search is True\n    if track_search:\n        query += \"/tracks\"\n\n    search_url = f\"https://www.musixmatch.com/search/{query}\"\n    search_resp = requests.get(\n        search_url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    search_soup = BeautifulSoup(search_resp.text, \"html.parser\")\n    song_url_tag = search_soup.select(\"a[href^='/lyrics/']\")\n\n    if not song_url_tag:\n        # song_url_tag being None means no results were found on the\n        # All Results page, therefore, we use `track_search` to\n        # search the tracks page.\n\n        # track_serach being True means we are already searching the tracks page.\n        if track_search:\n            return {}\n\n        return self.get_results(name, artists, track_search=True)\n\n    results: Dict[str, str] = {}\n    for tag in song_url_tag:\n        results[tag.get_text()] = \"https://www.musixmatch.com\" + str(\n            tag.get(\"href\", \"\")\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/synced/","title":"synced","text":"<p>Synced lyrics provider using the syncedlyrics library</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced","title":"<code>Synced()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Lyrics provider for synced lyrics using the syncedlyrics library Currently supported websites: Deezer, NetEase</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Try to get lyrics using syncedlyrics</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Try to get lyrics using syncedlyrics\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    try:\n        lyrics = syncedlyrics.search(\n            f\"{name} - {artists[0]}\",\n            synced_only=not kwargs.get(\"allow_plain_format\", True),\n        )\n        return lyrics\n    except requests.exceptions.SSLError:\n        # Max retries reached\n        return None\n    except TypeError:\n        # Error at syncedlyrics.providers.musixmatch L89 -\n        #   Because `body` is occasionally an empty list instead of a dictionary.\n        # We get this error when allow_plain_format is set to True,\n        #   and there are no synced lyrics present\n        # Because its empty, we know there are no lyrics\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/types/","title":"types","text":"<p>Types for the spotdl package.</p>"},{"location":"reference/types/album/","title":"album","text":"<p>Artist module for retrieving artist data from Spotify.</p>"},{"location":"reference/types/album/#spotdl.types.album.Album","title":"<code>Album(name, url, urls, songs, artist)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Album class for retrieving album data from Spotify.</p>"},{"location":"reference/types/album/#spotdl.types.album.Album.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for album.</p>"},{"location":"reference/types/album/#spotdl.types.album.Album.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the album.</li> </ul>"},{"location":"reference/types/album/#spotdl.types.album.Album.get_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary with metadata.</li> </ul> Source code in <code>spotdl/types/album.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for album.\n\n    ### Arguments\n    - url: The URL of the album.\n\n    ### Returns\n    - A dictionary with metadata.\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n\n    album_metadata = spotify_client.album(url)\n    if album_metadata is None:\n        raise AlbumError(\n            \"Couldn't get metadata, check if you have passed correct album id\"\n        )\n\n    metadata = {\n        \"name\": album_metadata[\"name\"],\n        \"artist\": album_metadata[\"artists\"][0],\n        \"url\": url,\n    }\n\n    album_response = spotify_client.album_tracks(url)\n    if album_response is None:\n        raise AlbumError(\n            \"Couldn't get metadata, check if you have passed correct album id\"\n        )\n\n    tracks = album_response[\"items\"]\n\n    # Get all tracks from album\n    while album_response[\"next\"]:\n        album_response = spotify_client.next(album_response)\n\n        # Failed to get response, break the loop\n        if album_response is None:\n            break\n\n        tracks.extend(album_response[\"items\"])\n\n    if album_response is None:\n        raise AlbumError(f\"Failed to get album response: {url}\")\n\n    songs = []\n    for track in tracks:\n        if not isinstance(track, dict) or track.get(\"is_local\"):\n            continue\n\n        release_date = album_metadata[\"release_date\"]\n        artists = artists = [artist[\"name\"] for artist in track[\"artists\"]]\n\n        song = Song.from_missing_data(\n            name=track[\"name\"],\n            artists=artists,\n            artist=artists[0],\n            album_id=album_metadata[\"id\"],\n            album_name=album_metadata[\"name\"],\n            album_artist=album_metadata[\"artists\"][0][\"name\"],\n            album_type=album_metadata[\"album_type\"],\n            disc_number=track[\"disc_number\"],\n            disc_count=int(album_metadata[\"tracks\"][\"items\"][-1][\"disc_number\"]),\n            duration=int(track[\"duration_ms\"] / 1000),\n            year=release_date[:4],\n            date=release_date,\n            track_number=track[\"track_number\"],\n            tracks_count=album_metadata[\"total_tracks\"],\n            song_id=track[\"id\"],\n            explicit=track[\"explicit\"],\n            publisher=album_metadata[\"label\"],\n            url=track[\"external_urls\"][\"spotify\"],\n            cover_url=(\n                max(\n                    album_metadata[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"]\n                )[\"url\"]\n                if album_metadata[\"images\"]\n                else None\n            ),\n            copyright_text=(\n                album_metadata[\"copyrights\"][0][\"text\"]\n                if album_metadata[\"copyrights\"]\n                else None\n            ),\n        )\n\n        songs.append(song)\n\n    return metadata, songs\n</code></pre>"},{"location":"reference/types/album/#spotdl.types.album.AlbumError","title":"<code>AlbumError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to albums.</p>"},{"location":"reference/types/artist/","title":"artist","text":"<p>Artist module for retrieving artist data from Spotify.</p>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist","title":"<code>Artist(name, url, urls, songs, genres, albums)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Artist class. Contains all the information about an artist. Frozen to prevent accidental modification.</p>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for artist.</p>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the artist.</li> </ul>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist.get_metadata--returns","title":"Returns","text":"<ul> <li>Dict with metadata for artist.</li> </ul> Source code in <code>spotdl/types/artist.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for artist.\n\n    ### Arguments\n    - url: The URL of the artist.\n\n    ### Returns\n    - Dict with metadata for artist.\n    \"\"\"\n\n    # query spotify for artist details\n    spotify_client = SpotifyClient()\n\n    # get artist info\n    raw_artist_meta = spotify_client.artist(url)\n\n    if raw_artist_meta is None:\n        raise ArtistError(\n            \"Couldn't get metadata, check if you have passed correct artist id\"\n        )\n\n    artist_albums = spotify_client.artist_albums(url, album_type=\"album,single\")\n    # check if there is response\n    if not artist_albums:\n        raise ArtistError(\n            \"Couldn't get albums, check if you have passed correct artist id\"\n        )\n\n    # get artist albums and remove duplicates\n    # duplicates can occur if the artist has the same album available in\n    # different countries\n    albums: List[str] = []\n    known_albums: Set[str] = set()\n    for album in artist_albums[\"items\"]:\n        albums.append(album[\"external_urls\"][\"spotify\"])\n        known_albums.add(slugify(album[\"name\"]))\n\n    # Fetch all artist albums\n    while artist_albums and artist_albums[\"next\"]:\n        artist_albums = spotify_client.next(artist_albums)\n        if artist_albums is None:\n            break\n\n        for album in artist_albums[\"items\"]:\n            album_name = slugify(album[\"name\"])\n\n            if album_name not in known_albums:\n                albums.append(album[\"external_urls\"][\"spotify\"])\n                known_albums.add(album_name)\n\n    songs = []\n    for album in albums:\n        album_obj = Album.from_url(album, fetch_songs=False)\n        songs.extend(album_obj.songs)\n\n    # Very aggressive deduplication\n    songs_list = []\n    songs_names = set()\n    for song in songs:\n        slug_name = slugify(song.name)\n        if song.name not in songs_names:\n            songs_list.append(song)\n            songs_names.add(slug_name)\n\n    metadata = {\n        \"name\": raw_artist_meta[\"name\"],\n        \"genres\": raw_artist_meta[\"genres\"],\n        \"url\": url,\n        \"albums\": albums,\n    }\n\n    return metadata, songs_list\n</code></pre>"},{"location":"reference/types/artist/#spotdl.types.artist.ArtistError","title":"<code>ArtistError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to artists.</p>"},{"location":"reference/types/options/","title":"options","text":"<p>This file contains types for spotdl/downloader/web modules. Options types have all the fields marked as required. Settings types have all the fields marked as optional.</p>"},{"location":"reference/types/options/#spotdl.types.options.DownloaderOptionalOptions","title":"<code>DownloaderOptionalOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Downloader.</p>"},{"location":"reference/types/options/#spotdl.types.options.DownloaderOptions","title":"<code>DownloaderOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Downloader.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotDLOptionalOptions","title":"<code>SpotDLOptionalOptions</code>","text":"<p>               Bases: <code>SpotifyOptionalOptions</code>, <code>DownloaderOptionalOptions</code>, <code>WebOptionalOptions</code></p> <p>Options used for initializing the SpotDL client. This type is modified to not require all the fields.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotDLOptions","title":"<code>SpotDLOptions</code>","text":"<p>               Bases: <code>SpotifyOptions</code>, <code>DownloaderOptions</code>, <code>WebOptions</code></p> <p>Options used for initializing the SpotDL client.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotifyOptionalOptions","title":"<code>SpotifyOptionalOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Spotify client.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotifyOptions","title":"<code>SpotifyOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Spotify client.</p>"},{"location":"reference/types/options/#spotdl.types.options.WebOptionalOptions","title":"<code>WebOptionalOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Web server.</p>"},{"location":"reference/types/options/#spotdl.types.options.WebOptions","title":"<code>WebOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Web server.</p>"},{"location":"reference/types/playlist/","title":"playlist","text":"<p>Playlist module for retrieving playlist data from Spotify.</p>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist","title":"<code>Playlist(name, url, urls, songs, description, author_url, author_name, cover_url)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Playlist class for retrieving playlist data from Spotify.</p>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for a playlist.</p>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the playlist.</li> </ul>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist.get_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary with metadata.</li> </ul> Source code in <code>spotdl/types/playlist.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for a playlist.\n\n    ### Arguments\n    - url: The URL of the playlist.\n\n    ### Returns\n    - A dictionary with metadata.\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n\n    playlist = spotify_client.playlist(url)\n    if playlist is None:\n        raise PlaylistError(\"Invalid playlist URL.\")\n\n    metadata = {\n        \"name\": playlist[\"name\"],\n        \"url\": url,\n        \"description\": playlist[\"description\"],\n        \"author_url\": playlist[\"external_urls\"][\"spotify\"],\n        \"author_name\": playlist[\"owner\"][\"display_name\"],\n        \"cover_url\": (\n            max(\n                playlist[\"images\"],\n                key=lambda i: (\n                    0\n                    if i[\"width\"] is None or i[\"height\"] is None\n                    else i[\"width\"] * i[\"height\"]\n                ),\n            )[\"url\"]\n            if (playlist.get(\"images\") is not None and len(playlist[\"images\"]) &gt; 0)\n            else \"\"\n        ),\n    }\n\n    playlist_response = spotify_client.playlist_items(url)\n    if playlist_response is None:\n        raise PlaylistError(f\"Wrong playlist id: {url}\")\n\n    # Get all tracks from playlist\n    tracks = playlist_response[\"items\"]\n    while playlist_response[\"next\"]:\n        playlist_response = spotify_client.next(playlist_response)\n\n        # Failed to get response, break the loop\n        if playlist_response is None:\n            break\n\n        # Add tracks to the list\n        tracks.extend(playlist_response[\"items\"])\n\n    songs = []\n    for track_no, track in enumerate(tracks):\n        if not isinstance(track, dict) or track.get(\"track\") is None:\n            continue\n\n        track_meta = track[\"track\"]\n\n        if track_meta.get(\"is_local\") or track_meta.get(\"type\") != \"track\":\n            logger.warning(\n                \"Skipping track: %s local tracks and %s are not supported\",\n                track_meta.get(\"id\"),\n                track_meta.get(\"type\"),\n            )\n\n            continue\n\n        track_id = track_meta.get(\"id\")\n        if track_id is None or track_meta.get(\"duration_ms\") == 0:\n            continue\n\n        album_meta = track_meta.get(\"album\", {})\n        release_date = album_meta.get(\"release_date\")\n        artists = [artist[\"name\"] for artist in track_meta.get(\"artists\", [])]\n        song = Song.from_missing_data(\n            name=track_meta[\"name\"],\n            artists=artists,\n            artist=artists[0],\n            album_id=album_meta.get(\"id\"),\n            album_name=album_meta.get(\"name\"),\n            album_artist=(\n                album_meta.get(\"artists\", [])[0][\"name\"]\n                if album_meta.get(\"artists\")\n                else None\n            ),\n            album_type=album_meta.get(\"album_type\"),\n            disc_number=track_meta[\"disc_number\"],\n            duration=int(track_meta[\"duration_ms\"] / 1000),\n            year=release_date[:4] if release_date else None,\n            date=release_date,\n            track_number=track_meta[\"track_number\"],\n            tracks_count=album_meta.get(\"total_tracks\"),\n            song_id=track_meta[\"id\"],\n            explicit=track_meta[\"explicit\"],\n            url=track_meta[\"external_urls\"][\"spotify\"],\n            isrc=track_meta.get(\"external_ids\", {}).get(\"isrc\"),\n            cover_url=(\n                max(album_meta[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"])[\n                    \"url\"\n                ]\n                if (len(album_meta.get(\"images\", [])) &gt; 0)\n                else None\n            ),\n            list_position=track_no + 1,\n        )\n\n        songs.append(song)\n\n    return metadata, songs\n</code></pre>"},{"location":"reference/types/playlist/#spotdl.types.playlist.PlaylistError","title":"<code>PlaylistError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to playlists.</p>"},{"location":"reference/types/result/","title":"result","text":"<p>Result is a class that contains all the information about a result from search performed by audio provider.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result","title":"<code>Result(source, url, verified, name, duration, author, result_id, isrc_search=None, search_query=None, artists=None, views=None, explicit=None, album=None, year=None, track_number=None, genre=None, lyrics=None)</code>  <code>dataclass</code>","text":"<p>Result is a class that contains all the information about a result from search perfoermed by audio provider.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.json","title":"<code>json: Dict[str, Any]</code>  <code>property</code>","text":"<p>Returns a dictionary of the song's data.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.json--returns","title":"Returns","text":"<ul> <li>The dictionary.</li> </ul>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_data_dump","title":"<code>from_data_dump(data)</code>  <code>classmethod</code>","text":"<p>Create a Result object from a data dump.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_data_dump--arguments","title":"Arguments","text":"<ul> <li>data: The data dump.</li> </ul>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_data_dump--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/result.py</code> <pre><code>@classmethod\ndef from_data_dump(cls, data: str) -&gt; \"Result\":\n    \"\"\"\n    Create a Result object from a data dump.\n\n    ### Arguments\n    - data: The data dump.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Create dict from json string\n    data_dict = json.loads(data)\n\n    # Return product object\n    return cls(**data_dict)\n</code></pre>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_dict","title":"<code>from_dict(data)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a dictionary.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_dict--arguments","title":"Arguments","text":"<ul> <li>data: The dictionary.</li> </ul>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_dict--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/result.py</code> <pre><code>@classmethod\ndef from_dict(cls, data: Dict[str, Any]) -&gt; \"Result\":\n    \"\"\"\n    Create a Song object from a dictionary.\n\n    ### Arguments\n    - data: The dictionary.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Return product object\n    return cls(**data)\n</code></pre>"},{"location":"reference/types/saved/","title":"saved","text":"<p>Saved module for handing the saved tracks from user library</p>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved","title":"<code>Saved(name, url, urls, songs)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Saved class for handling the saved tracks from user library.</p>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved.get_metadata","title":"<code>get_metadata(url='saved')</code>  <code>staticmethod</code>","text":"<p>Returns metadata for a saved list.</p>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: Not required, but used to match the signature of the other get_metadata methods.</li> </ul>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved.get_metadata--returns","title":"Returns","text":"<ul> <li>metadata: A dictionary containing the metadata for the saved list.</li> <li>songs: A list of Song objects.</li> </ul> Source code in <code>spotdl/types/saved.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str = \"saved\") -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Returns metadata for a saved list.\n\n    ### Arguments\n    - url: Not required, but used to match the signature of the other get_metadata methods.\n\n    ### Returns\n    - metadata: A dictionary containing the metadata for the saved list.\n    - songs: A list of Song objects.\n    \"\"\"\n\n    metadata = {\"name\": \"Saved tracks\", \"url\": url}\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SavedError(\"You must be logged in to use this function\")\n\n    saved_tracks_response = spotify_client.current_user_saved_tracks()\n    if saved_tracks_response is None:\n        raise SavedError(\"Couldn't get saved tracks\")\n\n    saved_tracks = saved_tracks_response[\"items\"]\n\n    # Fetch all saved tracks\n    while saved_tracks_response and saved_tracks_response[\"next\"]:\n        response = spotify_client.next(saved_tracks_response)\n        if response is None:\n            break\n\n        saved_tracks_response = response\n        saved_tracks.extend(saved_tracks_response[\"items\"])\n\n    songs = []\n    for track in saved_tracks:\n        if not isinstance(track, dict) or track.get(\"track\", {}).get(\"is_local\"):\n            continue\n\n        track_meta = track[\"track\"]\n        album_meta = track_meta[\"album\"]\n\n        release_date = album_meta[\"release_date\"]\n        artists = artists = [artist[\"name\"] for artist in track_meta[\"artists\"]]\n\n        song = Song.from_missing_data(\n            name=track_meta[\"name\"],\n            artists=artists,\n            artist=artists[0],\n            album_id=album_meta[\"id\"],\n            album_name=album_meta[\"name\"],\n            album_artist=album_meta[\"artists\"][0][\"name\"],\n            album_type=album_meta[\"album_type\"],\n            disc_number=track_meta[\"disc_number\"],\n            duration=int(track_meta[\"duration_ms\"] / 1000),\n            year=release_date[:4],\n            date=release_date,\n            track_number=track_meta[\"track_number\"],\n            tracks_count=album_meta[\"total_tracks\"],\n            song_id=track_meta[\"id\"],\n            explicit=track_meta[\"explicit\"],\n            url=track_meta[\"external_urls\"][\"spotify\"],\n            isrc=track_meta.get(\"external_ids\", {}).get(\"isrc\"),\n            cover_url=(\n                max(album_meta[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"])[\n                    \"url\"\n                ]\n                if album_meta[\"images\"]\n                else None\n            ),\n        )\n\n        songs.append(song)\n\n    return metadata, songs\n</code></pre>"},{"location":"reference/types/saved/#spotdl.types.saved.SavedError","title":"<code>SavedError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to saved tracks.</p>"},{"location":"reference/types/song/","title":"song","text":"<p>Song module that hold the Song and SongList classes.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song","title":"<code>Song(name, artists, artist, genres, disc_number, disc_count, album_name, album_artist, duration, year, date, track_number, tracks_count, song_id, explicit, publisher, url, isrc, cover_url, copyright_text, download_url=None, lyrics=None, popularity=None, album_id=None, list_name=None, list_url=None, list_position=None, list_length=None, artist_id=None, album_type=None)</code>  <code>dataclass</code>","text":"<p>Song class. Contains all the information about a song.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.display_name","title":"<code>display_name: str</code>  <code>property</code>","text":"<p>Returns a display name for the song.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.display_name--returns","title":"Returns","text":"<ul> <li>The display name.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.json","title":"<code>json: Dict[str, Any]</code>  <code>property</code>","text":"<p>Returns a dictionary of the song's data.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.json--returns","title":"Returns","text":"<ul> <li>The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_data_dump","title":"<code>from_data_dump(data)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a data dump.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_data_dump--arguments","title":"Arguments","text":"<ul> <li>data: The data dump.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_data_dump--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_data_dump(cls, data: str) -&gt; \"Song\":\n    \"\"\"\n    Create a Song object from a data dump.\n\n    ### Arguments\n    - data: The data dump.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Create dict from json string\n    data_dict = json.loads(data)\n\n    # Return product object\n    return cls(**data_dict)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_dict","title":"<code>from_dict(data)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a dictionary.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_dict--arguments","title":"Arguments","text":"<ul> <li>data: The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_dict--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_dict(cls, data: Dict[str, Any]) -&gt; \"Song\":\n    \"\"\"\n    Create a Song object from a dictionary.\n\n    ### Arguments\n    - data: The dictionary.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Return product object\n    return cls(**data)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_missing_data","title":"<code>from_missing_data(**kwargs)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a dictionary with missing data. For example, data dict doesn't contain all the required attributes for the Song class.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_missing_data--arguments","title":"Arguments","text":"<ul> <li>data: The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_missing_data--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_missing_data(cls, **kwargs) -&gt; \"Song\":\n    \"\"\"\n    Create a Song object from a dictionary with missing data.\n    For example, data dict doesn't contain all the required\n    attributes for the Song class.\n\n    ### Arguments\n    - data: The dictionary.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    song_data: Dict[str, Any] = {}\n    for key in cls.__dataclass_fields__:  # pylint: disable=E1101\n        song_data.setdefault(key, kwargs.get(key))\n\n    return cls(**song_data)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_search_term","title":"<code>from_search_term(search_term)</code>  <code>classmethod</code>","text":"<p>Creates a list of Song objects from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_search_term--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_search_term--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_search_term(cls, search_term: str) -&gt; \"Song\":\n    \"\"\"\n    Creates a list of Song objects from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    raw_search_results = Song.search(search_term)\n\n    if len(raw_search_results[\"tracks\"][\"items\"]) == 0:\n        raise SongError(f\"No results found for: {search_term}\")\n\n    return Song.from_url(\n        \"http://open.spotify.com/track/\"\n        + raw_search_results[\"tracks\"][\"items\"][0][\"id\"]\n    )\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_url","title":"<code>from_url(url)</code>  <code>classmethod</code>","text":"<p>Creates a Song object from a URL.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_url--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the song.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_url--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_url(cls, url: str) -&gt; \"Song\":\n    \"\"\"\n    Creates a Song object from a URL.\n\n    ### Arguments\n    - url: The URL of the song.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    if \"open.spotify.com\" not in url or \"track\" not in url:\n        raise SongError(f\"Invalid URL: {url}\")\n\n    # query spotify for song, artist, album details\n    spotify_client = SpotifyClient()\n\n    # get track info\n    raw_track_meta = spotify_client.track(url)\n\n    if raw_track_meta is None:\n        raise SongError(\n            \"Couldn't get metadata, check if you have passed correct track id\"\n        )\n\n    if raw_track_meta[\"duration_ms\"] == 0 or raw_track_meta[\"name\"].strip() == \"\":\n        raise SongError(f\"Track no longer exists: {url}\")\n\n    # get artist info\n    primary_artist_id = raw_track_meta[\"artists\"][0][\"id\"]\n    raw_artist_meta: Dict[str, Any] = spotify_client.artist(primary_artist_id)  # type: ignore\n\n    # get album info\n    album_id = raw_track_meta[\"album\"][\"id\"]\n    raw_album_meta: Dict[str, Any] = spotify_client.album(album_id)  # type: ignore\n\n    # create song object\n    return cls(\n        name=raw_track_meta[\"name\"],\n        artists=[artist[\"name\"] for artist in raw_track_meta[\"artists\"]],\n        artist=raw_track_meta[\"artists\"][0][\"name\"],\n        artist_id=primary_artist_id,\n        album_id=album_id,\n        album_name=raw_album_meta[\"name\"],\n        album_artist=raw_album_meta[\"artists\"][0][\"name\"],\n        album_type=raw_album_meta.get(\"album_type\"),\n        copyright_text=(\n            raw_album_meta[\"copyrights\"][0][\"text\"]\n            if raw_album_meta[\"copyrights\"]\n            else None\n        ),\n        genres=raw_album_meta[\"genres\"] + raw_artist_meta[\"genres\"],\n        disc_number=raw_track_meta[\"disc_number\"],\n        disc_count=int(raw_album_meta[\"tracks\"][\"items\"][-1][\"disc_number\"]),\n        duration=int(raw_track_meta[\"duration_ms\"] / 1000),\n        year=int(raw_album_meta[\"release_date\"][:4]),\n        date=raw_album_meta[\"release_date\"],\n        track_number=raw_track_meta[\"track_number\"],\n        tracks_count=raw_album_meta[\"total_tracks\"],\n        isrc=raw_track_meta.get(\"external_ids\", {}).get(\"isrc\"),\n        song_id=raw_track_meta[\"id\"],\n        explicit=raw_track_meta[\"explicit\"],\n        publisher=raw_album_meta[\"label\"],\n        url=raw_track_meta[\"external_urls\"][\"spotify\"],\n        popularity=raw_track_meta[\"popularity\"],\n        cover_url=(\n            max(raw_album_meta[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"])[\n                \"url\"\n            ]\n            if raw_album_meta[\"images\"]\n            else None\n        ),\n    )\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.list_from_search_term","title":"<code>list_from_search_term(search_term)</code>  <code>classmethod</code>","text":"<p>Creates a list of Song objects from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.list_from_search_term--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.list_from_search_term--returns","title":"Returns","text":"<ul> <li>The list of Song objects.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef list_from_search_term(cls, search_term: str) -&gt; \"List[Song]\":\n    \"\"\"\n    Creates a list of Song objects from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The list of Song objects.\n    \"\"\"\n\n    raw_search_results = Song.search(search_term)\n\n    songs = []\n    for idx, _ in enumerate(raw_search_results.get(\"tracks\", []).get(\"items\", [])):\n        songs.append(\n            Song.from_url(\n                \"http://open.spotify.com/track/\"\n                + raw_search_results[\"tracks\"][\"items\"][idx][\"id\"]\n            )\n        )\n\n    return songs\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.search","title":"<code>search(search_term)</code>  <code>staticmethod</code>","text":"<p>Searches for Songs from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.search--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.search--returns","title":"Returns","text":"<ul> <li>The raw search results</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@staticmethod\ndef search(search_term: str):\n    \"\"\"\n    Searches for Songs from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The raw search results\n    \"\"\"\n    spotify_client = SpotifyClient()\n    raw_search_results = spotify_client.search(search_term)\n\n    if raw_search_results is None:\n        raise SongError(f\"Spotipy error, no response: {search_term}\")\n\n    return raw_search_results\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongError","title":"<code>SongError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to songs.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList","title":"<code>SongList(name, url, urls, songs)</code>  <code>dataclass</code>","text":"<p>SongList class. Base class for all other song lists subclasses.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.json","title":"<code>json: Dict[str, Any]</code>  <code>property</code>","text":"<p>Returns a dictionary of the song list's data.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.json--returns","title":"Returns","text":"<ul> <li>The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.length","title":"<code>length: int</code>  <code>property</code>","text":"<p>Get list length (number of songs).</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.length--returns","title":"Returns","text":"<ul> <li>The list length.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_search_term","title":"<code>from_search_term(search_term, fetch_songs=True)</code>  <code>classmethod</code>","text":"<p>Creates a SongList object from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_search_term--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_search_term--returns","title":"Returns","text":"<ul> <li>The SongList object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_search_term(cls, search_term: str, fetch_songs: bool = True):\n    \"\"\"\n    Creates a SongList object from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The SongList object.\n    \"\"\"\n\n    list_type = cls.__name__.lower()\n    spotify_client = SpotifyClient()\n    raw_search_results = spotify_client.search(search_term, type=list_type)\n\n    if (\n        raw_search_results is None\n        or len(raw_search_results.get(f\"{list_type}s\", {}).get(\"items\", [])) == 0\n    ):\n        raise SongListError(\n            f\"No {list_type} matches found on spotify for '{search_term}'\"\n        )\n\n    matches = {}\n    for result in raw_search_results[f\"{list_type}s\"][\"items\"]:\n        score = fuzz.ratio(search_term.split(\":\", 1)[1].strip(), result[\"name\"])\n        matches[result[\"id\"]] = score\n\n    best_match = max(matches, key=matches.get)  # type: ignore\n\n    return cls.from_url(\n        f\"http://open.spotify.com/{list_type}/{best_match}\",\n        fetch_songs,\n    )\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_url","title":"<code>from_url(url, fetch_songs=True)</code>  <code>classmethod</code>","text":"<p>Create a SongList object from a url.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_url--arguments","title":"Arguments","text":"<ul> <li>url: The url of the list.</li> <li>fetch_songs: Whether to fetch missing metadata for songs.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_url--returns","title":"Returns","text":"<ul> <li>The SongList object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_url(cls, url: str, fetch_songs: bool = True):\n    \"\"\"\n    Create a SongList object from a url.\n\n    ### Arguments\n    - url: The url of the list.\n    - fetch_songs: Whether to fetch missing metadata for songs.\n\n    ### Returns\n    - The SongList object.\n    \"\"\"\n\n    metadata, songs = cls.get_metadata(url)\n    urls = [song.url for song in songs]\n\n    if fetch_songs:\n        songs = [Song.from_url(song.url) for song in songs]\n\n    return cls(**metadata, urls=urls, songs=songs)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongList.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for a song list.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url of the song list.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.get_metadata--returns","title":"Returns","text":"<ul> <li>The metadata.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for a song list.\n\n    ### Arguments\n    - url: The url of the song list.\n\n    ### Returns\n    - The metadata.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongListError","title":"<code>SongListError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to song lists.</p>"},{"location":"reference/utils/","title":"utils","text":"<p>Utility functions for spotdl. These functions are used in every stage of the download process.</p>"},{"location":"reference/utils/archive/","title":"archive","text":"<p>Module for archiving sets of data</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive","title":"<code>Archive</code>","text":"<p>               Bases: <code>Set</code></p> <p>Archive class. A file-persistable set.</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.load","title":"<code>load(file)</code>","text":"<p>Imports the archive from the file.</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.load--arguments","title":"Arguments","text":"<ul> <li>file: the file name of the archive</li> </ul>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.load--returns","title":"Returns","text":"<ul> <li>if the file exists</li> </ul> Source code in <code>spotdl/utils/archive.py</code> <pre><code>def load(self, file: str) -&gt; bool:\n    \"\"\"\n    Imports the archive from the file.\n\n    ### Arguments\n    - file: the file name of the archive\n\n    ### Returns\n    - if the file exists\n    \"\"\"\n\n    if not Path(file).exists():\n        return False\n\n    with open(file, \"r\", encoding=\"utf-8\") as archive:\n        self.clear()\n        self.update([line.strip() for line in archive])\n\n    return True\n</code></pre>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.save","title":"<code>save(file)</code>","text":"<p>Exports the current archive to the file.</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.save--arguments","title":"Arguments","text":"<ul> <li>file: the file name of the archive</li> </ul> Source code in <code>spotdl/utils/archive.py</code> <pre><code>def save(self, file: str) -&gt; bool:\n    \"\"\"\n    Exports the current archive to the file.\n\n    ### Arguments\n    - file: the file name of the archive\n    \"\"\"\n\n    with open(file, \"w\", encoding=\"utf-8\") as archive:\n        for element in sorted(self):\n            archive.write(f\"{element}\\n\")\n\n    return True\n</code></pre>"},{"location":"reference/utils/arguments/","title":"arguments","text":"<p>Module that handles the command line arguments.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.SmartFormatter","title":"<code>SmartFormatter</code>","text":"<p>               Bases: <code>HelpFormatter</code></p> <p>Class that overrides the default help formatter.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.create_parser","title":"<code>create_parser()</code>","text":"<p>Parse arguments from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.create_parser--returns","title":"Returns","text":"<ul> <li>A Namespace object containing the parsed arguments.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def create_parser() -&gt; ArgumentParser:\n    \"\"\"\n    Parse arguments from the command line.\n\n    ### Returns\n    - A Namespace object containing the parsed arguments.\n    \"\"\"\n\n    # Initialize argument parser\n    parser = ArgumentParser(\n        prog=\"spotdl\",\n        description=\"Download your Spotify playlists and songs along with album art and metadata\",\n        formatter_class=SmartFormatter,\n        epilog=(\n            \"For more information, visit http://spotdl.rtfd.io/ \"\n            \"or join our Discord server: https://discord.com/invite/xCa23pwJWY\"\n        ),\n    )\n\n    # Parse main options\n    main_options = parser.add_argument_group(\"Main options\")\n    parse_main_options(main_options)\n\n    # Parse spotify options\n    spotify_options = parser.add_argument_group(\"Spotify options\")\n    parse_spotify_options(spotify_options)\n\n    # Parse ffmpeg options\n    ffmpeg_options = parser.add_argument_group(\"FFmpeg options\")\n    parse_ffmpeg_options(ffmpeg_options)\n\n    # Parse output options\n    output_options = parser.add_argument_group(\"Output options\")\n    parse_output_options(output_options)\n\n    # Parse web options\n    web_options = parser.add_argument_group(\"Web options\")\n    parse_web_options(web_options)\n\n    # Parse misc options\n    misc_options = parser.add_argument_group(\"Misc options\")\n    parse_misc_options(misc_options)\n\n    # Parse other options\n    other_options = parser.add_argument_group(\"Other options\")\n    parse_other_options(other_options)\n\n    return parser\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_arguments","title":"<code>parse_arguments()</code>","text":"<p>Parse arguments from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_arguments--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to parse the arguments from.</li> </ul>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_arguments--returns","title":"Returns","text":"<ul> <li>A Namespace object containing the parsed arguments.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_arguments() -&gt; Namespace:\n    \"\"\"\n    Parse arguments from the command line.\n\n    ### Arguments\n    - parser: The argument parser to parse the arguments from.\n\n    ### Returns\n    - A Namespace object containing the parsed arguments.\n    \"\"\"\n\n    # Create parser\n    parser = create_parser()\n\n    # Parse arguments\n    return parser.parse_args()\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_ffmpeg_options","title":"<code>parse_ffmpeg_options(parser)</code>","text":"<p>Parse ffmpeg options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_ffmpeg_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_ffmpeg_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse ffmpeg options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add ffmpeg executable argument\n    parser.add_argument(\n        \"--ffmpeg\",\n        help=\"The ffmpeg executable to use.\",\n        type=str,\n    )\n\n    # Add search threads argument\n    parser.add_argument(\n        \"--threads\",\n        type=int,\n        help=\"The number of threads to use when downloading songs.\",\n    )\n\n    # Add constant bit rate argument\n    parser.add_argument(\n        \"--bitrate\",\n        choices=[\n            \"auto\",\n            \"disable\",\n            \"8k\",\n            \"16k\",\n            \"24k\",\n            \"32k\",\n            \"40k\",\n            \"48k\",\n            \"64k\",\n            \"80k\",\n            \"96k\",\n            \"112k\",\n            \"128k\",\n            \"160k\",\n            \"192k\",\n            \"224k\",\n            \"256k\",\n            \"320k\",\n        ]\n        + list(map(str, range(0, 10))),\n        type=str.lower,\n        help=(\n            \"The constant/variable bitrate to use for the output file. \"\n            \"Values from 0 to 9 are variable bitrates. \"\n            \"Auto will use the bitrate of the original file. \"\n            \"Disable will disable the bitrate option. \"\n            \"(In case of m4a and opus files, auto and disable will skip the conversion)\"\n        ),\n    )\n\n    # Additional ffmpeg arguments\n    parser.add_argument(\n        \"--ffmpeg-args\",\n        type=str,\n        help=\"Additional ffmpeg arguments passed as a string.\",\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_main_options","title":"<code>parse_main_options(parser)</code>","text":"<p>Parse main options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_main_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_main_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse main options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add operation argument\n    operation = parser.add_argument(\n        \"operation\",\n        choices=OPERATIONS,\n        default=\"download\",\n        const=\"download\",\n        nargs=\"?\",\n        help=(\n            \"N|The operation to perform.\\n\"\n            \"download: Download the songs to the disk and embed metadata.\\n\"\n            \"save: Saves the songs metadata to a file for further use.\\n\"\n            \"web: Starts a web interface to simplify the download process.\\n\"\n            \"sync: Removes songs that are no longer present, downloads new ones\\n\"\n            \"meta: Update your audio files with metadata\\n\"\n            \"url: Get the download URL for songs\\n\\n\"\n        ),\n    )\n\n    # Add query argument\n    query = parser.add_argument(\n        \"query\",\n        nargs=\"+\",\n        type=str,\n        help=(\n            \"N|Spotify/YouTube URL for a song/playlist/album/artist/etc. to download.\\n\\n\"\n            \"For album/playlist/artist searching, include 'album:', 'playlist:', 'artist:' \\n\"\n            \"(ie. 'album:the album name' you can mix these options to get more accurate results)\"\n            \".\\n\\n\"\n            \"To download liked songs use 'saved' as the query, to download all user playlists\\n\"\n            \"use 'all-user-playlists, to download playlists that the user has created\\n\"\n            \"use 'all-saved-playlists', to download all user liked playlists\\n\"\n            \"use 'all-user-followed-artists', to download all user saved albums \"\n            \"use 'all-user-saved-albums' \\n\\n\"\n            \"For manual audio matching, you can use the format 'YouTubeURL|SpotifyURL'\\n\"\n            \"You can only use album/playlist/tracks urls when \"\n            \"downloading/matching youtube urls.\\n\"\n            \"When using youtube url without spotify url, \"\n            \"you won't be able to use `--fetch-albums` option.\\n\\n\"\n        ),\n    )\n\n    try:\n        is_web = sys.argv[1] == \"web\"\n    except IndexError:\n        is_web = False\n\n    is_frozen = getattr(sys, \"frozen\", False)\n\n    # If the program is frozen, we and user didn't pass any arguments,\n    # or if the user is using the web interface, we don't need to parse\n    # the query\n    if (is_frozen and len(sys.argv) &lt; 2) or (len(sys.argv) &gt; 1 and is_web):\n        # If we are running the web interface\n        # or we are in the frozen env and not running web interface\n        # don't remove the operation from the arg parser\n        if not is_web or (is_frozen and not is_web):\n            parser._remove_action(operation)  # pylint: disable=protected-access\n\n        parser._remove_action(query)  # pylint: disable=protected-access\n\n    # Audio provider argument\n    parser.add_argument(\n        \"--audio\",\n        dest=\"audio_providers\",\n        nargs=\"*\",\n        choices=AUDIO_PROVIDERS,\n        help=\"The audio provider to use. You can provide more than one for fallback.\",\n    )\n\n    # Lyrics provider argument\n    parser.add_argument(\n        \"--lyrics\",\n        dest=\"lyrics_providers\",\n        nargs=\"*\",\n        choices=LYRICS_PROVIDERS.keys(),\n        help=(\n            \"The lyrics provider to use. You can provide more than one for fallback. \"\n            \"Synced lyrics might not work correctly with some music players. \"\n            \"For such cases it's better to use `--generate-lrc` option.\"\n        ),\n    )\n\n    parser.add_argument(\n        \"--genius-access-token\",\n        dest=\"genius_token\",\n        help=\"Lets you choose your own Genius access token.\",\n    )\n\n    # Add config argument\n    parser.add_argument(\n        \"--config\",\n        action=\"store_true\",\n        help=(\n            \"Use the config file to download songs. \"\n            \"It's located under C:\\\\Users\\\\user\\\\.spotdl\\\\config.json \"\n            \"or ~/.spotdl/config.json under linux\"\n        ),\n    )\n\n    # Add search query argument\n    parser.add_argument(\n        \"--search-query\",\n        help=f\"The search query to use, available variables: {', '.join(VARS)}\",\n        type=str,\n    )\n\n    # Add don't filter results argument\n    parser.add_argument(\n        \"--dont-filter-results\",\n        dest=\"filter_results\",\n        action=\"store_const\",\n        const=False,\n        help=\"Disable filtering results.\",\n    )\n\n    # Add use only verified results argument\n    parser.add_argument(\n        \"--album-type\",\n        choices={\"album\", \"single\"},\n        help=\"Type of the album to search for. (album, single)\",\n        type=str,\n    )\n\n    # Add use only verified results argument\n    parser.add_argument(\n        \"--only-verified-results\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use only verified results. (Not all providers support this)\",\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_misc_options","title":"<code>parse_misc_options(parser)</code>","text":"<p>Parse misc options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_misc_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_misc_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse misc options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add verbose argument\n    parser.add_argument(\n        \"--log-level\",\n        choices=NAME_TO_LEVEL.keys(),\n        help=\"Select log level.\",\n    )\n\n    # Add simple tui argument\n    parser.add_argument(\n        \"--simple-tui\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use a simple tui.\",\n    )\n\n    # Add log format argument\n    parser.add_argument(\n        \"--log-format\",\n        help=(\n            \"Custom logging format to use. More info: \"\n            \"https://docs.python.org/3/library/logging.html#logrecord-attributes\"\n        ),\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_other_options","title":"<code>parse_other_options(parser)</code>","text":"<p>Parse other options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_other_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_other_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse other options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    parser.add_argument(\n        \"--download-ffmpeg\",\n        action=\"store_true\",\n        help=\"Download ffmpeg to spotdl directory.\",\n    )\n\n    parser.add_argument(\n        \"--generate-config\",\n        action=\"store_true\",\n        help=\"Generate a config file. This will overwrite current config if present.\",\n    )\n\n    parser.add_argument(\n        \"--check-for-updates\", action=\"store_true\", help=\"Check for new version.\"\n    )\n\n    parser.add_argument(\n        \"--profile\",\n        action=\"store_true\",\n        help=\"Run in profile mode. Useful for debugging.\",\n    )\n\n    parser.add_argument(\n        \"--version\",\n        \"-v\",\n        action=\"version\",\n        help=\"Show the version number and exit.\",\n        version=_version.__version__,\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_output_options","title":"<code>parse_output_options(parser)</code>","text":"<p>Parse output options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_output_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_output_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse output options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add output format argument\n    parser.add_argument(\n        \"--format\",\n        choices=FFMPEG_FORMATS.keys(),\n        help=\"The format to download the song in.\",\n        type=str,\n    )\n\n    # Add save file argument\n    parser.add_argument(\n        \"--save-file\",\n        type=str,\n        help=(\n            \"The file to save/load the songs data from/to. \"\n            \"It has to end with .spotdl. \"\n            \"If combined with the download operation, it will save the songs data to the file. \"\n            \"Required for save/sync (use - to print to stdout when using save). \"\n        ),\n        required=len(sys.argv) &gt; 1 and sys.argv[1] in [\"save\"],\n    )\n\n    # Add preload argument\n    parser.add_argument(\n        \"--preload\",\n        action=\"store_const\",\n        const=True,\n        help=\"Preload the download url to speed up the download process.\",\n    )\n\n    # Add name format argument\n    parser.add_argument(\n        \"--output\",\n        type=str,\n        help=f\"Specify the downloaded file name format, available variables: {', '.join(VARS)}\",\n    )\n\n    # Add m3u argument\n    parser.add_argument(\n        \"--m3u\",\n        type=str,\n        nargs=\"?\",\n        help=(\n            \"Name of the m3u file to save the songs to. \"\n            \"Defaults to {list[0]}.m3u8 \"\n            \"If you want to generate a m3u for each list in the query use {list}, \"\n            \"If you want to generate a m3u file based on the first list in the query use {list[0]}\"\n            \", (0 is the first list in the query, 1 is the second, etc. \"\n            \"songs don't count towards the list number) \"\n        ),\n        const=\"{list[0]}.m3u8\",\n    )\n\n    # Add cookie file argument\n    parser.add_argument(\n        \"--cookie-file\",\n        help=\"Path to cookies file.\",\n        type=str,\n    )\n\n    # Add overwrite argument\n    parser.add_argument(\n        \"--overwrite\",\n        choices={\"force\", \"skip\", \"metadata\"},\n        help=(\n            \"How to handle existing/duplicate files. \"\n            \"(When combined with --scan-for-songs force will remove \"\n            \"all duplicates, and metadata will only apply metadata to the \"\n            \"latest song and will remove the rest. )\"\n        ),\n        type=str,\n    )\n\n    # Option to increase compatibility of filenames and easier handling in the shell\n    parser.add_argument(\n        \"--restrict\",\n        choices={\"strict\", \"ascii\", \"none\"},\n        const=\"strict\",\n        nargs=\"?\",\n        help=\"Restrict filenames to a sanitized set of characters for better compatibility\",\n        type=str,\n    )\n\n    # Option to print errors on exit, useful for long playlist\n    parser.add_argument(\n        \"--print-errors\",\n        action=\"store_const\",\n        const=True,\n        help=\"Print errors (wrong songs, failed downloads etc) on exit, useful for long playlist\",\n    )\n\n    # Option to save errors to a file\n    parser.add_argument(\n        \"--save-errors\",\n        type=str,\n        help=\"Save errors (wrong songs, failed downloads etc) to a file\",\n    )\n\n    # Option to use sponsor block\n    parser.add_argument(\n        \"--sponsor-block\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use the sponsor block to download songs from yt/ytm.\",\n    )\n\n    # Add archive_file argument\n    parser.add_argument(\n        \"--archive\",\n        type=str,\n        help=\"Specify the file name for an archive of already downloaded songs\",\n    )\n\n    # Option to set the track number &amp; album of tracks in a playlist to their index in the playlist\n    # &amp; the name of playlist respectively.\n    parser.add_argument(\n        \"--playlist-numbering\",\n        action=\"store_const\",\n        dest=\"playlist_numbering\",\n        const=True,\n        help=\"Sets each track in a playlist to have the playlist's name as its album,\\\n            and album art as the playlist's icon\",\n    )\n\n    # Option to set the track number &amp; album of tracks, while retaining album art of each track, in\n    # a playlist to their index in the playlist &amp; the name of playlist respectively.\n    parser.add_argument(\n        \"--playlist-retain-track-cover\",\n        action=\"store_const\",\n        dest=\"playlist_retain_track_cover\",\n        const=True,\n        help=\"Sets each track in a playlist to have the playlist's name as its album,\\\n            while retaining album art of each track\",\n    )\n\n    # Option to scan the output directory for existing files\n    parser.add_argument(\n        \"--scan-for-songs\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Scan the output directory for existing files. \"\n            \"This option should be combined with the --overwrite option \"\n            \"to control how existing files are handled. (Output directory is the last directory \"\n            \"that is not a template variable in the output template)\"\n        ),\n    )\n\n    # Option to fetch all albums from songs in query\n    parser.add_argument(\n        \"--fetch-albums\",\n        action=\"store_const\",\n        const=True,\n        help=\"Fetch all albums from songs in query\",\n    )\n\n    # Option to change the id3 separator\n    parser.add_argument(\n        \"--id3-separator\",\n        type=str,\n        help=\"Change the separator used in the id3 tags. Only supported for mp3 files.\",\n    )\n\n    # Option to use ytm data instead of spotify data\n    # when downloading using ytm link\n    parser.add_argument(\n        \"--ytm-data\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use ytm data instead of spotify data when downloading using ytm link.\",\n    )\n\n    # Option whether to add unavailable songs to the m3u file\n    parser.add_argument(\n        \"--add-unavailable\",\n        action=\"store_const\",\n        const=True,\n        help=\"Add unavailable songs to the m3u/archive files when downloading\",\n    )\n\n    # Generate lrc files\n    parser.add_argument(\n        \"--generate-lrc\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Generate lrc files for downloaded songs. \"\n            \"Requires `synced` provider to be present in the lyrics providers list.\"\n        ),\n    )\n\n    # Force update metadata\n    parser.add_argument(\n        \"--force-update-metadata\",\n        action=\"store_const\",\n        const=True,\n        help=\"Force update metadata for songs that already have metadata.\",\n    )\n\n    # Sync without deleting\n    parser.add_argument(\n        \"--sync-without-deleting\",\n        action=\"store_const\",\n        const=True,\n        help=\"Sync without deleting songs that are not in the query.\",\n    )\n\n    # Max file name length\n    parser.add_argument(\n        \"--max-filename-length\",\n        type=int,\n        help=(\n            \"Max file name length. \"\n            \"(This won't override the max file name length enforced by the OS)\"\n        ),\n    )\n\n    # YT-DlP options\n    parser.add_argument(\n        \"--yt-dlp-args\",\n        type=str,\n        help=\"Arguments to pass to yt-dlp\",\n    )\n\n    # Detect formats option\n    parser.add_argument(\n        \"--detect-formats\",\n        type=str,\n        nargs=\"*\",\n        help=(\n            \"Detect already downloaded songs with file format different from the --format option \"\n            \"(When combined with --m3u option, \"\n            \"only first detected format will be added to m3u file)\"\n        ),\n        choices=FFMPEG_FORMATS.keys(),\n    )\n\n    # download song in meta operation\n    parser.add_argument(\n        \"--redownload\",\n        action=\"store_const\",\n        const=True,\n        help=\"to redownload the local song in diffrent format using --format for meta operation\",\n    )\n\n    # skip album art for meta operation\n    parser.add_argument(\n        \"--skip-album-art\",\n        action=\"store_const\",\n        const=True,\n        help=\"skip downloading album art for meta operation\",\n    )\n\n    # Ignore songs from a paticular album\n    parser.add_argument(\n        \"--ignore-albums\",\n        type=str,\n        nargs=\"*\",\n        help=\"ignores the song of the given albums\",\n    )\n\n    # Skip explicit songs options\n    parser.add_argument(\n        \"--skip-explicit\", action=\"store_const\", const=True, help=\"Skip explicit songs\"\n    )\n\n    parser.add_argument(\n        \"--proxy\",\n        help=\"Http(s) proxy server for download song. Example: http://host:port\",\n    )\n\n    # Skip songs having a skip flag file\n    parser.add_argument(\n        \"--create-skip-file\",\n        action=\"store_const\",\n        const=True,\n        help=\"Create skip file for successfully downloaded file\",\n    )\n\n    # Skip songs having a skip flag file\n    parser.add_argument(\n        \"--respect-skip-file\",\n        action=\"store_const\",\n        const=True,\n        help=\"If a file with the extension .skip exists, skip download\",\n    )\n\n    # Sync remove lrc files\n    parser.add_argument(\n        \"--sync-remove-lrc\",\n        action=\"store_const\",\n        const=True,\n        help=\"Remove lrc files when using sync operation when downloading songs\",\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_spotify_options","title":"<code>parse_spotify_options(parser)</code>","text":"<p>Parse spotify options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_spotify_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_spotify_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse spotify options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add login argument\n    parser.add_argument(\n        \"--user-auth\",\n        action=\"store_const\",\n        const=True,\n        help=\"Login to Spotify using OAuth.\",\n    )\n\n    # Add client id argument\n    parser.add_argument(\n        \"--client-id\",\n        help=\"The client id to use when logging in to Spotify.\",\n        type=str,\n    )\n\n    # Add client secret argument\n    parser.add_argument(\n        \"--client-secret\",\n        help=\"The client secret to use when logging in to Spotify.\",\n        type=str,\n    )\n\n    # Add auth token argument\n    parser.add_argument(\n        \"--auth-token\",\n        help=\"The authorization token to use directly to log in to Spotify.\",\n        type=str,\n    )\n\n    # Add cache path argument\n    parser.add_argument(\n        \"--cache-path\",\n        type=str,\n        help=\"The path where spotipy cache file will be stored.\",\n    )\n\n    # Add no cache argument\n    parser.add_argument(\n        \"--no-cache\",\n        action=\"store_const\",\n        const=True,\n        help=\"Disable caching (both requests and token).\",\n    )\n\n    # Add max retries argument\n    parser.add_argument(\n        \"--max-retries\",\n        type=int,\n        help=\"The maximum number of retries to perform when getting metadata.\",\n    )\n\n    # Add headless argument\n    parser.add_argument(\n        \"--headless\",\n        action=\"store_const\",\n        const=True,\n        help=\"Run in headless mode.\",\n    )\n\n    # Add use cache file argument\n    parser.add_argument(\n        \"--use-cache-file\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Use the cache file to get metadata. \"\n            \"It's located under C:\\\\Users\\\\user\\\\.spotdl\\\\.spotify_cache \"\n            \"or ~/.spotdl/.spotify_cache under linux. \"\n            \"It only caches tracks and \"\n            \"gets updated whenever spotDL gets metadata from Spotify. \"\n            \"(It may provide outdated metadata use with caution)\"\n        ),\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_web_options","title":"<code>parse_web_options(parser)</code>","text":"<p>Parse web options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_web_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_web_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse web options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add host argument\n    parser.add_argument(\n        \"--host\",\n        type=str,\n        help=\"The host to use for the web server.\",\n    )\n\n    # Add port argument\n    parser.add_argument(\n        \"--port\",\n        type=int,\n        help=\"The port to run the web server on.\",\n    )\n\n    # Add keep alive argument\n    parser.add_argument(\n        \"--keep-alive\",\n        action=\"store_const\",\n        const=True,\n        help=\"Keep the web server alive even when no clients are connected.\",\n    )\n\n    # Add allowed origins argument\n    parser.add_argument(\n        \"--allowed-origins\",\n        nargs=\"*\",\n        help=\"The allowed origins for the web server.\",\n    )\n\n    # Add use output directory argument\n    parser.add_argument(\n        \"--web-use-output-dir\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Use the output directory instead of the session directory for downloads. (\"\n            \"This might cause issues if you have multiple users using the web-ui at the same time)\"\n        ),\n    )\n\n    # Add keep sessions argument\n    parser.add_argument(\n        \"--keep-sessions\",\n        action=\"store_const\",\n        const=True,\n        help=\"Keep the session directory after the web server is closed.\",\n    )\n\n    # Add keep sessions argument\n    parser.add_argument(\n        \"--force-update-gui\",\n        action=\"store_const\",\n        const=True,\n        default=False,\n        help=\"Refresh the web server directory with a fresh git checkout\",\n    )\n\n    # Add custom web gui repo\n    parser.add_argument(\n        \"--web-gui-repo\",\n        type=str,\n        help=(\n            \"Custom web gui repo to use for the web server. \"\n            \"Example: /~https://github.com/spotdl/web-ui/tree/master/dist\"\n        ),\n    )\n\n    # Add custom web gui repo\n    parser.add_argument(\n        \"--web-gui-location\",\n        type=str,\n        help=\"Path to the web gui directory to use for the web server.\",\n    )\n\n    # Enable TLS for the web server\n    parser.add_argument(\n        \"--enable-tls\",\n        action=\"store_const\",\n        const=True,\n        help=\"Enable TLS on the web server.\",\n    )\n\n    # Add File Location of the TLS Certificate file (Pem Format)\n    parser.add_argument(\n        \"--cert-file\", type=str, help=\"File Path to the TLS Certificate (PEM format).\"\n    )\n\n    # Add File Location of the TLS Private Key file (Pem Format)\n    parser.add_argument(\n        \"--key-file\", type=str, help=\"File Path to the TLS Private Key (PEM format).\"\n    )\n\n    # Add File Location of the TLS Certificate Authority file (Pem Format)\n    parser.add_argument(\n        \"--ca-file\",\n        type=str,\n        help=\"File Path to the TLS Certificate Authority File (PEM format).\",\n    )\n</code></pre>"},{"location":"reference/utils/config/","title":"config","text":"<p>Module related to managing reading and writing to the config file.</p> <p>Default config - spotdl.utils.config.DEFAULT_CONFIG</p>"},{"location":"reference/utils/config/#spotdl.utils.config.ConfigError","title":"<code>ConfigError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to config.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.GlobalConfig","title":"<code>GlobalConfig</code>","text":"<p>Class to store global configuration</p>"},{"location":"reference/utils/config/#spotdl.utils.config.GlobalConfig.get_parameter","title":"<code>get_parameter(key)</code>  <code>classmethod</code>","text":"<p>Get a parameter from the download config</p> Source code in <code>spotdl/utils/config.py</code> <pre><code>@classmethod\ndef get_parameter(cls, key):\n    \"\"\"\n    Get a parameter from the download config\n    \"\"\"\n\n    return cls.parameters.get(key, None)\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.GlobalConfig.set_parameter","title":"<code>set_parameter(key, value)</code>  <code>classmethod</code>","text":"<p>Set a parameter for the download config</p> Source code in <code>spotdl/utils/config.py</code> <pre><code>@classmethod\ndef set_parameter(cls, key, value):\n    \"\"\"\n    Set a parameter for the download config\n    \"\"\"\n\n    cls.parameters[key] = value\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings","title":"<code>create_settings(arguments)</code>","text":"<p>Create settings dicts for Spotify, Downloader and Web based on the arguments and config file (if enabled)</p>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings--arguments","title":"Arguments","text":"<ul> <li>arguments: Namespace from argparse</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings--returns","title":"Returns","text":"<ul> <li>spotify_options: SpotifyOptions</li> <li>downloader_options: DownloaderOptions</li> <li>web_options: WebOptions</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def create_settings(\n    arguments: Namespace,\n) -&gt; Tuple[SpotifyOptions, DownloaderOptions, WebOptions]:\n    \"\"\"\n    Create settings dicts for Spotify, Downloader and Web\n    based on the arguments and config file (if enabled)\n\n    ### Arguments\n    - arguments: Namespace from argparse\n\n    ### Returns\n    - spotify_options: SpotifyOptions\n    - downloader_options: DownloaderOptions\n    - web_options: WebOptions\n    \"\"\"\n\n    # Get the config file\n    # It will automatically load if the `load_config` is set to True\n    # in the config file\n    config = {}\n    if arguments.config or (\n        get_config_file().exists() and get_config().get(\"load_config\")\n    ):\n        config = get_config()\n\n    # Type: ignore because of the issues below\n    # /~https://github.com/python/mypy/issues/8890\n    # /~https://github.com/python/mypy/issues/5382\n    spotify_options = SpotifyOptions(\n        **create_settings_type(arguments, config, SPOTIFY_OPTIONS)  # type: ignore\n    )\n    downloader_options = DownloaderOptions(\n        **create_settings_type(arguments, config, DOWNLOADER_OPTIONS)  # type: ignore\n    )\n    web_options = WebOptions(**create_settings_type(arguments, config, WEB_OPTIONS))  # type: ignore\n\n    return spotify_options, downloader_options, web_options\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings_type","title":"<code>create_settings_type(arguments, config, default)</code>","text":"<p>Create settings dict Argument value has always the priority, then the config file value, and if neither are set, use default value</p>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings_type--arguments","title":"Arguments","text":"<ul> <li>arguments: Namespace from argparse</li> <li>default: dict</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings_type--returns","title":"Returns","text":"<ul> <li>settings: dict</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def create_settings_type(\n    arguments: Namespace,\n    config: Dict[str, Any],\n    default: Union[SpotifyOptions, DownloaderOptions, WebOptions],\n) -&gt; Dict[str, Any]:\n    \"\"\"\n    Create settings dict\n    Argument value has always the priority, then the config file\n    value, and if neither are set, use default value\n\n    ### Arguments\n    - arguments: Namespace from argparse\n    - default: dict\n\n    ### Returns\n    - settings: dict\n    \"\"\"\n\n    settings = {}\n    for key, default_value in default.items():\n        argument_val = arguments.__dict__.get(key)\n        config_val = config.get(key)\n\n        if argument_val is not None:\n            settings[key] = argument_val\n        elif config_val is not None:\n            settings[key] = config_val\n        else:\n            settings[key] = default_value\n\n    return settings\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_cache_path","title":"<code>get_cache_path()</code>","text":"<p>Get the path to the cache folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_cache_path--returns","title":"Returns","text":"<ul> <li>The path to the spotipy cache file.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_cache_path() -&gt; Path:\n    \"\"\"\n    Get the path to the cache folder.\n\n    ### Returns\n    - The path to the spotipy cache file.\n    \"\"\"\n\n    return get_spotdl_path() / \".spotipy\"\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config","title":"<code>get_config()</code>","text":"<p>Get the config.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config--returns","title":"Returns","text":"<ul> <li>The dictionary with the config.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config--errors","title":"Errors","text":"<ul> <li>ConfigError: If the config file does not exist.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_config() -&gt; Dict[str, Any]:\n    \"\"\"\n    Get the config.\n\n    ### Returns\n    - The dictionary with the config.\n\n    ### Errors\n    - ConfigError: If the config file does not exist.\n    \"\"\"\n\n    config_path = get_config_file()\n\n    if not config_path.exists():\n        raise ConfigError(\n            \"Config file not found.\"\n            \"Please run `spotdl --generate-config` to create a config file.\"\n        )\n\n    with open(config_path, \"r\", encoding=\"utf-8\") as config_file:\n        return json.load(config_file)\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config_file","title":"<code>get_config_file()</code>","text":"<p>Get config file path</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config_file--returns","title":"Returns","text":"<ul> <li>The path to the config file.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_config_file() -&gt; Path:\n    \"\"\"\n    Get config file path\n\n    ### Returns\n    - The path to the config file.\n    \"\"\"\n\n    return get_spotdl_path() / \"config.json\"\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_errors_path","title":"<code>get_errors_path()</code>","text":"<p>Get the path to the errors folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_errors_path--returns","title":"Returns","text":"<ul> <li>The path to the errors folder.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_errors_path--notes","title":"Notes","text":"<ul> <li>If the errors directory does not exist, it will be created.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_errors_path() -&gt; Path:\n    \"\"\"\n    Get the path to the errors folder.\n\n    ### Returns\n    - The path to the errors folder.\n\n    ### Notes\n    - If the errors directory does not exist, it will be created.\n    \"\"\"\n\n    errors_path = get_spotdl_path() / \"errors\"\n\n    if not errors_path.exists():\n        os.mkdir(errors_path)\n\n    return errors_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotdl_path","title":"<code>get_spotdl_path()</code>","text":"<p>Get the path to the spotdl folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotdl_path--returns","title":"Returns","text":"<ul> <li>The path to the spotdl folder.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotdl_path--notes","title":"Notes","text":"<ul> <li>If the spotdl directory does not exist, it will be created.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_spotdl_path() -&gt; Path:\n    \"\"\"\n    Get the path to the spotdl folder.\n\n    ### Returns\n    - The path to the spotdl folder.\n\n    ### Notes\n    - If the spotdl directory does not exist, it will be created.\n    \"\"\"\n\n    # Check if os is linux\n    if platform.system() == \"Linux\":\n        # if platform is linux, and XDG DATA HOME spotdl folder exists, use it\n        user_data_dir = Path(platformdirs.user_data_dir(\"spotdl\", \"spotDL\"))\n        if user_data_dir.exists():\n            return user_data_dir\n\n    spotdl_path = Path(os.path.expanduser(\"~\"), \".spotdl\")\n    if not spotdl_path.exists():\n        os.mkdir(spotdl_path)\n\n    return spotdl_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotify_cache_path","title":"<code>get_spotify_cache_path()</code>","text":"<p>Get the path to the spotify cache folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotify_cache_path--returns","title":"Returns","text":"<ul> <li>The path to the spotipy cache file.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_spotify_cache_path() -&gt; Path:\n    \"\"\"\n    Get the path to the spotify cache folder.\n\n    ### Returns\n    - The path to the spotipy cache file.\n    \"\"\"\n\n    return get_spotdl_path() / \".spotify_cache\"\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_temp_path","title":"<code>get_temp_path()</code>","text":"<p>Get the path to the temp folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_temp_path--returns","title":"Returns","text":"<ul> <li>The path to the temp folder.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_temp_path() -&gt; Path:\n    \"\"\"\n    Get the path to the temp folder.\n\n    ### Returns\n    - The path to the temp folder.\n    \"\"\"\n\n    temp_path = get_spotdl_path() / \"temp\"\n    if not temp_path.exists():\n        os.mkdir(temp_path)\n\n    return temp_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_web_ui_path","title":"<code>get_web_ui_path()</code>","text":"<p>Get the path to the web-ui folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_web_ui_path--returns","title":"Returns","text":"<ul> <li>The path to the web-ui folder.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_web_ui_path--notes","title":"Notes","text":"<ul> <li>If the web-ui directory does not exist, it will be created.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_web_ui_path() -&gt; Path:\n    \"\"\"\n    Get the path to the web-ui folder.\n\n    ### Returns\n    - The path to the web-ui folder.\n\n    ### Notes\n    - If the web-ui directory does not exist, it will be created.\n    \"\"\"\n\n    web_ui_path = get_spotdl_path() / \"web-ui\"\n\n    if not web_ui_path.exists():\n        os.mkdir(web_ui_path)\n\n    return web_ui_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.modernize_settings","title":"<code>modernize_settings(options)</code>","text":"<p>Handle deprecated values in config file.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.modernize_settings--arguments","title":"Arguments","text":"<ul> <li>options: DownloaderOptions to modernize</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def modernize_settings(options: DownloaderOptions):\n    \"\"\"Handle deprecated values in config file.\n\n    ### Arguments\n    - options: DownloaderOptions to modernize\n    \"\"\"\n\n    warning_msg = \"Deprecated '%s' value found for '%s' setting in config file. Using '%s' instead.\"\n\n    # Respect backward compatibility with old boolean --restrict flag\n    if options[\"restrict\"] is True:\n        logger.warning(warning_msg, True, \"restrict\", \"strict\")\n        options[\"restrict\"] = \"strict\"\n</code></pre>"},{"location":"reference/utils/console/","title":"console","text":"<p>Module for holding console related actions.</p>"},{"location":"reference/utils/console/#spotdl.utils.console.check_for_updates","title":"<code>check_for_updates()</code>","text":"<p>Check for updates to the current version.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def check_for_updates():\n    \"\"\"\n    Check for updates to the current version.\n    \"\"\"\n\n    version_message = get_update_status()\n\n    print(version_message)\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.download_ffmpeg","title":"<code>download_ffmpeg()</code>","text":"<p>Handle ffmpeg download process and print the result.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def download_ffmpeg():\n    \"\"\"\n    Handle ffmpeg download process and print the result.\n    \"\"\"\n\n    if get_local_ffmpeg() is not None or is_ffmpeg_installed():\n        overwrite_ffmpeg = input(\n            \"FFmpeg is already installed. Do you want to overwrite it? (y/N): \"\n        )\n\n        if overwrite_ffmpeg.lower() == \"y\":\n            local_ffmpeg = ffmpeg_download()\n\n            if local_ffmpeg.is_file():\n                print(f\"FFmpeg successfully downloaded to {local_ffmpeg.absolute()}\")\n            else:\n                print(\"FFmpeg download failed\")\n    else:\n        print(\"Downloading FFmpeg...\")\n        download_path = ffmpeg_download()\n\n        if download_path.is_file():\n            print(f\"FFmpeg successfully downloaded to {download_path.absolute()}\")\n        else:\n            print(\"FFmpeg download failed\")\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.generate_config","title":"<code>generate_config()</code>","text":"<p>Generate the config file if it doesn't exist This is done before the argument parser so it doesn't requires <code>operation</code> and <code>query</code> to be passed.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def generate_config():\n    \"\"\"\n    Generate the config file if it doesn't exist\n    This is done before the argument parser so it doesn't requires `operation`\n    and `query` to be passed.\n    \"\"\"\n\n    config_path = get_config_file()\n    if config_path.exists():\n        overwrite_config = input(\"Config file already exists. Overwrite? (y/N): \")\n\n        if overwrite_config.lower() != \"y\":\n            print(\"Exiting...\")\n            return None\n\n    with open(config_path, \"w\", encoding=\"utf-8\") as config_file:\n        json.dump(DEFAULT_CONFIG, config_file, indent=4)\n\n    print(f\"Config file generated at {config_path}\")\n\n    return None\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.generate_initial_config","title":"<code>generate_initial_config()</code>","text":"<p>Generate the initial config file if it doesn't exist.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def generate_initial_config():\n    \"\"\"\n    Generate the initial config file if it doesn't exist.\n    \"\"\"\n\n    if get_config_file().is_file() is False:\n        config_path = get_config_file()\n        with open(config_path, \"w\", encoding=\"utf-8\") as config_file:\n            json.dump(DEFAULT_CONFIG, config_file, indent=4)\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.is_executable","title":"<code>is_executable()</code>","text":"<p>Check if the application is an prebuilt executable. And has been launched with double click.</p>"},{"location":"reference/utils/console/#spotdl.utils.console.is_executable--returns","title":"Returns","text":"<ul> <li><code>True</code> if the application is an prebuilt executable, <code>False</code> otherwise.</li> </ul> Source code in <code>spotdl/utils/console.py</code> <pre><code>def is_executable():\n    \"\"\"\n    Check if the application is an prebuilt executable.\n    And has been launched with double click.\n\n    ### Returns\n    - `True` if the application is an prebuilt executable, `False` otherwise.\n    \"\"\"\n\n    return is_frozen() and len(sys.argv) == 1\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.is_frozen","title":"<code>is_frozen()</code>","text":"<p>Check if the application is frozen.</p>"},{"location":"reference/utils/console/#spotdl.utils.console.is_frozen--returns","title":"Returns","text":"<ul> <li><code>True</code> if the application is frozen, <code>False</code> otherwise.</li> </ul> Source code in <code>spotdl/utils/console.py</code> <pre><code>def is_frozen():\n    \"\"\"\n    Check if the application is frozen.\n\n    ### Returns\n    - `True` if the application is frozen, `False` otherwise.\n    \"\"\"\n\n    return getattr(sys, \"frozen\", False)\n</code></pre>"},{"location":"reference/utils/downloader/","title":"downloader","text":"<p>Module for functions related to downloading songs.</p>"},{"location":"reference/utils/downloader/#spotdl.utils.downloader.check_ytmusic_connection","title":"<code>check_ytmusic_connection()</code>","text":"<p>Check if we can connect to YouTube Music API</p>"},{"location":"reference/utils/downloader/#spotdl.utils.downloader.check_ytmusic_connection--returns","title":"Returns","text":"<ul> <li><code>True</code> if we can connect to YouTube Music API</li> <li><code>False</code> if we can't connect to YouTube Music API</li> </ul> Source code in <code>spotdl/utils/downloader.py</code> <pre><code>def check_ytmusic_connection() -&gt; bool:\n    \"\"\"\n    Check if we can connect to YouTube Music API\n\n    ### Returns\n    - `True` if we can connect to YouTube Music API\n    - `False` if we can't connect to YouTube Music API\n    \"\"\"\n\n    # Check if we are getting results from YouTube Music\n    ytm = YouTubeMusic()\n    test_results = ytm.get_results(\"a\")\n    if len(test_results) == 0:\n        return False\n\n    return True\n</code></pre>"},{"location":"reference/utils/ffmpeg/","title":"ffmpeg","text":"<p>Module for converting audio files to different formats and checking for ffmpeg binary, and downloading it if not found.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.FFmpegError","title":"<code>FFmpegError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to FFmpeg.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert","title":"<code>convert(input_file, output_file, ffmpeg='ffmpeg', output_format='mp3', bitrate=None, ffmpeg_args=None, progress_handler=None)</code>","text":"<p>Convert the input file to the output file synchronously with progress handler.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert--arguments","title":"Arguments","text":"<ul> <li>input_file: Path to input file or tuple of (url, file_format).</li> <li>output_file: Path to output file.</li> <li>ffmpeg: ffmpeg executable to use.</li> <li>output_format: output format.</li> <li>bitrate: constant/variable bitrate.</li> <li>ffmpeg_args: ffmpeg arguments.</li> <li>progress_handler: progress handler, has to accept an integer as argument.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert--returns","title":"Returns","text":"<ul> <li>Tuple of conversion status and error dictionary.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert--notes","title":"Notes","text":"<ul> <li>Make sure to check if ffmpeg is installed before calling this function.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def convert(\n    input_file: Union[Path, Tuple[str, str]],\n    output_file: Path,\n    ffmpeg: str = \"ffmpeg\",\n    output_format: str = \"mp3\",\n    bitrate: Optional[str] = None,\n    ffmpeg_args: Optional[str] = None,\n    progress_handler: Optional[Callable[[int], None]] = None,\n) -&gt; Tuple[bool, Optional[Dict[str, Any]]]:\n    \"\"\"\n    Convert the input file to the output file synchronously with progress handler.\n\n    ### Arguments\n    - input_file: Path to input file or tuple of (url, file_format).\n    - output_file: Path to output file.\n    - ffmpeg: ffmpeg executable to use.\n    - output_format: output format.\n    - bitrate: constant/variable bitrate.\n    - ffmpeg_args: ffmpeg arguments.\n    - progress_handler: progress handler, has to accept an integer as argument.\n\n    ### Returns\n    - Tuple of conversion status and error dictionary.\n\n    ### Notes\n    - Make sure to check if ffmpeg is installed before calling this function.\n    \"\"\"\n\n    # Initialize ffmpeg command\n    # -i is the input file\n    arguments: List[str] = [\n        \"-nostdin\",\n        \"-y\",\n        \"-i\",\n        str(input_file.resolve()) if isinstance(input_file, Path) else input_file[0],\n        \"-movflags\",\n        \"+faststart\",\n        \"-v\",\n        \"debug\",\n        \"-progress\",\n        \"-\",\n        \"-nostats\",\n    ]\n\n    file_format = (\n        str(input_file.suffix).split(\".\")[1]\n        if isinstance(input_file, Path)\n        else input_file[1]\n    )\n\n    # Add output format to command\n    # -c:a is used if the file is not an matroska container\n    # and we want to convert to opus\n    # otherwise we use arguments from FFMPEG_FORMATS\n    if output_format == \"opus\" and file_format != \"webm\":\n        arguments.extend([\"-c:a\", \"libopus\"])\n    else:\n        if (\n            (output_format == \"opus\" and file_format == \"webm\")\n            or (output_format == \"m4a\" and file_format == \"m4a\")\n            and not (bitrate or ffmpeg_args)\n        ):\n            # Copy the audio stream to the output file\n            arguments.extend([\"-vn\", \"-c:a\", \"copy\"])\n        else:\n            arguments.extend(FFMPEG_FORMATS[output_format])\n\n    # Add bitrate if specified\n    if bitrate:\n        # Check if bitrate is an integer\n        # if it is then use it as variable bitrate\n        if bitrate.isdigit():\n            arguments.extend([\"-q:a\", bitrate])\n        else:\n            arguments.extend([\"-b:a\", bitrate])\n\n    # Add other ffmpeg arguments if specified\n    if ffmpeg_args:\n        arguments.extend(shlex.split(ffmpeg_args))\n\n    # Add output file at the end\n    arguments.append(str(output_file.resolve()))\n\n    # Run ffmpeg\n    with subprocess.Popen(\n        [ffmpeg, *arguments],\n        stdin=subprocess.PIPE,\n        stdout=subprocess.PIPE,\n        stderr=subprocess.STDOUT,\n        universal_newlines=False,\n    ) as process:\n        if not progress_handler:\n            # Wait for process to finish\n            proc_out = process.communicate()\n\n            if process.returncode != 0:\n                # get version and build year\n                version = get_ffmpeg_version(ffmpeg)\n\n                # join stdout and stderr and decode to utf-8\n                message = b\"\".join([out for out in proc_out if out]).decode(\"utf-8\")\n\n                # return error dictionary\n                return False, {\n                    \"return_code\": process.returncode,\n                    \"arguments\": arguments,\n                    \"ffmpeg\": ffmpeg,\n                    \"version\": version[0],\n                    \"build_year\": version[1],\n                    \"error\": message,\n                }\n\n            return True, None\n\n        progress_handler(0)\n\n        out_buffer = []\n        total_dur = None\n        while True:\n            if process.stdout is None:\n                continue\n\n            out_line = (\n                process.stdout.readline().decode(\"utf-8\", errors=\"replace\").strip()\n            )\n\n            if out_line == \"\" and process.poll() is not None:\n                break\n\n            out_buffer.append(out_line.strip())\n\n            total_dur_match = DUR_REGEX.search(out_line)\n            if total_dur is None and total_dur_match:\n                total_dur = to_ms(**total_dur_match.groupdict())  # type: ignore\n                continue\n            if total_dur:\n                progress_time = TIME_REGEX.search(out_line)\n                if progress_time:\n                    elapsed_time = to_ms(**progress_time.groupdict())  # type: ignore\n                    progress_handler(int(elapsed_time / total_dur * 100))  # type: ignore\n\n        if process.returncode != 0:\n            # get version and build year\n            version = get_ffmpeg_version(ffmpeg)\n\n            return False, {\n                \"return_code\": process.returncode,\n                \"arguments\": arguments,\n                \"ffmpeg\": ffmpeg,\n                \"version\": version[0],\n                \"build_year\": version[1],\n                \"error\": \"\\n\".join(out_buffer),\n            }\n\n        progress_handler(100)\n\n        return True, None\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.download_ffmpeg","title":"<code>download_ffmpeg()</code>","text":"<p>Download ffmpeg binary to spotdl directory.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.download_ffmpeg--returns","title":"Returns","text":"<ul> <li>Path to ffmpeg binary.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.download_ffmpeg--notes","title":"Notes","text":"<ul> <li>ffmpeg is downloaded from github releases     for current platform and architecture.</li> <li>executable permission is set for ffmpeg binary.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def download_ffmpeg() -&gt; Path:\n    \"\"\"\n    Download ffmpeg binary to spotdl directory.\n\n    ### Returns\n    - Path to ffmpeg binary.\n\n    ### Notes\n    - ffmpeg is downloaded from github releases\n        for current platform and architecture.\n    - executable permission is set for ffmpeg binary.\n    \"\"\"\n\n    os_name = platform.system().lower()\n    os_arch = platform.machine().lower()\n    ffmpeg_url: Optional[str] = None\n\n    # if platform.system() == \"Darwin\" and (\n    #     platform.processor() == \"arm\"\n    #     or subprocess.run([\"sysctl\", \"-n\", \"sysctl.proc_translated\"], check=False)\n    # ):\n    #     ffmpeg_url = FFMPEG_URLS[\"darwin\"][\"arm\"]\n    # else:\n    #     ffmpeg_url = FFMPEG_URLS.get(os_name, {}).get(os_arch)\n\n    ffmpeg_url = FFMPEG_URLS.get(os_name, {}).get(os_arch)\n\n    if ffmpeg_url is None:\n        raise FFmpegError(\"FFmpeg binary is not available for your system.\")\n\n    ffmpeg_path = Path(\n        os.path.join(\n            get_spotdl_path(), \"ffmpeg\" + (\".exe\" if os_name == \"windows\" else \"\")\n        )\n    )\n\n    # Download binary and save it to a file in spotdl directory\n    ffmpeg_binary = requests.get(ffmpeg_url, allow_redirects=True, timeout=10).content\n    with open(ffmpeg_path, \"wb\") as ffmpeg_file:\n        ffmpeg_file.write(ffmpeg_binary)\n\n    # Set executable permission on linux and mac\n    if os_name in [\"linux\", \"darwin\"]:\n        ffmpeg_path.chmod(ffmpeg_path.stat().st_mode | stat.S_IEXEC)\n\n    return ffmpeg_path\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_path","title":"<code>get_ffmpeg_path()</code>","text":"<p>Get path to global ffmpeg binary or a local ffmpeg binary.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_path--returns","title":"Returns","text":"<ul> <li>Path to ffmpeg binary or None if not found.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def get_ffmpeg_path() -&gt; Optional[Path]:\n    \"\"\"\n    Get path to global ffmpeg binary or a local ffmpeg binary.\n\n    ### Returns\n    - Path to ffmpeg binary or None if not found.\n    \"\"\"\n\n    # Check if ffmpeg is installed\n    global_ffmpeg = shutil.which(\"ffmpeg\")\n    if global_ffmpeg:\n        return Path(global_ffmpeg)\n\n    # Get local ffmpeg path\n    return get_local_ffmpeg()\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version","title":"<code>get_ffmpeg_version(ffmpeg='ffmpeg')</code>","text":"<p>Get ffmpeg version.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version--arguments","title":"Arguments","text":"<ul> <li>ffmpeg: ffmpeg executable to check</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version--returns","title":"Returns","text":"<ul> <li>Tuple of optional version and optional year.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version--errors","title":"Errors","text":"<ul> <li>FFmpegError if ffmpeg is not installed.</li> <li>FFmpegError if ffmpeg version is not found.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def get_ffmpeg_version(ffmpeg: str = \"ffmpeg\") -&gt; Tuple[Optional[float], Optional[int]]:\n    \"\"\"\n    Get ffmpeg version.\n\n    ### Arguments\n    - ffmpeg: ffmpeg executable to check\n\n    ### Returns\n    - Tuple of optional version and optional year.\n\n    ### Errors\n    - FFmpegError if ffmpeg is not installed.\n    - FFmpegError if ffmpeg version is not found.\n    \"\"\"\n\n    # Check if ffmpeg is installed\n    if not is_ffmpeg_installed(ffmpeg):\n        if ffmpeg == \"ffmpeg\":\n            raise FFmpegError(\"ffmpeg is not installed.\")\n\n        raise FFmpegError(f\"{ffmpeg} is not a valid ffmpeg executable.\")\n\n    with subprocess.Popen(\n        [ffmpeg, \"-version\"],\n        stdout=subprocess.PIPE,\n        stderr=subprocess.PIPE,\n        encoding=\"utf-8\",\n    ) as process:\n        output = \"\".join(process.communicate())\n\n    # Search for version and build year in output\n    version_result = VERSION_REGEX.search(output)\n    year_result = YEAR_REGEX.search(output)\n\n    build_year = None\n    version = None\n\n    if version_result is not None:\n        # remove all non numeric characters from string example: n4.3\n        version_str = re.sub(r\"[a-zA-Z]\", \"\", version_result.group(0))\n\n        # parse version string to float\n        version = float(version_str) if version_str else None\n\n    if year_result is not None:\n        # get build years from string example: Copyright (c) 2019-2020\n        build_years = [\n            int(\n                re.sub(r\"[^0-9]\", \"\", year)\n            )  # remove all non numeric characters from string\n            for year in year_result.group(0).split(\n                \"-\"\n            )  # split string into list of years\n        ]\n\n        # get the highest build year\n        build_year = max(build_years)\n\n    return (version, build_year)\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_local_ffmpeg","title":"<code>get_local_ffmpeg()</code>","text":"<p>Get local ffmpeg binary path.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_local_ffmpeg--returns","title":"Returns","text":"<ul> <li>Path to ffmpeg binary or None if not found.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def get_local_ffmpeg() -&gt; Optional[Path]:\n    \"\"\"\n    Get local ffmpeg binary path.\n\n    ### Returns\n    - Path to ffmpeg binary or None if not found.\n    \"\"\"\n\n    ffmpeg_path = Path(get_spotdl_path()) / (\n        \"ffmpeg\" + (\".exe\" if platform.system() == \"Windows\" else \"\")\n    )\n\n    if ffmpeg_path.is_file():\n        return ffmpeg_path\n\n    return None\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.is_ffmpeg_installed","title":"<code>is_ffmpeg_installed(ffmpeg='ffmpeg')</code>","text":"<p>Check if ffmpeg is installed.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.is_ffmpeg_installed--arguments","title":"Arguments","text":"<ul> <li>ffmpeg: ffmpeg executable to check</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.is_ffmpeg_installed--returns","title":"Returns","text":"<ul> <li>True if ffmpeg is installed, False otherwise.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def is_ffmpeg_installed(ffmpeg: str = \"ffmpeg\") -&gt; bool:\n    \"\"\"\n    Check if ffmpeg is installed.\n\n    ### Arguments\n    - ffmpeg: ffmpeg executable to check\n\n    ### Returns\n    - True if ffmpeg is installed, False otherwise.\n    \"\"\"\n\n    if ffmpeg == \"ffmpeg\":\n        global_ffmpeg = shutil.which(\"ffmpeg\")\n        if global_ffmpeg is None:\n            ffmpeg_path = get_ffmpeg_path()\n        else:\n            ffmpeg_path = Path(global_ffmpeg)\n    else:\n        ffmpeg_path = Path(ffmpeg)\n\n    if ffmpeg_path is None:\n        return False\n\n    # else check if path to ffmpeg is valid\n    # and if ffmpeg has the correct access rights\n    return ffmpeg_path.exists() and os.access(ffmpeg_path, os.X_OK)\n</code></pre>"},{"location":"reference/utils/formatter/","title":"formatter","text":"<p>Module for formatting songs into strings. Contains functions to create search queries and song titles and file names.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.args_to_ytdlp_options","title":"<code>args_to_ytdlp_options(argument_list, defaults=None)</code>","text":"<p>Convert a list of arguments to a dictionary of options.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.args_to_ytdlp_options--arguments","title":"Arguments","text":"<ul> <li>argument_list: the list of arguments</li> <li>defaults: the default options</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.args_to_ytdlp_options--returns","title":"Returns","text":"<ul> <li>the dictionary of options</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def args_to_ytdlp_options(\n    argument_list: List[str], defaults: Optional[Dict[str, Any]] = None\n) -&gt; Dict[str, Any]:\n    \"\"\"\n    Convert a list of arguments to a dictionary of options.\n\n    ### Arguments\n    - argument_list: the list of arguments\n    - defaults: the default options\n\n    ### Returns\n    - the dictionary of options\n    \"\"\"\n\n    new_args = YT_DLP_PARSER.parse_args(argument_list, yt_dlp_optparse.Values(defaults))\n\n    return vars(new_args[0])\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_file_name","title":"<code>create_file_name(song, template, file_extension, restrict=None, short=False, file_name_length=None)</code>","text":"<p>Create the file name for the song, by replacing template variables with the actual values.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_file_name--arguments","title":"Arguments","text":"<ul> <li>song: the song object</li> <li>template: the template string</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>file_name_length: the maximum length of the file name</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_file_name--returns","title":"Returns","text":"<ul> <li>the formatted string as a Path object</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_file_name(\n    song: Song,\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    file_name_length: Optional[int] = None,\n) -&gt; Path:\n    \"\"\"\n    Create the file name for the song, by replacing template variables with the actual values.\n\n    ### Arguments\n    - song: the song object\n    - template: the template string\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - file_name_length: the maximum length of the file name\n\n    ### Returns\n    - the formatted string as a Path object\n    \"\"\"\n\n    temp_song = copy.deepcopy(song)\n\n    # If template does not contain any of the keys,\n    # append {artists} - {title}.{output-ext} to it\n    if not any(key in template for key in VARS) and template != \"\":\n        template += \"/{artists} - {title}.{output-ext}\"\n\n    if template == \"\":\n        template = \"{artists} - {title}.{output-ext}\"\n\n    # If template ends with a slash. Does not have a file name with extension\n    # at the end of the template, append {artists} - {title}.{output-ext} to it\n    if template.endswith(\"/\") or template.endswith(r\"\\\\\") or template.endswith(\"\\\\\\\\\"):\n        template += \"/{artists} - {title}.{output-ext}\"\n\n    # If template does not end with {output-ext}, append it to the end of the template\n    if not template.endswith(\".{output-ext}\"):\n        template += \".{output-ext}\"\n\n    formatted_string = format_query(\n        song=song,\n        template=template,\n        santitize=True,\n        file_extension=file_extension,\n        short=short,\n    )\n\n    file = create_path_object(formatted_string)\n\n    length_limit = file_name_length or 255\n\n    # Check if the file name length is greater than the limit\n    if len(file.name) &lt; length_limit:\n        # Restrict the filename if needed\n        if restrict and restrict != \"none\":\n            return restrict_filename(file, restrict == \"strict\")\n\n        return file\n\n    if short is False:\n        return create_file_name(\n            song,\n            template,\n            file_extension,\n            restrict=restrict,\n            short=True,\n            file_name_length=length_limit,\n        )\n\n    non_template_chars = re.findall(r\"(?&lt;!{)[^{}]+(?![^{}]*})\", template)\n    half_length = int((length_limit * 0.50) - (len(\"\".join(non_template_chars)) / 2))\n\n    # Path template is already short, but we still can't create a file\n    # so we reduce it even further\n    is_long_artist = len(temp_song.artist) &gt; half_length\n    is_long_title = len(temp_song.name) &gt; half_length\n\n    path_separator = \"/\" if \"/\" in template else \"\\\\\"\n    name_template_parts = template.rsplit(path_separator, 1)\n    name_template = (\n        name_template_parts[1]\n        if len(name_template_parts) &gt; 1\n        else name_template_parts[0]\n    )\n\n    if is_long_artist:\n        logger.warning(\n            \"%s: Song artist is too long. Using only part of song artist.\",\n            temp_song.display_name,\n        )\n\n        temp_song.artist = smart_split(temp_song.artist, half_length, None)\n        temp_song.artists = [temp_song.artist]\n\n    if is_long_title:\n        logger.warning(\n            \"%s: File name is too long. Using only part of the song title.\",\n            temp_song.display_name,\n        )\n\n        temp_song.name = smart_split(temp_song.name, half_length, None)\n\n    new_file = create_path_object(\n        format_query(\n            song=temp_song,\n            template=name_template,\n            santitize=True,\n            file_extension=file_extension,\n            short=short,\n        )\n    )\n\n    if len(new_file.name) &gt; length_limit:\n        logger.warning(\n            \"File name is still too long. \"\n            \"Using default file name with shortened artist and title.\"\n        )\n\n        if template == \"{artist} - {title}.{output-ext}\":\n            raise ValueError(\n                \"File name is still too long, \"\n                \"but the template is already short. \"\n                \"Please try other template, \"\n                \"increase the file name length limit.\"\n            )\n\n        return create_file_name(\n            temp_song,\n            \"{artist} - {title}.{output-ext}\",\n            file_extension,\n            restrict=restrict,\n            short=True,\n            file_name_length=length_limit,\n        )\n\n    return new_file\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_path_object","title":"<code>create_path_object(string)</code>","text":"<p>Create a Path object from a string. Sanitizes the filename part of the Path object.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_path_object--arguments","title":"Arguments","text":"<ul> <li>string: the string to convert</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_path_object--returns","title":"Returns","text":"<ul> <li>the Path object</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_path_object(string: str) -&gt; Path:\n    \"\"\"\n    Create a Path object from a string.\n    Sanitizes the filename part of the Path object.\n\n    ### Arguments\n    - string: the string to convert\n\n    ### Returns\n    - the Path object\n    \"\"\"\n\n    # Parse template as Path object\n    file = Path(string)\n\n    santitized_parts = []\n    for part in file.parts:\n        match = re.search(r\"[^\\.*](.*)[^\\.*$]\", part)\n        if match and part != \".spotdl\":\n            santitized_parts.append(match.group(0))\n        else:\n            santitized_parts.append(part)\n\n    # Join the parts of the path\n    return Path(*santitized_parts)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_search_query","title":"<code>create_search_query(song, template, santitize, file_extension=None, short=False)</code>","text":"<p>Create the search query for the song.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_search_query--arguments","title":"Arguments","text":"<ul> <li>song: the song object</li> <li>template: the template string</li> <li>santitize: whether to sanitize the string</li> <li>file_extension: the file extension to use</li> <li>short: whether to use the short version of the template</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_search_query--returns","title":"Returns","text":"<ul> <li>the formatted string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_search_query(\n    song: Song,\n    template: str,\n    santitize: bool,\n    file_extension: Optional[str] = None,\n    short: bool = False,\n) -&gt; str:\n    \"\"\"\n    Create the search query for the song.\n\n    ### Arguments\n    - song: the song object\n    - template: the template string\n    - santitize: whether to sanitize the string\n    - file_extension: the file extension to use\n    - short: whether to use the short version of the template\n\n    ### Returns\n    - the formatted string\n    \"\"\"\n\n    # If template does not contain any of the keys,\n    # append {artist} - {title} at the beginning of the template\n    if not any(key in template for key in VARS):\n        template = \"{artist} - {title}\" + template\n\n    return format_query(song, template, santitize, file_extension, short=short)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title","title":"<code>create_song_title(song_name, song_artists)</code>","text":"<p>Create the song title.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title--arguments","title":"Arguments","text":"<ul> <li>song_name: the name of the song</li> <li>song_artists: the list of artists of the song</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title--returns","title":"Returns","text":"<ul> <li>the song title</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title--notes","title":"Notes","text":"<ul> <li>Example: \"Artist1, Artist2 - Song Name\"</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_song_title(song_name: str, song_artists: List[str]) -&gt; str:\n    \"\"\"\n    Create the song title.\n\n    ### Arguments\n    - song_name: the name of the song\n    - song_artists: the list of artists of the song\n\n    ### Returns\n    - the song title\n\n    ### Notes\n    - Example: \"Artist1, Artist2 - Song Name\"\n\n    \"\"\"\n\n    joined_artists = \", \".join(song_artists)\n    if len(song_artists) &gt;= 1:\n        return f\"{joined_artists} - {song_name}\"\n\n    return song_name\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.format_query","title":"<code>format_query(song, template, santitize, file_extension=None, short=False)</code>","text":"<p>Replace template variables with the actual values.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.format_query--arguments","title":"Arguments","text":"<ul> <li>song: the song object</li> <li>template: the template string</li> <li>santitize: whether to sanitize the string</li> <li>file_extension: the file extension to use</li> <li>short: whether to use the short version of the template</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.format_query--returns","title":"Returns","text":"<ul> <li>the formatted string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def format_query(\n    song: Song,\n    template: str,\n    santitize: bool,\n    file_extension: Optional[str] = None,\n    short: bool = False,\n) -&gt; str:\n    \"\"\"\n    Replace template variables with the actual values.\n\n    ### Arguments\n    - song: the song object\n    - template: the template string\n    - santitize: whether to sanitize the string\n    - file_extension: the file extension to use\n    - short: whether to use the short version of the template\n\n    ### Returns\n    - the formatted string\n    \"\"\"\n\n    if \"{output-ext}\" in template and file_extension is None:\n        raise ValueError(\"file_extension is None, but template contains {output-ext}\")\n\n    for key, val in [\n        (\"{list-length}\", song.list_length),\n        (\"{list-position}\", song.list_position),\n        (\"{list-name}\", song.list_name),\n    ]:\n        if not (key in template and val is None):\n            continue\n\n        logger.warning(\n            \"Template contains %s, but it's value is None. Replacing with empty string.\",\n            key,\n        )\n\n        template = template.replace(key, \"\")\n        template = template.replace(r\"//\", r\"/\")\n\n    # If template has only {output-ext}, fix it\n    if template in [\"/.{output-ext}\", \".{output-ext}\"]:\n        template = \"{artists} - {title}.{output-ext}\"\n\n    # Remove artists from the list that are already in the title\n    if short:\n        artists = [\n            artist\n            for artist in song.artists\n            if slugify(artist) not in slugify(song.name)\n        ]\n\n        # Add the main artist again to the list\n        if len(artists) == 0 or artists[0] != song.artists[0]:\n            artists.insert(0, song.artists[0])\n    else:\n        artists = song.artists\n\n    artists_str = \", \".join(artists)\n\n    # the code below is valid, song_list is actually checked for None\n    formats = {\n        \"{title}\": song.name,\n        \"{artists}\": song.artists[0] if short is True else artists_str,\n        \"{artist}\": song.artists[0],\n        \"{album}\": song.album_name,\n        \"{album-artist}\": song.album_artist,\n        \"{genre}\": song.genres[0] if song.genres else \"\",\n        \"{disc-number}\": song.disc_number,\n        \"{disc-count}\": song.disc_count,\n        \"{duration}\": song.duration,\n        \"{year}\": song.year,\n        \"{original-date}\": song.date,\n        \"{track-number}\": f\"{int(song.track_number):02d}\" if song.track_number else \"\",\n        \"{tracks-count}\": song.tracks_count,\n        \"{isrc}\": song.isrc,\n        \"{track-id}\": song.song_id,\n        \"{publisher}\": song.publisher,\n        \"{output-ext}\": file_extension,\n        \"{list-name}\": song.list_name,\n        \"{list-position}\": str(song.list_position).zfill(len(str(song.list_length))),\n        \"{list-length}\": song.list_length,\n    }\n\n    if santitize:\n        # sanitize the values in formats dict\n        for key, value in formats.items():\n            if value is None:\n                continue\n\n            formats[key] = sanitize_string(str(value))\n\n    # Replace all the keys with the values\n    for key, value in formats.items():\n        template = template.replace(key, str(value))\n\n    return template\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.parse_duration","title":"<code>parse_duration(duration)</code>","text":"<p>Convert string value of time (duration: \"25:36:59\") to a float value of seconds (92219.0)</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.parse_duration--arguments","title":"Arguments","text":"<ul> <li>duration: the string value of time</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.parse_duration--returns","title":"Returns","text":"<ul> <li>the float value of seconds</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def parse_duration(duration: Optional[str]) -&gt; float:\n    \"\"\"\n    Convert string value of time (duration: \"25:36:59\") to a float value of seconds (92219.0)\n\n    ### Arguments\n    - duration: the string value of time\n\n    ### Returns\n    - the float value of seconds\n    \"\"\"\n\n    if duration is None:\n        return 0.0\n\n    try:\n        # {(1, \"s\"), (60, \"m\"), (3600, \"h\")}\n        mapped_increments = zip([1, 60, 3600], reversed(duration.split(\":\")))\n        seconds = sum(multiplier * int(time) for multiplier, time in mapped_increments)\n        return float(seconds)\n\n    # This usually occurs when the wrong string is mistaken for the duration\n    except (ValueError, TypeError, AttributeError):\n        return 0.0\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.ratio","title":"<code>ratio(string1, string2)</code>  <code>cached</code>","text":"<p>Wrapper for fuzz.ratio with lru_cache</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.ratio--arguments","title":"Arguments","text":"<ul> <li>string1: the first string</li> <li>string2: the second string</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.ratio--returns","title":"Returns","text":"<ul> <li>the ratio</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>@lru_cache()\ndef ratio(string1: str, string2: str) -&gt; float:\n    \"\"\"\n    Wrapper for fuzz.ratio\n    with lru_cache\n\n    ### Arguments\n    - string1: the first string\n    - string2: the second string\n\n    ### Returns\n    - the ratio\n    \"\"\"\n\n    return fuzz.ratio(string1, string2)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename","title":"<code>restrict_filename(pathobj, strict=True)</code>","text":"<p>Sanitizes the filename part of a Path object. Returns modified object.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename--arguments","title":"Arguments","text":"<ul> <li>pathobj: the Path object to sanitize</li> <li>strict: whether sanitization should be strict</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename--returns","title":"Returns","text":"<ul> <li>the modified Path object</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename--notes","title":"Notes","text":"<ul> <li>Based on the <code>sanitize_filename</code> function from yt-dlp</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def restrict_filename(pathobj: Path, strict: bool = True) -&gt; Path:\n    \"\"\"\n    Sanitizes the filename part of a Path object. Returns modified object.\n\n    ### Arguments\n    - pathobj: the Path object to sanitize\n    - strict: whether sanitization should be strict\n\n    ### Returns\n    - the modified Path object\n\n    ### Notes\n    - Based on the `sanitize_filename` function from yt-dlp\n    \"\"\"\n    if strict:\n        result = sanitize_filename(pathobj.name, True, False)  # type: ignore\n        result = result.replace(\"_-_\", \"-\")\n    else:\n        result = (\n            normalize(\"NFKD\", pathobj.name).encode(\"ascii\", \"ignore\").decode(\"utf-8\")\n        )\n\n    if not result:\n        result = \"_\"\n\n    return pathobj.with_name(result)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.sanitize_string","title":"<code>sanitize_string(string)</code>","text":"<p>Sanitize the filename to be used in the file system.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.sanitize_string--arguments","title":"Arguments","text":"<ul> <li>string: the string to sanitize</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.sanitize_string--returns","title":"Returns","text":"<ul> <li>the sanitized string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def sanitize_string(string: str) -&gt; str:\n    \"\"\"\n    Sanitize the filename to be used in the file system.\n\n    ### Arguments\n    - string: the string to sanitize\n\n    ### Returns\n    - the sanitized string\n    \"\"\"\n\n    output = string\n\n    # this is windows specific (disallowed chars)\n    output = \"\".join(char for char in output if char not in \"/?\\\\*|&lt;&gt;\")\n\n    # double quotes (\") and semi-colons (:) are also disallowed characters but we would\n    # like to retain their equivalents, so they aren't removed in the prior loop\n    output = output.replace('\"', \"'\").replace(\":\", \"-\")\n\n    return output\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.slugify","title":"<code>slugify(string)</code>  <code>cached</code>","text":"<p>Slugify the string.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.slugify--arguments","title":"Arguments","text":"<ul> <li>string: the string to slugify</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.slugify--returns","title":"Returns","text":"<ul> <li>the slugified string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>@lru_cache()\ndef slugify(string: str) -&gt; str:\n    \"\"\"\n    Slugify the string.\n\n    ### Arguments\n    - string: the string to slugify\n\n    ### Returns\n    - the slugified string\n    \"\"\"\n\n    # Replace ambiguous characters\n    if not JAP_REGEX.search(string):\n        # If string doesn't have japanese characters\n        # return early\n        return py_slugify(string, regex_pattern=DISALLOWED_REGEX.pattern)\n\n    # Workaround for japanese characters\n    # because slugify incorrectly converts them\n    # to latin characters\n    normal_slug = py_slugify(\n        string,\n        regex_pattern=JAP_REGEX.pattern,\n    )\n\n    results = KKS.convert(normal_slug)\n\n    result = \"\"\n    for index, item in enumerate(results):\n        result += item[\"hepburn\"]\n        if not (\n            item[\"kana\"] == item[\"hepburn\"]\n            or item[\"kana\"] == item[\"hepburn\"]\n            or (\n                item == results[-1]\n                or results[index + 1][\"kana\"] == results[index + 1][\"hepburn\"]\n            )\n        ):\n            result += \"-\"\n\n    return py_slugify(result, regex_pattern=DISALLOWED_REGEX.pattern)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.smart_split","title":"<code>smart_split(string, max_length, separators=None)</code>","text":"<p>Split a string into a list of strings with a maximum length of max_length. Stops at the first separator that produces a string with a length less than max_length.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.smart_split--arguments","title":"Arguments","text":"<ul> <li>string: the string to split</li> <li>max_length: the maximum length of string</li> <li>separators: the separators to split the string with</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.smart_split--returns","title":"Returns","text":"<ul> <li>the new string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def smart_split(\n    string: str, max_length: int, separators: Optional[List[str]] = None\n) -&gt; str:\n    \"\"\"\n    Split a string into a list of strings\n    with a maximum length of max_length.\n    Stops at the first separator that produces a string\n    with a length less than max_length.\n\n    ### Arguments\n    - string: the string to split\n    - max_length: the maximum length of string\n    - separators: the separators to split the string with\n\n    ### Returns\n    - the new string\n    \"\"\"\n\n    if separators is None:\n        separators = [\"-\", \",\", \" \", \"\"]\n\n    for separator in separators:\n        parts = string.split(separator if separator != \"\" else None)\n        new_string = separator.join(parts[:1])\n        for part in parts[1:]:\n            if len(new_string) + len(separator) + len(part) &gt; max_length:\n                break\n            new_string += separator + part\n\n        if len(new_string) &lt;= max_length:\n            return new_string\n\n    return string[:max_length]\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms","title":"<code>to_ms(string=None, precision=None, **kwargs)</code>","text":"<p>Convert a string to milliseconds.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms--arguments","title":"Arguments","text":"<ul> <li>string: the string to convert</li> <li>precision: the number of decimals to round to</li> <li>kwargs: the keyword args to convert</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms--returns","title":"Returns","text":"<ul> <li>the milliseconds</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms--notes","title":"Notes","text":"<ul> <li>You can either pass a string,</li> <li>or a set of keyword args (\"hour\", \"min\", \"sec\", \"ms\") to convert.</li> <li>If \"precision\" is set, the result is rounded to the number of decimals given.</li> <li>From: https://gist.github.com/Hellowlol/5f8545e999259b4371c91ac223409209</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def to_ms(\n    string: Optional[str] = None, precision: Optional[int] = None, **kwargs\n) -&gt; float:\n    \"\"\"\n    Convert a string to milliseconds.\n\n    ### Arguments\n    - string: the string to convert\n    - precision: the number of decimals to round to\n    - kwargs: the keyword args to convert\n\n    ### Returns\n    - the milliseconds\n\n    ### Notes\n    - You can either pass a string,\n    - or a set of keyword args (\"hour\", \"min\", \"sec\", \"ms\") to convert.\n    - If \"precision\" is set, the result is rounded to the number of decimals given.\n    - From: https://gist.github.com/Hellowlol/5f8545e999259b4371c91ac223409209\n    \"\"\"\n\n    if string:\n        hour = int(string[0:2])\n        minute = int(string[3:5])\n        sec = int(string[6:8])\n        milliseconds = int(string[10:11])\n    else:\n        hour = int(kwargs.get(\"hour\", 0))\n        minute = int(kwargs.get(\"min\", 0))\n        sec = int(kwargs.get(\"sec\", 0))\n        milliseconds = int(kwargs.get(\"ms\", 0))\n\n    result = (\n        (hour * 60 * 60 * 1000) + (minute * 60 * 1000) + (sec * 1000) + milliseconds\n    )\n\n    if precision and isinstance(precision, int):\n        return round(result, precision)\n\n    return result\n</code></pre>"},{"location":"reference/utils/github/","title":"github","text":"<p>Module for getting information about the current version of spotdl from GitHub, downloading the latest version, and checking for updates.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.RateLimitError","title":"<code>RateLimitError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Raised when the GitHub API rate limit is exceeded.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.check_for_updates","title":"<code>check_for_updates(repo=REPO)</code>","text":"<p>Check for updates to the current version.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.check_for_updates--arguments","title":"Arguments","text":"<ul> <li>repo: the repo to check (defaults to spotdl/spotify-downloader)</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.check_for_updates--returns","title":"Returns","text":"<ul> <li>the latest version</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def check_for_updates(repo: str = REPO) -&gt; str:\n    \"\"\"\n    Check for updates to the current version.\n\n    ### Arguments\n    - repo: the repo to check (defaults to spotdl/spotify-downloader)\n\n    ### Returns\n    - the latest version\n    \"\"\"\n\n    message = \"\"\n\n    latest_version = get_latest_version(repo)\n    current_version = f\"v{_version.__version__}\"  # returns \"vx.x.x\"\n\n    if latest_version != current_version:\n        message = f\"New version available: {latest_version}.\\n\\n\"\n    else:\n        message = \"No updates available.\\n\\n\"\n    try:\n        master = get_status(current_version, \"master\")\n        dev = get_status(current_version, \"dev\")\n    except RuntimeError:\n        message = \"Couldn't check for updates. You might be running a dev version.\\n\"\n        message += \"Current version: \" + current_version + \"\\n\"\n        message += \"Latest version: \" + latest_version\n        return message\n    except RateLimitError:\n        message = \"GitHub API rate limit exceeded. Couldn't check for updates.\\n\"\n        message += \"Current version: \" + current_version + \"\\n\"\n        message += \"Latest version: \" + latest_version + \"\\n\"\n        message += \"Please try again later.\"\n        return message\n\n    for branch in [\"master\", \"dev\"]:\n        name = branch.capitalize()\n        if branch == \"master\":\n            status, ahead_by, behind_by = master\n        else:\n            status, ahead_by, behind_by = dev\n\n        if status == \"behind\":\n            message += f\"{name} is {status} by {behind_by} commits.\\n\"\n        elif status == \"ahead\":\n            message += f\"{name} is {status} by {ahead_by} commits.\\n\"\n        else:\n            message += f\"{name} is up to date.\\n\"\n\n    return message\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.create_github_url","title":"<code>create_github_url(url=WEB_APP_URL)</code>","text":"<p>From the given url, produce a URL that is compatible with Github's REST API.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.create_github_url--arguments","title":"Arguments","text":"<ul> <li>url: the url to convert</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.create_github_url--notes","title":"Notes","text":"<ul> <li>Can handle blob or tree paths.</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def create_github_url(url: str = WEB_APP_URL):\n    \"\"\"\n    From the given url, produce a URL that is compatible with Github's REST API.\n\n    ### Arguments\n    - url: the url to convert\n\n    ### Notes\n    - Can handle blob or tree paths.\n    \"\"\"\n\n    repo_only_url = re.compile(\n        r\"https:\\/\\/github\\.com\\/[a-z\\d](?:[a-z\\d]|-(?=[a-z\\d])){0,38}\\/[a-zA-Z0-9]+$\"\n    )\n    re_branch = re.compile(\"/(tree|blob)/(.+?)/\")\n\n    # Check if the given url is a url to a GitHub repo. If it is, tell the\n    # user to use 'git clone' to download it\n    if re.match(repo_only_url, url):\n        raise ValueError(\n            \"The given URL is a GitHub repo. Please use 'git clone' to download it.\"\n        )\n\n    # extract the branch name from the given url (e.g master)\n    branch = re_branch.search(url)\n    if branch:\n        download_dirs = url[branch.end() :]\n        api_url = (\n            url[: branch.start()].replace(\"github.com\", \"api.github.com/repos\", 1)\n            + \"/contents/\"\n            + download_dirs\n            + \"?ref=\"\n            + branch.group(2)\n        )\n        return api_url\n\n    raise ValueError(\"The given url is not a valid GitHub url\")\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.download_github_dir","title":"<code>download_github_dir(repo_url=WEB_APP_URL, flatten=False, output_dir='./')</code>","text":"<p>Downloads the files and directories in repo_url.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.download_github_dir--arguments","title":"Arguments","text":"<ul> <li>repo_url: the url to the repo to download</li> <li>flatten: whether to flatten the directory structure</li> <li>output_dir: the directory to download the files to</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.download_github_dir--notes","title":"Notes","text":"<ul> <li>Modification of /~https://github.com/sdushantha/gitdir/blob/master/gitdir/gitdir.py</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def download_github_dir(\n    repo_url: str = WEB_APP_URL, flatten: bool = False, output_dir: str = \"./\"\n):\n    \"\"\"\n    Downloads the files and directories in repo_url.\n\n    ### Arguments\n    - repo_url: the url to the repo to download\n    - flatten: whether to flatten the directory structure\n    - output_dir: the directory to download the files to\n\n    ### Notes\n    - Modification of /~https://github.com/sdushantha/gitdir/blob/master/gitdir/gitdir.py\n    \"\"\"\n\n    # generate the url which returns the JSON data\n    api_url = create_github_url(repo_url)\n\n    dir_out = output_dir\n\n    response = requests.get(api_url, timeout=10).json()\n\n    if (\n        isinstance(response, dict)\n        and \"message\" in response.keys()\n        and \"rate limit\" in response[\"message\"]\n    ):\n        logging.error(\n            \"You have been rate limited by Github API attempting to update web client.\"\n            \"Proceeding with cached web client. Please try again later.\"\n            \"See https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting\"\n        )\n        return None\n\n    if not flatten:\n        # make a directory with the name which is taken from\n        # the actual repo\n        os.makedirs(dir_out, exist_ok=True)\n\n    if isinstance(response, dict) and response[\"type\"] == \"file\":\n        response = [response]\n\n    for file in response:\n        file_url = file[\"download_url\"]\n\n        if flatten:\n            path = os.path.join(dir_out, os.path.basename(file[\"path\"]))\n        else:\n            path = os.path.join(dir_out, file[\"path\"])\n\n        dirname = os.path.dirname(path)\n\n        if dirname != \"\":\n            os.makedirs(dirname, exist_ok=True)\n\n        if file_url is not None:\n            with open(path, \"wb\") as new_file:\n                new_file.write(requests.get(file_url, timeout=10).content)\n        else:\n            download_github_dir(file[\"html_url\"], flatten, output_dir)\n\n    return None\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.get_latest_version","title":"<code>get_latest_version(repo=REPO)</code>","text":"<p>Get the latest version of spotdl.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.get_latest_version--arguments","title":"Arguments","text":"<ul> <li>repo: the repo to check (defaults to spotdl/spotify-downloader)</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.get_latest_version--returns","title":"Returns","text":"<ul> <li>the latest version</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def get_latest_version(repo: str = REPO) -&gt; str:\n    \"\"\"\n    Get the latest version of spotdl.\n\n    ### Arguments\n    - repo: the repo to check (defaults to spotdl/spotify-downloader)\n\n    ### Returns\n    - the latest version\n    \"\"\"\n\n    url = f\"https://api.github.com/repos/{repo}/releases/latest\"\n\n    response = requests.get(url, timeout=10)\n\n    if response.status_code != 200:\n        if response.status_code == 403:\n            raise RateLimitError(\"GitHub API rate limit exceeded.\")\n\n        raise RuntimeError(\n            f\"Failed to get commit count. Status code: {response.status_code}\"\n        )\n\n    data = response.json()\n\n    return data[\"name\"]  # returns \"vx.x.x\"\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.get_status","title":"<code>get_status(start, end, repo=REPO)</code>","text":"<p>Get the status of a commit range.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.get_status--arguments","title":"Arguments","text":"<ul> <li>start: the starting commit/branch/tag</li> <li>end: the ending commit/branch/tag</li> <li>repo: the repo to check (defaults to spotdl/spotify-downloader)</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.get_status--returns","title":"Returns","text":"<ul> <li>tuple of (status, ahead_by, behind_by)</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def get_status(start: str, end: str, repo: str = REPO) -&gt; Tuple[str, int, int]:\n    \"\"\"\n    Get the status of a commit range.\n\n    ### Arguments\n    - start: the starting commit/branch/tag\n    - end: the ending commit/branch/tag\n    - repo: the repo to check (defaults to spotdl/spotify-downloader)\n\n    ### Returns\n    - tuple of (status, ahead_by, behind_by)\n    \"\"\"\n\n    url = f\"https://api.github.com/repos/{repo}/compare/{start}...{end}\"\n\n    response = requests.get(url, timeout=10)\n\n    if response.status_code != 200:\n        if response.status_code == 403:\n            raise RateLimitError(\"GitHub API rate limit exceeded.\")\n\n        raise RuntimeError(\n            f\"Failed to get commit count. Status code: {response.status_code}\"\n        )\n\n    data = response.json()\n\n    return (\n        data[\"status\"],\n        data[\"ahead_by\"],\n        data[\"behind_by\"],\n    )\n</code></pre>"},{"location":"reference/utils/logging/","title":"logging","text":"<p>Module for logging</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlFormatter","title":"<code>SpotdlFormatter</code>","text":"<p>               Bases: <code>Formatter</code></p> <p>A custom logger for spotdl.</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlFormatter.format","title":"<code>format(record)</code>","text":"<p>Format a log record.</p> Source code in <code>spotdl/utils/logging.py</code> <pre><code>def format(self, record: logging.LogRecord) -&gt; str:\n    \"\"\"\n    Format a log record.\n    \"\"\"\n\n    result = escape(super().format(record))\n\n    msg = result\n    if record.levelno == DEBUG:\n        msg = f\"[blue]{result}\"\n\n    if record.levelno == MATCH:\n        msg = f\"[magenta]{result}\"\n\n    if record.levelno == INFO:\n        msg = f\"[green]{result}\"\n\n    if record.levelno == WARNING:\n        msg = f\"[yellow]{result}\"\n\n    if record.levelno == ERROR:\n        msg = f\"[red]{result}\"\n\n    if record.levelno == CRITICAL:\n        msg = f\"[bold red]{result}\"\n\n    return msg\n</code></pre>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler","title":"<code>SpotdlHandler</code>","text":"<p>               Bases: <code>RichHandler</code></p> <p>A custom logging handler for spotdl. In this case, it's just a wrapper around the rich handler. To not highlight keywords in info messages</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler.render_message","title":"<code>render_message(record, message)</code>","text":"<p>Render message text in to Text.</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler.render_message--arguments","title":"Arguments","text":"<ul> <li>record: logging Record.</li> <li>message: String containing log message.</li> </ul>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler.render_message--returns","title":"Returns","text":"<ul> <li>ConsoleRenderable: Renderable to display log message.</li> </ul> Source code in <code>spotdl/utils/logging.py</code> <pre><code>def render_message(\n    self, record: logging.LogRecord, message: str\n) -&gt; \"ConsoleRenderable\":\n    \"\"\"Render message text in to Text.\n\n    ### Arguments\n    - record: logging Record.\n    - message: String containing log message.\n\n    ### Returns\n    - ConsoleRenderable: Renderable to display log message.\n    \"\"\"\n\n    use_markup = getattr(record, \"markup\", self.markup)\n    message_text = Text.from_markup(message) if use_markup else Text(message)\n\n    highlighter = getattr(record, \"highlighter\", self.highlighter)\n\n    # Don't highlight info messages\n    if highlighter and record.levelno != INFO:\n        message_text = highlighter(message_text)\n\n    if not hasattr(self, \"keywords\"):\n        self.keywords = self.KEYWORDS\n\n    # Don't highlight keywords in info messages\n    if self.keywords and record.levelno != INFO:\n        message_text.highlight_words(self.keywords, \"logging.keyword\")\n\n    return message_text\n</code></pre>"},{"location":"reference/utils/logging/#spotdl.utils.logging.init_logging","title":"<code>init_logging(log_level, log_format=None)</code>","text":"<p>Initialize logging for spotdl.</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.init_logging--arguments","title":"Arguments","text":"<ul> <li><code>console</code>: The console to use.</li> <li><code>log_level</code>: The log level to use.</li> </ul> Source code in <code>spotdl/utils/logging.py</code> <pre><code>def init_logging(log_level: str, log_format: Optional[str] = None):\n    \"\"\"\n    Initialize logging for spotdl.\n\n    ### Arguments\n    - `console`: The console to use.\n    - `log_level`: The log level to use.\n    \"\"\"\n\n    # Don't log too much\n    logging.getLogger(\"requests\").setLevel(logging.WARNING)\n    logging.getLogger(\"urllib3\").setLevel(logging.WARNING)\n    logging.getLogger(\"spotipy\").setLevel(logging.WARNING)\n    logging.getLogger(\"asyncio\").setLevel(logging.WARNING)\n    logging.getLogger(\"syncedlyrics\").setLevel(logging.WARNING)\n    logging.getLogger(\"bandcamp_api\").setLevel(logging.WARNING)\n    logging.getLogger(\"beautifulsoup4\").setLevel(logging.WARNING)\n    logging.getLogger(\"pytube\").setLevel(logging.ERROR)\n\n    # Create console\n    console = get_console()\n    console.push_theme(THEME)\n\n    # Add matching level loggers\n    logging.addLevelName(MATCH, \"MATCH\")\n\n    # Create a rich handler\n    rich_handler = SpotdlHandler(\n        show_time=log_level == \"DEBUG\",\n        log_time_format=\"[%X]\",\n        omit_repeated_times=False,\n        console=console,\n        level=log_level,\n        markup=True,\n        show_path=log_level == \"DEBUG\",\n        show_level=log_level == \"DEBUG\",\n        rich_tracebacks=True,\n    )\n\n    msg_format = \"%(message)s\"\n    if log_format is None:\n        if log_level == \"DEBUG\":\n            msg_format = \"%(threadName)s - %(message)s\"\n    else:\n        msg_format = log_format\n\n    # Add rich handler to spotdl logger\n    rich_handler.setFormatter(SpotdlFormatter(msg_format))\n\n    # Create spotdl logger\n    spotdl_logger = logging.getLogger(\"spotdl\")\n\n    # Setup spotdl logger\n    spotdl_logger.setLevel(log_level)\n    spotdl_logger.addHandler(rich_handler)\n\n    # Install rich traceback handler\n    install(show_locals=False, extra_lines=1, console=console)\n</code></pre>"},{"location":"reference/utils/lrc/","title":"lrc","text":"<p>LRC related functions</p>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.generate_lrc","title":"<code>generate_lrc(song, output_file)</code>","text":"<p>Generates an LRC file for the current song</p>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.generate_lrc--arguments","title":"Arguments","text":"<ul> <li>song: Song object</li> <li>output_file: Path to the output file</li> </ul> Source code in <code>spotdl/utils/lrc.py</code> <pre><code>def generate_lrc(song: Song, output_file: Path):\n    \"\"\"\n    Generates an LRC file for the current song\n\n    ### Arguments\n    - song: Song object\n    - output_file: Path to the output file\n    \"\"\"\n\n    if song.lyrics and has_translation(song.lyrics):\n        lrc_data = song.lyrics\n    else:\n        try:\n            lrc_data = syncedlyrics_search(song.display_name)\n        except Exception:\n            lrc_data = None\n\n    if lrc_data:\n        Lyrics(lrc_data).save_lrc_file(\n            str(output_file.with_suffix(\".lrc\")), TargetType.PREFER_SYNCED\n        )\n        logger.debug(\"Saved lrc file for %s\", song.display_name)\n    else:\n        logger.debug(\"No lrc file found for %s\", song.display_name)\n</code></pre>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.remomve_lrc","title":"<code>remomve_lrc(lyrics)</code>","text":"<p>Removes lrc tags from lyrics</p>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.remomve_lrc--arguments","title":"Arguments","text":"<ul> <li>lyrics: Lyrics string</li> </ul>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.remomve_lrc--returns","title":"Returns","text":"<ul> <li>Lyrics string without lrc tags</li> </ul> Source code in <code>spotdl/utils/lrc.py</code> <pre><code>def remomve_lrc(lyrics: str) -&gt; str:\n    \"\"\"\n    Removes lrc tags from lyrics\n\n    ### Arguments\n    - lyrics: Lyrics string\n\n    ### Returns\n    - Lyrics string without lrc tags\n    \"\"\"\n\n    return re.sub(r\"\\[.*?\\]\", \"\", lyrics)\n</code></pre>"},{"location":"reference/utils/m3u/","title":"m3u","text":"<p>Module for creating m3u content and writing it to a file.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_content","title":"<code>create_m3u_content(song_list, template, file_extension, restrict=None, short=False, detect_formats=None)</code>","text":"<p>Create m3u content and return it as a string.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_content--arguments","title":"Arguments","text":"<ul> <li>song_list: the list of songs</li> <li>template: the template to use</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> </ul>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_content--returns","title":"Returns","text":"<ul> <li>the m3u content as a string</li> </ul> Source code in <code>spotdl/utils/m3u.py</code> <pre><code>def create_m3u_content(\n    song_list: List[Song],\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    detect_formats: Optional[List[str]] = None,\n) -&gt; str:\n    \"\"\"\n    Create m3u content and return it as a string.\n\n    ### Arguments\n    - song_list: the list of songs\n    - template: the template to use\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n\n    ### Returns\n    - the m3u content as a string\n    \"\"\"\n\n    text = \"\"\n    for song in song_list:\n        if not detect_formats:\n            file_name = create_file_name(\n                song, template, file_extension, restrict, short\n            )\n\n            text += str(file_name) + \"\\n\"\n        else:\n            for file_ext in detect_formats:\n                file_name = create_file_name(song, template, file_ext, restrict, short)\n                if file_name.exists():\n                    text += str(file_name) + \"\\n\"\n                    break\n            else:\n                file_name = create_file_name(\n                    song, template, file_extension, restrict, short\n                )\n\n                text += str(file_name) + \"\\n\"\n\n    return text\n</code></pre>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_file","title":"<code>create_m3u_file(file_name, song_list, template, file_extension, restrict=None, short=False, detect_formats=None)</code>","text":"<p>Create the m3u file.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_file--arguments","title":"Arguments","text":"<ul> <li>file_name: the file name to use</li> <li>song_list: the list of songs</li> <li>template: the template to use</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>detect_formats: the formats to detect</li> </ul>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_file--returns","title":"Returns","text":"<ul> <li>the m3u content as a string</li> </ul> Source code in <code>spotdl/utils/m3u.py</code> <pre><code>def create_m3u_file(\n    file_name: str,\n    song_list: List[Song],\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    detect_formats: Optional[List[str]] = None,\n) -&gt; str:\n    \"\"\"\n    Create the m3u file.\n\n    ### Arguments\n    - file_name: the file name to use\n    - song_list: the list of songs\n    - template: the template to use\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - detect_formats: the formats to detect\n\n    ### Returns\n    - the m3u content as a string\n    \"\"\"\n\n    m3u_content = create_m3u_content(\n        song_list,\n        template,\n        file_extension,\n        restrict,\n        short,\n        detect_formats,\n    )\n\n    file_path = Path(\n        *(sanitize_string(part) for part in Path(file_name).parts)\n    ).absolute()\n\n    with open(file_path, \"w\", encoding=\"utf-8\") as m3u_file:\n        m3u_file.write(m3u_content)\n\n    return m3u_content\n</code></pre>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.gen_m3u_files","title":"<code>gen_m3u_files(songs, file_name, template, file_extension, restrict=None, short=False, detect_formats=None)</code>","text":"<p>Create an m3u8 filename from the query.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.gen_m3u_files--arguments","title":"Arguments","text":"<ul> <li>query: the query</li> <li>file_name: the file name to use</li> <li>song_list: the list of songs</li> <li>template: the output file template to use</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>detect_formats: the formats to detect</li> </ul> Source code in <code>spotdl/utils/m3u.py</code> <pre><code>def gen_m3u_files(\n    songs: List[Song],\n    file_name: Optional[str],\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    detect_formats: Optional[List[str]] = None,\n):\n    \"\"\"\n    Create an m3u8 filename from the query.\n\n    ### Arguments\n    - query: the query\n    - file_name: the file name to use\n    - song_list: the list of songs\n    - template: the output file template to use\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - detect_formats: the formats to detect\n    \"\"\"\n\n    # If no file name is provided, use the first list's name\n    if not file_name:\n        file_name = \"{list[0]}.m3u8\"\n\n    # If file_name ends with a slash. Does not have a m3u8 name with extension\n    # at the end of the template, append `{list[0]}`` to it\n    if (\n        file_name.endswith(\"/\")\n        or file_name.endswith(r\"\\\\\")\n        or file_name.endswith(\"\\\\\\\\\")\n    ):\n        file_name += \"/{list[0]}.m3u8\"\n\n    # Check if the file name ends with .m3u or .m3u8\n    if not file_name.endswith(\".m3u\") and not file_name.endswith(\".m3u8\"):\n        file_name += \".m3u8\"\n\n    lists_object: Dict[str, List[Song]] = {}\n    for song in songs:\n        if song.list_name is None:\n            continue\n\n        if song.list_name not in lists_object:\n            lists_object[song.list_name] = []\n\n        lists_object[song.list_name].append(song)\n\n    if \"{list}\" in file_name:\n        # Create multiple m3u files if there are multiple lists\n        for list_name, song_list in lists_object.items():\n            create_m3u_file(\n                file_name.format(\n                    list=list_name,\n                ),\n                song_list,\n                template,\n                file_extension,\n                restrict,\n                short,\n                detect_formats,\n            )\n    elif \"{list[\" in file_name and \"]}\" in file_name:\n        # Create a single m3u file for specified song list name\n        create_m3u_file(\n            file_name.format(list=list(lists_object.keys())),\n            songs,\n            template,\n            file_extension,\n            restrict,\n            short,\n            detect_formats,\n        )\n    else:\n        # Use the provided file name\n        create_m3u_file(\n            file_name,\n            songs,\n            template,\n            file_extension,\n            restrict,\n            short,\n            detect_formats,\n        )\n</code></pre>"},{"location":"reference/utils/matching/","title":"matching","text":"<p>Module for all things matching related</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup1","title":"<code>artists_match_fixup1(song, result, score)</code>","text":"<p>Multiple fixes to the artists score for not verified results to improve the accuracy</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup1--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> <li>score: current score</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup1--returns","title":"Returns","text":"<ul> <li>new score</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def artists_match_fixup1(song: Song, result: Result, score: float) -&gt; float:\n    \"\"\"\n    Multiple fixes to the artists score for\n    not verified results to improve the accuracy\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n    - score: current score\n\n    ### Returns\n    - new score\n    \"\"\"\n\n    # If we have a verified result, we don't have to fix anything\n    if result.verified or score &gt; 50:\n        return score\n\n    # If we didn't find any artist match,\n    # we fallback to channel name match\n    channel_name_match = ratio(\n        slugify(song.artist),\n        slugify(\", \".join(result.artists)) if result.artists else \"\",\n    )\n\n    score = max(score, channel_name_match)\n\n    # If artist match is still too low,\n    # we fallback to matching all song artist names\n    # with the result's title\n    if score &lt;= 70:\n        artist_title_match = 0.0\n        result_name = slugify(result.name).replace(\"-\", \"\")\n        for artist in song.artists:\n            slug_artist = slugify(artist).replace(\"-\", \"\")\n\n            if slug_artist in result_name:\n                artist_title_match += 1.0\n\n        artist_title_match = (artist_title_match / len(song.artists)) * 100\n\n        score = max(score, artist_title_match)\n\n    # If artist match is still too low,\n    # we fallback to matching all song artist names\n    # with the result's artists\n    if score &lt;= 70:\n        # Song artists: ['charlie-moncler', 'fukaj', 'mata', 'pedro']\n        # Result artists: ['fukaj-mata-charlie-moncler-und-pedro']\n\n        # For artist_list1\n        artist_list1 = []\n        for artist in song.artists:\n            artist_list1.extend(slugify(artist).split(\"-\"))\n\n        # For artist_list2\n        artist_list2 = []\n        if result.artists:\n            for artist in result.artists:\n                artist_list2.extend(slugify(artist).split(\"-\"))\n\n        artist_tuple1 = tuple(artist_list1)\n        artist_tuple2 = tuple(artist_list2)\n\n        artist_title_match = ratio(artist_tuple1, artist_tuple2)\n\n        score = max(score, artist_title_match)\n\n    return score\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup2","title":"<code>artists_match_fixup2(song, result, score, search_query=None)</code>","text":"<p>Multiple fixes to the artists score for verified results to improve the accuracy</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup2--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> <li>score: current score</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup2--returns","title":"Returns","text":"<ul> <li>new score</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def artists_match_fixup2(\n    song: Song, result: Result, score: float, search_query: Optional[str] = None\n) -&gt; float:\n    \"\"\"\n    Multiple fixes to the artists score for\n    verified results to improve the accuracy\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n    - score: current score\n\n    ### Returns\n    - new score\n    \"\"\"\n\n    if score &gt; 70 or not result.verified:\n        # Don't fixup the score\n        # if the artist match is already high\n        # or if the result is not verified\n        return score\n\n    # Slugify some variables\n    slug_song_name = slugify(song.name)\n    slug_result_name = slugify(result.name)\n\n    # # Check if the main artist is simlar\n    has_main_artist = (score / (2 if len(song.artists) &gt; 1 else 1)) &gt; 50\n\n    _, match_str2 = create_match_strings(song, result, search_query)\n\n    # Check if other song artists are in the result name\n    # if they are, we increase the artist match\n    # (main artist is already checked, so we skip it)\n    artists_to_check = song.artists[int(has_main_artist) :]\n    for artist in artists_to_check:\n        artist = slugify(artist).replace(\"-\", \"\")\n        if artist in match_str2.replace(\"-\", \"\"):\n            score += 5\n\n    # if the artist match is still too low,\n    # we fallback to matching all song artist names\n    # with the result's artists\n    if score &lt;= 70:\n        # Artists from song/result name without the song/result name words\n        artist_list1 = create_clean_string(song.artists, slug_song_name, True)\n        artist_list2 = create_clean_string(\n            list(result.artists) if result.artists else [result.author],\n            slug_result_name,\n            True,\n        )\n\n        artist_title_match = ratio(artist_list1, artist_list2)\n\n        score = max(score, artist_title_match)\n\n    return score\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup3","title":"<code>artists_match_fixup3(song, result, score)</code>","text":"<p>Calculate match percentage based result's name and song's title if the result has exactly one artist and the song has more than one artist</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup3--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> <li>score: current score</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup3--returns","title":"Returns","text":"<ul> <li>new score</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def artists_match_fixup3(song: Song, result: Result, score: float) -&gt; float:\n    \"\"\"\n    Calculate match percentage based result's name\n    and song's title if the result has exactly one artist\n    and the song has more than one artist\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n    - score: current score\n\n    ### Returns\n    - new score\n    \"\"\"\n\n    if (\n        score &gt; 70\n        or not result.artists\n        or len(result.artists) &gt; 1\n        or len(song.artists) == 1\n    ):\n        # Don't fixup the score\n        # if the score is already high\n        # or if the result has more than one artist\n        # or if the song has only one artist\n        return score\n\n    artists_score_fixup = ratio(\n        slugify(result.name),\n        slugify(create_song_title(song.name, [song.artist])),\n    )\n\n    if artists_score_fixup &gt;= 80:\n        score = (score + artists_score_fixup) / 2\n\n    # Make sure that the score is not higher than 100\n    score = min(score, 100)\n\n    return score\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.based_sort","title":"<code>based_sort(strings, based_on)</code>","text":"<p>Sort strings in list based on the order of strings in <code>based_on</code> list</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.based_sort--arguments","title":"Arguments","text":"<ul> <li>strings: strings to sort</li> <li>based_on: strings to sort <code>strings</code> list based on</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.based_sort--returns","title":"Returns","text":"<ul> <li>sorted list of strings</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def based_sort(strings: List[str], based_on: List[str]) -&gt; Tuple[List[str], List[str]]:\n    \"\"\"\n    Sort strings in list based on the order of strings in `based_on` list\n\n    ### Arguments\n    - strings: strings to sort\n    - based_on: strings to sort `strings` list based on\n\n    ### Returns\n    - sorted list of strings\n    \"\"\"\n\n    strings.sort()\n    based_on.sort()\n\n    list_map = {value: index for index, value in enumerate(based_on)}\n\n    strings = sorted(\n        strings,\n        key=lambda x: list_map.get(x, -1),\n        reverse=True,\n    )\n\n    based_on.reverse()\n\n    return strings, based_on\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_album_match","title":"<code>calc_album_match(song, result)</code>","text":"<p>Calculate album match percentage</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_album_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_album_match--returns","title":"Returns","text":"<ul> <li>album match percentage</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_album_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Calculate album match percentage\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - album match percentage\n    \"\"\"\n\n    if not result.album:\n        return 0.0\n\n    return ratio(slugify(song.album_name), slugify(result.album))\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_artists_match","title":"<code>calc_artists_match(song, result)</code>","text":"<p>Check if all artists are present in list of artists</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_artists_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_artists_match--returns","title":"Returns","text":"<ul> <li>artists match percentage</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_artists_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Check if all artists are present in list of artists\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - artists match percentage\n    \"\"\"\n\n    artist_match_number = 0.0\n\n    # Result has only one artist, return 0.0\n    if len(song.artists) == 1 or not result.artists:\n        return artist_match_number\n\n    artist1_list, artist2_list = based_sort(\n        list(map(slugify, song.artists)), list(map(slugify, result.artists))\n    )\n\n    # Remove main artist from the lists\n    artist1_list, artist2_list = artist1_list[1:], artist2_list[1:]\n\n    artists_match = 0.0\n    for artist1, artist2 in zip_longest(artist1_list, artist2_list):\n        artist12_match = ratio(artist1, artist2)\n        artists_match += artist12_match\n\n    artist_match_number = artists_match / len(artist1_list)\n\n    return artist_match_number\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_main_artist_match","title":"<code>calc_main_artist_match(song, result)</code>","text":"<p>Check if main artist is present in list of artists</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_main_artist_match--arguments","title":"Arguments","text":"<ul> <li>main_artist: main artist to check</li> <li>artists: list of artists to check</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_main_artist_match--returns","title":"Returns","text":"<ul> <li>True if main artist is present in list of artists, False otherwise</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_main_artist_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Check if main artist is present in list of artists\n\n    ### Arguments\n    - main_artist: main artist to check\n    - artists: list of artists to check\n\n    ### Returns\n    - True if main artist is present in list of artists, False otherwise\n    \"\"\"\n\n    main_artist_match = 0.0\n\n    # Result has no artists, return 0.0\n    if not result.artists:\n        return main_artist_match\n\n    song_artists, result_artists = list(map(slugify, song.artists)), list(\n        map(slugify, result.artists)\n    )\n    sorted_song_artists, sorted_result_artists = based_sort(\n        song_artists, result_artists\n    )\n\n    debug(song.song_id, result.result_id, f\"Song artists: {sorted_song_artists}\")\n    debug(song.song_id, result.result_id, f\"Result artists: {sorted_result_artists}\")\n\n    slug_song_main_artist = slugify(song.artists[0])\n    slug_result_main_artist = sorted_result_artists[0]\n\n    # Result has only one artist, but song has multiple artists\n    # we can assume that other artists are in the main artist name\n    if len(song.artists) &gt; 1 and len(result.artists) == 1:\n        for artist in map(slugify, song.artists[1:]):\n            artist = sort_string(slugify(artist).split(\"-\"), \"-\")\n\n            res_main_artist = sort_string(slug_result_main_artist.split(\"-\"), \"-\")\n\n            if artist in res_main_artist:\n                main_artist_match += 100 / len(song.artists)\n\n        return main_artist_match\n\n    # Match main result artist with main song artist\n    main_artist_match = ratio(slug_song_main_artist, slug_result_main_artist)\n\n    debug(\n        song.song_id, result.result_id, f\"First main artist match: {main_artist_match}\"\n    )\n\n    # Use second artist from the sorted list to\n    # calculate the match if the first artist match is too low\n    if main_artist_match &lt; 50 and len(song_artists) &gt; 1:\n        for song_artist, result_artist in product(\n            song_artists[:2], sorted_result_artists[:2]\n        ):\n            new_artist_match = ratio(song_artist, result_artist)\n            debug(\n                song.song_id,\n                result.result_id,\n                f\"Matched {song_artist} with {result_artist}: {new_artist_match}\",\n            )\n\n            main_artist_match = max(main_artist_match, new_artist_match)\n\n    return main_artist_match\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_name_match","title":"<code>calc_name_match(song, result, search_query=None)</code>","text":"<p>Calculate name match percentage</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_name_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_name_match--returns","title":"Returns","text":"<ul> <li>name match percentage</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_name_match(\n    song: Song, result: Result, search_query: Optional[str] = None\n) -&gt; float:\n    \"\"\"\n    Calculate name match percentage\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - name match percentage\n    \"\"\"\n\n    # Create match strings that will be used\n    # to calculate name match value\n    match_str1, match_str2 = create_match_strings(song, result, search_query)\n    result_name, song_name = slugify(result.name), slugify(song.name)\n\n    res_list, song_list = based_sort(result_name.split(\"-\"), song_name.split(\"-\"))\n    result_name, song_name = \"-\".join(res_list), \"-\".join(song_list)\n\n    # Calculate initial name match\n    name_match = ratio(result_name, song_name)\n\n    debug(song.song_id, result.result_id, f\"MATCH STRINGS: {match_str1} - {match_str2}\")\n    debug(\n        song.song_id,\n        result.result_id,\n        f\"SLUG MATCH STRINGS: {song_name} - {result_name}\",\n    )\n    debug(song.song_id, result.result_id, f\"First name match: {name_match}\")\n\n    # If name match is lower than 60%,\n    # we try to match using the test strings\n    if name_match &lt;= 75:\n        second_name_match = ratio(\n            match_str1,\n            match_str2,\n        )\n\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Second name match: {second_name_match}\",\n        )\n\n        name_match = max(name_match, second_name_match)\n\n    return name_match\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_time_match","title":"<code>calc_time_match(song, result)</code>","text":"<p>Calculate time difference between song and result</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_time_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_time_match--returns","title":"Returns","text":"<ul> <li>time difference between song and result</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_time_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Calculate time difference between song and result\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - time difference between song and result\n    \"\"\"\n\n    time_diff = abs(song.duration - result.duration)\n    score = exp(-0.1 * time_diff)\n    return score * 100\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_common_word","title":"<code>check_common_word(song, result)</code>","text":"<p>Check if a word is present in a sentence</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_common_word--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_common_word--returns","title":"Returns","text":"<ul> <li>True if word is present in sentence, False otherwise</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def check_common_word(song: Song, result: Result) -&gt; bool:\n    \"\"\"\n    Check if a word is present in a sentence\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - True if word is present in sentence, False otherwise\n    \"\"\"\n\n    sentence_words = slugify(song.name).split(\"-\")\n    to_check = slugify(result.name).replace(\"-\", \"\")\n\n    for word in sentence_words:\n        if word != \"\" and word in to_check:\n            return True\n\n    return False\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_forbidden_words","title":"<code>check_forbidden_words(song, result)</code>","text":"<p>Check if a forbidden word is present in the result name</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_forbidden_words--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_forbidden_words--returns","title":"Returns","text":"<ul> <li>True if forbidden word is present in result name, False otherwise</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def check_forbidden_words(song: Song, result: Result) -&gt; Tuple[bool, List[str]]:\n    \"\"\"\n    Check if a forbidden word is present in the result name\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - True if forbidden word is present in result name, False otherwise\n    \"\"\"\n\n    song_name = slugify(song.name).replace(\"-\", \"\")\n    to_check = slugify(result.name).replace(\"-\", \"\")\n\n    words = []\n    for word in FORBIDDEN_WORDS:\n        if word in to_check and word not in song_name:\n            words.append(word)\n\n    return len(words) &gt; 0, words\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_clean_string","title":"<code>create_clean_string(words, string, sort=False, join_str='-')</code>","text":"<p>Create a string with strings from <code>words</code> list if they are not yet present in <code>string</code></p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_clean_string--arguments","title":"Arguments","text":"<ul> <li>words: strings to check</li> <li>string: string to check if strings are present in</li> <li>sort: sort strings in list</li> <li>join_str: string to join strings with</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_clean_string--returns","title":"Returns","text":"<ul> <li>string with strings from <code>words</code> list</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def create_clean_string(\n    words: List[str], string: str, sort: bool = False, join_str: str = \"-\"\n) -&gt; str:\n    \"\"\"\n    Create a string with strings from `words` list\n    if they are not yet present in `string`\n\n    ### Arguments\n    - words: strings to check\n    - string: string to check if strings are present in\n    - sort: sort strings in list\n    - join_str: string to join strings with\n\n    ### Returns\n    - string with strings from `words` list\n    \"\"\"\n\n    string = slugify(string).replace(\"-\", \"\")\n\n    final = []\n    for word in words:\n        word = slugify(word).replace(\"-\", \"\")\n\n        if word in string:\n            continue\n\n        final.append(word)\n\n    if sort:\n        return sort_string(final, join_str)\n\n    return f\"{join_str}\".join(final)\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_match_strings","title":"<code>create_match_strings(song, result, search_query=None)</code>","text":"<p>Create strings based on song and result to match fill strings with missing artists</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_match_strings--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_match_strings--returns","title":"Returns","text":"<ul> <li>tuple of strings to match</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def create_match_strings(\n    song: Song, result: Result, search_query: Optional[str] = None\n) -&gt; Tuple[str, str]:\n    \"\"\"\n    Create strings based on song and result to match\n    fill strings with missing artists\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - tuple of strings to match\n    \"\"\"\n\n    slug_song_name = slugify(song.name)\n    slug_song_title = slugify(\n        create_song_title(song.name, song.artists)\n        if not search_query\n        else create_search_query(song, search_query, False, None, True)\n    )\n\n    test_str1 = slugify(result.name)\n    test_str2 = slug_song_name if result.verified else slug_song_title\n\n    # Fill strings with missing artists\n    test_str1 = fill_string(song.artists, test_str1, test_str2)\n    test_str2 = fill_string(song.artists, test_str2, test_str1)\n\n    # Sort both strings and then join them\n    test_list1, test_list2 = based_sort(test_str1.split(\"-\"), test_str2.split(\"-\"))\n    test_str1, test_str2 = \"-\".join(test_list1), \"-\".join(test_list2)\n\n    return test_str1, test_str2\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.debug","title":"<code>debug(song_id, result_id, message)</code>","text":"<p>Log a message with MATCH level</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.debug--arguments","title":"Arguments","text":"<ul> <li>message: message to log</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def debug(song_id: str, result_id: str, message: str) -&gt; None:\n    \"\"\"\n    Log a message with MATCH level\n\n    ### Arguments\n    - message: message to log\n    \"\"\"\n\n    logger.log(MATCH, \"[%s|%s] %s\", song_id, result_id, message)\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.fill_string","title":"<code>fill_string(strings, main_string, string_to_check)</code>","text":"<p>Create a string with strings from <code>strings</code> list if they are not yet present in main_string but are present in string_to_check</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.fill_string--arguments","title":"Arguments","text":"<ul> <li>strings: strings to check</li> <li>main_string: string to add strings to</li> <li>string_to_check: string to check if strings are present in</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.fill_string--returns","title":"Returns","text":"<ul> <li>string with strings from <code>strings</code> list</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def fill_string(strings: List[str], main_string: str, string_to_check: str) -&gt; str:\n    \"\"\"\n    Create a string with strings from `strings` list\n    if they are not yet present in main_string\n    but are present in string_to_check\n\n    ### Arguments\n    - strings: strings to check\n    - main_string: string to add strings to\n    - string_to_check: string to check if strings are present in\n\n    ### Returns\n    - string with strings from `strings` list\n    \"\"\"\n\n    final_str = main_string\n    test_str = final_str.replace(\"-\", \"\")\n    simple_test_str = string_to_check.replace(\"-\", \"\")\n    for string in strings:\n        slug_str = slugify(string).replace(\"-\", \"\")\n\n        if slug_str in simple_test_str and slug_str not in test_str:\n            final_str += f\"-{slug_str}\"\n            test_str += slug_str\n\n    return final_str\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.get_best_matches","title":"<code>get_best_matches(results, score_threshold)</code>","text":"<p>Get best matches from a list of results</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.get_best_matches--arguments","title":"Arguments","text":"<ul> <li>results: list of results to match</li> <li>score_threshold: threshold to match results</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.get_best_matches--returns","title":"Returns","text":"<ul> <li>list of best matches</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def get_best_matches(\n    results: Dict[Result, float], score_threshold: float\n) -&gt; List[Tuple[Result, float]]:\n    \"\"\"\n    Get best matches from a list of results\n\n    ### Arguments\n    - results: list of results to match\n    - score_threshold: threshold to match results\n\n    ### Returns\n    - list of best matches\n    \"\"\"\n\n    result_items = list(results.items())\n\n    # Sort results by highest score\n    sorted_results = sorted(result_items, key=lambda x: x[1], reverse=True)\n\n    best_score = sorted_results[0][1]\n\n    return [\n        result\n        for result in sorted_results\n        if (best_score - result[1]) &lt;= score_threshold\n    ]\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.order_results","title":"<code>order_results(results, song, search_query=None)</code>","text":"<p>Order results.</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.order_results--arguments","title":"Arguments","text":"<ul> <li>results: The results to order.</li> <li>song: The song to order for.</li> <li>search_query: The search query.</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.order_results--returns","title":"Returns","text":"<ul> <li>The ordered results.</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def order_results(\n    results: List[Result],\n    song: Song,\n    search_query: Optional[str] = None,\n) -&gt; Dict[Result, float]:\n    \"\"\"\n    Order results.\n\n    ### Arguments\n    - results: The results to order.\n    - song: The song to order for.\n    - search_query: The search query.\n\n    ### Returns\n    - The ordered results.\n    \"\"\"\n\n    # Assign an overall avg match value to each result\n    links_with_match_value = {}\n\n    # Iterate over all results\n    for result in results:\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Calculating match value for {result.url} - {result.json}\",\n        )\n\n        # skip results that have no common words in their name\n        if not check_common_word(song, result):\n            debug(\n                song.song_id, result.result_id, \"Skipping result due to no common words\"\n            )\n\n            continue\n\n        # Calculate match value for main artist\n        artists_match = calc_main_artist_match(song, result)\n        debug(song.song_id, result.result_id, f\"Main artist match: {artists_match}\")\n\n        # Calculate match value for all artists\n        other_artists_match = calc_artists_match(song, result)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Other artists match: {other_artists_match}\",\n        )\n\n        artists_match += other_artists_match\n\n        # Calculate initial artist match value\n        debug(song.song_id, result.result_id, f\"Initial artists match: {artists_match}\")\n        artists_match = artists_match / (2 if len(song.artists) &gt; 1 else 1)\n        debug(song.song_id, result.result_id, f\"First artists match: {artists_match}\")\n\n        # First attempt to fix artist match\n        artists_match = artists_match_fixup1(song, result, artists_match)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Artists match after fixup1: {artists_match}\",\n        )\n\n        # Second attempt to fix artist match\n        artists_match = artists_match_fixup2(song, result, artists_match)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Artists match after fixup2: {artists_match}\",\n        )\n\n        # Third attempt to fix artist match\n        artists_match = artists_match_fixup3(song, result, artists_match)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Artists match after fixup3: {artists_match}\",\n        )\n\n        debug(song.song_id, result.result_id, f\"Final artists match: {artists_match}\")\n\n        # Calculate name match\n        name_match = calc_name_match(song, result, search_query)\n        debug(song.song_id, result.result_id, f\"Initial name match: {name_match}\")\n\n        # Check if result contains forbidden words\n        contains_fwords, found_fwords = check_forbidden_words(song, result)\n        if contains_fwords:\n            for _ in found_fwords:\n                name_match -= 15\n\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Contains forbidden words: {contains_fwords}, {found_fwords}\",\n        )\n        debug(song.song_id, result.result_id, f\"Final name match: {name_match}\")\n\n        # Calculate album match\n        album_match = calc_album_match(song, result)\n        debug(song.song_id, result.result_id, f\"Final album match: {album_match}\")\n\n        # Calculate time match\n        time_match = calc_time_match(song, result)\n        debug(song.song_id, result.result_id, f\"Final time match: {time_match}\")\n\n        # Ignore results with name match lower than 60%\n        if name_match &lt;= 60:\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to name match lower than 60%\",\n            )\n            continue\n\n        # Ignore results with artists match lower than 70%\n        if artists_match &lt; 70 and result.source != \"slider.kz\":\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to artists match lower than 70%\",\n            )\n            continue\n\n        # Calculate total match\n        average_match = (artists_match + name_match) / 2\n        debug(song.song_id, result.result_id, f\"Average match: {average_match}\")\n\n        if (\n            result.verified\n            and not result.isrc_search\n            and result.album\n            and album_match &lt;= 80\n        ):\n            # we are almost certain that this is the correct result\n            # so we add the album match to the average match\n            average_match = (average_match + album_match) / 2\n            debug(\n                song.song_id,\n                result.result_id,\n                f\"Average match /w album match: {average_match}\",\n            )\n\n        # Skip results with time match lower than 25%\n        if time_match &lt; 25:\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to time match lower than 25%\",\n            )\n            continue\n\n        # If the time match is lower than 50%\n        # and the average match is lower than 75%\n        # we skip the result\n        if time_match &lt; 50 and average_match &lt; 75:\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to time match &lt; 50% and average match &lt; 75%\",\n            )\n            continue\n\n        if (\n            (not result.isrc_search and average_match &lt;= 85)\n            or result.source == \"slider.kz\"\n            or time_match &lt; 0\n        ):\n            # Don't add time to avg match if average match is not the best\n            # (lower than 85%), always include time match if result is from\n            # slider.kz or if time match is lower than 0\n            average_match = (average_match + time_match) / 2\n\n            debug(\n                song.song_id,\n                result.result_id,\n                f\"Average match /w time match: {average_match}\",\n            )\n\n            if (result.explicit is not None and song.explicit is not None) and (\n                result.explicit != song.explicit\n            ):\n                debug(\n                    song.song_id,\n                    result.result_id,\n                    \"Lowering average match due to explicit mismatch\",\n                )\n\n                average_match -= 5\n\n        average_match = min(average_match, 100)\n        debug(song.song_id, result.result_id, f\"Final average match: {average_match}\")\n\n        # the results along with the avg Match\n        links_with_match_value[result] = average_match\n\n    return links_with_match_value\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.sort_string","title":"<code>sort_string(strings, join_str)</code>","text":"<p>Sort strings in list and join them with <code>join</code> string</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.sort_string--arguments","title":"Arguments","text":"<ul> <li>strings: strings to sort</li> <li>join: string to join strings with</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.sort_string--returns","title":"Returns","text":"<ul> <li>joined sorted string</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def sort_string(strings: List[str], join_str: str) -&gt; str:\n    \"\"\"\n    Sort strings in list and join them with `join` string\n\n    ### Arguments\n    - strings: strings to sort\n    - join: string to join strings with\n\n    ### Returns\n    - joined sorted string\n    \"\"\"\n\n    final_str = strings\n    final_str.sort()\n\n    return f\"{join_str}\".join(final_str)\n</code></pre>"},{"location":"reference/utils/metadata/","title":"metadata","text":"<p>Module for embedding metadata into audio files using Mutagen.</p> <pre><code>embed_metadata(\n    output_file=Path(\"test.mp3\"),\n    song=song_object,\n    file_format=\"mp3\",\n)\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.MetadataError","title":"<code>MetadataError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to metadata and id3 embedding.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_cover","title":"<code>embed_cover(audio_file, song, encoding)</code>","text":"<p>Embed the album art in the audio file.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_cover--arguments","title":"Arguments","text":"<ul> <li>audio_file: Audio file object.</li> <li>song: Song object.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_cover(audio_file, song: Song, encoding: str):\n    \"\"\"\n    Embed the album art in the audio file.\n\n    ### Arguments\n    - audio_file: Audio file object.\n    - song: Song object.\n    \"\"\"\n\n    if not song.cover_url:\n        return audio_file\n\n    # Try to download the cover art\n    try:\n        cover_data = requests.get(\n            song.cover_url,\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        ).content\n    except Exception:\n        return audio_file\n\n    # Create the image object for the file type\n    if encoding in [\"flac\", \"ogg\", \"opus\"]:\n        picture = Picture()\n        picture.type = 3\n        picture.desc = \"Cover\"\n        picture.mime = \"image/jpeg\"\n        picture.data = cover_data\n\n        if encoding in [\"ogg\", \"opus\"]:\n            image_data = picture.write()\n            encoded_data = base64.b64encode(image_data)\n            vcomment_value = encoded_data.decode(\"ascii\")\n            if \"metadata_block_picture\" in audio_file.keys():\n                audio_file.pop(\"metadata_block_picture\")\n            audio_file[\"metadata_block_picture\"] = [vcomment_value]\n        elif encoding == \"flac\":\n            if audio_file.pictures:\n                audio_file.clear_pictures()\n            audio_file.add_picture(picture)\n    elif encoding == \"m4a\":\n        if M4A_TAG_PRESET[\"albumart\"] in audio_file.keys():\n            audio_file.pop(M4A_TAG_PRESET[\"albumart\"])\n        audio_file[M4A_TAG_PRESET[\"albumart\"]] = [\n            MP4Cover(\n                cover_data,\n                imageformat=MP4Cover.FORMAT_JPEG,\n            )\n        ]\n    elif encoding == \"mp3\":\n        if \"APIC:Cover\" in audio_file.keys():\n            audio_file.pop(\"APIC:Cover\")\n        audio_file[\"APIC\"] = APIC(\n            encoding=3,\n            mime=\"image/jpeg\",\n            type=3,\n            desc=\"Cover\",\n            data=cover_data,\n        )\n\n    return audio_file\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_lyrics","title":"<code>embed_lyrics(audio_file, song, encoding)</code>","text":"<p>Detect lyrics type (lrc or txt) and embed them in the audio file.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_lyrics--arguments","title":"Arguments","text":"<ul> <li>audio_file: Audio file object.</li> <li>song: Song object.</li> <li>encoding: Encoding type.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_lyrics(audio_file, song: Song, encoding: str):\n    \"\"\"\n    Detect lyrics type (lrc or txt) and embed them in the audio file.\n\n    ### Arguments\n    - audio_file: Audio file object.\n    - song: Song object.\n    - encoding: Encoding type.\n    \"\"\"\n\n    lyrics = song.lyrics\n    if not lyrics:\n        return audio_file\n\n    tag_preset = TAG_PRESET if encoding != \"m4a\" else M4A_TAG_PRESET\n\n    # Check if the lyrics are in lrc format\n    # using regex on the first 5 lines\n    lrc_lines = lyrics.splitlines()[:5]\n    lrc_lines = [line for line in lrc_lines if line and LRC_REGEX.match(line)]\n\n    if len(lrc_lines) == 0:\n        # Lyrics are not in lrc format\n        # Embed them normally\n        if encoding == \"mp3\":\n            audio_file.add(USLT(encoding=Encoding.UTF8, text=song.lyrics))\n        else:\n            audio_file[tag_preset[\"lyrics\"]] = song.lyrics\n    else:\n        # Lyrics are in lrc format\n        # Embed them as SYLT id3 tag\n        clean_lyrics = remomve_lrc(lyrics)\n        if encoding == \"mp3\":\n            lrc_data = []\n            for line in lyrics.splitlines():\n                time_tag = line.split(\"]\", 1)[0] + \"]\"\n                text = line.replace(time_tag, \"\")\n\n                time_tag = time_tag.replace(\"[\", \"\")\n                time_tag = time_tag.replace(\"]\", \"\")\n                time_tag = time_tag.replace(\".\", \":\")\n                time_tag_vals = time_tag.split(\":\")\n                if len(time_tag_vals) != 3 or any(\n                    not isinstance(tag, int) for tag in time_tag_vals\n                ):\n                    continue\n\n                minute, sec, millisecond = time_tag_vals\n                time = to_ms(min=minute, sec=sec, ms=millisecond)\n                lrc_data.append((text, time))\n\n            audio_file.add(USLT(encoding=3, text=clean_lyrics))\n            audio_file.add(SYLT(encoding=3, text=lrc_data, format=2, type=1))\n        else:\n            audio_file[tag_preset[\"lyrics\"]] = song.lyrics\n\n    return audio_file\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_metadata","title":"<code>embed_metadata(output_file, song, id3_separator='/', skip_album_art=False)</code>","text":"<p>Set ID3 tags for generic files (FLAC, OPUS, OGG)</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_metadata--arguments","title":"Arguments","text":"<ul> <li>output_file: Path to the output file.</li> <li>song: Song object.</li> <li>id3_separator: The separator used for the id3 tags.</li> <li>skip_album_art: Boolean to skip album art embedding.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_metadata(\n    output_file: Path,\n    song: Song,\n    id3_separator: str = \"/\",\n    skip_album_art: Optional[bool] = False,\n):\n    \"\"\"\n    Set ID3 tags for generic files (FLAC, OPUS, OGG)\n\n    ### Arguments\n    - output_file: Path to the output file.\n    - song: Song object.\n    - id3_separator: The separator used for the id3 tags.\n    - skip_album_art: Boolean to skip album art embedding.\n    \"\"\"\n\n    # Get the file extension for the output file\n    encoding = output_file.suffix[1:]\n\n    if encoding == \"wav\":\n        embed_wav_file(output_file, song)\n        return\n\n    # Get the tag preset for the file extension\n    tag_preset = TAG_PRESET if encoding != \"m4a\" else M4A_TAG_PRESET\n\n    try:\n        audio_file = File(str(output_file.resolve()), easy=encoding == \"mp3\")\n\n        if audio_file is None:\n            raise MetadataError(\n                f\"Unrecognized file format for {output_file} from {song.url}\"\n            )\n    except Exception as exc:\n        raise MetadataError(\"Unable to load file.\") from exc\n\n    # Embed basic metadata\n    audio_file[tag_preset[\"artist\"]] = song.artists\n    audio_file[tag_preset[\"albumartist\"]] = (\n        song.album_artist if song.album_artist else song.artist\n    )\n    audio_file[tag_preset[\"title\"]] = song.name\n    audio_file[tag_preset[\"date\"]] = song.date\n    audio_file[tag_preset[\"encodedby\"]] = song.publisher\n\n    # Embed metadata that isn't always present\n    album_name = song.album_name\n    if album_name:\n        audio_file[tag_preset[\"album\"]] = album_name\n\n    if song.genres:\n        audio_file[tag_preset[\"genre\"]] = song.genres[0].title()\n\n    if song.copyright_text:\n        audio_file[tag_preset[\"copyright\"]] = song.copyright_text\n\n    if song.download_url and encoding != \"mp3\":\n        audio_file[tag_preset[\"comment\"]] = song.download_url\n\n    # Embed some metadata in format specific ways\n    if encoding in [\"flac\", \"ogg\", \"opus\"]:\n        audio_file[\"discnumber\"] = str(song.disc_number)\n        audio_file[\"disctotal\"] = str(song.disc_count)\n        audio_file[\"tracktotal\"] = str(song.tracks_count)\n        audio_file[\"tracknumber\"] = str(song.track_number)\n        audio_file[\"woas\"] = song.url\n        audio_file[\"isrc\"] = song.isrc\n    elif encoding == \"m4a\":\n        audio_file[tag_preset[\"discnumber\"]] = [(song.disc_number, song.disc_count)]\n        audio_file[tag_preset[\"tracknumber\"]] = [(song.track_number, song.tracks_count)]\n        audio_file[tag_preset[\"explicit\"]] = (4 if song.explicit is True else 2,)\n        audio_file[tag_preset[\"woas\"]] = song.url.encode(\"utf-8\")\n    elif encoding == \"mp3\":\n        audio_file[\"tracknumber\"] = f\"{str(song.track_number)}/{str(song.tracks_count)}\"\n        audio_file[\"discnumber\"] = f\"{str(song.disc_number)}/{str(song.disc_count)}\"\n        audio_file[\"isrc\"] = song.isrc\n\n    # Mp3 specific encoding\n    if encoding == \"mp3\":\n        if id3_separator != \"/\":\n            audio_file.save(v23_sep=id3_separator, v2_version=3)\n        else:\n            audio_file.save(v2_version=3)\n\n        audio_file = ID3(str(output_file.resolve()))\n\n        audio_file.add(WOAS(encoding=3, url=song.url))\n\n        if song.download_url:\n            audio_file.add(COMM(encoding=3, text=song.download_url))\n\n        if song.popularity:\n            audio_file.add(\n                POPM(\n                    rating=int(song.popularity * 255 / 100),\n                )\n            )\n\n        if song.year:\n            audio_file.add(TYER(encoding=3, text=str(song.year)))\n\n    if not skip_album_art:\n        # Embed album art\n        audio_file = embed_cover(audio_file, song, encoding)\n\n    # Embed lyrics\n    audio_file = embed_lyrics(audio_file, song, encoding)\n\n    # Mp3 specific encoding\n    if encoding == \"mp3\":\n        audio_file.save(v23_sep=id3_separator, v2_version=3)\n    else:\n        audio_file.save()\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_wav_file","title":"<code>embed_wav_file(output_file, song)</code>","text":"<p>Embeds the song metadata into the wav file</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_wav_file--arguments","title":"Arguments","text":"<ul> <li>output_file: The output file path</li> <li>song: The song object</li> <li>id3_separator: The separator used for the id3 tags</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_wav_file(output_file: Path, song: Song):\n    \"\"\"\n    Embeds the song metadata into the wav file\n\n    ### Arguments\n    - output_file: The output file path\n    - song: The song object\n    - id3_separator: The separator used for the id3 tags\n    \"\"\"\n    audio = WAVE(output_file)\n    if audio is None:\n        raise ValueError(\"Invalid audio file\")\n\n    if audio.tags:\n        audio.tags.clear()\n\n    audio.add_tags()\n\n    audio.tags.add(TIT2(encoding=3, text=song.name))  # type: ignore\n    audio.tags.add(TPE1(encoding=3, text=song.artists))  # type: ignore\n    audio.tags.add(TALB(encoding=3, text=song.album_name))  # type: ignore\n    audio.tags.add(TCOM(encoding=3, text=song.publisher))  # type: ignore\n    audio.tags.add(TCON(encoding=3, text=song.genres))  # type: ignore\n    audio.tags.add(TDRC(encoding=3, text=song.date))  # type: ignore\n    audio.tags.add(  # type: ignore\n        TRCK(encoding=3, text=f\"{song.track_number}/{song.tracks_count}\")  # type: ignore\n    )\n    audio.tags.add(TDRC(encoding=3, text=song.date))  # type: ignore\n    audio.tags.add(WOAS(encoding=3, text=song.url))  # type: ignore\n    audio.tags.add(TSRC(encoding=3, text=song.isrc))  # type: ignore\n\n    if song.download_url:\n        audio.tags.add(COMM(encoding=3, text=song.download_url))  # type: ignore\n\n    if song.copyright_text:\n        audio.tags.add(TCOP(encoding=3, text=song.copyright_text))  # type: ignore\n\n    if song.popularity:\n        audio.tags.add(  # type: ignore\n            COMM(\n                encoding=3,\n                lang=\"eng\",\n                text=\"Spotify Popularity: \" + str(song.popularity),\n            )\n        )\n\n    if song.cover_url:\n        try:\n            cover_data = requests.get(song.cover_url, timeout=10).content\n            audio.tags.add(  # type: ignore\n                APIC(\n                    encoding=3, mime=\"image/jpeg\", type=3, desc=\"Cover\", data=cover_data\n                )\n            )\n        except Exception:\n            pass\n\n    if song.lyrics:\n        # Check if the lyrics are in lrc format\n        # using regex on the first 5 lines\n        lrc_lines = song.lyrics.splitlines()[:5]\n        lrc_lines = [line for line in lrc_lines if line and LRC_REGEX.match(line)]\n\n        if len(lrc_lines) == 0:\n            audio.tags.add(USLT(encoding=Encoding.UTF8, text=song.lyrics))  # type: ignore\n        else:\n            lrc_data = []\n            clean_lyrics = remomve_lrc(song.lyrics)\n            for line in song.lyrics.splitlines():\n                time_tag = line.split(\"]\", 1)[0] + \"]\"\n                text = line.replace(time_tag, \"\")\n\n                time_tag = time_tag.replace(\"[\", \"\")\n                time_tag = time_tag.replace(\"]\", \"\")\n                time_tag = time_tag.replace(\".\", \":\")\n                time_tag_vals = time_tag.split(\":\")\n                if len(time_tag_vals) != 3 or any(\n                    not isinstance(tag, int) for tag in time_tag_vals\n                ):\n                    continue\n\n                minute, sec, millisecond = time_tag_vals\n                time = to_ms(min=minute, sec=sec, ms=millisecond)\n                lrc_data.append((text, time))\n\n            audio.tags.add(USLT(encoding=3, text=clean_lyrics))  # type: ignore\n            audio.tags.add(SYLT(encoding=3, text=lrc_data, format=2, type=1))  # type: ignore\n\n    audio.save()\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata","title":"<code>get_file_metadata(path, id3_separator='/')</code>","text":"<p>Get song metadata.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata--arguments","title":"Arguments","text":"<ul> <li>path: Path to the song.</li> </ul>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata--returns","title":"Returns","text":"<ul> <li>Dict of song metadata.</li> </ul>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata--raises","title":"Raises","text":"<ul> <li>OSError: If the file is not found.</li> <li>MetadataError: If the file is not a valid audio file.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def get_file_metadata(path: Path, id3_separator: str = \"/\") -&gt; Optional[Dict[str, Any]]:\n    \"\"\"\n    Get song metadata.\n\n    ### Arguments\n    - path: Path to the song.\n\n    ### Returns\n    - Dict of song metadata.\n\n    ### Raises\n    - OSError: If the file is not found.\n    - MetadataError: If the file is not a valid audio file.\n    \"\"\"\n\n    if path.exists() is False:\n        raise OSError(f\"File not found: {path}\")\n\n    audio_file = File(str(path.resolve()))\n\n    if audio_file is None or audio_file == {}:\n        return None\n\n    song_meta: Dict[str, Any] = {}\n    for key in TAG_PRESET:\n        if path.suffix == \".m4a\":\n            val = audio_file.get(M4A_TAG_PRESET[key])\n        elif path.suffix == \".mp3\":\n            val = audio_file.get(MP3_TAG_PRESET[key])\n        else:\n            val = audio_file.get(key)\n\n        # Cover art is a special case and\n        # has to be handled before checking the val\n        # M4A is handled in the m4a section since it\n        # has data in the val variable\n        if key == \"albumart\":\n            if path.suffix == \".mp3\":\n                cover = audio_file.get(\"APIC:Cover\")\n                if cover:\n                    song_meta[\"album_art\"] = cover.data\n                else:\n                    song_meta[\"album_art\"] = None\n\n                continue\n\n            if path.suffix == \".flac\":\n                song_meta[\"album_art\"] = audio_file.pictures[0].data\n                continue\n\n            if path.suffix in [\".ogg\", \".opus\"]:\n                pictures = audio_file.get(\"metadata_block_picture\")\n                if pictures and pictures[0]:\n                    song_meta[\"album_art\"] = pictures[0]\n                else:\n                    song_meta[\"album_art\"] = None\n\n                continue\n\n        # If the tag is empty, skip it\n        if val is None:\n            # If the tag is empty but it's key is in the\n            # song object, set it to None\n            empty_key = TAG_TO_SONG.get(key)\n            if empty_key:\n                song_meta[empty_key] = None\n\n            continue\n\n        # MP3 specific decoding\n        if path.suffix == \".mp3\":\n            if key == \"woas\":\n                song_meta[\"url\"] = val.url\n            elif key == \"comment\":\n                song_meta[\"download_url\"] = val.text[0]\n            elif key == \"year\":\n                song_meta[\"year\"] = int(str(val.text[0])[:4])\n            elif key == \"date\":\n                song_meta[\"date\"] = str(val.text[0])\n            elif key in [\"tracknumber\", \"trackcount\"]:\n                count = val.text[0].split(id3_separator)\n                if len(count) == 2:\n                    song_meta[\"track_number\"] = int(count[0])\n                    song_meta[\"tracks_count\"] = int(count[1])\n                else:\n                    song_meta[\"track_number\"] = val.text[0]\n            elif key in [\"discnumber\", \"disccount\"]:\n                count = val.text[0].split(id3_separator)\n                if len(count) == 2:\n                    song_meta[\"disc_number\"] = int(count[0])\n                    song_meta[\"disc_count\"] = int(count[1])\n                else:\n                    song_meta[\"disc_number\"] = val.text[0]\n            elif key == \"artist\":\n                artists_val: str = (\n                    val.text[0] if isinstance(val.text, list) else val.text\n                )\n                song_meta[\"artists\"] = artists_val.split(id3_separator)\n            else:\n                meta_key = TAG_TO_SONG.get(key)\n                if meta_key and song_meta.get(meta_key) is None:\n                    song_meta[meta_key] = (\n                        val.text[0]\n                        if isinstance(val.text, list) and len(val.text) == 1\n                        else val.text\n                    )\n\n        # M4A specific decoding\n        elif path.suffix == \".m4a\":\n            if key == \"artist\":\n                song_meta[\"artists\"] = val\n            elif key == \"woas\":\n                song_meta[\"url\"] = val[0].decode(\"utf-8\")\n            elif key == \"explicit\":\n                song_meta[\"explicit\"] = val == [4] if val else None\n            elif key == \"year\":\n                song_meta[\"year\"] = int(str(val[0])[:4])\n            elif key == \"discnumber\":\n                song_meta[\"disc_number\"] = val[0][0]\n                song_meta[\"disc_count\"] = val[0][1]\n            elif key == \"tracknumber\":\n                song_meta[\"track_number\"] = val[0][0]\n                song_meta[\"tracks_count\"] = val[0][1]\n            else:\n                meta_key = TAG_TO_SONG.get(key)\n                if meta_key:\n                    song_meta[meta_key] = (\n                        val[0] if isinstance(val, list) and len(val) == 1 else val\n                    )\n\n        # FLAC, OGG, OPUS specific decoding\n        else:\n            if key == \"artist\":\n                song_meta[\"artists\"] = val\n            elif key == \"tracknumber\":\n                song_meta[\"track_number\"] = int(val[0])\n            elif key == \"discnumber\":\n                song_meta[\"disc_count\"] = int(val[0])\n                song_meta[\"disc_number\"] = int(val[0])\n            else:\n                meta_key = TAG_TO_SONG.get(key)\n                if meta_key:\n                    song_meta[meta_key] = (\n                        val[0] if isinstance(val, list) and len(val) == 1 else val\n                    )\n\n    # Make sure that artists is a list\n    if isinstance(song_meta[\"artists\"], str):\n        song_meta[\"artists\"] = [song_meta[\"artists\"]]\n    elif song_meta[\"artists\"] is not None:\n        song_meta[\"artists\"] = list(song_meta[\"artists\"])\n    else:\n        song_meta[\"artists\"] = []\n\n    # Make sure that genres is a list\n    if isinstance(song_meta[\"genres\"], str):\n        song_meta[\"genres\"] = [song_meta[\"genres\"]]\n\n    # Add main artist to the song meta object\n    if song_meta[\"artists\"]:\n        song_meta[\"artist\"] = song_meta[\"artists\"][0]\n    else:\n        song_meta[\"artist\"] = None\n\n    return song_meta\n</code></pre>"},{"location":"reference/utils/search/","title":"search","text":"<p>Module for creating Song objects by interacting with Spotify API or by parsing a query.</p> <p>To use this module you must first initialize the SpotifyClient.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.QueryError","title":"<code>QueryError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to query.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_album","title":"<code>create_ytm_album(url, fetch_songs=True)</code>","text":"<p>Creates a list of Song objects from an album query.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_album--arguments","title":"Arguments","text":"<ul> <li>album_query: the url of the album</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_album--returns","title":"Returns","text":"<ul> <li>a list of Song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def create_ytm_album(url: str, fetch_songs: bool = True) -&gt; Album:\n    \"\"\"\n    Creates a list of Song objects from an album query.\n\n    ### Arguments\n    - album_query: the url of the album\n\n    ### Returns\n    - a list of Song objects\n    \"\"\"\n\n    if \"?list=\" not in url or not url.startswith(\"https://music.youtube.com/\"):\n        raise ValueError(f\"Invalid album url: {url}\")\n\n    browse_id = get_ytm_client().get_album_browse_id(\n        url.split(\"?list=\")[1].split(\"&amp;\")[0]\n    )\n    if browse_id is None:\n        raise ValueError(f\"Invalid album url: {url}\")\n\n    album = get_ytm_client().get_album(browse_id)\n\n    if album is None:\n        raise ValueError(f\"Couldn't fetch album: {url}\")\n\n    metadata = {\n        \"artist\": album[\"artists\"][0][\"name\"],\n        \"name\": album[\"title\"],\n        \"url\": url,\n    }\n\n    songs = []\n    for track in album[\"tracks\"]:\n        artists = [artist[\"name\"] for artist in track[\"artists\"]]\n\n        song = Song.from_missing_data(\n            name=track[\"title\"],\n            artists=artists,\n            artist=artists[0],\n            album_name=metadata[\"name\"],\n            album_artist=metadata[\"artist\"],\n            duration=track[\"duration_seconds\"],\n            download_url=f\"https://music.youtube.com/watch?v={track['videoId']}\",\n        )\n\n        if fetch_songs:\n            song = Song.from_search_term(f\"{song.artist} - {song.name}\")\n\n        songs.append(song)\n\n    return Album(**metadata, songs=songs, urls=[song.url for song in songs])\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_playlist","title":"<code>create_ytm_playlist(url, fetch_songs=True)</code>","text":"<p>Returns a playlist object from a youtube playlist url</p>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_playlist--arguments","title":"Arguments","text":"<ul> <li>url: the url of the playlist</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_playlist--returns","title":"Returns","text":"<ul> <li>a Playlist object</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def create_ytm_playlist(url: str, fetch_songs: bool = True) -&gt; Playlist:\n    \"\"\"\n    Returns a playlist object from a youtube playlist url\n\n    ### Arguments\n    - url: the url of the playlist\n\n    ### Returns\n    - a Playlist object\n    \"\"\"\n\n    if not (\"?list=\" in url or \"/browse/VLPL\" in url) or not url.startswith(\n        \"https://music.youtube.com/\"\n    ):\n        raise ValueError(f\"Invalid playlist url: {url}\")\n\n    if \"/browse/VLPL\" in url:\n        playlist_id = url.split(\"/browse/\")[1]\n    else:\n        playlist_id = url.split(\"?list=\")[1]\n    playlist = get_ytm_client().get_playlist(playlist_id, None)  # type: ignore\n\n    if playlist is None:\n        raise ValueError(f\"Couldn't fetch playlist: {url}\")\n\n    metadata = {\n        \"description\": (\n            playlist[\"description\"] if playlist[\"description\"] is not None else \"\"\n        ),\n        \"author_url\": (\n            f\"https://music.youtube.com/channel/{playlist['author']['id']}\"\n            if playlist.get(\"author\") is not None\n            else \"Missing author url\"\n        ),\n        \"author_name\": (\n            playlist[\"author\"][\"name\"]\n            if playlist.get(\"author\") is not None\n            else \"Missing author\"\n        ),\n        \"cover_url\": (\n            playlist[\"thumbnails\"][0][\"url\"]\n            if playlist.get(\"thumbnails\") is not None\n            else \"Missing thumbnails\"\n        ),\n        \"name\": playlist[\"title\"],\n        \"url\": url,\n    }\n\n    songs = []\n    for track in playlist[\"tracks\"]:\n        if track[\"videoId\"] is None or track[\"isAvailable\"] is False:\n            continue\n\n        song = Song.from_missing_data(\n            name=track[\"title\"],\n            artists=(\n                [artist[\"name\"] for artist in track[\"artists\"]]\n                if track.get(\"artists\") is not None\n                else []\n            ),\n            artist=(\n                track[\"artists\"][0][\"name\"]\n                if track.get(\"artists\") is not None\n                else None\n            ),\n            album_name=(\n                track.get(\"album\", {}).get(\"name\")\n                if track.get(\"album\") is not None\n                else None\n            ),\n            duration=track.get(\"duration_seconds\"),\n            explicit=track.get(\"isExplicit\"),\n            download_url=f\"https://music.youtube.com/watch?v={track['videoId']}\",\n        )\n\n        if fetch_songs:\n            song = reinit_song(song)\n\n        songs.append(song)\n\n    return Playlist(**metadata, songs=songs, urls=[song.url for song in songs])\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.gather_known_songs","title":"<code>gather_known_songs(output, output_format)</code>","text":"<p>Gather all known songs from the output directory</p>"},{"location":"reference/utils/search/#spotdl.utils.search.gather_known_songs--arguments","title":"Arguments","text":"<ul> <li>output: Output path template</li> <li>output_format: Output format</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.gather_known_songs--returns","title":"Returns","text":"<ul> <li>Dictionary containing all known songs and their paths</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def gather_known_songs(output: str, output_format: str) -&gt; Dict[str, List[Path]]:\n    \"\"\"\n    Gather all known songs from the output directory\n\n    ### Arguments\n    - output: Output path template\n    - output_format: Output format\n\n    ### Returns\n    - Dictionary containing all known songs and their paths\n    \"\"\"\n\n    # Get the base directory from the path template\n    # Path(\"/Music/test/{artist}/{artists} - {title}.{output-ext}\") -&gt; \"/Music/test\"\n    base_dir = output.split(\"{\", 1)[0]\n    paths = Path(base_dir).glob(f\"**/*.{output_format}\")\n\n    known_songs: Dict[str, List[Path]] = {}\n    for path in paths:\n        # Try to get the song from the metadata\n        song = get_song_from_file_metadata(path)\n\n        # If the songs doesn't have metadata, try to get it from the filename\n        if song is None or song.url is None:\n            search_results = get_search_results(path.stem)\n            if len(search_results) == 0:\n                continue\n\n            song = search_results[0]\n\n        known_paths = known_songs.get(song.url)\n        if known_paths is None:\n            known_songs[song.url] = [path]\n        else:\n            known_songs[song.url].append(path)\n\n    return known_songs\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_saved_playlists","title":"<code>get_all_saved_playlists()</code>","text":"<p>Get all user playlists.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_saved_playlists--args-optional","title":"Args (optional)","text":"<ul> <li>user_url: Spotify user profile url.     If a url is mentioned, get all public playlists of that specific user.</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_saved_playlists--returns","title":"Returns","text":"<ul> <li>List of all user playlists</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_all_saved_playlists() -&gt; List[Playlist]:\n    \"\"\"\n    Get all user playlists.\n\n    ### Args (optional)\n    - user_url: Spotify user profile url.\n        If a url is mentioned, get all public playlists of that specific user.\n\n    ### Returns\n    - List of all user playlists\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    user_playlists_response = spotify_client.current_user_playlists()\n\n    if user_playlists_response is None:\n        raise SpotifyError(\"Couldn't get user playlists\")\n\n    user_playlists = user_playlists_response[\"items\"]\n    user_id = user_playlists_response[\"href\"].split(\"users/\")[-1].split(\"/\")[0]\n\n    # Fetch all saved tracks\n    while user_playlists_response and user_playlists_response[\"next\"]:\n        response = spotify_client.next(user_playlists_response)\n        if response is None:\n            break\n\n        user_playlists_response = response\n        user_playlists.extend(user_playlists_response[\"items\"])\n\n    return [\n        Playlist.from_url(playlist[\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for playlist in user_playlists\n        if playlist[\"owner\"][\"id\"] != user_id\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_user_playlists","title":"<code>get_all_user_playlists(user_url='')</code>","text":"<p>Get all user playlists.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_user_playlists--args-optional","title":"Args (optional)","text":"<ul> <li>user_url: Spotify user profile url.     If a url is mentioned, get all public playlists of that specific user.</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_user_playlists--returns","title":"Returns","text":"<ul> <li>List of all user playlists</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_all_user_playlists(user_url: str = \"\") -&gt; List[Playlist]:\n    \"\"\"\n    Get all user playlists.\n\n    ### Args (optional)\n    - user_url: Spotify user profile url.\n        If a url is mentioned, get all public playlists of that specific user.\n\n    ### Returns\n    - List of all user playlists\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    if user_url and not user_url.startswith(\"https://open.spotify.com/user/\"):\n        raise ValueError(f\"Invalid user profile url: {user_url}\")\n\n    user_id = user_url.split(\"https://open.spotify.com/user/\")[-1].replace(\"/\", \"\")\n\n    if user_id:\n        user_playlists_response = spotify_client.user_playlists(user_id)\n    else:\n        user_playlists_response = spotify_client.current_user_playlists()\n        user_resp = spotify_client.current_user()\n        if user_resp is None:\n            raise SpotifyError(\"Couldn't get user info\")\n\n        user_id = user_resp[\"id\"]\n\n    if user_playlists_response is None:\n        raise SpotifyError(\"Couldn't get user playlists\")\n\n    user_playlists = user_playlists_response[\"items\"]\n\n    # Fetch all saved tracks\n    while user_playlists_response and user_playlists_response[\"next\"]:\n        response = spotify_client.next(user_playlists_response)\n        if response is None:\n            break\n\n        user_playlists_response = response\n        user_playlists.extend(user_playlists_response[\"items\"])\n\n    return [\n        Playlist.from_url(playlist[\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for playlist in user_playlists\n        if playlist[\"owner\"][\"id\"] == user_id\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_search_results","title":"<code>get_search_results(search_term)</code>","text":"<p>Creates a list of Song objects from a search term.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_search_results--arguments","title":"Arguments","text":"<ul> <li>search_term: the search term to use</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_search_results--returns","title":"Returns","text":"<ul> <li>a list of Song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_search_results(search_term: str) -&gt; List[Song]:\n    \"\"\"\n    Creates a list of Song objects from a search term.\n\n    ### Arguments\n    - search_term: the search term to use\n\n    ### Returns\n    - a list of Song objects\n    \"\"\"\n\n    return Song.list_from_search_term(search_term)\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_simple_songs","title":"<code>get_simple_songs(query, use_ytm_data=False, playlist_numbering=False, albums_to_ignore=None, album_type=None, playlist_retain_track_cover=False)</code>","text":"<p>Parse query and return list containing simple song objects</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_simple_songs--arguments","title":"Arguments","text":"<ul> <li>query: List of strings containing query</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_simple_songs--returns","title":"Returns","text":"<ul> <li>List of simple song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_simple_songs(\n    query: List[str],\n    use_ytm_data: bool = False,\n    playlist_numbering: bool = False,\n    albums_to_ignore=None,\n    album_type=None,\n    playlist_retain_track_cover: bool = False,\n) -&gt; List[Song]:\n    \"\"\"\n    Parse query and return list containing simple song objects\n\n    ### Arguments\n    - query: List of strings containing query\n\n    ### Returns\n    - List of simple song objects\n    \"\"\"\n\n    songs: List[Song] = []\n    lists: List[SongList] = []\n    for request in query:\n        logger.info(\"Processing query: %s\", request)\n\n        # Remove /intl-xxx/ from Spotify URLs with regex\n        request = re.sub(r\"\\/intl-\\w+\\/\", \"/\", request)\n\n        if (\n            (  # pylint: disable=too-many-boolean-expressions\n                \"watch?v=\" in request\n                or \"youtu.be/\" in request\n                or \"soundcloud.com/\" in request\n                or \"bandcamp.com/\" in request\n            )\n            and \"open.spotify.com\" in request\n            and \"track\" in request\n            and \"|\" in request\n        ):\n            split_urls = request.split(\"|\")\n            if (\n                len(split_urls) &lt;= 1\n                or not (\n                    \"watch?v=\" in split_urls[0]\n                    or \"youtu.be\" in split_urls[0]\n                    or \"soundcloud.com/\" in split_urls[0]\n                    or \"bandcamp.com/\" in split_urls[0]\n                )\n                or \"spotify\" not in split_urls[1]\n            ):\n                raise QueryError(\n                    'Incorrect format used, please use \"YouTubeURL|SpotifyURL\"'\n                )\n\n            songs.append(\n                Song.from_missing_data(url=split_urls[1], download_url=split_urls[0])\n            )\n        elif \"music.youtube.com/watch?v\" in request:\n            track_data = get_ytm_client().get_song(request.split(\"?v=\", 1)[1])\n\n            yt_song = Song.from_search_term(\n                f\"{track_data['videoDetails']['author']} - {track_data['videoDetails']['title']}\"\n            )\n\n            if use_ytm_data:\n                yt_song.name = track_data[\"title\"]\n                yt_song.artist = track_data[\"author\"]\n                yt_song.artists = [track_data[\"author\"]]\n                yt_song.duration = track_data[\"lengthSeconds\"]\n\n            yt_song.download_url = request\n            songs.append(yt_song)\n        elif (\n            \"youtube.com/playlist?list=\" in request\n            or \"youtube.com/browse/VLPL\" in request\n        ):\n            request = request.replace(\n                \"https://www.youtube.com/\", \"https://music.youtube.com/\"\n            )\n            request = request.replace(\n                \"https://youtube.com/\", \"https://music.youtube.com/\"\n            )\n\n            split_urls = request.split(\"|\")\n            if len(split_urls) == 1:\n                if \"?list=OLAK5uy_\" in request:\n                    lists.append(create_ytm_album(request, fetch_songs=False))\n                elif \"?list=PL\" in request or \"browse/VLPL\" in request:\n                    lists.append(create_ytm_playlist(request, fetch_songs=False))\n            else:\n                if (\"spotify\" not in split_urls[1]) or not any(\n                    x in split_urls[0]\n                    for x in [\"?list=PL\", \"?list=OLAK5uy_\", \"browse/VLPL\"]\n                ):\n                    raise QueryError(\n                        'Incorrect format used, please use \"YouTubeMusicURL|SpotifyURL\". '\n                        \"Currently only supports YouTube Music playlists and albums.\"\n                    )\n\n                if (\"open.spotify.com\" in request and \"album\" in request) and (\n                    \"?list=OLAK5uy_\" in request\n                ):\n                    ytm_list: SongList = create_ytm_album(\n                        split_urls[0], fetch_songs=False\n                    )\n                    spot_list = Album.from_url(split_urls[1], fetch_songs=False)\n                elif (\"open.spotify.com\" in request and \"playlist\" in request) and (\n                    \"?list=PL\" in request or \"browse/VLPL\" in request\n                ):\n                    ytm_list = create_ytm_playlist(split_urls[0], fetch_songs=False)\n                    spot_list = Playlist.from_url(split_urls[1], fetch_songs=False)\n                else:\n                    raise QueryError(\n                        f\"URLs are not of the same type, {split_urls[0]} is not \"\n                        f\"the same type as {split_urls[1]}.\"\n                    )\n\n                if ytm_list.length != spot_list.length:\n                    raise QueryError(\n                        f\"The YouTube Music ({ytm_list.length}) \"\n                        f\"and Spotify ({spot_list.length}) lists have different lengths. \"\n                    )\n\n                if use_ytm_data:\n                    for index, song in enumerate(ytm_list.songs):\n                        song.url = spot_list.songs[index].url\n\n                    lists.append(ytm_list)\n                else:\n                    for index, song in enumerate(spot_list.songs):\n                        song.download_url = ytm_list.songs[index].download_url\n\n                    lists.append(spot_list)\n        elif \"open.spotify.com\" in request and \"track\" in request:\n            songs.append(Song.from_url(url=request))\n        elif \"https://spotify.link/\" in request:\n            resp = requests.head(request, allow_redirects=True, timeout=10)\n            full_url = resp.url\n            full_lists = get_simple_songs(\n                [full_url],\n                use_ytm_data=use_ytm_data,\n                playlist_numbering=playlist_numbering,\n                album_type=album_type,\n                playlist_retain_track_cover=playlist_retain_track_cover,\n            )\n            songs.extend(full_lists)\n        elif \"open.spotify.com\" in request and \"playlist\" in request:\n            lists.append(Playlist.from_url(request, fetch_songs=False))\n        elif \"open.spotify.com\" in request and \"album\" in request:\n            lists.append(Album.from_url(request, fetch_songs=False))\n        elif \"open.spotify.com\" in request and \"artist\" in request:\n            lists.append(Artist.from_url(request, fetch_songs=False))\n        elif \"open.spotify.com\" in request and \"user\" in request:\n            lists.extend(get_all_user_playlists(request))\n        elif \"album:\" in request:\n            lists.append(Album.from_search_term(request, fetch_songs=False))\n        elif \"playlist:\" in request:\n            lists.append(Playlist.from_search_term(request, fetch_songs=False))\n        elif \"artist:\" in request:\n            lists.append(Artist.from_search_term(request, fetch_songs=False))\n        elif request == \"saved\":\n            lists.append(Saved.from_url(request, fetch_songs=False))\n        elif request == \"all-user-playlists\":\n            lists.extend(get_all_user_playlists())\n        elif request == \"all-user-followed-artists\":\n            lists.extend(get_user_followed_artists())\n        elif request == \"all-user-saved-albums\":\n            lists.extend(get_user_saved_albums())\n        elif request == \"all-saved-playlists\":\n            lists.extend(get_all_saved_playlists())\n        elif request.endswith(\".spotdl\"):\n            with open(request, \"r\", encoding=\"utf-8\") as save_file:\n                for track in json.load(save_file):\n                    # Append to songs\n                    songs.append(Song.from_dict(track))\n        else:\n            songs.append(Song.from_search_term(request))\n\n    for song_list in lists:\n        logger.info(\n            \"Found %s songs in %s (%s)\",\n            len(song_list.urls),\n            song_list.name,\n            song_list.__class__.__name__,\n        )\n\n        for index, song in enumerate(song_list.songs):\n            song_data = song.json\n            song_data[\"list_name\"] = song_list.name\n            song_data[\"list_url\"] = song_list.url\n            song_data[\"list_position\"] = song.list_position\n            song_data[\"list_length\"] = song_list.length\n\n            if playlist_numbering:\n                song_data[\"track_number\"] = song_data[\"list_position\"]\n                song_data[\"tracks_count\"] = song_data[\"list_length\"]\n                song_data[\"album_name\"] = song_data[\"list_name\"]\n                song_data[\"disc_number\"] = 1\n                song_data[\"disc_count\"] = 1\n                if isinstance(song_list, Playlist):\n                    song_data[\"album_artist\"] = song_list.author_name\n                    song_data[\"cover_url\"] = song_list.cover_url\n\n            if playlist_retain_track_cover:\n                song_data[\"track_number\"] = song_data[\"list_position\"]\n                song_data[\"tracks_count\"] = song_data[\"list_length\"]\n                song_data[\"album_name\"] = song_data[\"list_name\"]\n                song_data[\"disc_number\"] = 1\n                song_data[\"disc_count\"] = 1\n                song_data[\"cover_url\"] = song_data[\"cover_url\"]\n                if isinstance(song_list, Playlist):\n                    song_data[\"album_artist\"] = song_list.author_name\n\n            songs.append(Song.from_dict(song_data))\n\n    # removing songs for --ignore-albums\n    original_length = len(songs)\n    if albums_to_ignore:\n        songs = [\n            song\n            for song in songs\n            if all(\n                keyword not in song.album_name.lower() for keyword in albums_to_ignore\n            )\n        ]\n        logger.info(\"Skipped %s songs (Ignored albums)\", (original_length - len(songs)))\n\n    if album_type:\n        songs = [song for song in songs if song.album_type == album_type]\n\n        logger.info(\n            \"Skipped %s songs for Album Type %s\",\n            (original_length - len(songs)),\n            album_type,\n        )\n\n    logger.debug(\"Found %s songs in %s lists\", len(songs), len(lists))\n\n    return songs\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_song_from_file_metadata","title":"<code>get_song_from_file_metadata(file, id3_separator='/')</code>","text":"<p>Get song based on the file metadata or file name</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_song_from_file_metadata--arguments","title":"Arguments","text":"<ul> <li>file: Path to file</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_song_from_file_metadata--returns","title":"Returns","text":"<ul> <li>Song object</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_song_from_file_metadata(file: Path, id3_separator: str = \"/\") -&gt; Optional[Song]:\n    \"\"\"\n    Get song based on the file metadata or file name\n\n    ### Arguments\n    - file: Path to file\n\n    ### Returns\n    - Song object\n    \"\"\"\n\n    file_metadata = get_file_metadata(file, id3_separator)\n\n    if file_metadata is None:\n        return None\n\n    return Song.from_missing_data(**file_metadata)\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_followed_artists","title":"<code>get_user_followed_artists()</code>","text":"<p>Get all user playlists</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_followed_artists--returns","title":"Returns","text":"<ul> <li>List of all user playlists</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_user_followed_artists() -&gt; List[Artist]:\n    \"\"\"\n    Get all user playlists\n\n    ### Returns\n    - List of all user playlists\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    user_followed_response = spotify_client.current_user_followed_artists()\n    if user_followed_response is None:\n        raise SpotifyError(\"Couldn't get user followed artists\")\n\n    user_followed_response = user_followed_response[\"artists\"]\n    user_followed = user_followed_response[\"items\"]\n\n    # Fetch all artists\n    while user_followed_response and user_followed_response[\"next\"]:\n        response = spotify_client.next(user_followed_response)\n        if response is None:\n            break\n\n        user_followed_response = response[\"artists\"]\n        user_followed.extend(user_followed_response[\"items\"])\n\n    return [\n        Artist.from_url(followed_artist[\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for followed_artist in user_followed\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_saved_albums","title":"<code>get_user_saved_albums()</code>","text":"<p>Get all user saved albums</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_saved_albums--returns","title":"Returns","text":"<ul> <li>List of all user saved albums</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_user_saved_albums() -&gt; List[Album]:\n    \"\"\"\n    Get all user saved albums\n\n    ### Returns\n    - List of all user saved albums\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    user_saved_albums_response = spotify_client.current_user_saved_albums()\n    if user_saved_albums_response is None:\n        raise SpotifyError(\"Couldn't get user saved albums\")\n\n    user_saved_albums = user_saved_albums_response[\"items\"]\n\n    # Fetch all saved tracks\n    while user_saved_albums_response and user_saved_albums_response[\"next\"]:\n        response = spotify_client.next(user_saved_albums_response)\n        if response is None:\n            break\n\n        user_saved_albums_response = response\n        user_saved_albums.extend(user_saved_albums_response[\"items\"])\n\n    return [\n        Album.from_url(item[\"album\"][\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for item in user_saved_albums\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_ytm_client","title":"<code>get_ytm_client()</code>","text":"<p>Lazily initialize the YTMusic client.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_ytm_client--returns","title":"Returns","text":"<ul> <li>the YTMusic client</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_ytm_client() -&gt; YTMusic:\n    \"\"\"\n    Lazily initialize the YTMusic client.\n\n    ### Returns\n    - the YTMusic client\n    \"\"\"\n\n    global client  # pylint: disable=global-statement\n    if client is None:\n        client = YTMusic()\n\n    return client\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.parse_query","title":"<code>parse_query(query, threads=1, use_ytm_data=False, playlist_numbering=False, album_type=None, playlist_retain_track_cover=False)</code>","text":"<p>Parse query and return list containing song object</p>"},{"location":"reference/utils/search/#spotdl.utils.search.parse_query--arguments","title":"Arguments","text":"<ul> <li>query: List of strings containing query</li> <li>threads: Number of threads to use</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.parse_query--returns","title":"Returns","text":"<ul> <li>List of song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def parse_query(\n    query: List[str],\n    threads: int = 1,\n    use_ytm_data: bool = False,\n    playlist_numbering: bool = False,\n    album_type=None,\n    playlist_retain_track_cover: bool = False,\n) -&gt; List[Song]:\n    \"\"\"\n    Parse query and return list containing song object\n\n    ### Arguments\n    - query: List of strings containing query\n    - threads: Number of threads to use\n\n    ### Returns\n    - List of song objects\n    \"\"\"\n\n    songs: List[Song] = get_simple_songs(\n        query,\n        use_ytm_data=use_ytm_data,\n        playlist_numbering=playlist_numbering,\n        album_type=album_type,\n        playlist_retain_track_cover=playlist_retain_track_cover,\n    )\n\n    results = []\n    with concurrent.futures.ThreadPoolExecutor(max_workers=threads) as executor:\n        future_to_song = {executor.submit(reinit_song, song): song for song in songs}\n        for future in concurrent.futures.as_completed(future_to_song):\n            song = future_to_song[future]\n            try:\n                results.append(future.result())\n            except Exception as exc:\n                logger.error(\"%s generated an exception: %s\", song.display_name, exc)\n\n    return results\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.reinit_song","title":"<code>reinit_song(song)</code>","text":"<p>Update song object with new data from Spotify</p>"},{"location":"reference/utils/search/#spotdl.utils.search.reinit_song--arguments","title":"Arguments","text":"<ul> <li>song: Song object</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.reinit_song--returns","title":"Returns","text":"<ul> <li>Updated song object</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def reinit_song(song: Song) -&gt; Song:\n    \"\"\"\n    Update song object with new data\n    from Spotify\n\n    ### Arguments\n    - song: Song object\n\n    ### Returns\n    - Updated song object\n    \"\"\"\n\n    data = song.json\n    if data.get(\"url\"):\n        new_data = Song.from_url(data[\"url\"]).json\n    elif data.get(\"song_id\"):\n        new_data = Song.from_url(\n            \"https://open.spotify.com/track/\" + data[\"song_id\"]\n        ).json\n    elif data.get(\"name\") and data.get(\"artist\"):\n        new_data = Song.from_search_term(f\"{data['artist']} - {data['name']}\").json\n    else:\n        raise QueryError(\"Song object is missing required data to be reinitialized\")\n\n    for key in Song.__dataclass_fields__:  # type: ignore # pylint: disable=E1101\n        val = data.get(key)\n        new_val = new_data.get(key)\n        if new_val is not None and val is None:\n            data[key] = new_val\n        elif new_val is not None and val is not None:\n            data[key] = val\n\n    # return reinitialized song object\n    return Song(**data)\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.songs_from_albums","title":"<code>songs_from_albums(albums)</code>","text":"<p>Get all songs from albums ids/urls/etc.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.songs_from_albums--arguments","title":"Arguments","text":"<ul> <li>albums: List of albums ids</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.songs_from_albums--returns","title":"Returns","text":"<ul> <li>List of songs</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def songs_from_albums(albums: List[str]):\n    \"\"\"\n    Get all songs from albums ids/urls/etc.\n\n    ### Arguments\n    - albums: List of albums ids\n\n    ### Returns\n    - List of songs\n    \"\"\"\n\n    songs: List[Song] = []\n    for album_id in albums:\n        album = Album.from_url(album_id, fetch_songs=False)\n\n        songs.extend([Song.from_missing_data(**song.json) for song in album.songs])\n\n    return songs\n</code></pre>"},{"location":"reference/utils/spotify/","title":"spotify","text":"<p>Module for interacting with Spotify API. To use this module, you must have a Spotify API key and Spotify API secret.</p> <pre><code>import spotdl.utils.spotify\nspotify.Spotify.init(client_id, client_secret)\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton","title":"<code>Singleton</code>","text":"<p>               Bases: <code>type</code></p> <p>Singleton metaclass for SpotifyClient. Ensures that SpotifyClient is not instantiated without prior initialization. Every other instantiation of SpotifyClient will return the same instance.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.__call__","title":"<code>__call__()</code>","text":"<p>Call method for Singleton metaclass.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.__call__--returns","title":"Returns","text":"<ul> <li>The instance of the SpotifyClient.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def __call__(self):  # pylint: disable=bad-mcs-method-argument\n    \"\"\"\n    Call method for Singleton metaclass.\n\n    ### Returns\n    - The instance of the SpotifyClient.\n    \"\"\"\n\n    if self._instance is None:\n        raise SpotifyError(\n            \"Spotify client not created. Call SpotifyClient.init\"\n            \"(client_id, client_secret, user_auth, cache_path, no_cache, open_browser) first.\"\n        )\n    return self._instance\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.init","title":"<code>init(client_id, client_secret, user_auth=False, no_cache=False, headless=False, max_retries=3, use_cache_file=False, auth_token=None, cache_path=None)</code>","text":"<p>Initializes the SpotifyClient.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.init--arguments","title":"Arguments","text":"<ul> <li>client_id: The client ID of the application.</li> <li>client_secret: The client secret of the application.</li> <li>auth_token: The access token to use.</li> <li>user_auth: Whether or not to use user authentication.</li> <li>cache_path: The path to the cache file.</li> <li>no_cache: Whether or not to use the cache.</li> <li>open_browser: Whether or not to open the browser.</li> </ul>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.init--returns","title":"Returns","text":"<ul> <li>The instance of the SpotifyClient.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def init(  # pylint: disable=bad-mcs-method-argument\n    self,\n    client_id: str,\n    client_secret: str,\n    user_auth: bool = False,\n    no_cache: bool = False,\n    headless: bool = False,\n    max_retries: int = 3,\n    use_cache_file: bool = False,\n    auth_token: Optional[str] = None,\n    cache_path: Optional[str] = None,\n) -&gt; \"Singleton\":\n    \"\"\"\n    Initializes the SpotifyClient.\n\n    ### Arguments\n    - client_id: The client ID of the application.\n    - client_secret: The client secret of the application.\n    - auth_token: The access token to use.\n    - user_auth: Whether or not to use user authentication.\n    - cache_path: The path to the cache file.\n    - no_cache: Whether or not to use the cache.\n    - open_browser: Whether or not to open the browser.\n\n    ### Returns\n    - The instance of the SpotifyClient.\n    \"\"\"\n\n    # check if initialization has been completed, if yes, raise an Exception\n    if isinstance(self._instance, self):\n        raise SpotifyError(\"A spotify client has already been initialized\")\n\n    credential_manager = None\n\n    cache_handler = (\n        CacheFileHandler(cache_path or get_cache_path())\n        if not no_cache\n        else MemoryCacheHandler()\n    )\n    # Use SpotifyOAuth as auth manager\n    if user_auth:\n        credential_manager = SpotifyOAuth(\n            client_id=client_id,\n            client_secret=client_secret,\n            redirect_uri=\"http://127.0.0.1:9900/\",\n            scope=\"user-library-read,user-follow-read,playlist-read-private\",\n            cache_handler=cache_handler,\n            open_browser=not headless,\n        )\n    # Use SpotifyClientCredentials as auth manager\n    else:\n        credential_manager = SpotifyClientCredentials(\n            client_id=client_id,\n            client_secret=client_secret,\n            cache_handler=cache_handler,\n        )\n    if auth_token is not None:\n        credential_manager = None\n\n    self.user_auth = user_auth\n    self.no_cache = no_cache\n    self.max_retries = max_retries\n    self.use_cache_file = use_cache_file\n\n    # Create instance\n    self._instance = super().__call__(\n        auth=auth_token,\n        auth_manager=credential_manager,\n        status_forcelist=(429, 500, 502, 503, 504, 404),\n    )\n\n    # Return instance\n    return self._instance\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.SpotifyClient","title":"<code>SpotifyClient(*args, **kwargs)</code>","text":"<p>               Bases: <code>Spotify</code></p> <p>This is the Spotify client meant to be used in the app. Has to be initialized first by calling <code>SpotifyClient.init(client_id, client_secret, user_auth, cache_path, no_cache, open_browser)</code>.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.SpotifyClient--arguments","title":"Arguments","text":"<ul> <li>auth: The access token to use.</li> <li>auth_manager: The auth manager to use.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def __init__(self, *args, **kwargs):\n    \"\"\"\n    Initializes the SpotifyClient.\n\n    ### Arguments\n    - auth: The access token to use.\n    - auth_manager: The auth manager to use.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n    self._initialized = True\n\n    use_cache_file: bool = self.use_cache_file  # type: ignore # pylint: disable=E1101\n    cache_file_loc = get_spotify_cache_path()\n\n    if use_cache_file and cache_file_loc.exists():\n        with open(cache_file_loc, \"r\", encoding=\"utf-8\") as cache_file:\n            self.cache = json.load(cache_file)\n    elif use_cache_file:\n        with open(cache_file_loc, \"w\", encoding=\"utf-8\") as cache_file:\n            json.dump(self.cache, cache_file)\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.SpotifyError","title":"<code>SpotifyError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to SpotifyClient.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.save_spotify_cache","title":"<code>save_spotify_cache(cache)</code>","text":"<p>Saves the Spotify cache to a file.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.save_spotify_cache--arguments","title":"Arguments","text":"<ul> <li>cache: The cache to save.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def save_spotify_cache(cache: Dict[str, Optional[Dict]]):\n    \"\"\"\n    Saves the Spotify cache to a file.\n\n    ### Arguments\n    - cache: The cache to save.\n    \"\"\"\n\n    cache_file_loc = get_spotify_cache_path()\n\n    logger.debug(\"Saving Spotify cache to %s\", cache_file_loc)\n\n    # Only cache tracks\n    cache = {\n        key: value\n        for key, value in cache.items()\n        if value is not None and \"tracks/\" in key\n    }\n\n    with open(cache_file_loc, \"w\", encoding=\"utf-8\") as cache_file:\n        json.dump(cache, cache_file)\n</code></pre>"},{"location":"reference/utils/static/","title":"static","text":"<p>Module for holding static variables that are used throughout the project. And are for the most part, not likely to change. (Also holds really large variables, so pylint is disabled here)</p>"},{"location":"reference/utils/web/","title":"web","text":"<p>Module which contains the web server related function FastAPI routes/classes etc.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.ApplicationState","title":"<code>ApplicationState</code>","text":"<p>Class that holds the application state.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client","title":"<code>Client(websocket, client_id)</code>","text":"<p>Holds the client's state.</p> <ul> <li>websocket: The WebSocket instance.</li> <li>client_id: The client's ID.</li> <li>downloader_settings: The downloader settings.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def __init__(\n    self,\n    websocket: WebSocket,\n    client_id: str,\n):\n    \"\"\"\n    Initialize the WebSocket handler.\n    ### Arguments\n    - websocket: The WebSocket instance.\n    - client_id: The client's ID.\n    - downloader_settings: The downloader settings.\n    \"\"\"\n\n    self.downloader_settings = DownloaderOptions(\n        **create_settings_type(\n            Namespace(config=False),\n            dict(app_state.downloader_settings),\n            DOWNLOADER_OPTIONS,\n        )  # type: ignore\n    )\n\n    self.websocket = websocket\n    self.client_id = client_id\n    self.downloader = Downloader(\n        settings=self.downloader_settings, loop=app_state.loop\n    )\n\n    self.downloader.progress_handler.web_ui = True\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.connect","title":"<code>connect()</code>  <code>async</code>","text":"<p>Called when a new client connects to the websocket.</p> Source code in <code>spotdl/utils/web.py</code> <pre><code>async def connect(self):\n    \"\"\"\n    Called when a new client connects to the websocket.\n    \"\"\"\n\n    await self.websocket.accept()\n\n    # Add the connection to the list of connections\n    app_state.clients[self.client_id] = self\n    app_state.logger.info(\"Client %s connected\", self.client_id)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.get_instance","title":"<code>get_instance(client_id)</code>  <code>classmethod</code>","text":"<p>Get the WebSocket instance for a client.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.get_instance--arguments","title":"Arguments","text":"<ul> <li>client_id: The client's ID.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.get_instance--returns","title":"Returns","text":"<ul> <li>returns the WebSocket instance.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@classmethod\ndef get_instance(cls, client_id: str) -&gt; Optional[\"Client\"]:\n    \"\"\"\n    Get the WebSocket instance for a client.\n\n    ### Arguments\n    - client_id: The client's ID.\n\n    ### Returns\n    - returns the WebSocket instance.\n    \"\"\"\n\n    instance = app_state.clients.get(client_id)\n    if instance:\n        return instance\n\n    app_state.logger.error(\"Client %s not found\", client_id)\n\n    return None\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.send_update","title":"<code>send_update(update)</code>  <code>async</code>","text":"<p>Send an update to the client.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.send_update--arguments","title":"Arguments","text":"<ul> <li>update: The update to send.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>async def send_update(self, update: Dict[str, Any]):\n    \"\"\"\n    Send an update to the client.\n\n    ### Arguments\n    - update: The update to send.\n    \"\"\"\n\n    await self.websocket.send_json(update)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.song_update","title":"<code>song_update(progress_handler, message)</code>","text":"<p>Called when a song updates.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.song_update--arguments","title":"Arguments","text":"<ul> <li>progress_handler: The progress handler.</li> <li>message: The message to send.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def song_update(self, progress_handler: SongTracker, message: str):\n    \"\"\"\n    Called when a song updates.\n\n    ### Arguments\n    - progress_handler: The progress handler.\n    - message: The message to send.\n    \"\"\"\n\n    update_message = {\n        \"song\": progress_handler.song.json,\n        \"progress\": progress_handler.progress,\n        \"message\": message,\n    }\n\n    asyncio.run_coroutine_threadsafe(\n        self.send_update(update_message), app_state.loop\n    )\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles","title":"<code>SPAStaticFiles</code>","text":"<p>               Bases: <code>StaticFiles</code></p> <p>Override the static files to serve the index.html and other assets.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles.get_response","title":"<code>get_response(path, scope)</code>  <code>async</code>","text":"<p>Serve static files from the SPA.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles.get_response--arguments","title":"Arguments","text":"<ul> <li>path: The path to the file.</li> <li>scope: The scope of the request.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles.get_response--returns","title":"Returns","text":"<ul> <li>returns the response.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>async def get_response(self, path: str, scope: Scope) -&gt; Response:\n    \"\"\"\n    Serve static files from the SPA.\n\n    ### Arguments\n    - path: The path to the file.\n    - scope: The scope of the request.\n\n    ### Returns\n    - returns the response.\n    \"\"\"\n\n    response = await super().get_response(path, scope)\n    if response.status_code == 404:\n        response = await super().get_response(\".\", scope)\n\n    response.headers.setdefault(\n        \"Cache-Control\", \"max-age=0, no-cache, no-store, , must-revalidate\"\n    )\n    response.headers.setdefault(\"Pragma\", \"no-cache\")\n    response.headers.setdefault(\"Expires\", \"0\")\n\n    return response\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.check_update","title":"<code>check_update()</code>","text":"<p>Check for update.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.check_update--returns","title":"Returns","text":"<ul> <li>returns True if there is an update.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/check_update\")\ndef check_update() -&gt; bool:\n    \"\"\"\n    Check for update.\n\n    ### Returns\n    - returns True if there is an update.\n    \"\"\"\n\n    try:\n        _, ahead, _ = get_status(__version__, \"master\")\n        if ahead &gt; 0:\n            return True\n    except RuntimeError:\n        latest_version = get_latest_version()\n        latest_tuple = tuple(latest_version.replace(\"v\", \"\").split(\".\"))\n        current_tuple = tuple(__version__.split(\".\"))\n        if latest_tuple &gt; current_tuple:\n            return True\n    except RateLimitError:\n        return False\n\n    return False\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.download_file","title":"<code>download_file(file, client=Depends(get_client), state=Depends(get_current_state))</code>  <code>async</code>","text":"<p>Download file using path.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.download_file--arguments","title":"Arguments","text":"<ul> <li>file: The file path.</li> <li>client: The client's state.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.download_file--returns","title":"Returns","text":"<ul> <li>returns the file response, filename specified to return as attachment.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/download/file\")\nasync def download_file(\n    file: str,\n    client: Client = Depends(get_client),\n    state: ApplicationState = Depends(get_current_state),\n):\n    \"\"\"\n    Download file using path.\n\n    ### Arguments\n    - file: The file path.\n    - client: The client's state.\n\n    ### Returns\n    - returns the file response, filename specified to return as attachment.\n    \"\"\"\n\n    expected_path = str((get_spotdl_path() / \"web/sessions\").absolute())\n    if state.web_settings.get(\"web_use_output_dir\", False):\n        expected_path = str(\n            Path(client.downloader_settings[\"output\"].split(\"{\", 1)[0]).absolute()\n        )\n\n    if (not file.endswith(client.downloader_settings[\"format\"])) or (\n        not file.startswith(expected_path)\n    ):\n        raise HTTPException(status_code=400, detail=\"Invalid download path.\")\n\n    return FileResponse(\n        file,\n        filename=os.path.basename(file),\n    )\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.download_url","title":"<code>download_url(url, client=Depends(get_client), state=Depends(get_current_state))</code>  <code>async</code>","text":"<p>Download songs using Song url.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.download_url--arguments","title":"Arguments","text":"<ul> <li>url: The url to download.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.download_url--returns","title":"Returns","text":"<ul> <li>returns the file path if the song was downloaded.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.post(\"/api/download/url\")\nasync def download_url(\n    url: str,\n    client: Client = Depends(get_client),\n    state: ApplicationState = Depends(get_current_state),\n) -&gt; Optional[str]:\n    \"\"\"\n    Download songs using Song url.\n\n    ### Arguments\n    - url: The url to download.\n\n    ### Returns\n    - returns the file path if the song was downloaded.\n    \"\"\"\n\n    if state.web_settings.get(\"web_use_output_dir\", False):\n        client.downloader.settings[\"output\"] = client.downloader_settings[\"output\"]\n    else:\n        client.downloader.settings[\"output\"] = str(\n            (get_spotdl_path() / f\"web/sessions/{client.client_id}\").absolute()\n        )\n\n    client.downloader.progress_handler = ProgressHandler(\n        simple_tui=True,\n        update_callback=client.song_update,\n    )\n\n    try:\n        # Fetch song metadata\n        song = Song.from_url(url)\n\n        # Download Song\n        _, path = await client.downloader.pool_download(song)\n\n        if path is None:\n            state.logger.error(f\"Failure downloading {song.name}\")\n\n            raise HTTPException(\n                status_code=500, detail=f\"Error downloading: {song.name}\"\n            )\n\n        return str(path.absolute())\n\n    except Exception as exception:\n        state.logger.error(f\"Error downloading! {exception}\")\n\n        raise HTTPException(\n            status_code=500, detail=f\"Error downloading: {exception}\"\n        ) from exception\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.fix_mime_types","title":"<code>fix_mime_types()</code>","text":"<p>Fix incorrect entries in the <code>mimetypes</code> registry. On Windows, the Python standard library's <code>mimetypes</code> reads in mappings from file extension to MIME type from the Windows registry. Other applications can and do write incorrect values to this registry, which causes <code>mimetypes.guess_type</code> to return incorrect values, which causes spotDL to fail to render on the frontend. This method hard-codes the correct mappings for certain MIME types that are known to be either used by TensorBoard or problematic in general.</p> Source code in <code>spotdl/utils/web.py</code> <pre><code>def fix_mime_types():\n    \"\"\"Fix incorrect entries in the `mimetypes` registry.\n    On Windows, the Python standard library's `mimetypes` reads in\n    mappings from file extension to MIME type from the Windows\n    registry. Other applications can and do write incorrect values\n    to this registry, which causes `mimetypes.guess_type` to return\n    incorrect values, which causes spotDL to fail to render on\n    the frontend.\n    This method hard-codes the correct mappings for certain MIME\n    types that are known to be either used by TensorBoard or\n    problematic in general.\n    \"\"\"\n\n    # Known to be problematic when Visual Studio is installed:\n    # &lt;/~https://github.com/tensorflow/tensorboard/issues/3120&gt;\n    # /~https://github.com/spotDL/spotify-downloader/issues/1540\n    mimetypes.add_type(\"application/javascript\", \".js\")\n\n    # Not known to be problematic, but used by spotDL:\n    mimetypes.add_type(\"text/css\", \".css\")\n    mimetypes.add_type(\"image/svg+xml\", \".svg\")\n    mimetypes.add_type(\"text/html\", \".html\")\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_client","title":"<code>get_client(client_id=Query(default=None))</code>","text":"<p>Get the client's state.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_client--arguments","title":"Arguments","text":"<ul> <li>client_id: The client's ID.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.get_client--returns","title":"Returns","text":"<ul> <li>returns the client's state.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def get_client(client_id: Union[str, None] = Query(default=None)) -&gt; Client:\n    \"\"\"\n    Get the client's state.\n\n    ### Arguments\n    - client_id: The client's ID.\n\n    ### Returns\n    - returns the client's state.\n    \"\"\"\n\n    if client_id is None:\n        raise HTTPException(status_code=400, detail=\"client_id is required\")\n\n    instance = Client.get_instance(client_id)\n    if instance is None:\n        raise HTTPException(status_code=404, detail=\"client not found\")\n\n    return instance\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_current_state","title":"<code>get_current_state()</code>","text":"<p>Get the current state of the application.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_current_state--returns","title":"Returns","text":"<ul> <li>returns the application state.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def get_current_state() -&gt; ApplicationState:\n    \"\"\"\n    Get the current state of the application.\n\n    ### Returns\n    - returns the application state.\n    \"\"\"\n\n    return app_state\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_options","title":"<code>get_options()</code>","text":"<p>Get options model (possible settings).</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_options--returns","title":"Returns","text":"<ul> <li>returns the options.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/options_model\")\ndef get_options() -&gt; Dict[str, Any]:\n    \"\"\"\n    Get options model (possible settings).\n\n    ### Returns\n    - returns the options.\n    \"\"\"\n\n    parser = create_parser()\n\n    # Forbidden actions\n    forbidden_actions = [\n        \"help\",\n        \"operation\",\n        \"version\",\n        \"config\",\n        \"user_auth\",\n        \"client_id\",\n        \"client_secret\",\n        \"auth_token\",\n        \"cache_path\",\n        \"no_cache\",\n        \"cookie_file\",\n        \"ffmpeg\",\n        \"archive\",\n        \"host\",\n        \"port\",\n        \"keep_alive\",\n        \"enable_tls\",\n        \"key_file\",\n        \"cert_file\",\n        \"ca_file\",\n        \"allowed_origins\",\n        \"web_use_output_dir\",\n        \"keep_sessions\",\n        \"log_level\",\n        \"simple_tui\",\n        \"headless\",\n        \"download_ffmpeg\",\n        \"generate_config\",\n        \"check_for_updates\",\n        \"profile\",\n        \"version\",\n    ]\n\n    options = {}\n    for action in parser._actions:  # pylint: disable=protected-access\n        if action.dest in forbidden_actions:\n            continue\n\n        default = app_state.downloader_settings.get(action.dest, None)\n        choices = list(action.choices) if action.choices else None\n\n        type_name = \"\"\n        if action.type is not None:\n            if hasattr(action.type, \"__objclass__\"):\n                type_name: str = action.type.__objclass__.__name__  # type: ignore\n            else:\n                type_name: str = action.type.__name__  # type: ignore\n\n        if isinstance(\n            action, argparse._StoreConstAction  # pylint: disable=protected-access\n        ):\n            type_name = \"bool\"\n\n        if choices is not None and action.nargs == \"*\":\n            type_name = \"list\"\n\n        options[action.dest] = {\n            \"type\": type_name,\n            \"choices\": choices,\n            \"default\": default,\n            \"help\": action.help,\n        }\n\n    return options\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_settings","title":"<code>get_settings(client=Depends(get_client))</code>","text":"<p>Get client settings.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_settings--arguments","title":"Arguments","text":"<ul> <li>client: The client's state.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.get_settings--returns","title":"Returns","text":"<ul> <li>returns the settings.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/settings\")\ndef get_settings(\n    client: Client = Depends(get_client),\n) -&gt; DownloaderOptions:\n    \"\"\"\n    Get client settings.\n\n    ### Arguments\n    - client: The client's state.\n\n    ### Returns\n    - returns the settings.\n    \"\"\"\n\n    return client.downloader_settings\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.query_search","title":"<code>query_search(query)</code>","text":"<p>Parse search term and return list of Song objects.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.query_search--arguments","title":"Arguments","text":"<ul> <li>query: The query to parse.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.query_search--returns","title":"Returns","text":"<ul> <li>returns a list of Song objects.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/songs/search\", response_model=None)\ndef query_search(query: str) -&gt; List[Song]:\n    \"\"\"\n    Parse search term and return list of Song objects.\n\n    ### Arguments\n    - query: The query to parse.\n\n    ### Returns\n    - returns a list of Song objects.\n    \"\"\"\n\n    return get_search_results(query)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.shutdown_event","title":"<code>shutdown_event()</code>  <code>async</code>","text":"<p>Called when the server is shutting down.</p> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.on_event(\"shutdown\")\nasync def shutdown_event():\n    \"\"\"\n    Called when the server is shutting down.\n    \"\"\"\n\n    if (\n        not app_state.web_settings[\"keep_sessions\"]\n        and not app_state.web_settings[\"web_use_output_dir\"]\n    ):\n        app_state.logger.info(\"Removing sessions directories\")\n        sessions_dir = Path(get_spotdl_path(), \"web/sessions\")\n        if sessions_dir.exists():\n            shutil.rmtree(sessions_dir)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.song_from_url","title":"<code>song_from_url(url)</code>","text":"<p>Search for a song on spotify using url.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.song_from_url--arguments","title":"Arguments","text":"<ul> <li>url: The url to search.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.song_from_url--returns","title":"Returns","text":"<ul> <li>returns the first result as a Song object.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/song/url\", response_model=None)\ndef song_from_url(url: str) -&gt; Song:\n    \"\"\"\n    Search for a song on spotify using url.\n\n    ### Arguments\n    - url: The url to search.\n\n    ### Returns\n    - returns the first result as a Song object.\n    \"\"\"\n\n    return Song.from_url(url)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.songs_from_url","title":"<code>songs_from_url(url)</code>","text":"<p>Search for a song, playlist, artist or album on spotify using url.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.songs_from_url--arguments","title":"Arguments","text":"<ul> <li>url: The url to search.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.songs_from_url--returns","title":"Returns","text":"<ul> <li>returns a list with Song objects to be downloaded.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/url\", response_model=None)\ndef songs_from_url(url: str) -&gt; List[Song]:\n    \"\"\"\n    Search for a song, playlist, artist or album on spotify using url.\n\n    ### Arguments\n    - url: The url to search.\n\n    ### Returns\n    - returns a list with Song objects to be downloaded.\n    \"\"\"\n\n    if \"playlist\" in url:\n        playlist = Playlist.from_url(url)\n        return list(map(Song.from_url, playlist.urls))\n    if \"album\" in url:\n        album = Album.from_url(url)\n        return list(map(Song.from_url, album.urls))\n    if \"artist\" in url:\n        artist = Artist.from_url(url)\n        return list(map(Song.from_url, artist.urls))\n\n    return [Song.from_url(url)]\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.update_settings","title":"<code>update_settings(settings, client=Depends(get_client), state=Depends(get_current_state))</code>","text":"<p>Update client settings, and re-initialize downloader.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.update_settings--arguments","title":"Arguments","text":"<ul> <li>settings: The settings to change.</li> <li>client: The client's state.</li> <li>state: The application state.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.update_settings--returns","title":"Returns","text":"<ul> <li>returns True if the settings were changed.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.post(\"/api/settings/update\")\ndef update_settings(\n    settings: DownloaderOptionalOptions,\n    client: Client = Depends(get_client),\n    state: ApplicationState = Depends(get_current_state),\n) -&gt; DownloaderOptions:\n    \"\"\"\n    Update client settings, and re-initialize downloader.\n\n    ### Arguments\n    - settings: The settings to change.\n    - client: The client's state.\n    - state: The application state.\n\n    ### Returns\n    - returns True if the settings were changed.\n    \"\"\"\n\n    # Create shallow copy of settings\n    settings_cpy = client.downloader_settings.copy()\n\n    # Update settings with new settings that are not None\n    settings_cpy.update({k: v for k, v in settings.items() if v is not None})  # type: ignore\n\n    state.logger.info(f\"Applying settings: {settings_cpy}\")\n\n    new_settings = DownloaderOptions(**settings_cpy)  # type: ignore\n\n    # Re-initialize downloader\n    client.downloader_settings = new_settings\n    client.downloader = Downloader(\n        new_settings,\n        loop=state.loop,\n    )\n\n    return new_settings\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.version","title":"<code>version()</code>","text":"<p>Get the current version This method is created to ensure backward compatibility of the web app, as the web app is updated with the latest regardless of the backend version</p>"},{"location":"reference/utils/web/#spotdl.utils.web.version--returns","title":"Returns","text":"<ul> <li>returns the version of the app</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/version\", response_model=None)\ndef version() -&gt; str:\n    \"\"\"\n    Get the current version\n    This method is created to ensure backward compatibility of the web app,\n    as the web app is updated with the latest regardless of the backend version\n\n    ### Returns\n    -  returns the version of the app\n    \"\"\"\n\n    return __version__\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.websocket_endpoint","title":"<code>websocket_endpoint(websocket, client_id)</code>  <code>async</code>","text":"<p>Websocket endpoint.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.websocket_endpoint--arguments","title":"Arguments","text":"<ul> <li>websocket: The WebSocket instance.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.websocket(\"/api/ws\")\nasync def websocket_endpoint(websocket: WebSocket, client_id: str):\n    \"\"\"\n    Websocket endpoint.\n\n    ### Arguments\n    - websocket: The WebSocket instance.\n    \"\"\"\n\n    await Client(websocket, client_id).connect()\n\n    try:\n        while True:\n            await websocket.receive_json()\n    except WebSocketDisconnect:\n        app_state.clients.pop(client_id, None)\n\n        if (\n            len(app_state.clients) == 0\n            and app_state.web_settings[\"keep_alive\"] is False\n        ):\n            app_state.logger.debug(\n                \"No active connections, waiting 1s before shutting down\"\n            )\n\n            await asyncio.sleep(1)\n\n            # Wait 1 second before shutting down\n            # This is to prevent the server from shutting down when a client\n            # disconnects and reconnects quickly (e.g. when refreshing the page)\n            if len(app_state.clients) == 0:\n                # Perform a clean exit\n                app_state.logger.info(\"Shutting down server, no active connections\")\n                app_state.server.force_exit = True\n                app_state.server.should_exit = True\n                await app_state.server.shutdown()\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#spotdl-v4","title":"spotDL v4","text":"<p>spotDL finds songs from Spotify playlists on YouTube and downloads them - along with album art, lyrics and metadata.</p> <p> </p> <p>spotDL: The fastest, easiest and most accurate command-line music downloader.</p> <p>Read the documentation on ReadTheDocs!</p>"},{"location":"#installation","title":"Installation","text":"<p>Refer to our Installation Guide for more details.</p>"},{"location":"#python-recommended-method","title":"Python (Recommended Method)","text":"<ul> <li>spotDL can be installed by running <code>pip install spotdl</code>.</li> <li>To update spotDL run <code>pip install --upgrade spotdl</code> <p>On some systems you might have to change <code>pip</code> to <code>pip3</code>.</p> </li> </ul>"},{"location":"#other-options","title":"Other options","text":"<ul> <li>Prebuilt executable</li> <li>You can download the latest version from the     Releases Tab</li> <li>On Termux</li> <li><code>curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh</code></li> <li>Arch</li> <li>There is an Arch User Repository (AUR) package for     spotDL.</li> <li>Docker</li> <li> <p>Build image:</p> <pre><code>docker build -t spotdl .\n</code></pre> </li> <li> <p>Launch container with spotDL parameters (see section below). You need to create mapped     volume to access song files</p> <pre><code>docker run --rm -v $(pwd):/music spotdl download [trackUrl]\n</code></pre> </li> <li> <p>Build from source     <pre><code>git clone /~https://github.com/spotDL/spotify-downloader &amp;&amp; cd spotify-downloader\npip install poetry\npoetry install\npython3 scripts/build.py\n</code></pre>     An executable is created in <code>spotify-downloader/dist/</code>.</p> </li> </ul>"},{"location":"#installing-ffmpeg","title":"Installing FFmpeg","text":"<p>FFmpeg is required for spotDL. If using FFmpeg only for spotDL, you can simply install FFmpeg to your spotDL installation directory: <code>spotdl --download-ffmpeg</code></p> <p>We recommend the above option, but if you want to install FFmpeg system-wide, follow these instructions</p> <ul> <li>Windows Tutorial</li> <li>OSX - <code>brew install ffmpeg</code></li> <li>Linux - <code>sudo apt install ffmpeg</code> or use your distro's package manager</li> </ul>"},{"location":"#usage","title":"Usage","text":"<p>Using SpotDL without options:: <pre><code>spotdl [urls]\n</code></pre> You can run spotDL as a package if running it as a script doesn't work: <pre><code>python -m spotdl [urls]\n</code></pre></p> <p>General usage: <pre><code>spotdl [operation] [options] QUERY\n</code></pre> When downloading songs, the song's Spotify Popularity variable (described here) is stored in metadata as a comment, so you can sort your downloaded songs by popularity.</p> <p>There are different operations spotDL can perform. The default is <code>download</code>, which simply downloads the songs from YouTube and embeds metadata.</p> <p>The query for spotDL is usually a list of Spotify URLs, but for some operations like sync, only a single link or file is required. For a list of all options use <code>spotdl -h</code></p>"},{"location":"#supported-operations","title":"Supported operations","text":"<ul> <li> <p><code>save</code>: Saves only the metadata from Spotify without downloading anything.</p> <ul> <li>Usage:     <code>spotdl save [query] --save-file {filename}.spotdl</code></li> </ul> </li> <li> <p><code>web</code>: Starts a web interface instead of using the command line. However, it has limited features and only supports downloading single songs.</p> <ul> <li>Usage:     <code>spotdl web</code></li> </ul> </li> <li> <p><code>url</code>: Get direct download link for each song from the query.</p> <ul> <li>Usage:     <code>spotdl url [query]</code></li> </ul> </li> <li> <p><code>sync</code>: Updates directories. Compares the directory with the current state of the playlist. Newly added songs will be downloaded and removed songs will be deleted. No other songs will be downloaded and no other files will be deleted.</p> <ul> <li> <p>Usage:     <code>spotdl sync [query] --save-file {filename}.spotdl</code></p> <p>This create a new sync file, to update the directory in the future, use:</p> <p><code>spotdl sync {filename}.spotdl</code></p> </li> </ul> </li> <li> <p><code>meta</code>: Updates metadata for the provided song files. </p> </li> </ul>"},{"location":"#music-sourcing-and-audio-quality","title":"Music Sourcing and Audio Quality","text":"<p>spotDL uses YouTube as a source for music downloads. This method is used to avoid any issues related to downloading music from Spotify.</p> <p>Note Users are responsible for their actions and potential legal consequences. We do not support unauthorized downloading of copyrighted material and take no responsibility for user actions.</p>"},{"location":"#audio-quality","title":"Audio Quality","text":"<p>spotDL downloads music from YouTube and is designed to always download the highest possible bitrate; which is 128 kbps for regular users and 256 kbps for YouTube Music premium users.</p> <p>Check the Audio Formats page for more info.</p>"},{"location":"#contributing","title":"Contributing","text":"<p>Interested in contributing? Check out our CONTRIBUTING.md to find resources around contributing along with a guide on how to set up a development environment.</p>"},{"location":"#license","title":"License","text":"<p>This project is Licensed under the MIT License.</p>"},{"location":"CODE_OF_CONDUCT/","title":"Contributor Covenant Code of Conduct","text":""},{"location":"CODE_OF_CONDUCT/#our-pledge","title":"Our Pledge","text":"<p>We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.</p> <p>We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.</p>"},{"location":"CODE_OF_CONDUCT/#our-standards","title":"Our Standards","text":"<p>Examples of behavior that contributes to a positive environment for our community include:</p> <ul> <li>Demonstrating empathy and kindness toward other people</li> <li>Being respectful of differing opinions, viewpoints, and experiences</li> <li>Giving and gracefully accepting constructive feedback</li> <li>Accepting responsibility and apologizing to those affected by our mistakes, and learning from   the experience</li> <li>Focusing on what is best not just for us as individuals, but for the overall community</li> </ul> <p>Examples of unacceptable behavior include:</p> <ul> <li>The use of sexualized language or imagery, and sexual attention or advances of any kind</li> <li>Trolling, insulting or derogatory comments, and personal or political attacks</li> <li>Public or private harassment</li> <li>Publishing others' private information, such as a physical or email address, without their   explicit permission</li> <li>Other conduct which could reasonably be considered inappropriate in a professional setting</li> </ul>"},{"location":"CODE_OF_CONDUCT/#enforcement-responsibilities","title":"Enforcement Responsibilities","text":"<p>Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.</p> <p>Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.</p>"},{"location":"CODE_OF_CONDUCT/#scope","title":"Scope","text":"<p>This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.</p>"},{"location":"CODE_OF_CONDUCT/#enforcement","title":"Enforcement","text":"<p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at spotdladmins@googlegroups.com. All complaints will be reviewed and investigated promptly and fairly.</p> <p>All community leaders are obligated to respect the privacy and security of the reporter of any incident.</p>"},{"location":"CODE_OF_CONDUCT/#enforcement-guidelines","title":"Enforcement Guidelines","text":"<p>Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:</p>"},{"location":"CODE_OF_CONDUCT/#1-correction","title":"1. Correction","text":"<p>Community Impact: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.</p> <p>Consequence: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.</p>"},{"location":"CODE_OF_CONDUCT/#2-warning","title":"2. Warning","text":"<p>Community Impact: A violation through a single incident or series of actions.</p> <p>Consequence: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.</p>"},{"location":"CODE_OF_CONDUCT/#3-temporary-ban","title":"3. Temporary Ban","text":"<p>Community Impact: A serious violation of community standards, including sustained inappropriate behavior.</p> <p>Consequence: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.</p>"},{"location":"CODE_OF_CONDUCT/#4-permanent-ban","title":"4. Permanent Ban","text":"<p>Community Impact: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.</p> <p>Consequence: A permanent ban from any sort of public interaction within the community.</p>"},{"location":"CODE_OF_CONDUCT/#attribution","title":"Attribution","text":"<p>This Code of Conduct is adapted from the Contributor Covenant, version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.</p> <p>Community Impact Guidelines were inspired by Mozilla's code of conduct enforcement ladder.</p> <p>For answers to common questions about this code of conduct, see the FAQ at https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.</p>"},{"location":"CONTRIBUTING/","title":"Contributing","text":""},{"location":"CONTRIBUTING/#contributing-to-spotdl","title":"Contributing to spotdl","text":"<p>First off, thanks for taking the time to contribute! \u2764\ufe0f</p> <p>All types of contributions are encouraged and valued. See the Table of Contents for different ways to help and details about how this project handles them. Please make sure to read the relevant section before making your contribution. It will make it a lot easier for us maintainers and smooth out the experience for everyone involved. The community looks forward to your contributions. \ud83c\udf89</p> <p>And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about:</p> <ul> <li>Star the project</li> <li>Tweet about it</li> <li>Refer this project in your project's readme</li> <li>Mention the project at local meetups and tell your friends/colleagues</li> </ul>"},{"location":"CONTRIBUTING/#table-of-contents","title":"Table of Contents","text":"<ul> <li>I Have a Question</li> <li>I Want To Contribute</li> <li>Reporting Bugs</li> <li>Suggesting Enhancements</li> <li>Linting, Formatting and Type-checking</li> <li>Python Documentation</li> <li>Overview of the Project Structure</li> <li>Join The Project Team</li> </ul>"},{"location":"CONTRIBUTING/#i-have-a-question","title":"I Have a Question","text":"<p>If you want to ask a question, we assume that you have read the available Documentation.</p> <p>Before you ask a question, it is best to search for existing Issues that might help you. In case you have found a suitable issue and still need clarification, you can write your question in this issue. It is also advisable to search the internet for answers first.</p> <p>If you then still feel the need to ask a question and need clarification, we recommend the following:</p> <ul> <li>Open an Issue.</li> <li>Provide as much context as you can about what you're running into.</li> <li>Provide project and platform versions (nodejs, npm, etc), depending on what seems relevant.</li> </ul> <p>We will then take care of the issue as soon as possible.</p>"},{"location":"CONTRIBUTING/#i-want-to-contribute","title":"I Want To Contribute","text":""},{"location":"CONTRIBUTING/#legal-notice","title":"Legal Notice","text":"<p>When contributing to this project, you must agree that you have authored 100% of the content, that you have the necessary rights to the content and that the content you contribute may be provided under the project license.</p>"},{"location":"CONTRIBUTING/#reporting-bugs","title":"Reporting Bugs","text":""},{"location":"CONTRIBUTING/#before-submitting-a-bug-report","title":"Before Submitting a Bug Report","text":"<p>A good bug report shouldn't leave others needing to chase you up for more information. Therefore, we ask you to investigate carefully, collect information and describe the issue in detail in your report. Please complete the following steps in advance to help us fix any potential bug as fast as possible.</p> <ul> <li>Make sure that you are using the latest version.</li> <li>Determine if your bug is really a bug and not an error on your side e.g. using incompatible   environment components/versions (Make sure that you have read the   documentation. If you are looking for   support, you might want to check this section).</li> <li>To see if other users have experienced (and potentially already solved) the same issue you   are having, check if there is not already a bug report existing for your bug or error in the   bug tracker.</li> <li>Also make sure to search the internet (including Stack Overflow) to see if users outside of   the GitHub community have discussed the issue.</li> <li>Collect information about the bug:</li> <li>Stack trace (Traceback)</li> <li>OS, Platform and Version (Windows, Linux, macOS, x86, ARM)</li> <li>Version of the interpreter, compiler, SDK, runtime environment, package manager, depending on   what seems relevant.</li> <li>Possibly your input and the output</li> <li>Can you reliably reproduce the issue? And can you also reproduce it with older versions?</li> </ul>"},{"location":"CONTRIBUTING/#how-do-i-submit-a-good-bug-report","title":"How Do I Submit a Good Bug Report?","text":"<p>You must never report security related issues, vulnerabilities or bugs to the issue tracker, or elsewhere in public. Instead sensitive bugs must be sent by Discord to Silverarmor (spotDL Discord Owner).</p> <p>We use GitHub issues to track bugs and errors. If you run into an issue with the project:</p> <ul> <li>Open an Issue. (Since we can't be   sure at this point whether it is a bug or not, we ask you not to talk about a bug yet and not   to label the issue.)</li> <li>Explain the behavior you would expect and the actual behavior.</li> <li>Please provide as much context as possible and describe the reproduction steps that someone   else can follow to recreate the issue on their own. This usually includes your code. For good   bug reports you should isolate the problem and create a reduced test case.</li> <li>Provide the information you collected in the previous section.</li> </ul> <p>Once it's filed:</p> <ul> <li>The project team will label the issue accordingly.</li> <li>A team member will try to reproduce the issue with your provided steps. If there are no   reproduction steps or no obvious way to reproduce the issue, the team will ask you for those   steps and mark the issue as <code>needs-repro</code>. Bugs with the <code>needs-repro</code> tag will not be   addressed until they are reproduced.</li> <li>If the team is able to reproduce the issue, it will be marked <code>needs-fix</code>, as well as   possibly other tags (such as <code>critical</code>), and the issue will be left to be   implemented by someone.</li> </ul>"},{"location":"CONTRIBUTING/#suggesting-enhancements","title":"Suggesting Enhancements","text":"<p>This section guides you through submitting an enhancement suggestion for spotdl, including completely new features and minor improvements to existing functionality. Following these guidelines will help maintainers and the community to understand your suggestion and find related suggestions.</p>"},{"location":"CONTRIBUTING/#before-submitting-an-enhancement","title":"Before Submitting an Enhancement","text":"<ul> <li>Make sure that you are using the latest version.</li> <li>Read the documentation carefully and find   out if the functionality is already covered, maybe by an individual configuration.</li> <li>Perform a search to see if the   enhancement has already been suggested. If it has, add a comment to the existing issue   instead of opening a new one.</li> <li>Find out whether your idea fits with the scope and aims of the project. It's up to you to   make a strong case to convince the project's developers of the merits of this feature. Keep   in mind that we want features that will be useful to the majority of our users and not just a   small subset. If you're just targeting a minority of users, consider writing an add-on/plugin   library.</li> </ul>"},{"location":"CONTRIBUTING/#how-do-i-submit-a-good-enhancement-suggestion","title":"How Do I Submit a Good Enhancement Suggestion?","text":"<p>Enhancement suggestions are tracked as GitHub issues.</p> <ul> <li>Use a clear and descriptive title for the issue to identify the suggestion.</li> <li>Provide a step-by-step description of the suggested enhancement in as many details as   possible.</li> <li>Describe the current behavior and explain which behavior you expected to see instead   and why. At this point you can also tell which alternatives do not work for you.</li> <li>You may want to include screenshots and animated GIFs which help you demonstrate the   steps or point out the part which the suggestion is related to. You can use   this tool to record GIFs on macOS and Windows, and   this tool or   this tool on Linux.       </li> <li>Explain why this enhancement would be useful to most spotdl users. You may also want to   point out the other projects that solved it better and which could serve as inspiration.</li> </ul>"},{"location":"CONTRIBUTING/#developing","title":"Developing","text":"<p>Fork the repository on Github and then clone it.</p> <pre><code>git clone [your username]/spotify-downloader\ncd spotify-downloader\n</code></pre> <p>Install poetry</p> <pre><code>pip install poetry\n</code></pre> <p>Then, to install spotDL in-place, run the following</p> <pre><code>poetry install\n</code></pre> <p>Then, to activate virtual environment run the following</p> <pre><code>poetry shell\n</code></pre> <p>All changes will now affect the poetry installation of the spotDL cli.</p>"},{"location":"CONTRIBUTING/#linting-formatting-and-type-checking","title":"Linting, Formatting and Type-checking","text":"<ul> <li>We use <code>pylint</code> for linting and expect a score above <code>9</code></li> </ul> <pre><code>pylint --fail-under 10 --limit-inference-results 0 --disable=R0917 ./spotdl\n</code></pre> <ul> <li>We use <code>black</code> for code formatting</li> </ul> <pre><code>black ./spotdl\n</code></pre> <ul> <li>We use <code>mypy</code> for type-checking and expect no errors at all</li> </ul> <p>To install type-stubs the first time around</p> <pre><code>mypy --ignore-missing-imports --follow-imports silent --install-types --non-interactive ./spotdl\n</code></pre> <pre><code>mypy ./spotdl\n</code></pre> <ul> <li>You can install these basic tools with</li> </ul> <pre><code>pip install --force-reinstall --upgrade mypy black pylint\n</code></pre>"},{"location":"CONTRIBUTING/#python-documentation","title":"Python Documentation","text":"<p>Any submitted code is expected to have accompanying documentation</p>"},{"location":"CONTRIBUTING/#mkdocs-generating-documentation","title":"mkdocs: generating documentation","text":"<ul> <li>We generate our documentation with <code>mkdocs</code></li> </ul> <pre><code>pip install mkdocs\n</code></pre> <p><code>mkdocs</code> requires that all development packages are installed</p> <pre><code>poetry install\n</code></pre> <p>generate docs with</p> <pre><code>mkdocs build --strict\n</code></pre> <p>view docs live-time while editing with</p> <pre><code>mkdocs serve\n</code></pre>"},{"location":"CONTRIBUTING/#docstring-formats","title":"DocString Formats","text":"<ul> <li>For functions</li> </ul> <pre><code>one-liner about functions purpose\n\n### Args (optional)\n- arg_name: description\n\n### Returns (optional)\n- return value description\n\n### Errors (only if there are known unhandled Errors/thrown Errors)\n- known errors\n\n### Notes (optional)\n- notes if any\n</code></pre> <ul> <li>For Classes</li> </ul> <pre><code>one-liner about class purpose\n\n### Attributes\n- attribute: description\n\n### Notes (optional)\n- notes if any\n</code></pre> <ul> <li>For modules/package <code>__init__</code></li> </ul> <pre><code>at max 3 lines about module/package purpose\n\noptional usage example for module/package preferably showcasing most commonly used functionality\n</code></pre>"},{"location":"CONTRIBUTING/#notes-about-docstrings","title":"Notes about docstrings","text":"<ul> <li>DocStrings are Inherited</li> </ul> <pre><code>class A:\n    def test(self):\n        \"\"\"Docstring for A.\"\"\"\n        pass\n\nclass B(A):\n    def test(self):\n        pass\n</code></pre>"},{"location":"CONTRIBUTING/#overview-of-the-project-structure","title":"Overview of the Project Structure","text":"sub-package purpose <code>utils</code> Contains commonly used functions <code>types</code> Custom data types used in the spotdl project <code>providers</code> Different Providers to obtain info (like song details) from <code>download</code> Download manager <code>console</code> Different user-facing operations like download, preload and web-ui <code>__init__</code> Contains spotdl class that simplifies the download process"},{"location":"CONTRIBUTING/#join-the-project-team","title":"Join The Project Team","text":""},{"location":"CONTRIBUTING/#attribution","title":"Attribution","text":"<p>This guide is based on the contributing-gen. Make your own!</p>"},{"location":"installation/","title":"spotDL Installation Guide","text":"<p>spotDL is a free and open source tool that downloads your Spotify playlists &amp; music</p> <p>The fastest, easiest, and most accurate command-line music downloader</p>"},{"location":"installation/#install-via-python","title":"Install via Python","text":"<p>This is our recommended installation method.</p> <p>If you are on Windows, Install Visual C++ Redistributable (link below) and then proceed to install Python &amp; FFmpeg</p>"},{"location":"installation/#prerequisites-to-spotdl","title":"Prerequisites to spotDL","text":"<ul> <li>Visual C++ 2019 redistributable   (on Windows)</li> <li>Python 3.7 or above (added to PATH)</li> <li>FFmpeg 4.2 or above (added to PATH)</li> </ul>"},{"location":"installation/#install-python-to-path","title":"Install Python to PATH","text":"<p>We recommend installing the latest version of Python</p> <p>When installing Python, ensure to select \"Add to PATH\".</p> <p></p>"},{"location":"installation/#installing-spotdl","title":"Installing spotDL","text":"<p>If you are not on Windows (e.g. OSX/UNIX), replace <code>pip</code> with <code>pip3</code> and <code>python</code> with <code>python3</code> in all commands.</p> <p>Firstly, open a terminal. On Windows: Command Prompt, OSX: \"Terminal\", *UNIX: Bash or Zsh.</p> <p>Verify you have installed Python correctly via <code>python -V</code>. Ensure you have v3.7 or greater.</p> <p>Next, install spotDL by typing the following</p> <pre><code>pip install spotdl\n</code></pre>"},{"location":"installation/#installing-ffmpeg","title":"Installing FFmpeg","text":"<p>If using FFmpeg only for spotDL, you can install FFmpeg to your local directory. <code>spotdl --download-ffmpeg</code> will download FFmpeg to your spotDL installation directory.</p> <p>We recommend the above option, but if you want to install FFmpeg system-wide,</p> <ul> <li>Windows Tutorial</li> <li>OSX - <code>brew install ffmpeg</code></li> <li>Linux - <code>sudo apt install ffmpeg</code> or use your distro's package manager</li> </ul> <p>If you require further help, ask in our Discord Server</p> <p></p>"},{"location":"installation/#using-prebuilt-executable","title":"Using Prebuilt Executable","text":""},{"location":"installation/#download-the-executable","title":"Download the executable","text":"<p>You can download the latest version from the Releases Tab</p>"},{"location":"installation/#running-web-ui","title":"Running Web UI","text":"<p>Web UI will start by default if no arguments are passed to the command line (after double-clicking for example)</p> <p></p>"},{"location":"installation/#running-the-cli","title":"Running the CLI","text":"<p>To use the command line interface just open your terminal and run <code>./spotdl-vX.X.X operation [urls]</code></p>"},{"location":"installation/#docker-setup","title":"Docker Setup","text":"<p>spotDL provides a Docker image.</p> <p>Install Docker: https://docs.docker.com/engine/installation/</p> <p>Install Docker Compose: https://docs.docker.com/compose/install/</p> <p>Docker documentation: https://docs.docker.com/</p>"},{"location":"installation/#built-in-docker-image","title":"Built-in Docker Image","text":"<ul> <li>Build docker image <code>docker build -t spotdl .</code></li> <li>List spotdl options: <code>docker run --rm spotdl --help</code></li> <li>Download a song:   <code>docker run --rm -v $(pwd):/music spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b</code></li> </ul>"},{"location":"installation/#docker-hub-image","title":"Docker Hub Image","text":"<ul> <li> <p>Pull docker image from Docker hub: <code>docker pull spotdl/spotify-downloader</code></p> </li> <li> <p>Download a song using Docker image:   <code>docker run --rm -v $(pwd):/music spotdl/spotify-downloader download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b</code></p> </li> <li> <p>Create a Docker container</p> </li> </ul> <pre><code>docker create \\\n  --name=spotdl \\\n  -v &lt;path to data&gt;:/music \\\n  spotdl/spotify-downloader\n</code></pre>"},{"location":"installation/#docker-compose","title":"Docker Compose","text":"<ul> <li>Create a container using Docker Compose: <code>docker-compose up --no-start</code></li> <li>Download a song using Docker compose:   <code>docker-compose run --rm spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b</code></li> </ul>"},{"location":"installation/#other-installation-methods","title":"Other Installation Methods","text":""},{"location":"installation/#termux","title":"Termux","text":"<p>We have a dedicated Termux installation script <code>curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh</code></p>"},{"location":"installation/#arch-user-repository-aur-package","title":"Arch User Repository (AUR) package","text":"<p>You can find the AUR Package here</p>"},{"location":"installation/#where-does-spotdl-download-songs","title":"Where does spotDL download songs?","text":"<p>spotDL downloads files to the folder where you ran spotDL from.</p> <p>Open pwsh/powershell/cmd/terminal/similar in the folder you want files to download to, or cd to desired folder.</p> <p>Windows Shortcut: Navigate to the folder you want the files to download to. <code>SHIFT + RIGHT CLICK</code>, then select \"Open PowerShell window here\"</p> <p></p>"},{"location":"installation/#we-have-a-public-discord-server-at-discordggxca23pwjwy","title":"We have a public Discord server at discord.gg/xCa23pwJWY!","text":""},{"location":"troubleshooting/","title":"Troubleshooting / FAQ Guide","text":"<p>As common issues or questions are encountered solutions will be added to this guide.</p> 'spotdl' is not recognized <p>Python/(site packages) is not added to PATH correctly. You need to install Python from https://www.python.org/downloads/</p> <p>Or you are using python from microsoft store. If so uninstall it and restart cmd. If this doesn't work reinstall python.</p> spotdl: command not found <p>If you see this error after installing spotdl, that means that the bin (Binaries) folder is not on <code>$PATH</code></p> pkg_resources.DistributionNotFound <p>Sometimes not all packages are installed but are required by yt-dlp for example: <code>brotli</code> or <code>websockets</code></p> HTTP Error 404 <p>/~https://github.com/plamere/spotipy/issues/795#issuecomment-1100321148</p> ssl.SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] <p>https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error</p> RecursionError <p>/~https://github.com/spotDL/spotify-downloader/issues/1493</p> RuntimeWarning <p>This happens when running spotdl using <code>python -m</code>.</p> Not found '_raw_ecb.so' <p>This error is specific for M1 Macs only.</p> <p>https://discord.com/channels/771628785447337985/871006150357823498 https://discord.com/channels/771628785447337985/939475659238043738</p>"},{"location":"troubleshooting/#error-message","title":"Error message","text":"<pre><code>'spotdl' is not recognized as an internal or external command,\noperable program or batch file.\n</code></pre>"},{"location":"troubleshooting/#solution","title":"Solution","text":"<p>Ensure to add to PATH when installing: </p>"},{"location":"troubleshooting/#solution_1","title":"Solution","text":""},{"location":"troubleshooting/#bashrc","title":"<code>.bashrc</code>","text":"<p>Add <code>export PATH=~/.local/bin:$PATH</code> at the bottom of <code>~/.bashrc</code></p> <p>Then run <code>source ~/.bashrc</code></p>"},{"location":"troubleshooting/#zshrc","title":"<code>.zshrc</code>","text":"<p>Add <code>export PATH=~/.local/bin:$PATH</code> at the bottom of <code>~/.zshrc</code> Then run <code>source ~/.zshrc</code></p>"},{"location":"troubleshooting/#error-message_1","title":"Error Message","text":"<p><code>pkg_resources.DistributionNotFound: The 'websockets' distribution was not found and is required by yt-dlp</code></p>"},{"location":"troubleshooting/#solution_2","title":"Solution","text":"<p><code>pip install brotli websockets yt-dlp -U</code></p>"},{"location":"troubleshooting/#error-message_2","title":"Error Message","text":"<p><code>HTTP Error for GET to URL with Params: {} returned 404 due to None</code></p>"},{"location":"troubleshooting/#solution_3","title":"Solution","text":"<p>Update spotdl to the latest version which contains workaround.</p> <p><code>pip install -U spotdl</code></p>"},{"location":"troubleshooting/#error-message_3","title":"Error Message","text":"<p><code>urllib.error.URLError: &lt;urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:847)&gt;</code></p>"},{"location":"troubleshooting/#solution_4","title":"Solution","text":"<p>https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error</p>"},{"location":"troubleshooting/#error-message_4","title":"Error Message","text":"<p><code>RecursionError: maximum recursion depth exceeded</code></p>"},{"location":"troubleshooting/#solution_5","title":"Solution","text":"<p>Update spotdl</p> <p><code>pip install spotdl -U</code></p>"},{"location":"troubleshooting/#error-message_5","title":"Error Message","text":"<pre><code>RuntimeWarning: 'spotdl.__main__' found in sys.modules after import of package 'spotdl',\nbut prior to execution of 'spotdl.__main__'; this may result in unpredictable behaviour\nwarn(RuntimeWarning(msg))\n</code></pre>"},{"location":"troubleshooting/#solution_6","title":"Solution","text":"<p>You can ignore this error or just run spotdl directly</p>"},{"location":"troubleshooting/#error-message_6","title":"Error Message","text":"<pre><code>aise OSError(\"Cannot load native module '%s': %s\" % (name, \", \".join(attempts)))\nOSError: Cannot load native module 'Cryptodome.Cipher._raw_ecb': Not found '_raw_ecb.cpython-39-darwin.so',\nCannot load '_raw_ecb.abi3.so': dlopen(/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Util/../Cipher/_raw_ecb.abi3.so, 6): no suitable image found.  Did find:\n/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Util/../Cipher/_raw_ecb.abi3.so: mach-o, but wrong architecture\n/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Cipher/_raw_ecb.abi3.so: mach-o, but wrong architecture, Not found '_raw_ecb.so'\n</code></pre>"},{"location":"troubleshooting/#solution_7","title":"Solution","text":"<p>Possible solutions:</p> <p>https://discord.com/channels/771628785447337985/871006150357823498 https://discord.com/channels/771628785447337985/939475659238043738</p>"},{"location":"usage/","title":"spotDL usage examples","text":""},{"location":"usage/#downloading","title":"Downloading","text":"Song <p>To download a song, run</p> <pre><code>spotdl download [trackUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b\n</code></pre> Album <p>To download an album, run</p> <pre><code>spotdl download [albumUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj\n</code></pre> Playlist <p>To download a playlist, run</p> <pre><code>spotdl download [playlistUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID\n</code></pre> Artist <p>To download all songs from an artist run</p> <pre><code>spotdl download [artistUrl]\n</code></pre> <p>example:</p> <pre><code>spotdl download https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\n</code></pre> Search <p>To search for and download a song, run, with quotation marks</p> <pre><code>spotdl download '[songQuery]'\n</code></pre> <p>example:</p> <pre><code>spotdl download 'The Weeknd - Blinding Lights'\n</code></pre> YouTube link with Spotify metadata <p>To download YouTube video with metadata from Spotify, run</p> <p>Noting the quote <code>\"</code> are required</p> <pre><code>spotdl download \"YouTubeURL|SpotifyURL\"\n</code></pre> <p>example:</p> <pre><code>spotdl download \"https://www.youtube.com/watch?v=XXYlFuWEuKI|https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b?si=b5c0790edc8f4904\"\n</code></pre> Liked songs <p>To download liked Spotify songs run</p> <p><code>--user-auth</code> is required</p> <pre><code>spotdl download saved --user-auth\n</code></pre> All user playlists <p>To download all user playlists run</p> <p><code>--user-auth</code> is required</p> <pre><code>spotdl download all-user-playlists --user-auth\n</code></pre> All user saved albums <p>To download all user saved albums run</p> <p><code>--user-auth</code> is required</p> <pre><code>spotdl download all-user-saved-albums --user-auth\n</code></pre> <p>You can queue up multiple download tasks by separating the arguments with spaces</p> <pre><code>spotdl download [songQuery1] [albumUrl] [songQuery2] ... (order does not matter)\n</code></pre> <p>example:</p> <pre><code>spotdl download 'The Weeknd - Blinding Lights' https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID ...\n</code></pre>"},{"location":"usage/#audio-formats-and-quality","title":"Audio Formats and Quality","text":"<p>Files are downloaded in MP3 format for the best compatibility across different platforms/players, but spotDL also supports other output formats like M4A and OPUS.</p> <p>Note: spotDL never downloads songs in a bitrate higher than 128kbps, except for those with YTMusic Premium, where 256 kbps is available for M4A format.</p> <p>Note that using the <code>--bitrate</code> flag will convert the file to the specified bitrate, so it may result in larger file sizes with no significant change in quality. If you prefer smaller file sizes, consider using the default bitrate or a lower value.</p> <p>Converting files might not be ideal for some users who prefer the files in their original quality.</p> <p>Alternatively, you can use the <code>--bitrate disable</code> option to skip the conversion step for certain file formats such as M4A/OPUS.</p>"},{"location":"usage/#youtube-music-premium","title":"YouTube Music Premium","text":"<p>YouTube Music Premium users can use their account to download songs with a higher bitrate (256kbps).</p> <p>To download music in higher quality follow the steps below:</p> <ol> <li> <p>Change quality in YouTube Music settings to highest possible.</p> </li> <li> <p>Get cookies.txt for https://music.youtube.com.</p> <p>You can use Get cookies.txt extension or cookies.txt for this. More info here</p> </li> <li> <p>Add <code>--cookie-file cookies.txt</code> option to your spotDL command line options</p> <p>Replace cookies.txt with the actual name of your cookies file</p> </li> <li> <p>Change the audio format to either M4A or OPUS to get the raw HQ file</p> </li> </ol> <p>Note To get the best audio possible you should use M4A/OPUS audio format with <code>--bitrate disable</code></p>"},{"location":"usage/#syncing","title":"Syncing","text":"<p>Sync function for the console. Keep local files up to date with playlists/albums/etc. This will download new songs and remove the ones that are no longer present in the playlists/albums/etc</p> Initialize Synchronization <p>To create the sync file run</p> <pre><code>spotdl sync [query] --save-file [fileName]\n</code></pre> <p>example:</p> <pre><code>spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file \"the-weeknd.sync.spotdl\"\n</code></pre> <p>Note: The sync file has to end with .spotdl</p> Syncing <p>To sync the songs run</p> <pre><code>spotdl sync [fileName]\n</code></pre> <p>example:</p> <pre><code>spotdl sync \"the-weeknd.sync.spotdl\"\n</code></pre>"},{"location":"usage/#saving","title":"Saving","text":"<p>Saves the songs metadata to a file for further use.</p> <pre><code>spotdl save [query] --save-file [fileName]\n</code></pre> <p>example:</p> <pre><code>spotdl save 'The Weeknd - Blinding Lights' --save-file 'the-weeknd.spotdl'\n</code></pre> Preloading <p>Preload the download url to speed up the download process.</p> <pre><code>spotdl save [query] --save-file [fileName] --preload\n</code></pre> <p>example:</p> <pre><code>spotdl save 'The Weeknd - Blinding Lights' --save-file 'the-weeknd.spotdl' --preload\n</code></pre>"},{"location":"usage/#web-ui-user-interface","title":"Web UI (User Interface)","text":"<p>To start the web UI, run</p> <pre><code>spotdl web\n</code></pre>"},{"location":"usage/#download-location","title":"Download Location","text":"<p>By default, the web UI downloads files to a special directory, to overwrite this behavior add option <code>--web-use-output-dir</code>, which will make output directory follow <code>--output</code></p>"},{"location":"usage/#config-file","title":"Config file","text":""},{"location":"usage/#config-file-location","title":"Config file location","text":"<p>The config file is located at <code>C:\\Users\\user\\.spotdl\\config.json</code> or <code>~/.spotdl/config.json</code> under linux</p> <p>Note: If you want to use XDG_DATA_HOME directory, run <code>mkdir $XDG_DATA_HOME/spotdl</code>, next time you run spotdl it will be automatically used.</p>"},{"location":"usage/#generate-a-config-file","title":"Generate a config file","text":"<p>To generate a config file, run</p> <pre><code>spotdl --generate-config\n</code></pre> <p>Note: This will overwrite the existing config file.</p>"},{"location":"usage/#loading-config","title":"Loading config","text":"<p>Config file gets loaded automatically if it already exists, or if you've passed <code>--config</code> flag</p> <p>If you don't want config to load automatically change <code>load_config</code> option in config file to false</p> <pre><code>{\n    \"load_config\": false\n}\n</code></pre>"},{"location":"usage/#default-config","title":"Default config","text":"<pre><code>{\n    \"client_id\": \"f8a606e5583643beaa27ce62c48e3fc1\",\n    \"client_secret\": \"f6f4c8f73f0649939286cf417c811607\",\n    \"auth_token\": null,\n    \"user_auth\": false,\n    \"headless\": false,\n    \"cache_path\": \"/Users/username/.spotdl/.spotipy\",\n    \"no_cache\": false,\n    \"max_retries\": 3,\n    \"use_cache_file\": false,\n    \"audio_providers\": [\n        \"youtube-music\"\n    ],\n    \"lyrics_providers\": [\n        \"genius\",\n        \"azlyrics\",\n        \"musixmatch\"\n    ],\n    \"playlist_numbering\": false,\n    \"scan_for_songs\": false,\n    \"m3u\": null,\n    \"output\": \"{artists} - {title}.{output-ext}\",\n    \"overwrite\": \"skip\",\n    \"search_query\": null,\n    \"ffmpeg\": \"ffmpeg\",\n    \"bitrate\": null,\n    \"ffmpeg_args\": null,\n    \"format\": \"mp3\",\n    \"save_file\": null,\n    \"filter_results\": true,\n    \"album_type\": null,\n    \"threads\": 4,\n    \"cookie_file\": null,\n    \"restrict\": null,\n    \"print_errors\": false,\n    \"sponsor_block\": false,\n    \"preload\": false,\n    \"archive\": null,\n    \"load_config\": true,\n    \"log_level\": \"INFO\",\n    \"simple_tui\": false,\n    \"fetch_albums\": false,\n    \"id3_separator\": \"/\",\n    \"ytm_data\": false,\n    \"add_unavailable\": false,\n    \"generate_lrc\": false,\n    \"force_update_metadata\": false,\n    \"only_verified_results\": false,\n    \"sync_without_deleting\": false,\n    \"max_filename_length\": null,\n    \"yt_dlp_args\": null,\n    \"detect_formats\": null,\n    \"save_errors\": null,\n    \"ignore_albums\": null,\n    \"proxy\": null,\n    \"skip_explicit\": false,\n    \"log_format\": null,\n    \"redownload\": false,\n    \"skip_album_art\": false,\n    \"create_skip_file\": false,\n    \"respect_skip_file\": false,\n    \"web_use_output_dir\": false,\n    \"port\": 8800,\n    \"host\": \"localhost\",\n    \"keep_alive\": false,\n    \"enable_tls\": false,\n    \"key_file\": null,\n    \"cert_file\": null,\n    \"ca_file\": null,\n    \"allowed_origins\": null,\n    \"keep_sessions\": false,\n    \"force_update_gui\": false,\n    \"web_gui_repo\": null,\n    \"web_gui_location\": null\n}\n</code></pre>"},{"location":"usage/#output-variables","title":"<code>output</code> variables","text":"<p>The <code>output</code> key supports several variables:</p> Variable Explanation Example <code>{title}</code> Song title Dark Horse <code>{artists}</code> Song artists Katy Perry, Juicy J <code>{artist}</code> Primary artist Katy Perry <code>{album}</code> Album name PRISM <code>{album-artist}</code> Primary artist of the album Katy Perry <code>{genre}</code> Genre dance pop <code>{disc-number}</code> Useful for multi-disc releases 1 <code>{disc-count}</code> Total number of discs in the album 1 <code>{duration}</code> Duration of the song in seconds 215.672 <code>{year}</code> Year of release 2013 <code>{original-date}</code> Date of original release 2013-01-01 <code>{track-number}</code> Track number in the album 06 <code>{tracks-count}</code> Total number of tracks in the album 13 <code>{isrc}</code> International Standard Recording Code USUM71311296 <code>{track-id}</code> Spotify song ID 4jbmgIyjGoXjY01XxatOx6 <code>{publisher}</code> Record label Capitol Records (CAP) <code>{list-length}</code> Number of items in a playlist 10 <code>{list-position}</code> Position of the song in a playlist 1 <code>{list-name}</code> Name of the playlist Saved <code>{output-ext}</code> File extension mp3"},{"location":"usage/#cli-command-line-interface","title":"CLI (Command Line Interface)","text":""},{"location":"usage/#command-line-options","title":"Command line options","text":"<pre><code>options:\n  -h, --help            show this help message and exit\n\nMain options:\n  {download,save,web,sync,meta,url}\n                        The operation to perform.\n                        download: Download the songs to the disk and embed metadata.\n                        save: Saves the songs metadata to a file for further use.\n                        web: Starts a web interface to simplify the download process.\n                        sync: Removes songs that are no longer present, downloads new ones\n                        meta: Update your audio files with metadata\n                        url: Get the download URL for songs\n\n  query                 Spotify/YouTube URL for a song/playlist/album/artist/etc. to download.\n\n                        For album/playlist/artist searching, include 'album:', 'playlist:', 'artist:'\n                        (ie. 'album:the album name' you can mix these options to get more accurate results).\n\n                        To download liked songs use 'saved' as the query, to download all user playlists\n                        use 'all-user-playlists, to download playlists that the user has created\n                        use 'all-saved-playlists', to download all user liked playlists\n                        use 'all-user-followed-artists', to download all user saved albums use 'all-user-saved-albums'\n\n                        For manual audio matching, you can use the format 'YouTubeURL|SpotifyURL'\n                        You can only use album/playlist/tracks urls when downloading/matching youtube urls.\n                        When using youtube url without spotify url, you won't be able to use `--fetch-albums` option.\n\n  --audio [{youtube,youtube-music,slider-kz,soundcloud,bandcamp,piped} ...]\n                        The audio provider to use. You can provide more than one for fallback.\n  --lyrics [{genius,musixmatch,azlyrics,synced} ...]\n                        The lyrics provider to use. You can provide more than one for fallback. Synced lyrics might not work correctly with some music players. For such cases it's better\n                        to use `--generate-lrc` option.\n  --genius-access-token GENIUS_TOKEN\n                        Lets you choose your own Genius access token.\n  --config              Use the config file to download songs. It's located under C:\\Users\\user\\.spotdl\\config.json or ~/.spotdl/config.json under linux\n  --search-query SEARCH_QUERY\n                        The search query to use, available variables: {title}, {artists}, {artist}, {album}, {album-artist}, {genre}, {disc-number}, {disc-count}, {duration}, {year},\n                        {original-date}, {track-number}, {tracks-count}, {isrc}, {track-id}, {publisher}, {list-length}, {list-position}, {list-name}, {output-ext}\n  --dont-filter-results\n                        Disable filtering results.\n  --album-type {single,album}\n                        Type of the album to search for. (album, single)\n  --only-verified-results\n                        Use only verified results. (Not all providers support this)\n\nSpotify options:\n  --user-auth           Login to Spotify using OAuth.\n  --client-id CLIENT_ID\n                        The client id to use when logging in to Spotify.\n  --client-secret CLIENT_SECRET\n                        The client secret to use when logging in to Spotify.\n  --auth-token AUTH_TOKEN\n                        The authorization token to use directly to log in to Spotify.\n  --cache-path CACHE_PATH\n                        The path where spotipy cache file will be stored.\n  --no-cache            Disable caching (both requests and token).\n  --max-retries MAX_RETRIES\n                        The maximum number of retries to perform when getting metadata.\n  --headless            Run in headless mode.\n  --use-cache-file      Use the cache file to get metadata. It's located under C:\\Users\\user\\.spotdl\\.spotify_cache or ~/.spotdl/.spotify_cache under linux. It only caches tracks and\n                        gets updated whenever spotDL gets metadata from Spotify. (It may provide outdated metadata use with caution)\n\nFFmpeg options:\n  --ffmpeg FFMPEG       The ffmpeg executable to use.\n  --threads THREADS     The number of threads to use when downloading songs.\n  --bitrate {auto,disable,8k,16k,24k,32k,40k,48k,64k,80k,96k,112k,128k,160k,192k,224k,256k,320k,0,1,2,3,4,5,6,7,8,9}\n                        The constant/variable bitrate to use for the output file. Values from 0 to 9 are variable bitrates. Auto will use the bitrate of the original file. Disable will\n                        disable the bitrate option. (In case of m4a and opus files, auto and disable will skip the conversion)\n  --ffmpeg-args FFMPEG_ARGS\n                        Additional ffmpeg arguments passed as a string.\n\nOutput options:\n  --format {mp3,flac,ogg,opus,m4a,wav}\n                        The format to download the song in.\n  --save-file SAVE_FILE\n                        The file to save/load the songs data from/to. It has to end with .spotdl. If combined with the download operation, it will save the songs data to the file.\n                        Required for save/sync (use - to print to stdout when using save).\n  --preload             Preload the download url to speed up the download process.\n  --output OUTPUT       Specify the downloaded file name format, available variables: {title}, {artists}, {artist}, {album}, {album-artist}, {genre}, {disc-number}, {disc-count},\n                        {duration}, {year}, {original-date}, {track-number}, {tracks-count}, {isrc}, {track-id}, {publisher}, {list-length}, {list-position}, {list-name}, {output-ext}\n  --m3u [M3U]           Name of the m3u file to save the songs to. Defaults to {list[0]}.m3u8 If you want to generate a m3u for each list in the query use {list}, If you want to generate\n                        a m3u file based on the first list in the query use {list[0]}, (0 is the first list in the query, 1 is the second, etc. songs don't count towards the list number)\n  --cookie-file COOKIE_FILE\n                        Path to cookies file.\n  --overwrite {skip,metadata,force}\n                        How to handle existing/duplicate files. (When combined with --scan-for-songs force will remove all duplicates, and metadata will only apply metadata to the latest\n                        song and will remove the rest. )\n  --restrict [{strict,ascii,none}]\n                        Restrict filenames to a sanitized set of characters for better compatibility\n  --print-errors        Print errors (wrong songs, failed downloads etc) on exit, useful for long playlist\n  --save-errors SAVE_ERRORS\n                        Save errors (wrong songs, failed downloads etc) to a file\n  --sponsor-block       Use the sponsor block to download songs from yt/ytm.\n  --archive ARCHIVE     Specify the file name for an archive of already downloaded songs\n  --playlist-numbering  Sets each track in a playlist to have the playlist's name as its album, and album art as the playlist's icon\n  --playlist-retain-track-cover\n                        Sets each track in a playlist to have the playlist's name as its album, while retaining album art of each track\n  --scan-for-songs      Scan the output directory for existing files. This option should be combined with the --overwrite option to control how existing files are handled. (Output\n                        directory is the last directory that is not a template variable in the output template)\n  --fetch-albums        Fetch all albums from songs in query\n  --id3-separator ID3_SEPARATOR\n                        Change the separator used in the id3 tags. Only supported for mp3 files.\n  --ytm-data            Use ytm data instead of spotify data when downloading using ytm link.\n  --add-unavailable     Add unavailable songs to the m3u/archive files when downloading\n  --generate-lrc        Generate lrc files for downloaded songs. Requires `synced` provider to be present in the lyrics providers list.\n  --force-update-metadata\n                        Force update metadata for songs that already have metadata.\n  --sync-without-deleting\n                        Sync without deleting songs that are not in the query.\n  --max-filename-length MAX_FILENAME_LENGTH\n                        Max file name length. (This won't override the max file name length enforced by the OS)\n  --yt-dlp-args YT_DLP_ARGS\n                        Arguments to pass to yt-dlp\n  --detect-formats [{mp3,flac,ogg,opus,m4a,wav} ...]\n                        Detect already downloaded songs with file format different from the --format option (When combined with --m3u option, only first detected format will be added to\n                        m3u file)\n  --redownload          to redownload the local song in diffrent format using --format for meta operation\n  --skip-album-art      skip downloading album art for meta operation\n  --ignore-albums [IGNORE_ALBUMS ...]\n                        ignores the song of the given albums\n  --skip-explicit       Skip explicit songs\n  --proxy PROXY         Http(s) proxy server for download song. Example: http://host:port\n  --create-skip-file    Create skip file for successfully downloaded file\n  --respect-skip-file   If a file with the extension .skip exists, skip download\n  --sync-remove-lrc     Remove lrc files when using sync operation when downloading songs\n\nWeb options:\n  --host HOST           The host to use for the web server.\n  --port PORT           The port to run the web server on.\n  --keep-alive          Keep the web server alive even when no clients are connected.\n  --allowed-origins [ALLOWED_ORIGINS ...]\n                        The allowed origins for the web server.\n  --web-use-output-dir  Use the output directory instead of the session directory for downloads. (This might cause issues if you have multiple users using the web-ui at the same time)\n  --keep-sessions       Keep the session directory after the web server is closed.\n  --force-update-gui    Refresh the web server directory with a fresh git checkout\n  --web-gui-repo WEB_GUI_REPO\n                        Custom web gui repo to use for the web server. Example: /~https://github.com/spotdl/web-ui/tree/master/dist\n  --web-gui-location WEB_GUI_LOCATION\n                        Path to the web gui directory to use for the web server.\n  --enable-tls          Enable TLS on the web server.\n  --cert-file CERT_FILE\n                        File Path to the TLS Certificate (PEM format).\n  --key-file KEY_FILE   File Path to the TLS Private Key (PEM format).\n  --ca-file CA_FILE     File Path to the TLS Certificate Authority File (PEM format).\n\nMisc options:\n  --log-level {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,MATCH,DEBUG,NOTSET}\n                        Select log level.\n  --simple-tui          Use a simple tui.\n  --log-format LOG_FORMAT\n                        Custom logging format to use. More info: https://docs.python.org/3/library/logging.html#logrecord-attributes\n\nOther options:\n  --download-ffmpeg     Download ffmpeg to spotdl directory.\n  --generate-config     Generate a config file. This will overwrite current config if present.\n  --check-for-updates   Check for new version.\n  --profile             Run in profile mode. Useful for debugging.\n  --version, -v         Show the version number and exit.\n</code></pre>"},{"location":"reference/","title":"__init__","text":"<p>Init module for spotdl. This module contains the main entry point for spotdl. And Spotdl class</p>"},{"location":"reference/#spotdl.Spotdl","title":"<code>Spotdl(client_id, client_secret, user_auth=False, cache_path=None, no_cache=False, headless=False, downloader_settings=None, loop=None)</code>","text":"<p>Spotdl class, which simplifies the process of downloading songs from Spotify.</p> <pre><code>from spotdl import Spotdl\n\nspotdl = Spotdl(client_id='your-client-id', client_secret='your-client-secret')\n\nsongs = spotdl.search(['joji - test drive',\n    'https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT'])\n\nresults = spotdl.download_songs(songs)\nsong, path = spotdl.download(songs[0])\n</code></pre>"},{"location":"reference/#spotdl.Spotdl--arguments","title":"Arguments","text":"<ul> <li>client_id: Spotify client id</li> <li>client_secret: Spotify client secret</li> <li>user_auth: If true, user will be prompted to authenticate</li> <li>cache_path: Path to cache directory</li> <li>no_cache: If true, no cache will be used</li> <li>headless: If true, no browser will be opened</li> <li>downloader_settings: Settings for the downloader</li> <li>loop: Event loop to use</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def __init__(\n    self,\n    client_id: str,\n    client_secret: str,\n    user_auth: bool = False,\n    cache_path: Optional[str] = None,\n    no_cache: bool = False,\n    headless: bool = False,\n    downloader_settings: Optional[\n        Union[DownloaderOptionalOptions, DownloaderOptions]\n    ] = None,\n    loop: Optional[asyncio.AbstractEventLoop] = None,\n):\n    \"\"\"\n    Initialize the Spotdl class\n\n    ### Arguments\n    - client_id: Spotify client id\n    - client_secret: Spotify client secret\n    - user_auth: If true, user will be prompted to authenticate\n    - cache_path: Path to cache directory\n    - no_cache: If true, no cache will be used\n    - headless: If true, no browser will be opened\n    - downloader_settings: Settings for the downloader\n    - loop: Event loop to use\n    \"\"\"\n\n    if downloader_settings is None:\n        downloader_settings = {}\n\n    # Initialize spotify client\n    SpotifyClient.init(\n        client_id=client_id,\n        client_secret=client_secret,\n        user_auth=user_auth,\n        cache_path=cache_path,\n        no_cache=no_cache,\n        headless=headless,\n    )\n\n    # Initialize downloader\n    self.downloader = Downloader(\n        settings=downloader_settings,\n        loop=loop,\n    )\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.download","title":"<code>download(song)</code>","text":"<p>Download and convert song to the output format.</p>"},{"location":"reference/#spotdl.Spotdl.download--arguments","title":"Arguments","text":"<ul> <li>song: Song object</li> </ul>"},{"location":"reference/#spotdl.Spotdl.download--returns","title":"Returns","text":"<ul> <li>A tuple containing the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def download(self, song: Song) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Download and convert song to the output format.\n\n    ### Arguments\n    - song: Song object\n\n    ### Returns\n    - A tuple containing the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    return self.downloader.download_song(song)\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.download_songs","title":"<code>download_songs(songs)</code>","text":"<p>Download and convert songs to the output format.</p>"},{"location":"reference/#spotdl.Spotdl.download_songs--arguments","title":"Arguments","text":"<ul> <li>songs: List of Song objects</li> </ul>"},{"location":"reference/#spotdl.Spotdl.download_songs--returns","title":"Returns","text":"<ul> <li>A list of tuples containing the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def download_songs(self, songs: List[Song]) -&gt; List[Tuple[Song, Optional[Path]]]:\n    \"\"\"\n    Download and convert songs to the output format.\n\n    ### Arguments\n    - songs: List of Song objects\n\n    ### Returns\n    - A list of tuples containing the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    return self.downloader.download_multiple_songs(songs)\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.get_download_urls","title":"<code>get_download_urls(songs)</code>","text":"<p>Get the download urls for a list of songs.</p>"},{"location":"reference/#spotdl.Spotdl.get_download_urls--arguments","title":"Arguments","text":"<ul> <li>songs: List of Song objects</li> </ul>"},{"location":"reference/#spotdl.Spotdl.get_download_urls--returns","title":"Returns","text":"<ul> <li>A list of urls if successful.</li> </ul>"},{"location":"reference/#spotdl.Spotdl.get_download_urls--notes","title":"Notes","text":"<ul> <li>This function is multi-threaded.</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def get_download_urls(self, songs: List[Song]) -&gt; List[Optional[str]]:\n    \"\"\"\n    Get the download urls for a list of songs.\n\n    ### Arguments\n    - songs: List of Song objects\n\n    ### Returns\n    - A list of urls if successful.\n\n    ### Notes\n    - This function is multi-threaded.\n    \"\"\"\n\n    urls: List[Optional[str]] = []\n    with concurrent.futures.ThreadPoolExecutor(\n        max_workers=self.downloader.settings[\"threads\"]\n    ) as executor:\n        future_to_song = {\n            executor.submit(self.downloader.search, song): song for song in songs\n        }\n        for future in concurrent.futures.as_completed(future_to_song):\n            song = future_to_song[future]\n            try:\n                data = future.result()\n                urls.append(data)\n            except Exception as exc:\n                logger.error(\"%s generated an exception: %s\", song, exc)\n\n    return urls\n</code></pre>"},{"location":"reference/#spotdl.Spotdl.search","title":"<code>search(query)</code>","text":"<p>Search for songs.</p>"},{"location":"reference/#spotdl.Spotdl.search--arguments","title":"Arguments","text":"<ul> <li>query: List of search queries</li> </ul>"},{"location":"reference/#spotdl.Spotdl.search--returns","title":"Returns","text":"<ul> <li>A list of Song objects</li> </ul>"},{"location":"reference/#spotdl.Spotdl.search--notes","title":"Notes","text":"<ul> <li>query can be a list of song titles, urls, uris</li> </ul> Source code in <code>spotdl/__init__.py</code> <pre><code>def search(self, query: List[str]) -&gt; List[Song]:\n    \"\"\"\n    Search for songs.\n\n    ### Arguments\n    - query: List of search queries\n\n    ### Returns\n    - A list of Song objects\n\n    ### Notes\n    - query can be a list of song titles, urls, uris\n    \"\"\"\n\n    return parse_query(\n        query=query,\n        threads=self.downloader.settings[\"threads\"],\n        use_ytm_data=self.downloader.settings[\"ytm_data\"],\n        playlist_numbering=self.downloader.settings[\"playlist_numbering\"],\n        album_type=self.downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=self.downloader.settings[\n            \"playlist_retain_track_cover\"\n        ],\n    )\n</code></pre>"},{"location":"reference/#spotdl.console_entry_point","title":"<code>console_entry_point()</code>","text":"<p>Entry point for the console. With profile flag, it runs the code with cProfile.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def console_entry_point():\n    \"\"\"\n    Entry point for the console. With profile flag, it runs the code with cProfile.\n    \"\"\"\n\n    if \"--profile\" in sys.argv:\n        with cProfile.Profile() as profile:\n            entry_point()\n\n        stats = pstats.Stats(profile)\n        stats.sort_stats(pstats.SortKey.TIME)\n        stats.dump_stats(\"spotdl.profile\")\n    else:\n        entry_point()\n</code></pre>"},{"location":"reference/SUMMARY/","title":"SUMMARY","text":"<ul> <li>__init__</li> <li>providers<ul> <li>lyrics<ul> <li>synced</li> <li>musixmatch</li> <li>azlyrics</li> <li>base</li> <li>genius</li> </ul> </li> <li>audio<ul> <li>piped</li> <li>youtube</li> <li>soundcloud</li> <li>bandcamp</li> <li>ytmusic</li> <li>base</li> <li>sliderkz</li> </ul> </li> </ul> </li> <li>utils<ul> <li>spotify</li> <li>m3u</li> <li>metadata</li> <li>logging</li> <li>static</li> <li>matching</li> <li>search</li> <li>downloader</li> <li>archive</li> <li>lrc</li> <li>config</li> <li>arguments</li> <li>console</li> <li>github</li> <li>web</li> <li>ffmpeg</li> <li>formatter</li> </ul> </li> <li>types<ul> <li>options</li> <li>saved</li> <li>artist</li> <li>result</li> <li>playlist</li> <li>song</li> <li>album</li> </ul> </li> <li>download<ul> <li>downloader</li> <li>progress_handler</li> </ul> </li> <li>console<ul> <li>save</li> <li>url</li> <li>entry_point</li> <li>sync</li> <li>meta</li> <li>download</li> <li>web</li> </ul> </li> </ul>"},{"location":"reference/console/","title":"console","text":"<p>Console module, contains the console entry point and different subcommands.</p>"},{"location":"reference/console/#spotdl.console.console_entry_point","title":"<code>console_entry_point()</code>","text":"<p>Entry point for the console. With profile flag, it runs the code with cProfile.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def console_entry_point():\n    \"\"\"\n    Entry point for the console. With profile flag, it runs the code with cProfile.\n    \"\"\"\n\n    if \"--profile\" in sys.argv:\n        with cProfile.Profile() as profile:\n            entry_point()\n\n        stats = pstats.Stats(profile)\n        stats.sort_stats(pstats.SortKey.TIME)\n        stats.dump_stats(\"spotdl.profile\")\n    else:\n        entry_point()\n</code></pre>"},{"location":"reference/console/download/","title":"download","text":"<p>Download module for the console.</p>"},{"location":"reference/console/download/#spotdl.console.download.download","title":"<code>download(query, downloader)</code>","text":"<p>Find songs with the provided audio provider and save them to the disk.</p>"},{"location":"reference/console/download/#spotdl.console.download.download--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> </ul> Source code in <code>spotdl/console/download.py</code> <pre><code>def download(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Find songs with the provided audio provider and save them to the disk.\n\n    ### Arguments\n    - query: list of strings to search for.\n    \"\"\"\n\n    # Parse the query\n    songs = get_simple_songs(\n        query,\n        use_ytm_data=downloader.settings[\"ytm_data\"],\n        playlist_numbering=downloader.settings[\"playlist_numbering\"],\n        albums_to_ignore=downloader.settings[\"ignore_albums\"],\n        album_type=downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=downloader.settings[\"playlist_retain_track_cover\"],\n    )\n\n    # Download the songs\n    downloader.download_multiple_songs(songs)\n</code></pre>"},{"location":"reference/console/entry_point/","title":"entry_point","text":"<p>Module that holds the entry point for the console.</p>"},{"location":"reference/console/entry_point/#spotdl.console.entry_point.console_entry_point","title":"<code>console_entry_point()</code>","text":"<p>Entry point for the console. With profile flag, it runs the code with cProfile.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def console_entry_point():\n    \"\"\"\n    Entry point for the console. With profile flag, it runs the code with cProfile.\n    \"\"\"\n\n    if \"--profile\" in sys.argv:\n        with cProfile.Profile() as profile:\n            entry_point()\n\n        stats = pstats.Stats(profile)\n        stats.sort_stats(pstats.SortKey.TIME)\n        stats.dump_stats(\"spotdl.profile\")\n    else:\n        entry_point()\n</code></pre>"},{"location":"reference/console/entry_point/#spotdl.console.entry_point.entry_point","title":"<code>entry_point()</code>","text":"<p>Console entry point for spotdl. This is where the magic happens.</p> Source code in <code>spotdl/console/entry_point.py</code> <pre><code>def entry_point():\n    \"\"\"\n    Console entry point for spotdl. This is where the magic happens.\n    \"\"\"\n\n    # Create config file if it doesn't exist\n    generate_initial_config()\n\n    # Check if sys.argv contains an action\n    # If it does, we run the action and exit\n    try:\n        action_to_run = next(\n            action for action_name, action in ACTIONS.items() if action_name in sys.argv\n        )\n    except StopIteration:\n        action_to_run = None\n\n    if action_to_run:\n        action_to_run()\n        return None\n\n    # Parse the arguments\n    arguments = parse_arguments()\n\n    # Create settings dicts\n    spotify_settings, downloader_settings, web_settings = create_settings(arguments)\n\n    init_logging(downloader_settings[\"log_level\"], downloader_settings[\"log_format\"])\n\n    # If the application is frozen, we check for ffmpeg\n    # if it's not present download it create config file\n    if is_executable():\n        if is_ffmpeg_installed() is False:\n            download_ffmpeg()\n\n    # Check if ffmpeg is installed\n    if is_ffmpeg_installed(downloader_settings[\"ffmpeg\"]) is False:\n        raise FFmpegError(\n            \"FFmpeg is not installed. Please run `spotdl --download-ffmpeg` to install it, \"\n            \"or `spotdl --ffmpeg /path/to/ffmpeg` to specify the path to ffmpeg.\"\n        )\n\n    # Check if we are not blocked by ytm\n    if \"youtube-music\" in downloader_settings[\"audio_providers\"]:\n        if not check_ytmusic_connection():\n            raise DownloaderError(\n                \"You are blocked by YouTube Music. \"\n                \"Please use a VPN, change youtube-music to piped, or use other audio providers\"\n            )\n\n    # Initialize spotify client\n    SpotifyClient.init(**spotify_settings)\n    spotify_client = SpotifyClient()\n\n    # If the application is frozen start web ui\n    # or if the operation is `web`\n    if is_executable() or arguments.operation == \"web\":\n\n        # Default to the current directory when running a frozen application\n        if is_executable():\n            web_settings[\"web_use_output_dir\"] = True\n\n        # Start web ui\n        web(web_settings, downloader_settings)\n\n        return None\n\n    # Check if save file is present and if it's valid\n    if isinstance(downloader_settings[\"save_file\"], str) and (\n        not downloader_settings[\"save_file\"].endswith(\".spotdl\")\n        and not downloader_settings[\"save_file\"] == \"-\"\n    ):\n        raise DownloaderError(\"Save file has to end with .spotdl\")\n\n    # Check if the user is logged in\n    if (\n        arguments.query\n        and \"saved\" in arguments.query\n        and not spotify_settings[\"user_auth\"]\n    ):\n        raise SpotifyError(\n            \"You must be logged in to use the saved query. \"\n            \"Log in by adding the --user-auth flag\"\n        )\n\n    # Initialize the downloader\n    # for download, load and preload operations\n    downloader = Downloader(downloader_settings)\n\n    def graceful_exit(_signal, _frame):\n        if spotify_settings[\"use_cache_file\"]:\n            save_spotify_cache(spotify_client.cache)\n\n        downloader.progress_handler.close()\n        sys.exit(0)\n\n    signal.signal(signal.SIGINT, graceful_exit)\n    signal.signal(signal.SIGTERM, graceful_exit)\n\n    start_time = time.perf_counter()\n\n    try:\n        # Pick the operation to perform\n        # based on the name and run it!\n        OPERATIONS[arguments.operation](\n            query=arguments.query,\n            downloader=downloader,\n        )\n    except Exception as exc:\n        if downloader_settings[\"save_errors\"]:\n            with open(\n                downloader_settings[\"save_errors\"], \"a\", encoding=\"utf-8\"\n            ) as error_file:\n                error_file.write(\"\\n\".join([exc + \"\\n\" for exc in exc.args]))\n\n            logger.debug(\"Saved errors to %s\", downloader_settings[\"save_errors\"])\n\n        end_time = time.perf_counter()\n        logger.debug(\"Took %d seconds\", end_time - start_time)\n\n        downloader.progress_handler.close()\n        logger.exception(\"An error occurred\")\n\n        sys.exit(1)\n\n    end_time = time.perf_counter()\n    logger.debug(\"Took %d seconds\", end_time - start_time)\n\n    if spotify_settings[\"use_cache_file\"]:\n        save_spotify_cache(spotify_client.cache)\n\n    downloader.progress_handler.close()\n\n    return None\n</code></pre>"},{"location":"reference/console/meta/","title":"meta","text":"<p>Sync Lyrics module for the console</p>"},{"location":"reference/console/meta/#spotdl.console.meta.meta","title":"<code>meta(query, downloader)</code>","text":"<p>This function applies metadata to the selected songs based on the file name. If song already has metadata, missing metadata is added</p>"},{"location":"reference/console/meta/#spotdl.console.meta.meta--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> <li>downloader: Already initialized downloader instance.</li> </ul>"},{"location":"reference/console/meta/#spotdl.console.meta.meta--notes","title":"Notes","text":"<ul> <li>This function is multi-threaded.</li> </ul> Source code in <code>spotdl/console/meta.py</code> <pre><code>def meta(query: List[str], downloader: Downloader) -&gt; None:\n    \"\"\"\n    This function applies metadata to the selected songs\n    based on the file name.\n    If song already has metadata, missing metadata is added\n\n    ### Arguments\n    - query: list of strings to search for.\n    - downloader: Already initialized downloader instance.\n\n    ### Notes\n    - This function is multi-threaded.\n    \"\"\"\n\n    # Create a list of all songs from all paths in query\n    paths: List[Path] = []\n    for path in query:\n        test_path = Path(path)\n        if not test_path.exists():\n            logger.error(\"Path does not exist: %s\", path)\n            continue\n\n        if test_path.is_dir():\n            for out_format in FFMPEG_FORMATS:\n                paths.extend(test_path.glob(f\"*.{out_format}\"))\n        elif test_path.is_file():\n            if test_path.suffix.split(\".\")[-1] not in FFMPEG_FORMATS:\n                logger.error(\"File is not a supported audio format: %s\", path)\n                continue\n\n            paths.append(test_path)\n\n    def process_file(file: Path):\n        # metadata of the file, url is present in the file.\n        song_meta = get_file_metadata(file, downloader.settings[\"id3_separator\"])\n\n        # Check if song has metadata\n        # and if it has all the required fields\n        # if it has all of these fields, we can assume that the metadata is correct\n        if song_meta and not downloader.settings[\"force_update_metadata\"]:\n            if (\n                song_meta.get(\"artist\")\n                and song_meta.get(\"artists\")\n                and song_meta.get(\"name\")\n                and song_meta.get(\"lyrics\")\n                and song_meta.get(\"album_art\")\n            ):\n                logger.info(\"Song already has metadata: %s\", file.name)\n                if downloader.settings[\"generate_lrc\"]:\n                    lrc_file = file.with_suffix(\".lrc\")\n                    if lrc_file.exists():\n                        logger.info(\"Lrc file already exists for %s\", file.name)\n                        return None\n\n                    song = Song.from_missing_data(\n                        name=song_meta[\"name\"],\n                        artists=song_meta[\"artists\"],\n                        artist=song_meta[\"artist\"],\n                    )\n\n                    generate_lrc(song, file)\n                    if lrc_file.exists():\n                        logger.info(\"Saved lrc file for %s\", song.display_name)\n                    else:\n                        logger.info(\"Could not find lrc file for %s\", song.display_name)\n\n                return None\n\n        # Same as above\n        if (\n            not song_meta\n            or None\n            in [\n                song_meta.get(\"name\"),\n                song_meta.get(\"album_art\"),\n                song_meta.get(\"artist\"),\n                song_meta.get(\"artists\"),\n                song_meta.get(\"track_number\"),\n            ]\n            or downloader.settings[\"force_update_metadata\"]\n        ):\n            # Song does not have metadata, or it is missing some fields\n            # or we are forcing update of metadata\n            # so we search for it\n            logger.debug(\"Searching metadata for %s\", file.name)\n            search_results = get_search_results(file.stem)\n            if not search_results:\n                logger.error(\"Could not find metadata for %s\", file.name)\n                return None\n\n            song = search_results[0]\n        else:\n            # Song has metadata, so we use it to reinitialize the song object\n            # and fill in the missing metadata\n            try:\n                song = reinit_song(Song.from_missing_data(**song_meta))\n            except QueryError:\n                logger.error(\"Could not find metadata for %s\", file.name)\n                return None\n\n        # Check if the song has lyric\n        # if not use downloader to find lyrics\n        if song_meta is None or song_meta.get(\"lyrics\") is None:\n            logger.debug(\"Fetching lyrics for %s\", song.display_name)\n            song.lyrics = downloader.search_lyrics(song)\n            if song.lyrics:\n                logger.info(\"Found lyrics for song: %s\", song.display_name)\n        else:\n            song.lyrics = song_meta.get(\"lyrics\")\n\n        # Apply metadata to the song\n        embed_metadata(file, song, skip_album_art=downloader.settings[\"skip_album_art\"])\n\n        logger.info(\"Applied metadata to %s\", file.name)\n\n        if downloader.settings[\"generate_lrc\"]:\n            lrc_file = file.with_suffix(\".lrc\")\n            if lrc_file.exists():\n                logger.info(\"Lrc file already exists for %s\", file.name)\n                return None\n\n            generate_lrc(song, file)\n            if lrc_file.exists():\n                logger.info(\"Saved lrc file for %s\", song.display_name)\n            else:\n                logger.info(\"Could not find lrc file for %s\", song.display_name)\n        return None\n\n    async def pool_worker(file_path: Path) -&gt; None:\n        async with downloader.semaphore:\n            # The following function calls blocking code, which would block whole event loop.\n            # Therefore it has to be called in a separate thread via ThreadPoolExecutor. This\n            # is not a problem, since GIL is released for the I/O operations, so it shouldn't\n            # hurt performance.\n            await downloader.loop.run_in_executor(None, process_file, file_path)\n\n    tasks = [pool_worker(path) for path in paths]\n\n    # call all task asynchronously, and wait until all are finished\n    downloader.loop.run_until_complete(asyncio.gather(*tasks))\n\n    # to re-download the local songs\n    if downloader.settings[\"redownload\"]:\n        songs_url: List[str] = []\n        for file in paths:\n            meta_data = get_file_metadata(\n                Path(file), downloader.settings[\"id3_separator\"]\n            )\n            if meta_data and meta_data[\"url\"]:\n                songs_url.append(meta_data[\"url\"])\n\n        songs_list = parse_query(\n            query=songs_url,\n            threads=downloader.settings[\"threads\"],\n            use_ytm_data=downloader.settings[\"ytm_data\"],\n            playlist_numbering=downloader.settings[\"playlist_numbering\"],\n            album_type=downloader.settings[\"album_type\"],\n            playlist_retain_track_cover=downloader.settings[\n                \"playlist_retain_track_cover\"\n            ],\n        )\n\n        downloader.download_multiple_songs(songs_list)\n</code></pre>"},{"location":"reference/console/save/","title":"save","text":"<p>Save module for the console.</p>"},{"location":"reference/console/save/#spotdl.console.save.save","title":"<code>save(query, downloader)</code>","text":"<p>Save metadata from spotify to the disk.</p>"},{"location":"reference/console/save/#spotdl.console.save.save--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> <li>downloader: Already initialized downloader instance.</li> </ul>"},{"location":"reference/console/save/#spotdl.console.save.save--notes","title":"Notes","text":"<ul> <li>This function is multi-threaded.</li> </ul> Source code in <code>spotdl/console/save.py</code> <pre><code>def save(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Save metadata from spotify to the disk.\n\n    ### Arguments\n    - query: list of strings to search for.\n    - downloader: Already initialized downloader instance.\n\n    ### Notes\n    - This function is multi-threaded.\n    \"\"\"\n\n    save_path = downloader.settings[\"save_file\"]\n    m3u_file = downloader.settings[\"m3u\"]\n\n    to_stdout = save_path == \"-\"\n\n    if save_path is None and not to_stdout:\n        raise DownloaderError(\"Save file is not specified\")\n\n    # Parse the query\n    songs = parse_query(\n        query=query,\n        threads=downloader.settings[\"threads\"],\n        use_ytm_data=downloader.settings[\"ytm_data\"],\n        playlist_numbering=downloader.settings[\"playlist_numbering\"],\n        album_type=downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=downloader.settings[\"playlist_retain_track_cover\"],\n    )\n    save_data = [song.json for song in songs]\n\n    def process_song(song: Song):\n        download_url = None\n        if downloader.settings[\"preload\"]:\n            try:\n                download_url = downloader.search(song)\n                if download_url is None:\n                    logger.error(\"Could not find a match for %s\", song.display_name)\n                    return None\n\n                logger.info(\"Found url for %s: %s\", song.display_name, download_url)\n            except Exception as exception:\n                logger.error(\n                    \"%s generated an exception: %s\", song.display_name, exception\n                )\n                return None\n\n        lyrics = None\n        try:\n            lyrics = downloader.search_lyrics(song)\n            if lyrics is None:\n                logger.debug(\n                    \"No lyrics found for %s, lyrics providers: %s\",\n                    song.display_name,\n                    \", \".join(\n                        [lprovider.name for lprovider in downloader.lyrics_providers]\n                    ),\n                )\n        except Exception as exception:\n            logger.debug(\"Could not search for lyrics: %s\", exception)\n\n        return {**song.json, \"download_url\": download_url, \"lyrics\": lyrics}\n\n    async def pool_worker(song: Song):\n        async with downloader.semaphore:\n            # The following function calls blocking code, which would block whole event loop.\n            # Therefore it has to be called in a separate thread via ThreadPoolExecutor. This\n            # is not a problem, since GIL is released for the I/O operations, so it shouldn't\n            # hurt performance.\n            return await downloader.loop.run_in_executor(None, process_song, song)\n\n    tasks = [pool_worker(song) for song in songs]\n\n    # call all task asynchronously, and wait until all are finished\n    save_data = list(downloader.loop.run_until_complete(asyncio.gather(*tasks)))\n\n    if to_stdout:\n        # Print the songs to stdout\n        print(json.dumps(save_data, indent=4, ensure_ascii=False))\n    elif save_path:\n        # Save the songs to a file\n        with open(save_path, \"w\", encoding=\"utf-8\") as save_file:\n            json.dump(save_data, save_file, indent=4, ensure_ascii=False)\n\n    if m3u_file:\n        gen_m3u_files(\n            songs,\n            m3u_file,\n            downloader.settings[\"output\"],\n            downloader.settings[\"format\"],\n            downloader.settings[\"restrict\"],\n            False,\n        )\n\n    if not to_stdout:\n        logger.info(\n            \"Saved %s song%s to %s\",\n            len(save_data),\n            \"s\" if len(save_data) &gt; 1 else \"\",\n            save_path,\n        )\n</code></pre>"},{"location":"reference/console/sync/","title":"sync","text":"<p>Sync module for the console.</p>"},{"location":"reference/console/sync/#spotdl.console.sync.sync","title":"<code>sync(query, downloader)</code>","text":"<p>Sync function for the console. It will download the songs and remove the ones that are no longer present in the playlists/albums/etc</p>"},{"location":"reference/console/sync/#spotdl.console.sync.sync--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> <li>downloader: Already initialized downloader instance.</li> </ul> Source code in <code>spotdl/console/sync.py</code> <pre><code>def sync(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Sync function for the console.\n    It will download the songs and remove the ones that are no longer\n    present in the playlists/albums/etc\n\n\n    ### Arguments\n    - query: list of strings to search for.\n    - downloader: Already initialized downloader instance.\n    \"\"\"\n\n    save_path = downloader.settings[\"save_file\"]\n    downloader.settings[\"save_file\"] = None\n\n    m3u_file = downloader.settings[\"m3u\"]\n    downloader.settings[\"m3u\"] = None\n\n    # Query and save file\n    # Create initial sync file\n    if query and save_path:\n        if any(req for req in query if req.endswith(\".spotdl\")):\n            # If the query contains a .spotdl file, and we are about to create\n            # .spotdl file, raise an error.\n            raise ValueError(\n                \"Cannot create a sync file with a .spotdl file in the query.\"\n            )\n\n        # Parse the query\n        songs_list = parse_query(\n            query=query,\n            threads=downloader.settings[\"threads\"],\n            use_ytm_data=downloader.settings[\"ytm_data\"],\n            playlist_numbering=downloader.settings[\"playlist_numbering\"],\n            album_type=downloader.settings[\"album_type\"],\n            playlist_retain_track_cover=downloader.settings[\n                \"playlist_retain_track_cover\"\n            ],\n        )\n\n        # Create sync file\n        with open(save_path, \"w\", encoding=\"utf-8\") as save_file:\n            json.dump(\n                {\n                    \"type\": \"sync\",\n                    \"query\": query,\n                    \"songs\": [song.json for song in songs_list],\n                },\n                save_file,\n                indent=4,\n                ensure_ascii=False,\n            )\n\n        # Perform initial download\n        downloader.download_multiple_songs(songs_list)\n\n        # Create m3u file\n        if m3u_file:\n            gen_m3u_files(\n                songs_list,\n                m3u_file,\n                downloader.settings[\"output\"],\n                downloader.settings[\"format\"],\n                downloader.settings[\"restrict\"],\n                False,\n            )\n\n        return None\n\n    # If the query is a single file, download it\n    if (  # pylint: disable=R1702\n        len(query) == 1  # pylint: disable=R1702\n        and query[0].endswith(\".spotdl\")  # pylint: disable=R1702\n        and not save_path  # pylint: disable=R1702\n    ):\n        # Load the sync file\n        with open(query[0], \"r\", encoding=\"utf-8\") as sync_file:\n            sync_data = json.load(sync_file)\n\n        # Verify the sync file\n        if (\n            not isinstance(sync_data, dict)\n            or sync_data.get(\"type\") != \"sync\"\n            or sync_data.get(\"songs\") is None\n        ):\n            raise ValueError(\"Sync file is not a valid sync file.\")\n\n        # Parse the query\n        songs_playlist = parse_query(\n            query=sync_data[\"query\"],\n            threads=downloader.settings[\"threads\"],\n            use_ytm_data=downloader.settings[\"ytm_data\"],\n            playlist_numbering=downloader.settings[\"playlist_numbering\"],\n            album_type=downloader.settings[\"album_type\"],\n            playlist_retain_track_cover=downloader.settings[\n                \"playlist_retain_track_cover\"\n            ],\n        )\n\n        # Get the names and URLs of previously downloaded songs from the sync file\n        old_files = []\n        for entry in sync_data[\"songs\"]:\n            file_name = create_file_name(\n                Song.from_dict(entry),\n                downloader.settings[\"output\"],\n                downloader.settings[\"format\"],\n                downloader.settings[\"restrict\"],\n            )\n\n            old_files.append((file_name, entry[\"url\"]))\n\n        new_urls = [song.url for song in songs_playlist]\n\n        # Delete all song files whose URL is no longer part of the latest playlist\n        if not downloader.settings[\"sync_without_deleting\"]:\n            # Rename songs that have \"{list-length}\", \"{list-position}\", \"{list-name}\",\n            # in the output path so that we don't have to download them again,\n            # and to avoid mangling the directory structure.\n            to_rename: List[Tuple[Path, Path]] = []\n            to_delete = []\n            for path, url in old_files:\n                if url not in new_urls:\n                    to_delete.append(path)\n                else:\n                    new_song = songs_playlist[new_urls.index(url)]\n\n                    new_path = create_file_name(\n                        Song.from_dict(new_song.json),\n                        downloader.settings[\"output\"],\n                        downloader.settings[\"format\"],\n                        downloader.settings[\"restrict\"],\n                    )\n\n                    if path != new_path:\n                        to_rename.append((path, new_path))\n\n            # fix later Downloading duplicate songs in the same playlist\n            # will trigger a re-download of the song. To fix this we have to copy the song\n            # to the new location without removing the old one.\n            for old_path, new_path in to_rename:\n                if old_path.exists():\n                    logger.info(\"Renaming %s to %s\", f\"'{old_path}'\", f\"'{new_path}'\")\n                    if new_path.exists():\n                        old_path.unlink()\n                        continue\n\n                    try:\n                        old_path.rename(new_path)\n                    except (PermissionError, OSError) as exc:\n                        logger.debug(\n                            \"Could not rename temp file: %s, error: %s\", old_path, exc\n                        )\n                else:\n                    logger.debug(\"%s does not exist.\", old_path)\n\n                if downloader.settings[\"sync_remove_lrc\"]:\n                    lrc_file = old_path.with_suffix(\".lrc\")\n                    new_lrc_file = new_path.with_suffix(\".lrc\")\n                    if lrc_file.exists():\n                        logger.debug(\n                            \"Renaming lrc %s to %s\",\n                            f\"'{lrc_file}'\",\n                            f\"'{new_lrc_file}'\",\n                        )\n                        try:\n                            lrc_file.rename(new_lrc_file)\n                        except (PermissionError, OSError) as exc:\n                            logger.debug(\n                                \"Could not rename lrc file: %s, error: %s\",\n                                lrc_file,\n                                exc,\n                            )\n                    else:\n                        logger.debug(\"%s does not exist.\", lrc_file)\n\n            for file in to_delete:\n                if file.exists():\n                    logger.info(\"Deleting %s\", file)\n                    try:\n                        file.unlink()\n                    except (PermissionError, OSError) as exc:\n                        logger.debug(\n                            \"Could not remove temp file: %s, error: %s\", file, exc\n                        )\n                else:\n                    logger.debug(\"%s does not exist.\", file)\n\n                if downloader.settings[\"sync_remove_lrc\"]:\n                    lrc_file = file.with_suffix(\".lrc\")\n                    if lrc_file.exists():\n                        logger.debug(\"Deleting lrc %s\", lrc_file)\n                        try:\n                            lrc_file.unlink()\n                        except (PermissionError, OSError) as exc:\n                            logger.debug(\n                                \"Could not remove lrc file: %s, error: %s\",\n                                lrc_file,\n                                exc,\n                            )\n                    else:\n                        logger.debug(\"%s does not exist.\", lrc_file)\n\n            if len(to_delete) == 0:\n                logger.info(\"Nothing to delete...\")\n            else:\n                logger.info(\"%s old songs were deleted.\", len(to_delete))\n\n        if m3u_file:\n            gen_m3u_files(\n                songs_playlist,\n                m3u_file,\n                downloader.settings[\"output\"],\n                downloader.settings[\"format\"],\n                downloader.settings[\"restrict\"],\n                False,\n            )\n\n        # Write the new sync file\n        with open(query[0], \"w\", encoding=\"utf-8\") as save_file:\n            json.dump(\n                {\n                    \"type\": \"sync\",\n                    \"query\": sync_data[\"query\"],\n                    \"songs\": [song.json for song in songs_playlist],\n                },\n                save_file,\n                indent=4,\n                ensure_ascii=False,\n            )\n\n        downloader.download_multiple_songs(songs_playlist)\n\n        return None\n\n    raise ValueError(\n        \"Wrong combination of arguments. \"\n        \"Either provide a query and a save path. Or a single sync file in the query\"\n    )\n</code></pre>"},{"location":"reference/console/url/","title":"url","text":"<p>Url module for the console.</p>"},{"location":"reference/console/url/#spotdl.console.url.url","title":"<code>url(query, downloader)</code>","text":"<p>Print download url for the provided songs.</p>"},{"location":"reference/console/url/#spotdl.console.url.url--arguments","title":"Arguments","text":"<ul> <li>query: list of strings to search for.</li> </ul> Source code in <code>spotdl/console/url.py</code> <pre><code>def url(\n    query: List[str],\n    downloader: Downloader,\n) -&gt; None:\n    \"\"\"\n    Print download url for the provided songs.\n\n    ### Arguments\n    - query: list of strings to search for.\n    \"\"\"\n\n    # Parse the query\n    songs = parse_query(\n        query=query,\n        threads=downloader.settings[\"threads\"],\n        use_ytm_data=downloader.settings[\"ytm_data\"],\n        playlist_numbering=downloader.settings[\"playlist_numbering\"],\n        album_type=downloader.settings[\"album_type\"],\n        playlist_retain_track_cover=downloader.settings[\"playlist_retain_track_cover\"],\n    )\n\n    def process_song(song: Song):\n        try:\n            data = downloader.search(song)\n            if data is None:\n                logger.error(\"Could not find a match for %s\", song.display_name)\n\n                return None\n\n            audio_provider = downloader.audio_providers[0]\n            download_url = audio_provider.get_download_metadata(data)[\"url\"]\n\n            print(download_url)\n        except Exception as exception:\n            logger.error(\"%s generated an exception: %s\", song.display_name, exception)\n\n        return None\n\n    async def pool_worker(song: Song):\n        async with downloader.semaphore:\n            # The following function calls blocking code, which would block whole event loop.\n            # Therefore it has to be called in a separate thread via ThreadPoolExecutor. This\n            # is not a problem, since GIL is released for the I/O operations, so it shouldn't\n            # hurt performance.\n            return await downloader.loop.run_in_executor(None, process_song, song)\n\n    tasks = [pool_worker(song) for song in songs]\n    downloader.loop.run_until_complete(asyncio.gather(*tasks))\n</code></pre>"},{"location":"reference/console/web/","title":"web","text":"<p>Web module for the console.</p>"},{"location":"reference/console/web/#spotdl.console.web.web","title":"<code>web(web_settings, downloader_settings)</code>","text":"<p>Run the web server.</p>"},{"location":"reference/console/web/#spotdl.console.web.web--arguments","title":"Arguments","text":"<ul> <li>web_settings: Web server settings.</li> <li>downloader_settings: Downloader settings.</li> </ul> Source code in <code>spotdl/console/web.py</code> <pre><code>def web(web_settings: WebOptions, downloader_settings: DownloaderOptions):\n    \"\"\"\n    Run the web server.\n\n    ### Arguments\n    - web_settings: Web server settings.\n    - downloader_settings: Downloader settings.\n    \"\"\"\n\n    # Apply the fix for mime types\n    fix_mime_types()\n\n    # Set up the app loggers\n    uvicorn_logger = logging.getLogger(\"uvicorn\")\n    uvicorn_logger.propagate = False\n\n    spotipy_logger = logging.getLogger(\"spotipy\")\n    spotipy_logger.setLevel(logging.NOTSET)\n\n    # Initialize the web server settings\n    app_state.web_settings = web_settings\n    app_state.logger = uvicorn_logger\n\n    # Create the event loop\n    app_state.loop = (\n        asyncio.new_event_loop()\n        if sys.platform != \"win32\"\n        else asyncio.ProactorEventLoop()  # type: ignore\n    )\n\n    downloader_settings[\"simple_tui\"] = True\n\n    # Download web app from GitHub if not already downloaded or force flag set\n    web_app_dir = get_web_ui_path()\n    dist_dir = web_app_dir / \"dist\"\n    if (not dist_dir.exists() or web_settings[\"force_update_gui\"]) and web_settings[\n        \"web_gui_location\"\n    ] is None:\n        if web_settings[\"web_gui_repo\"] is None:\n            gui_repo = \"/~https://github.com/spotdl/web-ui/tree/master/dist\"\n        else:\n            gui_repo = web_settings[\"web_gui_repo\"]\n\n        logger.info(\"Updating web app from %s\", gui_repo)\n\n        download_github_dir(\n            gui_repo,\n            output_dir=str(web_app_dir),\n        )\n        web_app_dir = Path(os.path.join(web_app_dir, \"dist\")).resolve()\n    elif web_settings[\"web_gui_location\"]:\n        web_app_dir = Path(web_settings[\"web_gui_location\"]).resolve()\n        logger.info(\"Using custom web app location: %s\", web_app_dir)\n    else:\n        logger.info(\n            \"Using cached web app. To update use the `--force-update-gui` flag.\"\n        )\n        web_app_dir = Path(os.path.join(web_app_dir, \"dist\")).resolve()\n\n    app_state.api = FastAPI(\n        title=\"spotDL\",\n        description=\"Download music from Spotify\",\n        version=__version__,\n        dependencies=[Depends(get_current_state)],\n    )\n\n    app_state.api.include_router(router)\n\n    # Add the CORS middleware\n    app_state.api.add_middleware(\n        CORSMiddleware,\n        allow_origins=(\n            ALLOWED_ORIGINS + web_settings[\"allowed_origins\"]\n            if web_settings[\"allowed_origins\"]\n            else ALLOWED_ORIGINS\n        ),\n        allow_credentials=True,\n        allow_methods=[\"*\"],\n        allow_headers=[\"*\"],\n    )\n\n    # Add the static files\n    app_state.api.mount(\n        \"/\",\n        SPAStaticFiles(directory=web_app_dir, html=True),\n        name=\"static\",\n    )\n    protocol = \"http\"\n    config = Config(\n        app=app_state.api,\n        host=web_settings[\"host\"],\n        port=web_settings[\"port\"],\n        workers=1,\n        log_level=NAME_TO_LEVEL[downloader_settings[\"log_level\"]],\n        loop=app_state.loop,  # type: ignore\n    )\n    if web_settings[\"enable_tls\"]:\n        logger.info(\"Enabeling TLS\")\n        protocol = \"https\"\n        config.ssl_certfile = web_settings[\"cert_file\"]\n        config.ssl_keyfile = web_settings[\"key_file\"]\n        config.ssl_ca_certs = web_settings[\"ca_file\"]\n\n    app_state.server = Server(config)\n\n    app_state.downloader_settings = downloader_settings\n\n    # Open the web browser\n    webbrowser.open(f\"{protocol}://{web_settings['host']}:{web_settings['port']}/\")\n\n    if not web_settings[\"web_use_output_dir\"]:\n        logger.info(\n            \"Files are stored in temporary directory \"\n            \"and will be deleted after the program exits \"\n            \"to save them to current directory permanently \"\n            \"enable the `web_use_output_dir` option \"\n        )\n    else:\n        logger.info(\n            \"Files are stored in current directory \"\n            \"to save them to temporary directory \"\n            \"disable the `web_use_output_dir` option \"\n        )\n\n    logger.info(\"Starting web server \\n\")\n\n    # Start the web server\n    app_state.loop.run_until_complete(app_state.server.serve())\n</code></pre>"},{"location":"reference/download/","title":"download","text":"<p>Download module that holds the downloader and progress handler modules.</p>"},{"location":"reference/download/downloader/","title":"downloader","text":"<p>Downloader module, this is where all the downloading pre/post processing happens etc.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader","title":"<code>Downloader(settings=None, loop=None)</code>","text":"<p>Downloader class, this is where all the downloading pre/post processing happens etc. It handles the downloading/moving songs, multithreading, metadata embedding etc.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader--arguments","title":"Arguments","text":"<ul> <li>settings: The settings to use.</li> <li>loop: The event loop to use.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader--notes","title":"Notes","text":"<ul> <li><code>search-query</code> uses the same format as <code>output</code>.</li> <li>if <code>audio_provider</code> or <code>lyrics_provider</code> is a list, then if no match is found,     the next provider in the list will be used.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def __init__(\n    self,\n    settings: Optional[Union[DownloaderOptionalOptions, DownloaderOptions]] = None,\n    loop: Optional[asyncio.AbstractEventLoop] = None,\n):\n    \"\"\"\n    Initialize the Downloader class.\n\n    ### Arguments\n    - settings: The settings to use.\n    - loop: The event loop to use.\n\n    ### Notes\n    - `search-query` uses the same format as `output`.\n    - if `audio_provider` or `lyrics_provider` is a list, then if no match is found,\n        the next provider in the list will be used.\n    \"\"\"\n\n    if settings is None:\n        settings = {}\n\n    # Create settings dictionary, fill in missing values with defaults\n    # from spotdl.types.options.DOWNLOADER_OPTIONS\n    self.settings: DownloaderOptions = DownloaderOptions(\n        **create_settings_type(\n            Namespace(config=False), dict(settings), DOWNLOADER_OPTIONS\n        )  # type: ignore\n    )\n\n    # Handle deprecated values in config file\n    modernize_settings(self.settings)\n    logger.debug(\"Downloader settings: %s\", self.settings)\n\n    # If no audio providers specified, raise an error\n    if len(self.settings[\"audio_providers\"]) == 0:\n        raise DownloaderError(\n            \"No audio providers specified. Please specify at least one.\"\n        )\n\n    # If ffmpeg is the default value and it's not installed\n    # try to use the spotdl's ffmpeg\n    self.ffmpeg = self.settings[\"ffmpeg\"]\n    if self.ffmpeg == \"ffmpeg\" and shutil.which(\"ffmpeg\") is None:\n        ffmpeg_exec = get_ffmpeg_path()\n        if ffmpeg_exec is None:\n            raise DownloaderError(\"ffmpeg is not installed\")\n\n        self.ffmpeg = str(ffmpeg_exec.absolute())\n\n    logger.debug(\"FFmpeg path: %s\", self.ffmpeg)\n\n    self.loop = loop or (\n        asyncio.new_event_loop()\n        if sys.platform != \"win32\"\n        else asyncio.ProactorEventLoop()  # type: ignore\n    )\n\n    if loop is None:\n        asyncio.set_event_loop(self.loop)\n\n    # semaphore is required to limit concurrent asyncio executions\n    self.semaphore = asyncio.Semaphore(self.settings[\"threads\"])\n\n    self.progress_handler = ProgressHandler(self.settings[\"simple_tui\"])\n\n    # Gather already present songs\n    self.scan_formats = self.settings[\"detect_formats\"] or [self.settings[\"format\"]]\n    self.known_songs: Dict[str, List[Path]] = {}\n    if self.settings[\"scan_for_songs\"]:\n        logger.info(\"Scanning for known songs, this might take a while...\")\n        for scan_format in self.scan_formats:\n            logger.debug(\"Scanning for %s files\", scan_format)\n\n            found_files = gather_known_songs(self.settings[\"output\"], scan_format)\n\n            logger.debug(\"Found %s %s files\", len(found_files), scan_format)\n\n            for song_url, song_paths in found_files.items():\n                known_paths = self.known_songs.get(song_url)\n                if known_paths is None:\n                    self.known_songs[song_url] = song_paths\n                else:\n                    self.known_songs[song_url].extend(song_paths)\n\n    logger.debug(\"Found %s known songs\", len(self.known_songs))\n\n    # Initialize lyrics providers\n    self.lyrics_providers: List[LyricsProvider] = []\n    for lyrics_provider in self.settings[\"lyrics_providers\"]:\n        lyrics_class = LYRICS_PROVIDERS.get(lyrics_provider)\n        if lyrics_class is None:\n            raise DownloaderError(f\"Invalid lyrics provider: {lyrics_provider}\")\n        if lyrics_provider == \"genius\":\n            access_token = self.settings.get(\"genius_token\")\n            if not access_token:\n                raise DownloaderError(\"Genius token not found in settings\")\n            self.lyrics_providers.append(Genius(access_token))\n        else:\n            self.lyrics_providers.append(lyrics_class())\n\n    # Initialize audio providers\n    self.audio_providers: List[AudioProvider] = []\n    for audio_provider in self.settings[\"audio_providers\"]:\n        audio_class = AUDIO_PROVIDERS.get(audio_provider)\n        if audio_class is None:\n            raise DownloaderError(f\"Invalid audio provider: {audio_provider}\")\n\n        self.audio_providers.append(\n            audio_class(\n                output_format=self.settings[\"format\"],\n                cookie_file=self.settings[\"cookie_file\"],\n                search_query=self.settings[\"search_query\"],\n                filter_results=self.settings[\"filter_results\"],\n                yt_dlp_args=self.settings[\"yt_dlp_args\"],\n            )\n        )\n\n    # Initialize list of errors\n    self.errors: List[str] = []\n\n    # Initialize proxy server\n    proxy = self.settings[\"proxy\"]\n    proxies = None\n    if proxy:\n        if not re.match(\n            pattern=r\"^(http|https):\\/\\/(?:(\\w+)(?::(\\w+))?@)?((?:\\d{1,3})(?:\\.\\d{1,3}){3})(?::(\\d{1,5}))?$\",  # pylint: disable=C0301\n            string=proxy,\n        ):\n            raise DownloaderError(f\"Invalid proxy server: {proxy}\")\n        proxies = {\"http\": proxy, \"https\": proxy}\n        logger.info(\"Setting proxy server: %s\", proxy)\n\n    GlobalConfig.set_parameter(\"proxies\", proxies)\n\n    # Initialize archive\n    self.url_archive = Archive()\n    if self.settings[\"archive\"]:\n        self.url_archive.load(self.settings[\"archive\"])\n\n    logger.debug(\"Archive: %d urls\", len(self.url_archive))\n\n    logger.debug(\"Downloader initialized\")\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_multiple_songs","title":"<code>download_multiple_songs(songs)</code>","text":"<p>Download multiple songs to the temp directory.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_multiple_songs--arguments","title":"Arguments","text":"<ul> <li>songs: The songs to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_multiple_songs--returns","title":"Returns","text":"<ul> <li>list of tuples with the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def download_multiple_songs(\n    self, songs: List[Song]\n) -&gt; List[Tuple[Song, Optional[Path]]]:\n    \"\"\"\n    Download multiple songs to the temp directory.\n\n    ### Arguments\n    - songs: The songs to download.\n\n    ### Returns\n    - list of tuples with the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    if self.settings[\"fetch_albums\"]:\n        albums = set(song.album_id for song in songs if song.album_id is not None)\n        logger.info(\n            \"Fetching %d album%s\", len(albums), \"s\" if len(albums) &gt; 1 else \"\"\n        )\n\n        songs.extend(songs_from_albums(list(albums)))\n\n        # Remove duplicates\n        return_obj = {}\n        for song in songs:\n            return_obj[song.url] = song\n\n        songs = list(return_obj.values())\n\n    logger.debug(\"Downloading %d songs\", len(songs))\n\n    if self.settings[\"archive\"]:\n        songs = [song for song in songs if song.url not in self.url_archive]\n        logger.debug(\"Filtered %d songs with archive\", len(songs))\n\n    self.progress_handler.set_song_count(len(songs))\n\n    # Create tasks list\n    tasks = [self.pool_download(song) for song in songs]\n\n    # Call all task asynchronously, and wait until all are finished\n    results = list(self.loop.run_until_complete(asyncio.gather(*tasks)))\n\n    # Print errors\n    if self.settings[\"print_errors\"]:\n        for error in self.errors:\n            logger.error(error)\n\n    if self.settings[\"save_errors\"]:\n        with open(\n            self.settings[\"save_errors\"], \"a\", encoding=\"utf-8\"\n        ) as error_file:\n            if len(self.errors) &gt; 0:\n                error_file.write(\n                    f\"{datetime.datetime.now().strftime('%Y-%m-%d-%H-%M-%S')}\\n\"\n                )\n            for error in self.errors:\n                error_file.write(f\"{error}\\n\")\n\n        logger.info(\"Saved errors to %s\", self.settings[\"save_errors\"])\n\n    # Save archive\n    if self.settings[\"archive\"]:\n        for result in results:\n            if result[1] or self.settings[\"add_unavailable\"]:\n                self.url_archive.add(result[0].url)\n\n        self.url_archive.save(self.settings[\"archive\"])\n        logger.info(\n            \"Saved archive with %d urls to %s\",\n            len(self.url_archive),\n            self.settings[\"archive\"],\n        )\n\n    # Create m3u playlist\n    if self.settings[\"m3u\"]:\n        song_list = [\n            song\n            for song, path in results\n            if path or self.settings[\"add_unavailable\"]\n        ]\n\n        gen_m3u_files(\n            song_list,\n            self.settings[\"m3u\"],\n            self.settings[\"output\"],\n            self.settings[\"format\"],\n            self.settings[\"restrict\"],\n            False,\n            self.settings[\"detect_formats\"],\n        )\n\n    # Save results to a file\n    if self.settings[\"save_file\"]:\n        with open(self.settings[\"save_file\"], \"w\", encoding=\"utf-8\") as save_file:\n            json.dump([song.json for song, _ in results], save_file, indent=4)\n\n        logger.info(\"Saved results to %s\", self.settings[\"save_file\"])\n\n    return results\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_song","title":"<code>download_song(song)</code>","text":"<p>Download a single song.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_song--arguments","title":"Arguments","text":"<ul> <li>song: The song to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.download_song--returns","title":"Returns","text":"<ul> <li>tuple with the song and the path to the downloaded file if successful.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def download_song(self, song: Song) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Download a single song.\n\n    ### Arguments\n    - song: The song to download.\n\n    ### Returns\n    - tuple with the song and the path to the downloaded file if successful.\n    \"\"\"\n\n    self.progress_handler.set_song_count(1)\n\n    results = self.download_multiple_songs([song])\n\n    return results[0]\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download","title":"<code>pool_download(song)</code>  <code>async</code>","text":"<p>Run asynchronous task in a pool to make sure that all processes.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download--arguments","title":"Arguments","text":"<ul> <li>song: The song to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download--returns","title":"Returns","text":"<ul> <li>tuple with the song and the path to the downloaded file if successful.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.pool_download--notes","title":"Notes","text":"<ul> <li>This method calls <code>self.search_and_download</code> in a new thread.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>async def pool_download(self, song: Song) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Run asynchronous task in a pool to make sure that all processes.\n\n    ### Arguments\n    - song: The song to download.\n\n    ### Returns\n    - tuple with the song and the path to the downloaded file if successful.\n\n    ### Notes\n    - This method calls `self.search_and_download` in a new thread.\n    \"\"\"\n\n    # tasks that cannot acquire semaphore will wait here until it's free\n    # only certain amount of tasks can acquire the semaphore at the same time\n    async with self.semaphore:\n        return await self.loop.run_in_executor(None, self.search_and_download, song)\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search","title":"<code>search(song)</code>","text":"<p>Search for a song using all available providers.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search--returns","title":"Returns","text":"<ul> <li>tuple with download url and audio provider if successful.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def search(self, song: Song) -&gt; str:\n    \"\"\"\n    Search for a song using all available providers.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - tuple with download url and audio provider if successful.\n    \"\"\"\n\n    for audio_provider in self.audio_providers:\n        url = audio_provider.search(song, self.settings[\"only_verified_results\"])\n        if url:\n            return url\n\n        logger.debug(\"%s failed to find %s\", audio_provider.name, song.display_name)\n\n    raise LookupError(f\"No results found for song: {song.display_name}\")\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download","title":"<code>search_and_download(song)</code>","text":"<p>Search for the song and download it.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download--arguments","title":"Arguments","text":"<ul> <li>song: The song to download.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download--returns","title":"Returns","text":"<ul> <li>tuple with the song and the path to the downloaded file if successful.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_and_download--notes","title":"Notes","text":"<ul> <li>This function is synchronous.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def search_and_download(  # pylint: disable=R0911\n    self, song: Song\n) -&gt; Tuple[Song, Optional[Path]]:\n    \"\"\"\n    Search for the song and download it.\n\n    ### Arguments\n    - song: The song to download.\n\n    ### Returns\n    - tuple with the song and the path to the downloaded file if successful.\n\n    ### Notes\n    - This function is synchronous.\n    \"\"\"\n\n    # Check if song has name/artist and url/song_id\n    if not (song.name and (song.artists or song.artist)) and not (\n        song.url or song.song_id\n    ):\n        logger.error(\"Song is missing required fields: %s\", song.display_name)\n        self.errors.append(f\"Song is missing required fields: {song.display_name}\")\n\n        return song, None\n\n    reinitialized = False\n    try:\n        # Create the output file path\n        output_file = create_file_name(\n            song=song,\n            template=self.settings[\"output\"],\n            file_extension=self.settings[\"format\"],\n            restrict=self.settings[\"restrict\"],\n            file_name_length=self.settings[\"max_filename_length\"],\n        )\n\n    except Exception:\n        song = reinit_song(song)\n\n        output_file = create_file_name(\n            song=song,\n            template=self.settings[\"output\"],\n            file_extension=self.settings[\"format\"],\n            restrict=self.settings[\"restrict\"],\n            file_name_length=self.settings[\"max_filename_length\"],\n        )\n\n        reinitialized = True\n\n    if song.explicit is True and self.settings[\"skip_explicit\"] is True:\n        logger.info(\"Skipping explicit song: %s\", song.display_name)\n        return song, None\n\n    # Initialize the progress tracker\n    display_progress_tracker = self.progress_handler.get_new_tracker(song)\n\n    try:\n        # Create the temp folder path\n        temp_folder = get_temp_path()\n\n        # Check if there is an already existing song file, with the same spotify URL in its\n        # metadata, but saved under a different name. If so, save its path.\n        dup_song_paths: List[Path] = self.known_songs.get(song.url, [])\n\n        # Remove files from the list that have the same path as the output file\n        dup_song_paths = [\n            dup_song_path\n            for dup_song_path in dup_song_paths\n            if (dup_song_path.absolute() != output_file.absolute())\n            and dup_song_path.exists()\n        ]\n\n        # Checking if file already exists in all subfolders of output directory\n        file_exists = file_exists = output_file.exists() or dup_song_paths\n        if not self.settings[\"scan_for_songs\"]:\n            for file_extension in self.scan_formats:\n                ext_path = output_file.with_suffix(f\".{file_extension}\")\n                if ext_path.exists():\n                    dup_song_paths.append(ext_path)\n\n        if dup_song_paths:\n            logger.debug(\n                \"Found duplicate songs for %s at %s\",\n                song.display_name,\n                \", \".join(\n                    [f\"'{str(dup_song_path)}'\" for dup_song_path in dup_song_paths]\n                ),\n            )\n\n        # If the file already exists and we don't want to overwrite it,\n        # we can skip the download\n        if (  # pylint: disable=R1705\n            Path(str(output_file.absolute()) + \".skip\").exists()\n            and self.settings[\"respect_skip_file\"]\n        ):\n            logger.info(\n                \"Skipping %s (skip file found) %s\",\n                song.display_name,\n                \"\",\n            )\n\n            return song, output_file if output_file.exists() else None\n\n        elif file_exists and self.settings[\"overwrite\"] == \"skip\":\n            logger.info(\n                \"Skipping %s (file already exists) %s\",\n                song.display_name,\n                \"(duplicate)\" if dup_song_paths else \"\",\n            )\n\n            display_progress_tracker.notify_download_skip()\n            return song, output_file\n\n        # Check if we have all the metadata\n        # and that the song object is not a placeholder\n        # If it's None extract the current metadata\n        # And reinitialize the song object\n        # Force song reinitialization if we are fetching albums\n        # they have most metadata but not all\n        if (\n            (song.name is None and song.url)\n            or (self.settings[\"fetch_albums\"] and reinitialized is False)\n            or None\n            in [\n                song.genres,\n                song.disc_count,\n                song.tracks_count,\n                song.track_number,\n                song.album_id,\n                song.album_artist,\n            ]\n        ):\n            song = reinit_song(song)\n            reinitialized = True\n\n        # Don't skip if the file exists and overwrite is set to force\n        if file_exists and self.settings[\"overwrite\"] == \"force\":\n            logger.info(\n                \"Overwriting %s %s\",\n                song.display_name,\n                \" (duplicate)\" if dup_song_paths else \"\",\n            )\n\n            # If the duplicate song path is not None, we can delete the old file\n            for dup_song_path in dup_song_paths:\n                try:\n                    logger.info(\"Removing duplicate file: %s\", dup_song_path)\n\n                    dup_song_path.unlink()\n                except (PermissionError, OSError, Exception) as exc:\n                    logger.debug(\n                        \"Could not remove duplicate file: %s, error: %s\",\n                        dup_song_path,\n                        exc,\n                    )\n\n        # Find song lyrics and add them to the song object\n        try:\n            lyrics = self.search_lyrics(song)\n            if lyrics is None:\n                logger.debug(\n                    \"No lyrics found for %s, lyrics providers: %s\",\n                    song.display_name,\n                    \", \".join(\n                        [lprovider.name for lprovider in self.lyrics_providers]\n                    ),\n                )\n            else:\n                song.lyrics = lyrics\n        except Exception as exc:\n            logger.debug(\"Could not search for lyrics: %s\", exc)\n\n        # If the file already exists and we want to overwrite the metadata,\n        # we can skip the download\n        if file_exists and self.settings[\"overwrite\"] == \"metadata\":\n            most_recent_duplicate: Optional[Path] = None\n            if dup_song_paths:\n                # Get the most recent duplicate song path and remove the rest\n                most_recent_duplicate = max(\n                    dup_song_paths,\n                    key=lambda dup_song_path: dup_song_path.stat().st_mtime\n                    and dup_song_path.suffix == output_file.suffix,\n                )\n\n                # Remove the rest of the duplicate song paths\n                for old_song_path in dup_song_paths:\n                    if most_recent_duplicate == old_song_path:\n                        continue\n\n                    try:\n                        logger.info(\"Removing duplicate file: %s\", old_song_path)\n                        old_song_path.unlink()\n                    except (PermissionError, OSError) as exc:\n                        logger.debug(\n                            \"Could not remove duplicate file: %s, error: %s\",\n                            old_song_path,\n                            exc,\n                        )\n\n                # Move the old file to the new location\n                if (\n                    most_recent_duplicate\n                    and most_recent_duplicate.suffix == output_file.suffix\n                ):\n                    most_recent_duplicate.replace(\n                        output_file.with_suffix(f\".{self.settings['format']}\")\n                    )\n\n            if (\n                most_recent_duplicate\n                and most_recent_duplicate.suffix != output_file.suffix\n            ):\n                logger.info(\n                    \"Could not move duplicate file: %s, different file extension\",\n                    most_recent_duplicate,\n                )\n\n                display_progress_tracker.notify_complete()\n\n                return song, None\n\n            # Update the metadata\n            embed_metadata(\n                output_file=output_file,\n                song=song,\n                skip_album_art=self.settings[\"skip_album_art\"],\n            )\n\n            logger.info(\n                f\"Updated metadata for {song.display_name}\"\n                f\", moved to new location: {output_file}\"\n                if most_recent_duplicate\n                else \"\"\n            )\n\n            display_progress_tracker.notify_complete()\n\n            return song, output_file\n\n        # Create the output directory if it doesn't exist\n        output_file.parent.mkdir(parents=True, exist_ok=True)\n        if song.download_url is None:\n            download_url = self.search(song)\n        else:\n            download_url = song.download_url\n\n        # Initialize audio downloader\n        audio_downloader: Union[AudioProvider, Piped]\n        if self.settings[\"audio_providers\"][0] == \"piped\":\n            audio_downloader = Piped(\n                output_format=self.settings[\"format\"],\n                cookie_file=self.settings[\"cookie_file\"],\n                search_query=self.settings[\"search_query\"],\n                filter_results=self.settings[\"filter_results\"],\n                yt_dlp_args=self.settings[\"yt_dlp_args\"],\n            )\n        else:\n            audio_downloader = AudioProvider(\n                output_format=self.settings[\"format\"],\n                cookie_file=self.settings[\"cookie_file\"],\n                search_query=self.settings[\"search_query\"],\n                filter_results=self.settings[\"filter_results\"],\n                yt_dlp_args=self.settings[\"yt_dlp_args\"],\n            )\n\n        logger.debug(\"Downloading %s using %s\", song.display_name, download_url)\n\n        # Add progress hook to the audio provider\n        audio_downloader.audio_handler.add_progress_hook(\n            display_progress_tracker.yt_dlp_progress_hook\n        )\n\n        download_info = audio_downloader.get_download_metadata(\n            download_url, download=True\n        )\n\n        temp_file = Path(\n            temp_folder / f\"{download_info['id']}.{download_info['ext']}\"\n        )\n\n        if download_info is None:\n            logger.debug(\n                \"No download info found for %s, url: %s\",\n                song.display_name,\n                download_url,\n            )\n\n            raise DownloaderError(\n                f\"yt-dlp failed to get metadata for: {song.name} - {song.artist}\"\n            )\n\n        display_progress_tracker.notify_download_complete()\n\n        # Copy the downloaded file to the output file\n        # if the temp file and output file have the same extension\n        # and the bitrate is set to auto or disable\n        # Don't copy if the audio provider is piped\n        # unless the bitrate is set to disable\n        if (\n            self.settings[\"bitrate\"] in [\"auto\", \"disable\", None]\n            and temp_file.suffix == output_file.suffix\n        ) and not (\n            self.settings[\"audio_providers\"][0] == \"piped\"\n            and self.settings[\"bitrate\"] != \"disable\"\n        ):\n            shutil.move(str(temp_file), output_file)\n            success = True\n            result = None\n        else:\n            if self.settings[\"bitrate\"] in [\"auto\", None]:\n                # Use the bitrate from the download info if it exists\n                # otherwise use `copy`\n                bitrate = (\n                    f\"{int(download_info['abr'])}k\"\n                    if download_info.get(\"abr\")\n                    else \"copy\"\n                )\n            elif self.settings[\"bitrate\"] == \"disable\":\n                bitrate = None\n            else:\n                bitrate = str(self.settings[\"bitrate\"])\n\n            # Convert the downloaded file to the output format\n            success, result = convert(\n                input_file=temp_file,\n                output_file=output_file,\n                ffmpeg=self.ffmpeg,\n                output_format=self.settings[\"format\"],\n                bitrate=bitrate,\n                ffmpeg_args=self.settings[\"ffmpeg_args\"],\n                progress_handler=display_progress_tracker.ffmpeg_progress_hook,\n            )\n\n            if self.settings[\"create_skip_file\"]:\n                with open(\n                    str(output_file) + \".skip\", mode=\"w\", encoding=\"utf-8\"\n                ) as _:\n                    pass\n\n        # Remove the temp file\n        if temp_file.exists():\n            try:\n                temp_file.unlink()\n            except (PermissionError, OSError) as exc:\n                logger.debug(\n                    \"Could not remove temp file: %s, error: %s\", temp_file, exc\n                )\n\n                raise DownloaderError(\n                    f\"Could not remove temp file: {temp_file}, possible duplicate song\"\n                ) from exc\n\n        if not success and result:\n            # If the conversion failed and there is an error message\n            # create a file with the error message\n            # and save it in the errors directory\n            # raise an exception with file path\n            file_name = (\n                get_errors_path()\n                / f\"ffmpeg_error_{datetime.datetime.now().strftime('%Y-%m-%d-%H-%M-%S')}.txt\"\n            )\n\n            error_message = \"\"\n            for key, value in result.items():\n                error_message += f\"### {key}:\\n{str(value).strip()}\\n\\n\"\n\n            with open(file_name, \"w\", encoding=\"utf-8\") as error_path:\n                error_path.write(error_message)\n\n            # Remove the file that failed to convert\n            if output_file.exists():\n                output_file.unlink()\n\n            raise FFmpegError(\n                f\"Failed to convert {song.display_name}, \"\n                f\"you can find error here: {str(file_name.absolute())}\"\n            )\n\n        download_info[\"filepath\"] = str(output_file)\n\n        # Set the song's download url\n        if song.download_url is None:\n            song.download_url = download_url\n\n        display_progress_tracker.notify_conversion_complete()\n\n        # SponsorBlock post processor\n        if self.settings[\"sponsor_block\"]:\n            # Initialize the sponsorblock post processor\n            post_processor = SponsorBlockPP(\n                audio_downloader.audio_handler, SPONSOR_BLOCK_CATEGORIES\n            )\n\n            # Run the post processor to get the sponsor segments\n            _, download_info = post_processor.run(download_info)\n            chapters = download_info[\"sponsorblock_chapters\"]\n\n            # If there are sponsor segments, remove them\n            if len(chapters) &gt; 0:\n                logger.info(\n                    \"Removing %s sponsor segments for %s\",\n                    len(chapters),\n                    song.display_name,\n                )\n\n                # Initialize the modify chapters post processor\n                modify_chapters = ModifyChaptersPP(\n                    downloader=audio_downloader.audio_handler,\n                    remove_sponsor_segments=SPONSOR_BLOCK_CATEGORIES,\n                )\n\n                # Run the post processor to remove the sponsor segments\n                # this returns a list of files to delete\n                files_to_delete, download_info = modify_chapters.run(download_info)\n\n                # Delete the files that were created by the post processor\n                for file_to_delete in files_to_delete:\n                    Path(file_to_delete).unlink()\n\n        try:\n            embed_metadata(\n                output_file,\n                song,\n                id3_separator=self.settings[\"id3_separator\"],\n                skip_album_art=self.settings[\"skip_album_art\"],\n            )\n        except Exception as exception:\n            raise MetadataError(\n                \"Failed to embed metadata to the song\"\n            ) from exception\n\n        if self.settings[\"generate_lrc\"]:\n            generate_lrc(song, output_file)\n\n        display_progress_tracker.notify_complete()\n\n        # Add the song to the known songs\n        self.known_songs.get(song.url, []).append(output_file)\n\n        logger.info('Downloaded \"%s\": %s', song.display_name, song.download_url)\n\n        return song, output_file\n    except (Exception, UnicodeEncodeError) as exception:\n        if isinstance(exception, UnicodeEncodeError):\n            exception_cause = exception\n            exception = DownloaderError(\n                \"You may need to add PYTHONIOENCODING=utf-8 to your environment\"\n            )\n\n            exception.__cause__ = exception_cause\n\n        display_progress_tracker.notify_error(\n            traceback.format_exc(), exception, True\n        )\n        self.errors.append(\n            f\"{song.url} - {exception.__class__.__name__}: {exception}\"\n        )\n        return song, None\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_lyrics","title":"<code>search_lyrics(song)</code>","text":"<p>Search for lyrics using all available providers.</p>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_lyrics--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/download/downloader/#spotdl.download.downloader.Downloader.search_lyrics--returns","title":"Returns","text":"<ul> <li>lyrics if successful else None.</li> </ul> Source code in <code>spotdl/download/downloader.py</code> <pre><code>def search_lyrics(self, song: Song) -&gt; Optional[str]:\n    \"\"\"\n    Search for lyrics using all available providers.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - lyrics if successful else None.\n    \"\"\"\n\n    for lyrics_provider in self.lyrics_providers:\n        lyrics = lyrics_provider.get_lyrics(song.name, song.artists)\n        if lyrics:\n            logger.debug(\n                \"Found lyrics for %s on %s\", song.display_name, lyrics_provider.name\n            )\n\n            return lyrics\n\n        logger.debug(\n            \"%s failed to find lyrics for %s\",\n            lyrics_provider.name,\n            song.display_name,\n        )\n\n    return None\n</code></pre>"},{"location":"reference/download/downloader/#spotdl.download.downloader.DownloaderError","title":"<code>DownloaderError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to downloaders.</p>"},{"location":"reference/download/progress_handler/","title":"progress_handler","text":"<p>Module that holds the ProgressHandler class and Song Tracker class.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler","title":"<code>ProgressHandler(simple_tui=False, update_callback=None, web_ui=False)</code>","text":"<p>Class for handling the progress of a download, including the progress bar.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler--arguments","title":"Arguments","text":"<ul> <li>simple_tui: Whether or not to use the simple TUI.</li> <li>update_callback: A callback to call when the progress bar is updated.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def __init__(\n    self,\n    simple_tui: bool = False,\n    update_callback: Optional[Callable[[Any, str], None]] = None,\n    web_ui: bool = False,\n):\n    \"\"\"\n    Initialize the progress handler.\n\n    ### Arguments\n    - simple_tui: Whether or not to use the simple TUI.\n    - update_callback: A callback to call when the progress bar is updated.\n    \"\"\"\n\n    self.songs: List[Song] = []\n    self.song_count: int = 0\n    self.overall_progress = 0\n    self.overall_total = 100\n    self.overall_completed_tasks = 0\n    self.update_callback = update_callback\n    self.previous_overall = self.overall_completed_tasks\n\n    self.simple_tui = simple_tui\n    self.web_ui = web_ui\n    self.quiet = logger.getEffectiveLevel() &lt; 10\n    self.overall_task_id: Optional[TaskID] = None\n\n    if not self.simple_tui:\n        console = get_console()\n\n        self.rich_progress_bar = Progress(\n            SizedTextColumn(\n                \"[white]{task.description}\",\n                overflow=\"ellipsis\",\n                width=int(console.width / 3),\n            ),\n            SizedTextColumn(\n                \"{task.fields[message]}\", width=18, style=\"nonimportant\"\n            ),\n            BarColumn(bar_width=None, finished_style=\"green\"),\n            \"[progress.percentage]{task.percentage:&gt;3.0f}%\",\n            TimeRemainingColumn(),\n            # Normally when you exit the progress context manager (or call stop())\n            # the last refreshed display remains in the terminal with the cursor on\n            # the following line. You can also make the progress display disappear on\n            # exit by setting transient=True on the Progress constructor\n            transient=True,\n        )\n\n        # Basically a wrapper for rich's: with ... as ...\n        self.rich_progress_bar.__enter__()\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.add_song","title":"<code>add_song(song)</code>","text":"<p>Adds a song to the list of songs.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.add_song--arguments","title":"Arguments","text":"<ul> <li>song: The song to add.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def add_song(self, song: Song) -&gt; None:\n    \"\"\"\n    Adds a song to the list of songs.\n\n    ### Arguments\n    - song: The song to add.\n    \"\"\"\n\n    self.songs.append(song)\n    self.set_song_count(len(self.songs))\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.close","title":"<code>close()</code>","text":"<p>Close the Tui Progress Handler.</p> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def close(self) -&gt; None:\n    \"\"\"\n    Close the Tui Progress Handler.\n    \"\"\"\n\n    if not self.simple_tui:\n        self.rich_progress_bar.stop()\n\n    logging.shutdown()\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.get_new_tracker","title":"<code>get_new_tracker(song)</code>","text":"<p>Get a new progress tracker.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--arguments","title":"Arguments","text":"<ul> <li>song: The song to track.</li> </ul>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.get_new_tracker--returns","title":"Returns","text":"<ul> <li>A new progress tracker.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def get_new_tracker(self, song: Song) -&gt; \"SongTracker\":\n    \"\"\"\n    Get a new progress tracker.\n\n    ### Arguments\n    - song: The song to track.\n\n    ### Returns\n    - A new progress tracker.\n    \"\"\"\n\n    return SongTracker(self, song)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_song_count","title":"<code>set_song_count(count)</code>","text":"<p>Set the number of songs to download.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_song_count--arguments","title":"Arguments","text":"<ul> <li>count: The number of songs to download.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def set_song_count(self, count: int) -&gt; None:\n    \"\"\"\n    Set the number of songs to download.\n\n    ### Arguments\n    - count: The number of songs to download.\n    \"\"\"\n\n    self.song_count = count\n    self.overall_total = 100 * count\n\n    if not self.simple_tui:\n        if self.song_count &gt; 4:\n            self.overall_task_id = self.rich_progress_bar.add_task(\n                description=\"Total\",\n                message=(\n                    f\"{self.overall_completed_tasks}/{int(self.overall_total / 100)} \"\n                    \"complete\"\n                ),\n                total=self.overall_total,\n                visible=(not self.quiet),\n            )\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_songs","title":"<code>set_songs(songs)</code>","text":"<p>Sets the list of songs to be downloaded.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.set_songs--arguments","title":"Arguments","text":"<ul> <li>songs: The list of songs to download.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def set_songs(self, songs: List[Song]) -&gt; None:\n    \"\"\"\n    Sets the list of songs to be downloaded.\n\n    ### Arguments\n    - songs: The list of songs to download.\n    \"\"\"\n\n    self.songs = songs\n    self.set_song_count(len(songs))\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandler.update_overall","title":"<code>update_overall()</code>","text":"<p>Update the overall progress bar.</p> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def update_overall(self) -&gt; None:\n    \"\"\"\n    Update the overall progress bar.\n    \"\"\"\n\n    if not self.simple_tui:\n        # If the overall progress bar exists\n        if self.overall_task_id is not None:\n            self.rich_progress_bar.update(\n                self.overall_task_id,\n                message=f\"{self.overall_completed_tasks}/\"\n                f\"{int(self.overall_total / 100)} \"\n                \"complete\",\n                completed=self.overall_progress,\n            )\n    else:\n        if self.previous_overall != self.overall_completed_tasks:\n            logger.info(\n                \"%s/%s complete\", self.overall_completed_tasks, self.song_count\n            )\n            self.previous_overall = self.overall_completed_tasks\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.ProgressHandlerError","title":"<code>ProgressHandlerError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions raised by ProgressHandler subclasses.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn","title":"<code>SizedTextColumn(text_format, style='none', justify='left', markup=True, highlighter=None, overflow=None, width=20)</code>","text":"<p>               Bases: <code>ProgressColumn</code></p> <p>Custom sized text column based on the Rich library.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn--arguments","title":"Arguments","text":"<ul> <li>text_format: The format string to use for the text.</li> <li>style: The style to use for the text.</li> <li>justify: The justification to use for the text.</li> <li>markup: Whether or not the text should be rendered as markup.</li> <li>highlighter: A Highlighter to use for highlighting the text.</li> <li>overflow: The overflow method to use for truncating the text.</li> <li>width: The maximum width of the text.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def __init__(\n    self,\n    text_format: str,\n    style: StyleType = \"none\",\n    justify: JustifyMethod = \"left\",\n    markup: bool = True,\n    highlighter: Optional[Highlighter] = None,\n    overflow: Optional[OverflowMethod] = None,\n    width: int = 20,\n) -&gt; None:\n    \"\"\"\n    A column containing text.\n\n    ### Arguments\n    - text_format: The format string to use for the text.\n    - style: The style to use for the text.\n    - justify: The justification to use for the text.\n    - markup: Whether or not the text should be rendered as markup.\n    - highlighter: A Highlighter to use for highlighting the text.\n    - overflow: The overflow method to use for truncating the text.\n    - width: The maximum width of the text.\n    \"\"\"\n\n    self.text_format = text_format\n    self.justify: JustifyMethod = justify\n    self.style = style\n    self.markup = markup\n    self.highlighter = highlighter\n    self.overflow: Optional[OverflowMethod] = overflow\n    self.width = width\n    super().__init__()\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn.render","title":"<code>render(task)</code>","text":"<p>Render the Column.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn.render--arguments","title":"Arguments","text":"<ul> <li>task: The Task to render.</li> </ul>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SizedTextColumn.render--returns","title":"Returns","text":"<ul> <li>A Text object.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def render(self, task: Task) -&gt; Text:\n    \"\"\"\n    Render the Column.\n\n    ### Arguments\n    - task: The Task to render.\n\n    ### Returns\n    - A Text object.\n    \"\"\"\n\n    _text = self.text_format.format(task=task)\n    if self.markup:\n        text = Text.from_markup(_text, style=self.style, justify=self.justify)\n    else:\n        text = Text(_text, style=self.style, justify=self.justify)\n    if self.highlighter:\n        self.highlighter.highlight(text)\n\n    text.truncate(max_width=self.width, overflow=self.overflow, pad=True)\n    return text\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker","title":"<code>SongTracker(parent, song)</code>","text":"<p>Class to track the progress of a song.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker--arguments","title":"Arguments","text":"<ul> <li>parent: The parent Tui Progress Handler.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def __init__(self, parent, song: Song) -&gt; None:\n    \"\"\"\n    Initialize the Tui Song Tracker.\n\n    ### Arguments\n    - parent: The parent Tui Progress Handler.\n    \"\"\"\n\n    self.parent: \"ProgressHandler\" = parent\n    self.song = song\n\n    # Clean up the song name\n    # from weird unicode characters\n    self.song_name = \"\".join(\n        char\n        for char in self.song.display_name\n        if char not in [chr(i) for i in BAD_CHARS]\n    )\n\n    self.progress: int = 0\n    self.old_progress: int = 0\n    self.status = \"\"\n\n    if not self.parent.simple_tui:\n        self.task_id = self.parent.rich_progress_bar.add_task(\n            description=escape(self.song_name),\n            message=\"Processing\",\n            total=100,\n            completed=self.progress,\n            start=False,\n            visible=(not self.parent.quiet),\n        )\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook","title":"<code>ffmpeg_progress_hook(progress)</code>","text":"<p>Updates the progress.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.ffmpeg_progress_hook--arguments","title":"Arguments","text":"<ul> <li>progress: The progress to update to.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def ffmpeg_progress_hook(self, progress: int) -&gt; None:\n    \"\"\"\n    Updates the progress.\n\n    ### Arguments\n    - progress: The progress to update to.\n    \"\"\"\n\n    if self.parent.simple_tui and not self.parent.web_ui:\n        self.progress = 50\n    else:\n        self.progress = 50 + int(progress * 0.45)\n\n    self.update(\"Converting\")\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_complete","title":"<code>notify_complete(status='Done')</code>","text":"<p>Notifies the progress handler that the song has been downloaded and converted.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_complete--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_complete(self, status=\"Done\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been downloaded and converted.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 100\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_conversion_complete","title":"<code>notify_conversion_complete(status='Embedding metadata')</code>","text":"<p>Notifies the progress handler that the song has been converted.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_conversion_complete--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_conversion_complete(self, status=\"Embedding metadata\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been converted.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 95\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_complete","title":"<code>notify_download_complete(status='Converting')</code>","text":"<p>Notifies the progress handler that the song has been downloaded.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_complete--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_download_complete(self, status=\"Converting\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been downloaded.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 50\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_skip","title":"<code>notify_download_skip(status='Skipped')</code>","text":"<p>Notifies the progress handler that the song has been skipped.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_download_skip--arguments","title":"Arguments","text":"<ul> <li>status: The status to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_download_skip(self, status=\"Skipped\") -&gt; None:\n    \"\"\"\n    Notifies the progress handler that the song has been skipped.\n\n    ### Arguments\n    - status: The status to display.\n    \"\"\"\n\n    self.progress = 100\n    self.update(status)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_error","title":"<code>notify_error(message, traceback, finish=False)</code>","text":"<p>Logs an error message.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.notify_error--arguments","title":"Arguments","text":"<ul> <li>message: The message to log.</li> <li>traceback: The traceback of the error.</li> <li>finish: Whether to finish the task.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def notify_error(\n    self, message: str, traceback: Exception, finish: bool = False\n) -&gt; None:\n    \"\"\"\n    Logs an error message.\n\n    ### Arguments\n    - message: The message to log.\n    - traceback: The traceback of the error.\n    - finish: Whether to finish the task.\n    \"\"\"\n\n    self.update(\"Error\")\n    if finish:\n        self.progress = 100\n\n    if logger.getEffectiveLevel() == logging.DEBUG:\n        logger.exception(message)\n    else:\n        logger.error(\"%s: %s\", traceback.__class__.__name__, traceback)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.update","title":"<code>update(message='')</code>","text":"<p>Called at every event.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.update--arguments","title":"Arguments","text":"<ul> <li>message: The message to display.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def update(self, message=\"\"):\n    \"\"\"\n    Called at every event.\n\n    ### Arguments\n    - message: The message to display.\n    \"\"\"\n\n    old_message = self.status\n    self.status = message\n\n    # The change in progress since last update\n    delta = self.progress - self.old_progress\n\n    if not self.parent.simple_tui:\n        # Update the progress bar\n        # `start_task` called everytime to ensure progress is remove from indeterminate state\n        self.parent.rich_progress_bar.start_task(self.task_id)\n        self.parent.rich_progress_bar.update(\n            self.task_id,\n            description=escape(self.song_name),\n            message=message,\n            completed=self.progress,\n        )\n\n        # If task is complete\n        if self.progress == 100 or message == \"Error\":\n            self.parent.overall_completed_tasks += 1\n            self.parent.rich_progress_bar.remove_task(self.task_id)\n    else:\n        # If task is complete\n        if self.progress == 100 or message == \"Error\":\n            self.parent.overall_completed_tasks += 1\n\n        # When running web ui print progress\n        # only one time when downloading/converting/embedding\n        if self.parent.web_ui and old_message != self.status:\n            logger.info(\"%s: %s\", self.song_name, message)\n        elif not self.parent.web_ui and delta:\n            logger.info(\"%s: %s\", self.song_name, message)\n\n    # Update the overall progress bar\n    if self.parent.song_count == self.parent.overall_completed_tasks:\n        self.parent.overall_progress = self.parent.song_count * 100\n    else:\n        self.parent.overall_progress += delta\n\n    self.parent.update_overall()\n    self.old_progress = self.progress\n\n    if self.parent.update_callback:\n        self.parent.update_callback(self, message)\n</code></pre>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook","title":"<code>yt_dlp_progress_hook(data)</code>","text":"<p>Updates the progress.</p>"},{"location":"reference/download/progress_handler/#spotdl.download.progress_handler.SongTracker.yt_dlp_progress_hook--arguments","title":"Arguments","text":"<ul> <li>progress: The progress to update to.</li> </ul> Source code in <code>spotdl/download/progress_handler.py</code> <pre><code>def yt_dlp_progress_hook(self, data: Dict[str, Any]) -&gt; None:\n    \"\"\"\n    Updates the progress.\n\n    ### Arguments\n    - progress: The progress to update to.\n    \"\"\"\n\n    if data[\"status\"] == \"downloading\":\n        file_bytes = data.get(\"total_bytes\")\n        if file_bytes is None:\n            file_bytes = data.get(\"total_bytes_estimate\")\n\n        downloaded_bytes = data.get(\"downloaded_bytes\")\n        if self.parent.simple_tui and not self.parent.web_ui:\n            self.progress = 50\n        elif file_bytes and downloaded_bytes:\n            self.progress = downloaded_bytes / file_bytes * 50\n\n        self.update(\"Downloading\")\n</code></pre>"},{"location":"reference/providers/","title":"providers","text":"<p>Different types of data providers for spotdl.</p>"},{"location":"reference/providers/audio/","title":"audio","text":"<p>Audio providers for spotdl.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider","title":"<code>AudioProvider(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>Base class for all other providers. Provides some common functionality. Handles the yt-dlp audio handler.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.name","title":"<code>name</code>  <code>property</code>","text":"<p>Get the name of the provider.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.name--returns","title":"Returns","text":"<ul> <li>The name of the provider.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_best_result","title":"<code>get_best_result(results)</code>","text":"<p>Get the best match from the results using views and average match</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_best_result--arguments","title":"Arguments","text":"<ul> <li>results: A dictionary of results and their scores</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_best_result--returns","title":"Returns","text":"<ul> <li>The best match URL and its score</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_best_result(self, results: Dict[Result, float]) -&gt; Tuple[Result, float]:\n    \"\"\"\n    Get the best match from the results\n    using views and average match\n\n    ### Arguments\n    - results: A dictionary of results and their scores\n\n    ### Returns\n    - The best match URL and its score\n    \"\"\"\n\n    best_results = get_best_matches(results, 8)\n\n    # If we have only one result, return it\n    if len(best_results) == 1:\n        return best_results[0][0], best_results[0][1]\n\n    # Initial best result based on the average match\n    best_result = best_results[0]\n\n    # If the best result has a score higher than 80%\n    # and it's a isrc search, return it\n    if best_result[1] &gt; 80 and best_result[0].isrc_search:\n        return best_result[0], best_result[1]\n\n    # If we have more than one result,\n    # return the one with the highest score\n    # and most views\n    if len(best_results) &gt; 1:\n        views: List[int] = []\n        for best_result in best_results:\n            if best_result[0].views:\n                views.append(best_result[0].views)\n            else:\n                views.append(self.get_views(best_result[0].url))\n\n        highest_views = max(views)\n        lowest_views = min(views)\n\n        if highest_views in (0, lowest_views):\n            return best_result[0], best_result[1]\n\n        weighted_results: List[Tuple[Result, float]] = []\n        for index, best_result in enumerate(best_results):\n            result_views = views[index]\n            views_score = (\n                (result_views - lowest_views) / (highest_views - lowest_views)\n            ) * 15\n            score = min(best_result[1] + views_score, 100)\n            weighted_results.append((best_result[0], score))\n\n        # Now we return the result with the highest score\n        return max(weighted_results, key=lambda x: x[1])\n\n    return best_result[0], best_result[1]\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    try:\n        data = self.audio_handler.extract_info(url, download=download)\n\n        if data:\n            return data\n    except Exception as exception:\n        logger.debug(exception)\n        raise AudioProviderError(f\"YT-DLP download error - {url}\") from exception\n\n    raise AudioProviderError(f\"No metadata found for the provided url {url}\")\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from audio provider.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_results--returns","title":"Returns","text":"<ul> <li>A list of results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from audio provider.\n\n    ### Arguments\n    - search_term: The search term to use.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A list of results.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_views","title":"<code>get_views(url)</code>","text":"<p>Get the number of views for a video.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_views--arguments","title":"Arguments","text":"<ul> <li>url: The url of the video.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.get_views--returns","title":"Returns","text":"<ul> <li>The number of views.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_views(self, url: str) -&gt; int:\n    \"\"\"\n    Get the number of views for a video.\n\n    ### Arguments\n    - url: The url of the video.\n\n    ### Returns\n    - The number of views.\n    \"\"\"\n\n    data = self.get_download_metadata(url)\n\n    return data[\"view_count\"]\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.search","title":"<code>search(song, only_verified=False)</code>","text":"<p>Search for a song and return best match.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.search--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProvider.search--returns","title":"Returns","text":"<ul> <li>The url of the best match or None if no match was found.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def search(self, song: Song, only_verified: bool = False) -&gt; Optional[str]:\n    \"\"\"\n    Search for a song and return best match.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - The url of the best match or None if no match was found.\n    \"\"\"\n\n    # Create initial search query\n    search_query = create_song_title(song.name, song.artists).lower()\n    if self.search_query:\n        search_query = create_search_query(\n            song, self.search_query, False, None, True\n        )\n\n    logger.debug(\"[%s] Searching for %s\", song.song_id, search_query)\n\n    isrc_urls: List[str] = []\n\n    # search for song using isrc if it's available\n    if song.isrc and self.SUPPORTS_ISRC and not self.search_query:\n        isrc_results = self.get_results(song.isrc)\n\n        if only_verified:\n            isrc_results = [result for result in isrc_results if result.verified]\n            logger.debug(\n                \"[%s] Filtered to %s verified ISRC results\",\n                song.song_id,\n                len(isrc_results),\n            )\n\n        isrc_urls = [result.url for result in isrc_results]\n        logger.debug(\n            \"[%s] Found %s results for ISRC %s\",\n            song.song_id,\n            len(isrc_results),\n            song.isrc,\n        )\n\n        if len(isrc_results) == 1 and isrc_results[0].verified:\n            # If we only have one verified result, return it\n            # What's the chance of it being wrong?\n            logger.debug(\n                \"[%s] Returning only ISRC result %s\",\n                song.song_id,\n                isrc_results[0].url,\n            )\n\n            return isrc_results[0].url\n\n        if len(isrc_results) &gt; 0:\n            sorted_isrc_results = order_results(\n                isrc_results, song, self.search_query\n            )\n\n            # get the best result, if the score is above 80 return it\n            best_isrc_results = sorted(\n                sorted_isrc_results.items(), key=lambda x: x[1], reverse=True\n            )\n\n            logger.debug(\n                \"[%s] Filtered to %s ISRC results\",\n                song.song_id,\n                len(best_isrc_results),\n            )\n\n            if len(best_isrc_results) &gt; 0:\n                best_isrc = best_isrc_results[0]\n                if best_isrc[1] &gt; 80.0:\n                    logger.debug(\n                        \"[%s] Best ISRC result is %s with score %s\",\n                        song.song_id,\n                        best_isrc[0].url,\n                        best_isrc[1],\n                    )\n\n                    return best_isrc[0].url\n\n    results: Dict[Result, float] = {}\n    for options in self.GET_RESULTS_OPTS:\n        # Query YTM by songs only first, this way if we get correct result on the first try\n        # we don't have to make another request\n        search_results = self.get_results(search_query, **options)\n\n        if only_verified:\n            search_results = [\n                result for result in search_results if result.verified\n            ]\n\n        logger.debug(\n            \"[%s] Found %s results for search query %s with options %s\",\n            song.song_id,\n            len(search_results),\n            search_query,\n            options,\n        )\n\n        # Check if any of the search results is in the\n        # first isrc results, since they are not hashable we have to check\n        # by name\n        isrc_result = next(\n            (result for result in search_results if result.url in isrc_urls),\n            None,\n        )\n\n        if isrc_result:\n            logger.debug(\n                \"[%s] Best ISRC result is %s\", song.song_id, isrc_result.url\n            )\n\n            return isrc_result.url\n\n        logger.debug(\n            \"[%s] Have to filter results: %s\", song.song_id, self.filter_results\n        )\n\n        if self.filter_results:\n            # Order results\n            new_results = order_results(search_results, song, self.search_query)\n        else:\n            new_results = {}\n            if len(search_results) &gt; 0:\n                new_results = {search_results[0]: 100.0}\n\n        logger.debug(\"[%s] Filtered to %s results\", song.song_id, len(new_results))\n\n        # song type results are always more accurate than video type,\n        # so if we get score of 80 or above\n        # we are almost 100% sure that this is the correct link\n        if len(new_results) != 0:\n            # get the result with highest score\n            best_result, best_score = self.get_best_result(new_results)\n            logger.debug(\n                \"[%s] Best result is %s with score %s\",\n                song.song_id,\n                best_result.url,\n                best_score,\n            )\n\n            if best_score &gt;= 80 and best_result.verified:\n                logger.debug(\n                    \"[%s] Returning verified best result %s with score %s\",\n                    song.song_id,\n                    best_result.url,\n                    best_score,\n                )\n\n                return best_result.url\n\n            # Update final results with new results\n            results.update(new_results)\n\n    # No matches found\n    if not results:\n        logger.debug(\"[%s] No results found\", song.song_id)\n        return None\n\n    # get the result with highest score\n    best_result, best_score = self.get_best_result(results)\n    logger.debug(\n        \"[%s] Returning best result %s with score %s\",\n        song.song_id,\n        best_result.url,\n        best_score,\n    )\n\n    return best_result.url\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.AudioProviderError","title":"<code>AudioProviderError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to audio searching/downloading.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp","title":"<code>BandCamp(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.BandCamp.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    try:\n        results = search(search_term)\n    except KeyError:\n        return []\n    except Exception as exc:\n        logger.error(\"Failed to get results from BandCamp\", exc_info=exc)\n        return []\n\n    simplified_results: List[Result] = []\n    for result in results:\n        track = BandCampTrack(int(result[0]), int(result[1]))\n\n        simplified_results.append(\n            Result(\n                source=\"bandcamp\",\n                url=track.track_url,\n                verified=False,\n                name=track.track_title,\n                duration=track.track_duration_seconds,\n                author=track.artist_title,\n                result_id=track.track_url,\n                search_query=search_term,\n                album=track.album_title,\n                artists=tuple(track.artist_title.split(\", \")),\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped","title":"<code>Piped(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def __init__(  # pylint: disable=super-init-not-called\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Pipe audio provider class\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"best[ext=m4a]/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"best[ext=webm]/best\"\n    else:\n        ytdl_format = \"best\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": f\"{get_temp_path()}/%(id)s.%(ext)s\",\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        user_options = args_to_ytdlp_options(shlex.split(yt_dlp_args))\n        yt_dlp_options.update(user_options)\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n    self.session = requests.Session()\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    url_id = url.split(\"?v=\")[1]\n    piped_response = requests.get(\n        f\"https://piped.video/streams/{url_id}\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    if piped_response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get metadata for {url} from Piped: {piped_response.text}\"\n        )\n\n    piped_data = piped_response.json()\n\n    yt_dlp_json = {\n        \"title\": piped_data[\"title\"],\n        \"id\": url_id,\n        \"view_count\": piped_data[\"views\"],\n        \"extractor\": \"Generic\",\n        \"formats\": [],\n    }\n\n    for audio_stream in piped_data[\"audioStreams\"]:\n        yt_dlp_json[\"formats\"].append(\n            {\n                \"url\": audio_stream[\"url\"],\n                \"ext\": \"webm\" if audio_stream[\"codec\"] == \"opus\" else \"m4a\",\n                \"abr\": audio_stream[\"quality\"].split(\" \")[0],\n                \"filesize\": audio_stream[\"contentLength\"],\n            }\n        )\n\n    return self.audio_handler.process_video_result(yt_dlp_json, download=download)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.Piped.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    if kwargs is None:\n        kwargs = {}\n\n    params = {\"q\": search_term, **kwargs}\n    if params.get(\"filter\") is None:\n        params[\"filter\"] = \"music_videos\"\n\n    response = self.session.get(\n        \"https://piped.video/search\",\n        params=params,\n        headers=HEADERS,\n        timeout=20,\n    )\n\n    if response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get results for {search_term} from Piped: {response.text}\"\n        )\n\n    search_results = response.json()\n\n    # Simplify results\n    results = []\n    for result in search_results[\"items\"]:\n        if result[\"type\"] != \"stream\":\n            continue\n\n        isrc_result = ISRC_REGEX.search(search_term)\n\n        results.append(\n            Result(\n                source=\"piped\",\n                url=f\"https://piped.video{result['url']}\",\n                verified=kwargs.get(\"filter\") == \"music_songs\",\n                name=result[\"title\"],\n                duration=result[\"duration\"],\n                author=result[\"uploaderName\"],\n                result_id=result[\"url\"].split(\"?v=\")[1],\n                artists=(\n                    (result[\"uploaderName\"],)\n                    if kwargs.get(\"filter\") == \"music_songs\"\n                    else None\n                ),\n                isrc_search=isrc_result is not None,\n                search_query=search_term,\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud","title":"<code>SoundCloud(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the SoundCloud API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n    self.client = SoundCloudClient()\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.SoundCloud.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    results = list(islice(self.client.search(search_term), 20))\n    regex = r\"^(.+?)-|(\\(\\w+[\\s\\S]*\\))\"\n    # Because anyone can post on soundcloud, we do another search with an edited search\n    # The regex removes anything in brackets and the artist(s)'s name(s) if in the name\n    edited_search_term = re.sub(regex, \"\", search_term)\n    results.extend(list(islice(self.client.search(edited_search_term), 20)))\n\n    # Simplify results\n    simplified_results = []\n    for result in results:\n        if not isinstance(result, Track):\n            continue\n\n        # Ignore results that are not playable\n        if \"/preview/\" in result.media.transcodings[0].url:\n            continue\n\n        album = self.client.get_track_albums(result.id)\n\n        try:\n            album_name = next(album).title\n        except StopIteration:\n            album_name = None\n\n        simplified_results.append(\n            Result(\n                source=\"soundcloud\",\n                url=result.permalink_url,\n                name=result.title,\n                verified=result.user.verified,\n                duration=result.full_duration,\n                author=result.user.username,\n                result_id=str(result.id),\n                isrc_search=False,\n                search_query=search_term,\n                views=result.playback_count,\n                explicit=False,\n                album=album_name,\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger","title":"<code>YTDLLogger</code>","text":"<p>Custom YT-dlp logger.</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger.debug","title":"<code>debug(msg)</code>","text":"<p>YTDL uses this to print debug messages.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def debug(self, msg):\n    \"\"\"\n    YTDL uses this to print debug messages.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger.error","title":"<code>error(msg)</code>","text":"<p>YTDL uses this to print errors.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def error(self, msg):\n    \"\"\"\n    YTDL uses this to print errors.\n    \"\"\"\n\n    raise AudioProviderError(msg)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YTDLLogger.warning","title":"<code>warning(msg)</code>","text":"<p>YTDL uses this to print warnings.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def warning(self, msg):\n    \"\"\"\n    YTDL uses this to print warnings.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube","title":"<code>YouTube(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube audio provider class</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from YouTube</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTube.get_results--returns","title":"Returns","text":"<ul> <li>A list of YouTube results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/youtube.py</code> <pre><code>def get_results(\n    self, search_term: str, *_args, **_kwargs\n) -&gt; List[Result]:  # pylint: disable=W0221\n    \"\"\"\n    Get results from YouTube\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of YouTube results if found, None otherwise.\n    \"\"\"\n\n    search_results: Optional[List[PyTube]] = Search(search_term).results\n\n    if not search_results:\n        return []\n\n    results = []\n    for result in search_results:\n        if result.watch_url:\n            try:\n                duration = result.length\n            except Exception:\n                duration = 0\n\n            try:\n                views = result.views\n            except Exception:\n                views = 0\n\n            results.append(\n                Result(\n                    source=self.name,\n                    url=result.watch_url,\n                    verified=False,\n                    name=result.title,\n                    duration=duration,\n                    author=result.author,\n                    search_query=search_term,\n                    views=views,\n                    result_id=result.video_id,\n                )\n            )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic","title":"<code>YouTubeMusic(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the YouTube Music API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n\n    self.client = YTMusic(language=\"de\")\n</code></pre>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/#spotdl.providers.audio.YouTubeMusic.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    is_isrc_result = ISRC_REGEX.search(search_term) is not None\n    # if is_isrc_result:\n    #     print(\"FORCEFULLY SETTING FILTER TO SONGS\")\n    #     kwargs[\"filter\"] = \"songs\"\n\n    search_results = self.client.search(search_term, **kwargs)\n\n    # Simplify results\n    results = []\n    for result in search_results:\n        if (\n            result is None\n            or result.get(\"videoId\") is None\n            or result.get(\"artists\") in [[], None]\n        ):\n            continue\n\n        results.append(\n            Result(\n                source=self.name,\n                url=(\n                    f'https://{\"music\" if result[\"resultType\"] == \"song\" else \"www\"}'\n                    f\".youtube.com/watch?v={result['videoId']}\"\n                ),\n                verified=result.get(\"resultType\") == \"song\",\n                name=result[\"title\"],\n                result_id=result[\"videoId\"],\n                author=result[\"artists\"][0][\"name\"],\n                artists=tuple(map(lambda a: a[\"name\"], result[\"artists\"])),\n                duration=parse_duration(result.get(\"duration\")),\n                isrc_search=is_isrc_result,\n                search_query=search_term,\n                explicit=result.get(\"isExplicit\"),\n                album=(\n                    result.get(\"album\", {}).get(\"name\")\n                    if result.get(\"album\")\n                    else None\n                ),\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/","title":"bandcamp","text":"<p>BandCamp module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp","title":"<code>BandCamp(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCamp.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    try:\n        results = search(search_term)\n    except KeyError:\n        return []\n    except Exception as exc:\n        logger.error(\"Failed to get results from BandCamp\", exc_info=exc)\n        return []\n\n    simplified_results: List[Result] = []\n    for result in results:\n        track = BandCampTrack(int(result[0]), int(result[1]))\n\n        simplified_results.append(\n            Result(\n                source=\"bandcamp\",\n                url=track.track_url,\n                verified=False,\n                name=track.track_title,\n                duration=track.track_duration_seconds,\n                author=track.artist_title,\n                result_id=track.track_url,\n                search_query=search_term,\n                album=track.album_title,\n                artists=tuple(track.artist_title.split(\", \")),\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.BandCampTrack","title":"<code>BandCampTrack(artist_id, track_id)</code>","text":"<p>BandCamp track class based on the bandcamp_api library</p> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def __init__(self, artist_id: int, track_id: int):\n    # object info\n    self.type = \"track\"\n\n    # track information\n    self.track_id: int = 0\n    self.track_title: str = \"\"\n    self.track_number: int = 0\n    self.track_duration_seconds: float = 0.00\n    self.track_streamable: Optional[bool] = None\n    self.has_lyrics: Optional[bool] = None\n    self.lyrics: str = \"\"\n    self.is_price_set: Optional[bool] = None\n    self.price: dict = {}\n    self.require_email: Optional[bool] = None\n    self.is_purchasable: Optional[bool] = None\n    self.is_free: Optional[bool] = None\n    self.is_preorder: Optional[bool] = None\n    self.tags: list = []\n    self.track_url: str = \"\"\n\n    # art\n    self.art_id: int = 0\n    self.art_url: str = \"\"\n\n    # artist information\n    self.artist_id: int = 0\n    self.artist_title: str = \"\"\n\n    # album information\n    self.album_id: int = 0\n    self.album_title: str = \"\"\n\n    # label\n    self.label_id: int = 0\n    self.label_title: str = \"\"\n\n    # about\n    self.about: str = \"\"\n    self.credits: str = \"\"\n    self.date_released_unix: int = 0\n\n    # advanced\n    self.date_last_modified_unix: int = 0\n    self.date_published_unix: int = 0\n    self.supporters: list = []\n\n    response = requests.get(\n        url=\"https://bandcamp.com/api/mobile/25/tralbum_details?band_id=\"\n        + str(artist_id)\n        + \"&amp;tralbum_id=\"\n        + str(track_id)\n        + \"&amp;tralbum_type=t\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    result = response.json()\n    self.track_id = result[\"id\"]\n    self.track_title = result[\"title\"]\n    self.track_number = result[\"tracks\"][0][\"track_num\"]\n    self.track_duration_seconds = result[\"tracks\"][0][\"duration\"]\n    self.track_streamable = result[\"tracks\"][0][\"is_streamable\"]\n    self.has_lyrics = result[\"tracks\"][0][\"has_lyrics\"]\n\n    # getting lyrics, if there is any\n    if self.has_lyrics is True:\n        resp = requests.get(\n            \"https://bandcamp.com/api/mobile/25/tralbum_lyrics?tralbum_id=\"\n            + str(self.track_id)\n            + \"&amp;tralbum_type=t\",\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        )\n        rjson = resp.json()\n        self.lyrics = rjson[\"lyrics\"][str(self.track_id)]\n\n    self.is_price_set = result[\"is_set_price\"]\n    self.price = {\"currency\": result[\"currency\"], \"amount\": result[\"price\"]}\n    self.require_email = result[\"require_email\"]\n    self.is_purchasable = result[\"is_purchasable\"]\n    self.is_free = result[\"free_download\"]\n    self.is_preorder = result[\"is_preorder\"]\n\n    for tag in result[\"tags\"]:\n        self.tags.append(tag[\"name\"])\n\n    self.art_id = result[\"art_id\"]\n    self.art_url = \"https://f4.bcbits.com/img/a\" + str(self.art_id) + \"_0.jpg\"\n\n    self.artist_id = result[\"band\"][\"band_id\"]\n    self.artist_title = result[\"band\"][\"name\"]\n\n    self.album_id = result[\"album_id\"]\n    self.album_title = result[\"album_title\"]\n\n    self.label_id = result[\"label_id\"]\n    self.label_title = result[\"label\"]\n\n    self.about = result[\"about\"]\n    self.credits = result[\"credits\"]\n\n    self.date_released_unix = result[\"release_date\"]\n\n    self.track_url = result[\"bandcamp_url\"]\n</code></pre>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.search","title":"<code>search(search_string='')</code>","text":"<p>I got this api url from the iOS app needs a way of removing characters that will screw up an url keep url safe characters</p>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.search--arguments","title":"Arguments","text":"<ul> <li>search_string: The search term to search for.</li> </ul>"},{"location":"reference/providers/audio/bandcamp/#spotdl.providers.audio.bandcamp.search--returns","title":"Returns","text":"<ul> <li>A list of artist and track ids if found</li> </ul> Source code in <code>spotdl/providers/audio/bandcamp.py</code> <pre><code>def search(search_string: str = \"\"):\n    \"\"\"\n    I got this api url from the iOS app\n    needs a way of removing characters\n    that will screw up an url\n    keep url safe characters\n\n    ### Arguments\n    - search_string: The search term to search for.\n\n    ### Returns\n    - A list of artist and track ids if found\n    \"\"\"\n\n    response = requests.get(\n        \"https://bandcamp.com/api/fuzzysearch/2/app_autocomplete?q=\"\n        + search_string\n        + \"&amp;param_with_locations=true\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    results = response.json()[\"results\"]\n\n    return_results: List[Tuple[str, str]] = []\n\n    for item in results:\n        if item[\"type\"] == \"t\":\n            return_results.append((item[\"band_id\"], item[\"id\"]))\n\n    return return_results\n</code></pre>"},{"location":"reference/providers/audio/base/","title":"base","text":"<p>Base audio provider module.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider","title":"<code>AudioProvider(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>Base class for all other providers. Provides some common functionality. Handles the yt-dlp audio handler.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.name","title":"<code>name</code>  <code>property</code>","text":"<p>Get the name of the provider.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.name--returns","title":"Returns","text":"<ul> <li>The name of the provider.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_best_result","title":"<code>get_best_result(results)</code>","text":"<p>Get the best match from the results using views and average match</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_best_result--arguments","title":"Arguments","text":"<ul> <li>results: A dictionary of results and their scores</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_best_result--returns","title":"Returns","text":"<ul> <li>The best match URL and its score</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_best_result(self, results: Dict[Result, float]) -&gt; Tuple[Result, float]:\n    \"\"\"\n    Get the best match from the results\n    using views and average match\n\n    ### Arguments\n    - results: A dictionary of results and their scores\n\n    ### Returns\n    - The best match URL and its score\n    \"\"\"\n\n    best_results = get_best_matches(results, 8)\n\n    # If we have only one result, return it\n    if len(best_results) == 1:\n        return best_results[0][0], best_results[0][1]\n\n    # Initial best result based on the average match\n    best_result = best_results[0]\n\n    # If the best result has a score higher than 80%\n    # and it's a isrc search, return it\n    if best_result[1] &gt; 80 and best_result[0].isrc_search:\n        return best_result[0], best_result[1]\n\n    # If we have more than one result,\n    # return the one with the highest score\n    # and most views\n    if len(best_results) &gt; 1:\n        views: List[int] = []\n        for best_result in best_results:\n            if best_result[0].views:\n                views.append(best_result[0].views)\n            else:\n                views.append(self.get_views(best_result[0].url))\n\n        highest_views = max(views)\n        lowest_views = min(views)\n\n        if highest_views in (0, lowest_views):\n            return best_result[0], best_result[1]\n\n        weighted_results: List[Tuple[Result, float]] = []\n        for index, best_result in enumerate(best_results):\n            result_views = views[index]\n            views_score = (\n                (result_views - lowest_views) / (highest_views - lowest_views)\n            ) * 15\n            score = min(best_result[1] + views_score, 100)\n            weighted_results.append((best_result[0], score))\n\n        # Now we return the result with the highest score\n        return max(weighted_results, key=lambda x: x[1])\n\n    return best_result[0], best_result[1]\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    try:\n        data = self.audio_handler.extract_info(url, download=download)\n\n        if data:\n            return data\n    except Exception as exception:\n        logger.debug(exception)\n        raise AudioProviderError(f\"YT-DLP download error - {url}\") from exception\n\n    raise AudioProviderError(f\"No metadata found for the provided url {url}\")\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from audio provider.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_results--returns","title":"Returns","text":"<ul> <li>A list of results.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from audio provider.\n\n    ### Arguments\n    - search_term: The search term to use.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A list of results.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_views","title":"<code>get_views(url)</code>","text":"<p>Get the number of views for a video.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_views--arguments","title":"Arguments","text":"<ul> <li>url: The url of the video.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.get_views--returns","title":"Returns","text":"<ul> <li>The number of views.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def get_views(self, url: str) -&gt; int:\n    \"\"\"\n    Get the number of views for a video.\n\n    ### Arguments\n    - url: The url of the video.\n\n    ### Returns\n    - The number of views.\n    \"\"\"\n\n    data = self.get_download_metadata(url)\n\n    return data[\"view_count\"]\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.search","title":"<code>search(song, only_verified=False)</code>","text":"<p>Search for a song and return best match.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.search--arguments","title":"Arguments","text":"<ul> <li>song: The song to search for.</li> </ul>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProvider.search--returns","title":"Returns","text":"<ul> <li>The url of the best match or None if no match was found.</li> </ul> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def search(self, song: Song, only_verified: bool = False) -&gt; Optional[str]:\n    \"\"\"\n    Search for a song and return best match.\n\n    ### Arguments\n    - song: The song to search for.\n\n    ### Returns\n    - The url of the best match or None if no match was found.\n    \"\"\"\n\n    # Create initial search query\n    search_query = create_song_title(song.name, song.artists).lower()\n    if self.search_query:\n        search_query = create_search_query(\n            song, self.search_query, False, None, True\n        )\n\n    logger.debug(\"[%s] Searching for %s\", song.song_id, search_query)\n\n    isrc_urls: List[str] = []\n\n    # search for song using isrc if it's available\n    if song.isrc and self.SUPPORTS_ISRC and not self.search_query:\n        isrc_results = self.get_results(song.isrc)\n\n        if only_verified:\n            isrc_results = [result for result in isrc_results if result.verified]\n            logger.debug(\n                \"[%s] Filtered to %s verified ISRC results\",\n                song.song_id,\n                len(isrc_results),\n            )\n\n        isrc_urls = [result.url for result in isrc_results]\n        logger.debug(\n            \"[%s] Found %s results for ISRC %s\",\n            song.song_id,\n            len(isrc_results),\n            song.isrc,\n        )\n\n        if len(isrc_results) == 1 and isrc_results[0].verified:\n            # If we only have one verified result, return it\n            # What's the chance of it being wrong?\n            logger.debug(\n                \"[%s] Returning only ISRC result %s\",\n                song.song_id,\n                isrc_results[0].url,\n            )\n\n            return isrc_results[0].url\n\n        if len(isrc_results) &gt; 0:\n            sorted_isrc_results = order_results(\n                isrc_results, song, self.search_query\n            )\n\n            # get the best result, if the score is above 80 return it\n            best_isrc_results = sorted(\n                sorted_isrc_results.items(), key=lambda x: x[1], reverse=True\n            )\n\n            logger.debug(\n                \"[%s] Filtered to %s ISRC results\",\n                song.song_id,\n                len(best_isrc_results),\n            )\n\n            if len(best_isrc_results) &gt; 0:\n                best_isrc = best_isrc_results[0]\n                if best_isrc[1] &gt; 80.0:\n                    logger.debug(\n                        \"[%s] Best ISRC result is %s with score %s\",\n                        song.song_id,\n                        best_isrc[0].url,\n                        best_isrc[1],\n                    )\n\n                    return best_isrc[0].url\n\n    results: Dict[Result, float] = {}\n    for options in self.GET_RESULTS_OPTS:\n        # Query YTM by songs only first, this way if we get correct result on the first try\n        # we don't have to make another request\n        search_results = self.get_results(search_query, **options)\n\n        if only_verified:\n            search_results = [\n                result for result in search_results if result.verified\n            ]\n\n        logger.debug(\n            \"[%s] Found %s results for search query %s with options %s\",\n            song.song_id,\n            len(search_results),\n            search_query,\n            options,\n        )\n\n        # Check if any of the search results is in the\n        # first isrc results, since they are not hashable we have to check\n        # by name\n        isrc_result = next(\n            (result for result in search_results if result.url in isrc_urls),\n            None,\n        )\n\n        if isrc_result:\n            logger.debug(\n                \"[%s] Best ISRC result is %s\", song.song_id, isrc_result.url\n            )\n\n            return isrc_result.url\n\n        logger.debug(\n            \"[%s] Have to filter results: %s\", song.song_id, self.filter_results\n        )\n\n        if self.filter_results:\n            # Order results\n            new_results = order_results(search_results, song, self.search_query)\n        else:\n            new_results = {}\n            if len(search_results) &gt; 0:\n                new_results = {search_results[0]: 100.0}\n\n        logger.debug(\"[%s] Filtered to %s results\", song.song_id, len(new_results))\n\n        # song type results are always more accurate than video type,\n        # so if we get score of 80 or above\n        # we are almost 100% sure that this is the correct link\n        if len(new_results) != 0:\n            # get the result with highest score\n            best_result, best_score = self.get_best_result(new_results)\n            logger.debug(\n                \"[%s] Best result is %s with score %s\",\n                song.song_id,\n                best_result.url,\n                best_score,\n            )\n\n            if best_score &gt;= 80 and best_result.verified:\n                logger.debug(\n                    \"[%s] Returning verified best result %s with score %s\",\n                    song.song_id,\n                    best_result.url,\n                    best_score,\n                )\n\n                return best_result.url\n\n            # Update final results with new results\n            results.update(new_results)\n\n    # No matches found\n    if not results:\n        logger.debug(\"[%s] No results found\", song.song_id)\n        return None\n\n    # get the result with highest score\n    best_result, best_score = self.get_best_result(results)\n    logger.debug(\n        \"[%s] Returning best result %s with score %s\",\n        song.song_id,\n        best_result.url,\n        best_score,\n    )\n\n    return best_result.url\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.AudioProviderError","title":"<code>AudioProviderError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to audio searching/downloading.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger","title":"<code>YTDLLogger</code>","text":"<p>Custom YT-dlp logger.</p>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger.debug","title":"<code>debug(msg)</code>","text":"<p>YTDL uses this to print debug messages.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def debug(self, msg):\n    \"\"\"\n    YTDL uses this to print debug messages.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger.error","title":"<code>error(msg)</code>","text":"<p>YTDL uses this to print errors.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def error(self, msg):\n    \"\"\"\n    YTDL uses this to print errors.\n    \"\"\"\n\n    raise AudioProviderError(msg)\n</code></pre>"},{"location":"reference/providers/audio/base/#spotdl.providers.audio.base.YTDLLogger.warning","title":"<code>warning(msg)</code>","text":"<p>YTDL uses this to print warnings.</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def warning(self, msg):\n    \"\"\"\n    YTDL uses this to print warnings.\n    \"\"\"\n\n    pass  # pylint: disable=W0107\n</code></pre>"},{"location":"reference/providers/audio/piped/","title":"piped","text":"<p>Piped module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped","title":"<code>Piped(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped--arguments","title":"Arguments","text":"<ul> <li>output_directory: The directory to save the downloaded songs to.</li> <li>output_format: The format to save the downloaded songs in.</li> <li>cookie_file: The path to a file containing cookies to be used by YTDL.</li> <li>search_query: The query to use when searching for songs.</li> <li>filter_results: Whether to filter results.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def __init__(  # pylint: disable=super-init-not-called\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Pipe audio provider class\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"best[ext=m4a]/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"best[ext=webm]/best\"\n    else:\n        ytdl_format = \"best\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": f\"{get_temp_path()}/%(id)s.%(ext)s\",\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        user_options = args_to_ytdlp_options(shlex.split(yt_dlp_args))\n        yt_dlp_options.update(user_options)\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n    self.session = requests.Session()\n</code></pre>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_download_metadata","title":"<code>get_download_metadata(url, download=False)</code>","text":"<p>Get metadata for a download using yt-dlp.</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_download_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url to get metadata for.</li> </ul>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_download_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary containing the metadata.</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_download_metadata(self, url: str, download: bool = False) -&gt; Dict:\n    \"\"\"\n    Get metadata for a download using yt-dlp.\n\n    ### Arguments\n    - url: The url to get metadata for.\n\n    ### Returns\n    - A dictionary containing the metadata.\n    \"\"\"\n\n    url_id = url.split(\"?v=\")[1]\n    piped_response = requests.get(\n        f\"https://piped.video/streams/{url_id}\",\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    if piped_response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get metadata for {url} from Piped: {piped_response.text}\"\n        )\n\n    piped_data = piped_response.json()\n\n    yt_dlp_json = {\n        \"title\": piped_data[\"title\"],\n        \"id\": url_id,\n        \"view_count\": piped_data[\"views\"],\n        \"extractor\": \"Generic\",\n        \"formats\": [],\n    }\n\n    for audio_stream in piped_data[\"audioStreams\"]:\n        yt_dlp_json[\"formats\"].append(\n            {\n                \"url\": audio_stream[\"url\"],\n                \"ext\": \"webm\" if audio_stream[\"codec\"] == \"opus\" else \"m4a\",\n                \"abr\": audio_stream[\"quality\"].split(\" \")[0],\n                \"filesize\": audio_stream[\"contentLength\"],\n            }\n        )\n\n    return self.audio_handler.process_video_result(yt_dlp_json, download=download)\n</code></pre>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/piped/#spotdl.providers.audio.piped.Piped.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/piped.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    if kwargs is None:\n        kwargs = {}\n\n    params = {\"q\": search_term, **kwargs}\n    if params.get(\"filter\") is None:\n        params[\"filter\"] = \"music_videos\"\n\n    response = self.session.get(\n        \"https://piped.video/search\",\n        params=params,\n        headers=HEADERS,\n        timeout=20,\n    )\n\n    if response.status_code != 200:\n        raise AudioProviderError(\n            f\"Failed to get results for {search_term} from Piped: {response.text}\"\n        )\n\n    search_results = response.json()\n\n    # Simplify results\n    results = []\n    for result in search_results[\"items\"]:\n        if result[\"type\"] != \"stream\":\n            continue\n\n        isrc_result = ISRC_REGEX.search(search_term)\n\n        results.append(\n            Result(\n                source=\"piped\",\n                url=f\"https://piped.video{result['url']}\",\n                verified=kwargs.get(\"filter\") == \"music_songs\",\n                name=result[\"title\"],\n                duration=result[\"duration\"],\n                author=result[\"uploaderName\"],\n                result_id=result[\"url\"].split(\"?v=\")[1],\n                artists=(\n                    (result[\"uploaderName\"],)\n                    if kwargs.get(\"filter\") == \"music_songs\"\n                    else None\n                ),\n                isrc_search=isrc_result is not None,\n                search_query=search_term,\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/sliderkz/","title":"sliderkz","text":"<p>SliderKZ module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ","title":"<code>SliderKZ(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>Slider.kz audio provider class</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/sliderkz/#spotdl.providers.audio.sliderkz.SliderKZ.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/sliderkz.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    search_results = None\n    max_retries = 0\n\n    while not search_results and max_retries &lt; 3:\n        try:\n            search_response = requests.get(\n                url=\"https://hayqbhgr.slider.kz/vk_auth.php?q=\" + search_term,\n                headers=HEADERS,\n                timeout=5,\n                proxies=GlobalConfig.get_parameter(\"proxies\"),\n            )\n\n            # Check if the response is valid\n            if len(search_response.text) &gt; 30:\n                # Set the search results to the json response\n                # effectively breaking out of the loop\n                search_results = search_response.json()\n\n        except Exception as exc:\n            logger.debug(\n                \"Slider.kz search failed for query %s with error: %s. Retrying...\",\n                search_term,\n                exc,\n            )\n\n        max_retries += 1\n\n    if not search_results:\n        logger.debug(\"Slider.kz search failed for query %s\", search_term)\n        return []\n\n    results = []\n    for result in search_results[\"audios\"][\"\"]:\n        # urls from slider.kz sometimes are relative, so we need to add the domain\n        if \"https://\" not in result[\"url\"]:\n            result[\"url\"] = \"https://hayqbhgr.slider.kz/\" + result[\"url\"]\n\n        results.append(\n            Result(\n                source=\"slider.kz\",\n                url=result.get(\"url\"),\n                verified=False,\n                name=result.get(\"tit_art\"),\n                duration=int(result.get(\"duration\", -9999)),\n                author=\"slider.kz\",\n                result_id=result.get(\"id\"),\n                views=1,\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/soundcloud/","title":"soundcloud","text":"<p>SoundCloud module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud","title":"<code>SoundCloud(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>SoundCloud audio provider class</p>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the SoundCloud API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n    self.client = SoundCloudClient()\n</code></pre>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from slider.kz</p>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/soundcloud/#spotdl.providers.audio.soundcloud.SoundCloud.get_results--returns","title":"Returns","text":"<ul> <li>A list of slider.kz results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/soundcloud.py</code> <pre><code>def get_results(self, search_term: str, *_args, **_kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from slider.kz\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of slider.kz results if found, None otherwise.\n    \"\"\"\n\n    results = list(islice(self.client.search(search_term), 20))\n    regex = r\"^(.+?)-|(\\(\\w+[\\s\\S]*\\))\"\n    # Because anyone can post on soundcloud, we do another search with an edited search\n    # The regex removes anything in brackets and the artist(s)'s name(s) if in the name\n    edited_search_term = re.sub(regex, \"\", search_term)\n    results.extend(list(islice(self.client.search(edited_search_term), 20)))\n\n    # Simplify results\n    simplified_results = []\n    for result in results:\n        if not isinstance(result, Track):\n            continue\n\n        # Ignore results that are not playable\n        if \"/preview/\" in result.media.transcodings[0].url:\n            continue\n\n        album = self.client.get_track_albums(result.id)\n\n        try:\n            album_name = next(album).title\n        except StopIteration:\n            album_name = None\n\n        simplified_results.append(\n            Result(\n                source=\"soundcloud\",\n                url=result.permalink_url,\n                name=result.title,\n                verified=result.user.verified,\n                duration=result.full_duration,\n                author=result.user.username,\n                result_id=str(result.id),\n                isrc_search=False,\n                search_query=search_term,\n                views=result.playback_count,\n                explicit=False,\n                album=album_name,\n            )\n        )\n\n    return simplified_results\n</code></pre>"},{"location":"reference/providers/audio/youtube/","title":"youtube","text":"<p>Youtube module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube","title":"<code>YouTube(output_format='mp3', cookie_file=None, search_query=None, filter_results=True, yt_dlp_args=None)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube audio provider class</p> Source code in <code>spotdl/providers/audio/base.py</code> <pre><code>def __init__(\n    self,\n    output_format: str = \"mp3\",\n    cookie_file: Optional[str] = None,\n    search_query: Optional[str] = None,\n    filter_results: bool = True,\n    yt_dlp_args: Optional[str] = None,\n) -&gt; None:\n    \"\"\"\n    Base class for audio providers.\n\n    ### Arguments\n    - output_directory: The directory to save the downloaded songs to.\n    - output_format: The format to save the downloaded songs in.\n    - cookie_file: The path to a file containing cookies to be used by YTDL.\n    - search_query: The query to use when searching for songs.\n    - filter_results: Whether to filter results.\n    \"\"\"\n\n    self.output_format = output_format\n    self.cookie_file = cookie_file\n    self.search_query = search_query\n    self.filter_results = filter_results\n\n    if self.output_format == \"m4a\":\n        ytdl_format = \"bestaudio[ext=m4a]/bestaudio/best\"\n    elif self.output_format == \"opus\":\n        ytdl_format = \"bestaudio[ext=webm]/bestaudio/best\"\n    else:\n        ytdl_format = \"bestaudio\"\n\n    yt_dlp_options = {\n        \"format\": ytdl_format,\n        \"quiet\": True,\n        \"no_warnings\": True,\n        \"encoding\": \"UTF-8\",\n        \"logger\": YTDLLogger(),\n        \"cookiefile\": self.cookie_file,\n        \"outtmpl\": str((get_temp_path() / \"%(id)s.%(ext)s\").resolve()),\n        \"retries\": 5,\n    }\n\n    if yt_dlp_args:\n        yt_dlp_options = args_to_ytdlp_options(\n            shlex.split(yt_dlp_args), yt_dlp_options\n        )\n\n    self.audio_handler = YoutubeDL(yt_dlp_options)\n</code></pre>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube.get_results","title":"<code>get_results(search_term, *_args, **_kwargs)</code>","text":"<p>Get results from YouTube</p>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>args: Unused.</li> <li>kwargs: Unused.</li> </ul>"},{"location":"reference/providers/audio/youtube/#spotdl.providers.audio.youtube.YouTube.get_results--returns","title":"Returns","text":"<ul> <li>A list of YouTube results if found, None otherwise.</li> </ul> Source code in <code>spotdl/providers/audio/youtube.py</code> <pre><code>def get_results(\n    self, search_term: str, *_args, **_kwargs\n) -&gt; List[Result]:  # pylint: disable=W0221\n    \"\"\"\n    Get results from YouTube\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - args: Unused.\n    - kwargs: Unused.\n\n    ### Returns\n    - A list of YouTube results if found, None otherwise.\n    \"\"\"\n\n    search_results: Optional[List[PyTube]] = Search(search_term).results\n\n    if not search_results:\n        return []\n\n    results = []\n    for result in search_results:\n        if result.watch_url:\n            try:\n                duration = result.length\n            except Exception:\n                duration = 0\n\n            try:\n                views = result.views\n            except Exception:\n                views = 0\n\n            results.append(\n                Result(\n                    source=self.name,\n                    url=result.watch_url,\n                    verified=False,\n                    name=result.title,\n                    duration=duration,\n                    author=result.author,\n                    search_query=search_term,\n                    views=views,\n                    result_id=result.video_id,\n                )\n            )\n\n    return results\n</code></pre>"},{"location":"reference/providers/audio/ytmusic/","title":"ytmusic","text":"<p>YTMusic module for downloading and searching songs.</p>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic","title":"<code>YouTubeMusic(*args, **kwargs)</code>","text":"<p>               Bases: <code>AudioProvider</code></p> <p>YouTube Music audio provider class</p>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic--arguments","title":"Arguments","text":"<ul> <li>args: Arguments passed to the <code>AudioProvider</code> class.</li> <li>kwargs: Keyword arguments passed to the <code>AudioProvider</code> class.</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Initialize the YouTube Music API\n\n    ### Arguments\n    - args: Arguments passed to the `AudioProvider` class.\n    - kwargs: Keyword arguments passed to the `AudioProvider` class.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n\n    self.client = YTMusic(language=\"de\")\n</code></pre>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results","title":"<code>get_results(search_term, **kwargs)</code>","text":"<p>Get results from YouTube Music API and simplify them</p>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to search for.</li> <li>kwargs: other keyword arguments passed to the <code>YTMusic.search</code> method.</li> </ul>"},{"location":"reference/providers/audio/ytmusic/#spotdl.providers.audio.ytmusic.YouTubeMusic.get_results--returns","title":"Returns","text":"<ul> <li>A list of simplified results (dicts)</li> </ul> Source code in <code>spotdl/providers/audio/ytmusic.py</code> <pre><code>def get_results(self, search_term: str, **kwargs) -&gt; List[Result]:\n    \"\"\"\n    Get results from YouTube Music API and simplify them\n\n    ### Arguments\n    - search_term: The search term to search for.\n    - kwargs: other keyword arguments passed to the `YTMusic.search` method.\n\n    ### Returns\n    - A list of simplified results (dicts)\n    \"\"\"\n\n    is_isrc_result = ISRC_REGEX.search(search_term) is not None\n    # if is_isrc_result:\n    #     print(\"FORCEFULLY SETTING FILTER TO SONGS\")\n    #     kwargs[\"filter\"] = \"songs\"\n\n    search_results = self.client.search(search_term, **kwargs)\n\n    # Simplify results\n    results = []\n    for result in search_results:\n        if (\n            result is None\n            or result.get(\"videoId\") is None\n            or result.get(\"artists\") in [[], None]\n        ):\n            continue\n\n        results.append(\n            Result(\n                source=self.name,\n                url=(\n                    f'https://{\"music\" if result[\"resultType\"] == \"song\" else \"www\"}'\n                    f\".youtube.com/watch?v={result['videoId']}\"\n                ),\n                verified=result.get(\"resultType\") == \"song\",\n                name=result[\"title\"],\n                result_id=result[\"videoId\"],\n                author=result[\"artists\"][0][\"name\"],\n                artists=tuple(map(lambda a: a[\"name\"], result[\"artists\"])),\n                duration=parse_duration(result.get(\"duration\")),\n                isrc_search=is_isrc_result,\n                search_query=search_term,\n                explicit=result.get(\"isExplicit\"),\n                album=(\n                    result.get(\"album\", {}).get(\"name\")\n                    if result.get(\"album\")\n                    else None\n                ),\n            )\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/","title":"lyrics","text":"<p>Lyrics providers for spotdl.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics","title":"<code>AzLyrics()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>AZLyrics lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def __init__(self):\n    super().__init__()\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n\n    self.x_code = self.get_x_code()\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    response = self.session.get(url)\n    soup = BeautifulSoup(response.content, \"html.parser\")\n\n    # Find all divs that don't have a class\n    div_tags = soup.find_all(\"div\", class_=False, id_=False)\n\n    # Find the div with the longest text\n    lyrics_div = sorted(div_tags, key=lambda x: len(x.text))[-1]\n\n    # extract lyrics from div and clean it up\n    lyrics = lyrics_div.get_text().strip()\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    if self.x_code is None:\n        self.x_code = self.get_x_code()\n\n    if self.x_code is None:\n        return {}\n\n    # Join every artist by comma in artists\n    artist_str = \", \".join(artist for artist in artists if artist)\n\n    params = {\n        \"q\": f\"{artist_str} - {name}\",\n        \"x\": self.x_code,\n    }\n\n    counter = 0\n    soup = None\n    while counter &lt; 4:\n        try:\n            response = self.session.get(\n                \"https://search.azlyrics.com/search.php\", params=params\n            )\n        except requests.ConnectionError:\n            continue\n\n        if not response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(response.content, \"html.parser\")\n        break\n\n    if soup is None:\n        return {}\n\n    td_tags = soup.find_all(\"td\")\n    if len(td_tags) == 0:\n        return {}\n\n    results = {}\n    for td_tag in td_tags:\n        a_tags = td_tag.find_all(\"a\", href=True)\n        if len(a_tags) == 0:\n            continue\n\n        a_tag = a_tags[0]\n        url = a_tag[\"href\"].strip()\n        if url == \"\":\n            continue\n\n        title = td_tag.find(\"span\").get_text().strip()\n        artist = td_tag.find(\"b\").get_text().strip()\n\n        results[f\"{artist} - {title}\"] = url\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_x_code","title":"<code>get_x_code()</code>","text":"<p>Returns the x_code used by AZLyrics.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.AzLyrics.get_x_code--returns","title":"Returns","text":"<ul> <li>The x_code used by AZLyrics or None if it couldn't be retrieved.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_x_code(self) -&gt; Optional[str]:\n    \"\"\"\n    Returns the x_code used by AZLyrics.\n\n    ### Returns\n    - The x_code used by AZLyrics or None if it couldn't be retrieved.\n    \"\"\"\n\n    x_code = None\n\n    try:\n        self.session.get(\"https://www.azlyrics.com/\")\n\n        resp = self.session.get(\"https://www.azlyrics.com/geo.js\")\n\n        # extract value from js code\n        js_code = resp.text\n        start_index = js_code.find('value\"') + 9\n        end_index = js_code[start_index:].find('\");')\n\n        x_code = js_code[start_index : start_index + end_index]\n    except requests.ConnectionError:\n        pass\n\n    return x_code\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius","title":"<code>Genius(access_token)</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Genius lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def __init__(self, access_token: str):\n    \"\"\"\n    Init the lyrics provider search and set headers.\n    \"\"\"\n\n    super().__init__()\n\n    self.access_token = access_token\n\n    self.headers.update(\n        {\n            \"Authorization\": f\"Bearer {self.access_token}\",\n        }\n    )\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    url = f\"https://api.genius.com/songs/{url}\"\n    song_response = self.session.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    url = song_response.json()[\"response\"][\"song\"][\"url\"]\n\n    soup = None\n    counter = 0\n    while counter &lt; 4:\n        genius_page_response = self.session.get(\n            url,\n            headers=self.headers,\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        )\n\n        if not genius_page_response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(\n            genius_page_response.text.replace(\"&lt;br/&gt;\", \"\\n\"), \"html.parser\"\n        )\n\n        break\n\n    if soup is None:\n        return None\n\n    lyrics_div = soup.select_one(\"div.lyrics\")\n    lyrics_containers = soup.select(\"div[class^=Lyrics__Container]\")\n\n    # Get lyrics\n    if lyrics_div:\n        lyrics = lyrics_div.get_text()\n    elif lyrics_containers:\n        lyrics = \"\\n\".join(con.get_text() for con in lyrics_containers)\n    else:\n        return None\n\n    if not lyrics:\n        return None\n\n    # Clean lyrics\n    lyrics = lyrics.strip()\n\n    # Remove desc at the beginning if it exists\n    for to_remove in [\"desc\", \"Desc\"]:\n        lyrics.replace(to_remove, \"\", 1)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Genius.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    artists_str = \", \".join(artists)\n    title = f\"{name} - {artists_str}\"\n\n    search_response = self.session.get(\n        \"https://api.genius.com/search\",\n        params={\"q\": title},\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    results: Dict[str, str] = {}\n    for hit in search_response.json()[\"response\"][\"hits\"]:\n        results[hit[\"result\"][\"full_title\"]] = hit[\"result\"][\"id\"]\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider","title":"<code>LyricsProvider()</code>","text":"<p>Base class for all other lyrics providers.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.name","title":"<code>name</code>  <code>property</code>","text":"<p>Returns the name of the lyrics provider.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Returns the lyrics for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Returns the lyrics for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n    try:\n        results = self.get_results(name, artists, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to get results for %s - %s: %s\",\n            self.name,\n            name,\n            \", \".join(artists),\n            exc,\n        )\n        return None\n\n    if not results:\n        return None\n\n    results_with_score = {}\n    for title, url in results.items():\n        result_title = slugify(title)\n        match_title = slugify(f\"{name} - {', '.join(artists)}\")\n\n        res_list, song_list = based_sort(\n            result_title.split(\"-\"), match_title.split(\"-\")\n        )\n        result_title, match_title = \"-\".join(res_list), \"-\".join(song_list)\n\n        score = ratio(result_title, match_title)\n        results_with_score[score] = url\n\n    if not results_with_score:\n        return None\n\n    # Get song url with highest title match\n    score, url = max(results_with_score.items(), key=lambda x: x[0])\n\n    # Only return lyrics if the title match is at least 55%\n    if score &lt; 55:\n        return None\n\n    try:\n        return self.extract_lyrics(url, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to extract lyrics from %s: %s\", self.name, url, exc\n        )\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.LyricsProvider.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch","title":"<code>MusixMatch()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>MusixMatch lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    lyrics_resp = requests.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    lyrics_soup = BeautifulSoup(lyrics_resp.text, \"html.parser\")\n    lyrics_paragraphs = lyrics_soup.select(\"p.mxm-lyrics__content\")\n    lyrics = \"\\n\".join(i.get_text() for i in lyrics_paragraphs)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.MusixMatch.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    track_search = kwargs.get(\"track_search\", False)\n    artists_str = \", \".join(\n        artist for artist in artists if artist.lower() not in name.lower()\n    )\n\n    # quote the query so that it's safe to use in a url\n    # e.g \"Au/Ra\" -&gt; \"Au%2FRa\"\n    query = quote(f\"{name} - {artists_str}\", safe=\"\")\n\n    # search the `tracks page` if track_search is True\n    if track_search:\n        query += \"/tracks\"\n\n    search_url = f\"https://www.musixmatch.com/search/{query}\"\n    search_resp = requests.get(\n        search_url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    search_soup = BeautifulSoup(search_resp.text, \"html.parser\")\n    song_url_tag = search_soup.select(\"a[href^='/lyrics/']\")\n\n    if not song_url_tag:\n        # song_url_tag being None means no results were found on the\n        # All Results page, therefore, we use `track_search` to\n        # search the tracks page.\n\n        # track_serach being True means we are already searching the tracks page.\n        if track_search:\n            return {}\n\n        return self.get_results(name, artists, track_search=True)\n\n    results: Dict[str, str] = {}\n    for tag in song_url_tag:\n        results[tag.get_text()] = \"https://www.musixmatch.com\" + str(\n            tag.get(\"href\", \"\")\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced","title":"<code>Synced()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Lyrics provider for synced lyrics using the syncedlyrics library Currently supported websites: Deezer, NetEase</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Try to get lyrics using syncedlyrics</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Try to get lyrics using syncedlyrics\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    try:\n        lyrics = syncedlyrics.search(\n            f\"{name} - {artists[0]}\",\n            synced_only=not kwargs.get(\"allow_plain_format\", True),\n        )\n        return lyrics\n    except requests.exceptions.SSLError:\n        # Max retries reached\n        return None\n    except TypeError:\n        # Error at syncedlyrics.providers.musixmatch L89 -\n        #   Because `body` is occasionally an empty list instead of a dictionary.\n        # We get this error when allow_plain_format is set to True,\n        #   and there are no synced lyrics present\n        # Because its empty, we know there are no lyrics\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/#spotdl.providers.lyrics.Synced.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/","title":"azlyrics","text":"<p>AZLyrics lyrics module.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics","title":"<code>AzLyrics()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>AZLyrics lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def __init__(self):\n    super().__init__()\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n\n    self.x_code = self.get_x_code()\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    response = self.session.get(url)\n    soup = BeautifulSoup(response.content, \"html.parser\")\n\n    # Find all divs that don't have a class\n    div_tags = soup.find_all(\"div\", class_=False, id_=False)\n\n    # Find the div with the longest text\n    lyrics_div = sorted(div_tags, key=lambda x: len(x.text))[-1]\n\n    # extract lyrics from div and clean it up\n    lyrics = lyrics_div.get_text().strip()\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    if self.x_code is None:\n        self.x_code = self.get_x_code()\n\n    if self.x_code is None:\n        return {}\n\n    # Join every artist by comma in artists\n    artist_str = \", \".join(artist for artist in artists if artist)\n\n    params = {\n        \"q\": f\"{artist_str} - {name}\",\n        \"x\": self.x_code,\n    }\n\n    counter = 0\n    soup = None\n    while counter &lt; 4:\n        try:\n            response = self.session.get(\n                \"https://search.azlyrics.com/search.php\", params=params\n            )\n        except requests.ConnectionError:\n            continue\n\n        if not response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(response.content, \"html.parser\")\n        break\n\n    if soup is None:\n        return {}\n\n    td_tags = soup.find_all(\"td\")\n    if len(td_tags) == 0:\n        return {}\n\n    results = {}\n    for td_tag in td_tags:\n        a_tags = td_tag.find_all(\"a\", href=True)\n        if len(a_tags) == 0:\n            continue\n\n        a_tag = a_tags[0]\n        url = a_tag[\"href\"].strip()\n        if url == \"\":\n            continue\n\n        title = td_tag.find(\"span\").get_text().strip()\n        artist = td_tag.find(\"b\").get_text().strip()\n\n        results[f\"{artist} - {title}\"] = url\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code","title":"<code>get_x_code()</code>","text":"<p>Returns the x_code used by AZLyrics.</p>"},{"location":"reference/providers/lyrics/azlyrics/#spotdl.providers.lyrics.azlyrics.AzLyrics.get_x_code--returns","title":"Returns","text":"<ul> <li>The x_code used by AZLyrics or None if it couldn't be retrieved.</li> </ul> Source code in <code>spotdl/providers/lyrics/azlyrics.py</code> <pre><code>def get_x_code(self) -&gt; Optional[str]:\n    \"\"\"\n    Returns the x_code used by AZLyrics.\n\n    ### Returns\n    - The x_code used by AZLyrics or None if it couldn't be retrieved.\n    \"\"\"\n\n    x_code = None\n\n    try:\n        self.session.get(\"https://www.azlyrics.com/\")\n\n        resp = self.session.get(\"https://www.azlyrics.com/geo.js\")\n\n        # extract value from js code\n        js_code = resp.text\n        start_index = js_code.find('value\"') + 9\n        end_index = js_code[start_index:].find('\");')\n\n        x_code = js_code[start_index : start_index + end_index]\n    except requests.ConnectionError:\n        pass\n\n    return x_code\n</code></pre>"},{"location":"reference/providers/lyrics/base/","title":"base","text":"<p>Base module for all other lyrics providers.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider","title":"<code>LyricsProvider()</code>","text":"<p>Base class for all other lyrics providers.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.name","title":"<code>name</code>  <code>property</code>","text":"<p>Returns the name of the lyrics provider.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Returns the lyrics for the given song.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Returns the lyrics for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n    try:\n        results = self.get_results(name, artists, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to get results for %s - %s: %s\",\n            self.name,\n            name,\n            \", \".join(artists),\n            exc,\n        )\n        return None\n\n    if not results:\n        return None\n\n    results_with_score = {}\n    for title, url in results.items():\n        result_title = slugify(title)\n        match_title = slugify(f\"{name} - {', '.join(artists)}\")\n\n        res_list, song_list = based_sort(\n            result_title.split(\"-\"), match_title.split(\"-\")\n        )\n        result_title, match_title = \"-\".join(res_list), \"-\".join(song_list)\n\n        score = ratio(result_title, match_title)\n        results_with_score[score] = url\n\n    if not results_with_score:\n        return None\n\n    # Get song url with highest title match\n    score, url = max(results_with_score.items(), key=lambda x: x[0])\n\n    # Only return lyrics if the title match is at least 55%\n    if score &lt; 55:\n        return None\n\n    try:\n        return self.extract_lyrics(url, **kwargs)\n    except Exception as exc:\n        logger.debug(\n            \"%s: Failed to extract lyrics from %s: %s\", self.name, url, exc\n        )\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/base/#spotdl.providers.lyrics.base.LyricsProvider.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/genius/","title":"genius","text":"<p>Genius Lyrics module.</p>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius","title":"<code>Genius(access_token)</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Genius lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def __init__(self, access_token: str):\n    \"\"\"\n    Init the lyrics provider search and set headers.\n    \"\"\"\n\n    super().__init__()\n\n    self.access_token = access_token\n\n    self.headers.update(\n        {\n            \"Authorization\": f\"Bearer {self.access_token}\",\n        }\n    )\n\n    self.session = requests.Session()\n    self.session.headers.update(self.headers)\n</code></pre>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    url = f\"https://api.genius.com/songs/{url}\"\n    song_response = self.session.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    url = song_response.json()[\"response\"][\"song\"][\"url\"]\n\n    soup = None\n    counter = 0\n    while counter &lt; 4:\n        genius_page_response = self.session.get(\n            url,\n            headers=self.headers,\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        )\n\n        if not genius_page_response.ok:\n            counter += 1\n            continue\n\n        soup = BeautifulSoup(\n            genius_page_response.text.replace(\"&lt;br/&gt;\", \"\\n\"), \"html.parser\"\n        )\n\n        break\n\n    if soup is None:\n        return None\n\n    lyrics_div = soup.select_one(\"div.lyrics\")\n    lyrics_containers = soup.select(\"div[class^=Lyrics__Container]\")\n\n    # Get lyrics\n    if lyrics_div:\n        lyrics = lyrics_div.get_text()\n    elif lyrics_containers:\n        lyrics = \"\\n\".join(con.get_text() for con in lyrics_containers)\n    else:\n        return None\n\n    if not lyrics:\n        return None\n\n    # Clean lyrics\n    lyrics = lyrics.strip()\n\n    # Remove desc at the beginning if it exists\n    for to_remove in [\"desc\", \"Desc\"]:\n        lyrics.replace(to_remove, \"\", 1)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.get_results","title":"<code>get_results(name, artists, **_)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/genius/#spotdl.providers.lyrics.genius.Genius.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/genius.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **_) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    artists_str = \", \".join(artists)\n    title = f\"{name} - {artists_str}\"\n\n    search_response = self.session.get(\n        \"https://api.genius.com/search\",\n        params={\"q\": title},\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    results: Dict[str, str] = {}\n    for hit in search_response.json()[\"response\"][\"hits\"]:\n        results[hit[\"result\"][\"full_title\"]] = hit[\"result\"][\"id\"]\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/musixmatch/","title":"musixmatch","text":"<p>MusixMatch lyrics provider.</p>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch","title":"<code>MusixMatch()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>MusixMatch lyrics provider class.</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics","title":"<code>extract_lyrics(url, **_)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def extract_lyrics(self, url: str, **_) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    lyrics_resp = requests.get(\n        url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n\n    lyrics_soup = BeautifulSoup(lyrics_resp.text, \"html.parser\")\n    lyrics_paragraphs = lyrics_soup.select(\"p.mxm-lyrics__content\")\n    lyrics = \"\\n\".join(i.get_text() for i in lyrics_paragraphs)\n\n    return lyrics\n</code></pre>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/musixmatch/#spotdl.providers.lyrics.musixmatch.MusixMatch.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/musixmatch.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    track_search = kwargs.get(\"track_search\", False)\n    artists_str = \", \".join(\n        artist for artist in artists if artist.lower() not in name.lower()\n    )\n\n    # quote the query so that it's safe to use in a url\n    # e.g \"Au/Ra\" -&gt; \"Au%2FRa\"\n    query = quote(f\"{name} - {artists_str}\", safe=\"\")\n\n    # search the `tracks page` if track_search is True\n    if track_search:\n        query += \"/tracks\"\n\n    search_url = f\"https://www.musixmatch.com/search/{query}\"\n    search_resp = requests.get(\n        search_url,\n        headers=self.headers,\n        timeout=10,\n        proxies=GlobalConfig.get_parameter(\"proxies\"),\n    )\n    search_soup = BeautifulSoup(search_resp.text, \"html.parser\")\n    song_url_tag = search_soup.select(\"a[href^='/lyrics/']\")\n\n    if not song_url_tag:\n        # song_url_tag being None means no results were found on the\n        # All Results page, therefore, we use `track_search` to\n        # search the tracks page.\n\n        # track_serach being True means we are already searching the tracks page.\n        if track_search:\n            return {}\n\n        return self.get_results(name, artists, track_search=True)\n\n    results: Dict[str, str] = {}\n    for tag in song_url_tag:\n        results[tag.get_text()] = \"https://www.musixmatch.com\" + str(\n            tag.get(\"href\", \"\")\n        )\n\n    return results\n</code></pre>"},{"location":"reference/providers/lyrics/synced/","title":"synced","text":"<p>Synced lyrics provider using the syncedlyrics library</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced","title":"<code>Synced()</code>","text":"<p>               Bases: <code>LyricsProvider</code></p> <p>Lyrics provider for synced lyrics using the syncedlyrics library Currently supported websites: Deezer, NetEase</p> Source code in <code>spotdl/providers/lyrics/base.py</code> <pre><code>def __init__(self):\n    \"\"\"\n    Init the lyrics provider searchand set headers.\n    \"\"\"\n\n    self.headers = {\n        \"Connection\": \"keep-alive\",\n        \"Pragma\": \"no-cache\",\n        \"Cache-Control\": \"no-cache\",\n        \"sec-ch-ua\": '\"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"',\n        \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 \"\n        \"(KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36\",\n        \"Accept\": \"*/*\",\n        \"Sec-Fetch-Site\": \"same-origin\",\n        \"Sec-Fetch-Mode\": \"cors\",\n        \"Sec-Fetch-Dest\": \"empty\",\n        \"Accept-Language\": \"en-US;q=0.8,en;q=0.7\",\n    }\n</code></pre>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.extract_lyrics","title":"<code>extract_lyrics(url, **kwargs)</code>","text":"<p>Extracts the lyrics from the given url.</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.extract_lyrics--arguments","title":"Arguments","text":"<ul> <li>url: The url to extract the lyrics from.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.extract_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def extract_lyrics(self, url: str, **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Extracts the lyrics from the given url.\n\n    ### Arguments\n    - url: The url to extract the lyrics from.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_lyrics","title":"<code>get_lyrics(name, artists, **kwargs)</code>","text":"<p>Try to get lyrics using syncedlyrics</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_lyrics--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_lyrics--returns","title":"Returns","text":"<ul> <li>The lyrics of the song or None if no lyrics were found.</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_lyrics(self, name: str, artists: List[str], **kwargs) -&gt; Optional[str]:\n    \"\"\"\n    Try to get lyrics using syncedlyrics\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - The lyrics of the song or None if no lyrics were found.\n    \"\"\"\n\n    try:\n        lyrics = syncedlyrics.search(\n            f\"{name} - {artists[0]}\",\n            synced_only=not kwargs.get(\"allow_plain_format\", True),\n        )\n        return lyrics\n    except requests.exceptions.SSLError:\n        # Max retries reached\n        return None\n    except TypeError:\n        # Error at syncedlyrics.providers.musixmatch L89 -\n        #   Because `body` is occasionally an empty list instead of a dictionary.\n        # We get this error when allow_plain_format is set to True,\n        #   and there are no synced lyrics present\n        # Because its empty, we know there are no lyrics\n        return None\n</code></pre>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_results","title":"<code>get_results(name, artists, **kwargs)</code>","text":"<p>Returns the results for the given song.</p>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_results--arguments","title":"Arguments","text":"<ul> <li>name: The name of the song.</li> <li>artists: The artists of the song.</li> <li>kwargs: Additional arguments.</li> </ul>"},{"location":"reference/providers/lyrics/synced/#spotdl.providers.lyrics.synced.Synced.get_results--returns","title":"Returns","text":"<ul> <li>A dictionary with the results. (The key is the title and the value is the url.)</li> </ul> Source code in <code>spotdl/providers/lyrics/synced.py</code> <pre><code>def get_results(self, name: str, artists: List[str], **kwargs) -&gt; Dict[str, str]:\n    \"\"\"\n    Returns the results for the given song.\n\n    ### Arguments\n    - name: The name of the song.\n    - artists: The artists of the song.\n    - kwargs: Additional arguments.\n\n    ### Returns\n    - A dictionary with the results. (The key is the title and the value is the url.)\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/types/","title":"types","text":"<p>Types for the spotdl package.</p>"},{"location":"reference/types/album/","title":"album","text":"<p>Artist module for retrieving artist data from Spotify.</p>"},{"location":"reference/types/album/#spotdl.types.album.Album","title":"<code>Album(name, url, urls, songs, artist)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Album class for retrieving album data from Spotify.</p>"},{"location":"reference/types/album/#spotdl.types.album.Album.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for album.</p>"},{"location":"reference/types/album/#spotdl.types.album.Album.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the album.</li> </ul>"},{"location":"reference/types/album/#spotdl.types.album.Album.get_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary with metadata.</li> </ul> Source code in <code>spotdl/types/album.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for album.\n\n    ### Arguments\n    - url: The URL of the album.\n\n    ### Returns\n    - A dictionary with metadata.\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n\n    album_metadata = spotify_client.album(url)\n    if album_metadata is None:\n        raise AlbumError(\n            \"Couldn't get metadata, check if you have passed correct album id\"\n        )\n\n    metadata = {\n        \"name\": album_metadata[\"name\"],\n        \"artist\": album_metadata[\"artists\"][0],\n        \"url\": url,\n    }\n\n    album_response = spotify_client.album_tracks(url)\n    if album_response is None:\n        raise AlbumError(\n            \"Couldn't get metadata, check if you have passed correct album id\"\n        )\n\n    tracks = album_response[\"items\"]\n\n    # Get all tracks from album\n    while album_response[\"next\"]:\n        album_response = spotify_client.next(album_response)\n\n        # Failed to get response, break the loop\n        if album_response is None:\n            break\n\n        tracks.extend(album_response[\"items\"])\n\n    if album_response is None:\n        raise AlbumError(f\"Failed to get album response: {url}\")\n\n    songs = []\n    for track in tracks:\n        if not isinstance(track, dict) or track.get(\"is_local\"):\n            continue\n\n        release_date = album_metadata[\"release_date\"]\n        artists = artists = [artist[\"name\"] for artist in track[\"artists\"]]\n\n        song = Song.from_missing_data(\n            name=track[\"name\"],\n            artists=artists,\n            artist=artists[0],\n            album_id=album_metadata[\"id\"],\n            album_name=album_metadata[\"name\"],\n            album_artist=album_metadata[\"artists\"][0][\"name\"],\n            album_type=album_metadata[\"album_type\"],\n            disc_number=track[\"disc_number\"],\n            disc_count=int(album_metadata[\"tracks\"][\"items\"][-1][\"disc_number\"]),\n            duration=int(track[\"duration_ms\"] / 1000),\n            year=release_date[:4],\n            date=release_date,\n            track_number=track[\"track_number\"],\n            tracks_count=album_metadata[\"total_tracks\"],\n            song_id=track[\"id\"],\n            explicit=track[\"explicit\"],\n            publisher=album_metadata[\"label\"],\n            url=track[\"external_urls\"][\"spotify\"],\n            cover_url=(\n                max(\n                    album_metadata[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"]\n                )[\"url\"]\n                if album_metadata[\"images\"]\n                else None\n            ),\n            copyright_text=(\n                album_metadata[\"copyrights\"][0][\"text\"]\n                if album_metadata[\"copyrights\"]\n                else None\n            ),\n        )\n\n        songs.append(song)\n\n    return metadata, songs\n</code></pre>"},{"location":"reference/types/album/#spotdl.types.album.AlbumError","title":"<code>AlbumError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to albums.</p>"},{"location":"reference/types/artist/","title":"artist","text":"<p>Artist module for retrieving artist data from Spotify.</p>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist","title":"<code>Artist(name, url, urls, songs, genres, albums)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Artist class. Contains all the information about an artist. Frozen to prevent accidental modification.</p>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for artist.</p>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the artist.</li> </ul>"},{"location":"reference/types/artist/#spotdl.types.artist.Artist.get_metadata--returns","title":"Returns","text":"<ul> <li>Dict with metadata for artist.</li> </ul> Source code in <code>spotdl/types/artist.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for artist.\n\n    ### Arguments\n    - url: The URL of the artist.\n\n    ### Returns\n    - Dict with metadata for artist.\n    \"\"\"\n\n    # query spotify for artist details\n    spotify_client = SpotifyClient()\n\n    # get artist info\n    raw_artist_meta = spotify_client.artist(url)\n\n    if raw_artist_meta is None:\n        raise ArtistError(\n            \"Couldn't get metadata, check if you have passed correct artist id\"\n        )\n\n    artist_albums = spotify_client.artist_albums(url, album_type=\"album,single\")\n    # check if there is response\n    if not artist_albums:\n        raise ArtistError(\n            \"Couldn't get albums, check if you have passed correct artist id\"\n        )\n\n    # get artist albums and remove duplicates\n    # duplicates can occur if the artist has the same album available in\n    # different countries\n    albums: List[str] = []\n    known_albums: Set[str] = set()\n    for album in artist_albums[\"items\"]:\n        albums.append(album[\"external_urls\"][\"spotify\"])\n        known_albums.add(slugify(album[\"name\"]))\n\n    # Fetch all artist albums\n    while artist_albums and artist_albums[\"next\"]:\n        artist_albums = spotify_client.next(artist_albums)\n        if artist_albums is None:\n            break\n\n        for album in artist_albums[\"items\"]:\n            album_name = slugify(album[\"name\"])\n\n            if album_name not in known_albums:\n                albums.append(album[\"external_urls\"][\"spotify\"])\n                known_albums.add(album_name)\n\n    songs = []\n    for album in albums:\n        album_obj = Album.from_url(album, fetch_songs=False)\n        songs.extend(album_obj.songs)\n\n    # Very aggressive deduplication\n    songs_list = []\n    songs_names = set()\n    for song in songs:\n        slug_name = slugify(song.name)\n        if song.name not in songs_names:\n            songs_list.append(song)\n            songs_names.add(slug_name)\n\n    metadata = {\n        \"name\": raw_artist_meta[\"name\"],\n        \"genres\": raw_artist_meta[\"genres\"],\n        \"url\": url,\n        \"albums\": albums,\n    }\n\n    return metadata, songs_list\n</code></pre>"},{"location":"reference/types/artist/#spotdl.types.artist.ArtistError","title":"<code>ArtistError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to artists.</p>"},{"location":"reference/types/options/","title":"options","text":"<p>This file contains types for spotdl/downloader/web modules. Options types have all the fields marked as required. Settings types have all the fields marked as optional.</p>"},{"location":"reference/types/options/#spotdl.types.options.DownloaderOptionalOptions","title":"<code>DownloaderOptionalOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Downloader.</p>"},{"location":"reference/types/options/#spotdl.types.options.DownloaderOptions","title":"<code>DownloaderOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Downloader.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotDLOptionalOptions","title":"<code>SpotDLOptionalOptions</code>","text":"<p>               Bases: <code>SpotifyOptionalOptions</code>, <code>DownloaderOptionalOptions</code>, <code>WebOptionalOptions</code></p> <p>Options used for initializing the SpotDL client. This type is modified to not require all the fields.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotDLOptions","title":"<code>SpotDLOptions</code>","text":"<p>               Bases: <code>SpotifyOptions</code>, <code>DownloaderOptions</code>, <code>WebOptions</code></p> <p>Options used for initializing the SpotDL client.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotifyOptionalOptions","title":"<code>SpotifyOptionalOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Spotify client.</p>"},{"location":"reference/types/options/#spotdl.types.options.SpotifyOptions","title":"<code>SpotifyOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Spotify client.</p>"},{"location":"reference/types/options/#spotdl.types.options.WebOptionalOptions","title":"<code>WebOptionalOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Web server.</p>"},{"location":"reference/types/options/#spotdl.types.options.WebOptions","title":"<code>WebOptions</code>","text":"<p>               Bases: <code>TypedDict</code></p> <p>Options used for initializing the Web server.</p>"},{"location":"reference/types/playlist/","title":"playlist","text":"<p>Playlist module for retrieving playlist data from Spotify.</p>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist","title":"<code>Playlist(name, url, urls, songs, description, author_url, author_name, cover_url)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Playlist class for retrieving playlist data from Spotify.</p>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for a playlist.</p>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the playlist.</li> </ul>"},{"location":"reference/types/playlist/#spotdl.types.playlist.Playlist.get_metadata--returns","title":"Returns","text":"<ul> <li>A dictionary with metadata.</li> </ul> Source code in <code>spotdl/types/playlist.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for a playlist.\n\n    ### Arguments\n    - url: The URL of the playlist.\n\n    ### Returns\n    - A dictionary with metadata.\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n\n    playlist = spotify_client.playlist(url)\n    if playlist is None:\n        raise PlaylistError(\"Invalid playlist URL.\")\n\n    metadata = {\n        \"name\": playlist[\"name\"],\n        \"url\": url,\n        \"description\": playlist[\"description\"],\n        \"author_url\": playlist[\"external_urls\"][\"spotify\"],\n        \"author_name\": playlist[\"owner\"][\"display_name\"],\n        \"cover_url\": (\n            max(\n                playlist[\"images\"],\n                key=lambda i: (\n                    0\n                    if i[\"width\"] is None or i[\"height\"] is None\n                    else i[\"width\"] * i[\"height\"]\n                ),\n            )[\"url\"]\n            if (playlist.get(\"images\") is not None and len(playlist[\"images\"]) &gt; 0)\n            else \"\"\n        ),\n    }\n\n    playlist_response = spotify_client.playlist_items(url)\n    if playlist_response is None:\n        raise PlaylistError(f\"Wrong playlist id: {url}\")\n\n    # Get all tracks from playlist\n    tracks = playlist_response[\"items\"]\n    while playlist_response[\"next\"]:\n        playlist_response = spotify_client.next(playlist_response)\n\n        # Failed to get response, break the loop\n        if playlist_response is None:\n            break\n\n        # Add tracks to the list\n        tracks.extend(playlist_response[\"items\"])\n\n    songs = []\n    for track_no, track in enumerate(tracks):\n        if not isinstance(track, dict) or track.get(\"track\") is None:\n            continue\n\n        track_meta = track[\"track\"]\n\n        if track_meta.get(\"is_local\") or track_meta.get(\"type\") != \"track\":\n            logger.warning(\n                \"Skipping track: %s local tracks and %s are not supported\",\n                track_meta.get(\"id\"),\n                track_meta.get(\"type\"),\n            )\n\n            continue\n\n        track_id = track_meta.get(\"id\")\n        if track_id is None or track_meta.get(\"duration_ms\") == 0:\n            continue\n\n        album_meta = track_meta.get(\"album\", {})\n        release_date = album_meta.get(\"release_date\")\n        artists = [artist[\"name\"] for artist in track_meta.get(\"artists\", [])]\n        song = Song.from_missing_data(\n            name=track_meta[\"name\"],\n            artists=artists,\n            artist=artists[0],\n            album_id=album_meta.get(\"id\"),\n            album_name=album_meta.get(\"name\"),\n            album_artist=(\n                album_meta.get(\"artists\", [])[0][\"name\"]\n                if album_meta.get(\"artists\")\n                else None\n            ),\n            album_type=album_meta.get(\"album_type\"),\n            disc_number=track_meta[\"disc_number\"],\n            duration=int(track_meta[\"duration_ms\"] / 1000),\n            year=release_date[:4] if release_date else None,\n            date=release_date,\n            track_number=track_meta[\"track_number\"],\n            tracks_count=album_meta.get(\"total_tracks\"),\n            song_id=track_meta[\"id\"],\n            explicit=track_meta[\"explicit\"],\n            url=track_meta[\"external_urls\"][\"spotify\"],\n            isrc=track_meta.get(\"external_ids\", {}).get(\"isrc\"),\n            cover_url=(\n                max(album_meta[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"])[\n                    \"url\"\n                ]\n                if (len(album_meta.get(\"images\", [])) &gt; 0)\n                else None\n            ),\n            list_position=track_no + 1,\n        )\n\n        songs.append(song)\n\n    return metadata, songs\n</code></pre>"},{"location":"reference/types/playlist/#spotdl.types.playlist.PlaylistError","title":"<code>PlaylistError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to playlists.</p>"},{"location":"reference/types/result/","title":"result","text":"<p>Result is a class that contains all the information about a result from search performed by audio provider.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result","title":"<code>Result(source, url, verified, name, duration, author, result_id, isrc_search=None, search_query=None, artists=None, views=None, explicit=None, album=None, year=None, track_number=None, genre=None, lyrics=None)</code>  <code>dataclass</code>","text":"<p>Result is a class that contains all the information about a result from search perfoermed by audio provider.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.json","title":"<code>json</code>  <code>property</code>","text":"<p>Returns a dictionary of the song's data.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.json--returns","title":"Returns","text":"<ul> <li>The dictionary.</li> </ul>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_data_dump","title":"<code>from_data_dump(data)</code>  <code>classmethod</code>","text":"<p>Create a Result object from a data dump.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_data_dump--arguments","title":"Arguments","text":"<ul> <li>data: The data dump.</li> </ul>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_data_dump--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/result.py</code> <pre><code>@classmethod\ndef from_data_dump(cls, data: str) -&gt; \"Result\":\n    \"\"\"\n    Create a Result object from a data dump.\n\n    ### Arguments\n    - data: The data dump.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Create dict from json string\n    data_dict = json.loads(data)\n\n    # Return product object\n    return cls(**data_dict)\n</code></pre>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_dict","title":"<code>from_dict(data)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a dictionary.</p>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_dict--arguments","title":"Arguments","text":"<ul> <li>data: The dictionary.</li> </ul>"},{"location":"reference/types/result/#spotdl.types.result.Result.from_dict--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/result.py</code> <pre><code>@classmethod\ndef from_dict(cls, data: Dict[str, Any]) -&gt; \"Result\":\n    \"\"\"\n    Create a Song object from a dictionary.\n\n    ### Arguments\n    - data: The dictionary.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Return product object\n    return cls(**data)\n</code></pre>"},{"location":"reference/types/saved/","title":"saved","text":"<p>Saved module for handing the saved tracks from user library</p>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved","title":"<code>Saved(name, url, urls, songs)</code>  <code>dataclass</code>","text":"<p>               Bases: <code>SongList</code></p> <p>Saved class for handling the saved tracks from user library.</p>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved.get_metadata","title":"<code>get_metadata(url='saved')</code>  <code>staticmethod</code>","text":"<p>Returns metadata for a saved list.</p>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: Not required, but used to match the signature of the other get_metadata methods.</li> </ul>"},{"location":"reference/types/saved/#spotdl.types.saved.Saved.get_metadata--returns","title":"Returns","text":"<ul> <li>metadata: A dictionary containing the metadata for the saved list.</li> <li>songs: A list of Song objects.</li> </ul> Source code in <code>spotdl/types/saved.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str = \"saved\") -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Returns metadata for a saved list.\n\n    ### Arguments\n    - url: Not required, but used to match the signature of the other get_metadata methods.\n\n    ### Returns\n    - metadata: A dictionary containing the metadata for the saved list.\n    - songs: A list of Song objects.\n    \"\"\"\n\n    metadata = {\"name\": \"Saved tracks\", \"url\": url}\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SavedError(\"You must be logged in to use this function\")\n\n    saved_tracks_response = spotify_client.current_user_saved_tracks()\n    if saved_tracks_response is None:\n        raise SavedError(\"Couldn't get saved tracks\")\n\n    saved_tracks = saved_tracks_response[\"items\"]\n\n    # Fetch all saved tracks\n    while saved_tracks_response and saved_tracks_response[\"next\"]:\n        response = spotify_client.next(saved_tracks_response)\n        if response is None:\n            break\n\n        saved_tracks_response = response\n        saved_tracks.extend(saved_tracks_response[\"items\"])\n\n    songs = []\n    for track in saved_tracks:\n        if not isinstance(track, dict) or track.get(\"track\", {}).get(\"is_local\"):\n            continue\n\n        track_meta = track[\"track\"]\n        album_meta = track_meta[\"album\"]\n\n        release_date = album_meta[\"release_date\"]\n        artists = artists = [artist[\"name\"] for artist in track_meta[\"artists\"]]\n\n        song = Song.from_missing_data(\n            name=track_meta[\"name\"],\n            artists=artists,\n            artist=artists[0],\n            album_id=album_meta[\"id\"],\n            album_name=album_meta[\"name\"],\n            album_artist=album_meta[\"artists\"][0][\"name\"],\n            album_type=album_meta[\"album_type\"],\n            disc_number=track_meta[\"disc_number\"],\n            duration=int(track_meta[\"duration_ms\"] / 1000),\n            year=release_date[:4],\n            date=release_date,\n            track_number=track_meta[\"track_number\"],\n            tracks_count=album_meta[\"total_tracks\"],\n            song_id=track_meta[\"id\"],\n            explicit=track_meta[\"explicit\"],\n            url=track_meta[\"external_urls\"][\"spotify\"],\n            isrc=track_meta.get(\"external_ids\", {}).get(\"isrc\"),\n            cover_url=(\n                max(album_meta[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"])[\n                    \"url\"\n                ]\n                if album_meta[\"images\"]\n                else None\n            ),\n        )\n\n        songs.append(song)\n\n    return metadata, songs\n</code></pre>"},{"location":"reference/types/saved/#spotdl.types.saved.SavedError","title":"<code>SavedError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to saved tracks.</p>"},{"location":"reference/types/song/","title":"song","text":"<p>Song module that hold the Song and SongList classes.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song","title":"<code>Song(name, artists, artist, genres, disc_number, disc_count, album_name, album_artist, duration, year, date, track_number, tracks_count, song_id, explicit, publisher, url, isrc, cover_url, copyright_text, download_url=None, lyrics=None, popularity=None, album_id=None, list_name=None, list_url=None, list_position=None, list_length=None, artist_id=None, album_type=None)</code>  <code>dataclass</code>","text":"<p>Song class. Contains all the information about a song.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.display_name","title":"<code>display_name</code>  <code>property</code>","text":"<p>Returns a display name for the song.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.display_name--returns","title":"Returns","text":"<ul> <li>The display name.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.json","title":"<code>json</code>  <code>property</code>","text":"<p>Returns a dictionary of the song's data.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.json--returns","title":"Returns","text":"<ul> <li>The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_data_dump","title":"<code>from_data_dump(data)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a data dump.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_data_dump--arguments","title":"Arguments","text":"<ul> <li>data: The data dump.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_data_dump--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_data_dump(cls, data: str) -&gt; \"Song\":\n    \"\"\"\n    Create a Song object from a data dump.\n\n    ### Arguments\n    - data: The data dump.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Create dict from json string\n    data_dict = json.loads(data)\n\n    # Return product object\n    return cls(**data_dict)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_dict","title":"<code>from_dict(data)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a dictionary.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_dict--arguments","title":"Arguments","text":"<ul> <li>data: The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_dict--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_dict(cls, data: Dict[str, Any]) -&gt; \"Song\":\n    \"\"\"\n    Create a Song object from a dictionary.\n\n    ### Arguments\n    - data: The dictionary.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    # Return product object\n    return cls(**data)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_missing_data","title":"<code>from_missing_data(**kwargs)</code>  <code>classmethod</code>","text":"<p>Create a Song object from a dictionary with missing data. For example, data dict doesn't contain all the required attributes for the Song class.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_missing_data--arguments","title":"Arguments","text":"<ul> <li>data: The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_missing_data--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_missing_data(cls, **kwargs) -&gt; \"Song\":\n    \"\"\"\n    Create a Song object from a dictionary with missing data.\n    For example, data dict doesn't contain all the required\n    attributes for the Song class.\n\n    ### Arguments\n    - data: The dictionary.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    song_data: Dict[str, Any] = {}\n    for key in cls.__dataclass_fields__:  # pylint: disable=E1101\n        song_data.setdefault(key, kwargs.get(key))\n\n    return cls(**song_data)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_search_term","title":"<code>from_search_term(search_term)</code>  <code>classmethod</code>","text":"<p>Creates a list of Song objects from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_search_term--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_search_term--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_search_term(cls, search_term: str) -&gt; \"Song\":\n    \"\"\"\n    Creates a list of Song objects from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    raw_search_results = Song.search(search_term)\n\n    if len(raw_search_results[\"tracks\"][\"items\"]) == 0:\n        raise SongError(f\"No results found for: {search_term}\")\n\n    return Song.from_url(\n        \"http://open.spotify.com/track/\"\n        + raw_search_results[\"tracks\"][\"items\"][0][\"id\"]\n    )\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_url","title":"<code>from_url(url)</code>  <code>classmethod</code>","text":"<p>Creates a Song object from a URL.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_url--arguments","title":"Arguments","text":"<ul> <li>url: The URL of the song.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.from_url--returns","title":"Returns","text":"<ul> <li>The Song object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_url(cls, url: str) -&gt; \"Song\":\n    \"\"\"\n    Creates a Song object from a URL.\n\n    ### Arguments\n    - url: The URL of the song.\n\n    ### Returns\n    - The Song object.\n    \"\"\"\n\n    if \"open.spotify.com\" not in url or \"track\" not in url:\n        raise SongError(f\"Invalid URL: {url}\")\n\n    # query spotify for song, artist, album details\n    spotify_client = SpotifyClient()\n\n    # get track info\n    raw_track_meta = spotify_client.track(url)\n\n    if raw_track_meta is None:\n        raise SongError(\n            \"Couldn't get metadata, check if you have passed correct track id\"\n        )\n\n    if raw_track_meta[\"duration_ms\"] == 0 or raw_track_meta[\"name\"].strip() == \"\":\n        raise SongError(f\"Track no longer exists: {url}\")\n\n    # get artist info\n    primary_artist_id = raw_track_meta[\"artists\"][0][\"id\"]\n    raw_artist_meta: Dict[str, Any] = spotify_client.artist(primary_artist_id)  # type: ignore\n\n    # get album info\n    album_id = raw_track_meta[\"album\"][\"id\"]\n    raw_album_meta: Dict[str, Any] = spotify_client.album(album_id)  # type: ignore\n\n    # create song object\n    return cls(\n        name=raw_track_meta[\"name\"],\n        artists=[artist[\"name\"] for artist in raw_track_meta[\"artists\"]],\n        artist=raw_track_meta[\"artists\"][0][\"name\"],\n        artist_id=primary_artist_id,\n        album_id=album_id,\n        album_name=raw_album_meta[\"name\"],\n        album_artist=raw_album_meta[\"artists\"][0][\"name\"],\n        album_type=raw_album_meta.get(\"album_type\"),\n        copyright_text=(\n            raw_album_meta[\"copyrights\"][0][\"text\"]\n            if raw_album_meta[\"copyrights\"]\n            else None\n        ),\n        genres=raw_album_meta[\"genres\"] + raw_artist_meta[\"genres\"],\n        disc_number=raw_track_meta[\"disc_number\"],\n        disc_count=int(raw_album_meta[\"tracks\"][\"items\"][-1][\"disc_number\"]),\n        duration=int(raw_track_meta[\"duration_ms\"] / 1000),\n        year=int(raw_album_meta[\"release_date\"][:4]),\n        date=raw_album_meta[\"release_date\"],\n        track_number=raw_track_meta[\"track_number\"],\n        tracks_count=raw_album_meta[\"total_tracks\"],\n        isrc=raw_track_meta.get(\"external_ids\", {}).get(\"isrc\"),\n        song_id=raw_track_meta[\"id\"],\n        explicit=raw_track_meta[\"explicit\"],\n        publisher=raw_album_meta[\"label\"],\n        url=raw_track_meta[\"external_urls\"][\"spotify\"],\n        popularity=raw_track_meta[\"popularity\"],\n        cover_url=(\n            max(raw_album_meta[\"images\"], key=lambda i: i[\"width\"] * i[\"height\"])[\n                \"url\"\n            ]\n            if raw_album_meta[\"images\"]\n            else None\n        ),\n    )\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.list_from_search_term","title":"<code>list_from_search_term(search_term)</code>  <code>classmethod</code>","text":"<p>Creates a list of Song objects from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.list_from_search_term--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.list_from_search_term--returns","title":"Returns","text":"<ul> <li>The list of Song objects.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef list_from_search_term(cls, search_term: str) -&gt; \"List[Song]\":\n    \"\"\"\n    Creates a list of Song objects from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The list of Song objects.\n    \"\"\"\n\n    raw_search_results = Song.search(search_term)\n\n    songs = []\n    for idx, _ in enumerate(raw_search_results.get(\"tracks\", []).get(\"items\", [])):\n        songs.append(\n            Song.from_url(\n                \"http://open.spotify.com/track/\"\n                + raw_search_results[\"tracks\"][\"items\"][idx][\"id\"]\n            )\n        )\n\n    return songs\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.Song.search","title":"<code>search(search_term)</code>  <code>staticmethod</code>","text":"<p>Searches for Songs from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.Song.search--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.Song.search--returns","title":"Returns","text":"<ul> <li>The raw search results</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@staticmethod\ndef search(search_term: str):\n    \"\"\"\n    Searches for Songs from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The raw search results\n    \"\"\"\n    spotify_client = SpotifyClient()\n    raw_search_results = spotify_client.search(search_term)\n\n    if raw_search_results is None:\n        raise SongError(f\"Spotipy error, no response: {search_term}\")\n\n    return raw_search_results\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongError","title":"<code>SongError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to songs.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList","title":"<code>SongList(name, url, urls, songs)</code>  <code>dataclass</code>","text":"<p>SongList class. Base class for all other song lists subclasses.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.json","title":"<code>json</code>  <code>property</code>","text":"<p>Returns a dictionary of the song list's data.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.json--returns","title":"Returns","text":"<ul> <li>The dictionary.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.length","title":"<code>length</code>  <code>property</code>","text":"<p>Get list length (number of songs).</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.length--returns","title":"Returns","text":"<ul> <li>The list length.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_search_term","title":"<code>from_search_term(search_term, fetch_songs=True)</code>  <code>classmethod</code>","text":"<p>Creates a SongList object from a search term.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_search_term--arguments","title":"Arguments","text":"<ul> <li>search_term: The search term to use.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_search_term--returns","title":"Returns","text":"<ul> <li>The SongList object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_search_term(cls, search_term: str, fetch_songs: bool = True):\n    \"\"\"\n    Creates a SongList object from a search term.\n\n    ### Arguments\n    - search_term: The search term to use.\n\n    ### Returns\n    - The SongList object.\n    \"\"\"\n\n    list_type = cls.__name__.lower()\n    spotify_client = SpotifyClient()\n    raw_search_results = spotify_client.search(search_term, type=list_type)\n\n    if (\n        raw_search_results is None\n        or len(raw_search_results.get(f\"{list_type}s\", {}).get(\"items\", [])) == 0\n    ):\n        raise SongListError(\n            f\"No {list_type} matches found on spotify for '{search_term}'\"\n        )\n\n    matches = {}\n    for result in raw_search_results[f\"{list_type}s\"][\"items\"]:\n        score = fuzz.ratio(search_term.split(\":\", 1)[1].strip(), result[\"name\"])\n        matches[result[\"id\"]] = score\n\n    best_match = max(matches, key=matches.get)  # type: ignore\n\n    return cls.from_url(\n        f\"http://open.spotify.com/{list_type}/{best_match}\",\n        fetch_songs,\n    )\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_url","title":"<code>from_url(url, fetch_songs=True)</code>  <code>classmethod</code>","text":"<p>Create a SongList object from a url.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_url--arguments","title":"Arguments","text":"<ul> <li>url: The url of the list.</li> <li>fetch_songs: Whether to fetch missing metadata for songs.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.from_url--returns","title":"Returns","text":"<ul> <li>The SongList object.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@classmethod\ndef from_url(cls, url: str, fetch_songs: bool = True):\n    \"\"\"\n    Create a SongList object from a url.\n\n    ### Arguments\n    - url: The url of the list.\n    - fetch_songs: Whether to fetch missing metadata for songs.\n\n    ### Returns\n    - The SongList object.\n    \"\"\"\n\n    metadata, songs = cls.get_metadata(url)\n    urls = [song.url for song in songs]\n\n    if fetch_songs:\n        songs = [Song.from_url(song.url) for song in songs]\n\n    return cls(**metadata, urls=urls, songs=songs)\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongList.get_metadata","title":"<code>get_metadata(url)</code>  <code>staticmethod</code>","text":"<p>Get metadata for a song list.</p>"},{"location":"reference/types/song/#spotdl.types.song.SongList.get_metadata--arguments","title":"Arguments","text":"<ul> <li>url: The url of the song list.</li> </ul>"},{"location":"reference/types/song/#spotdl.types.song.SongList.get_metadata--returns","title":"Returns","text":"<ul> <li>The metadata.</li> </ul> Source code in <code>spotdl/types/song.py</code> <pre><code>@staticmethod\ndef get_metadata(url: str) -&gt; Tuple[Dict[str, Any], List[Song]]:\n    \"\"\"\n    Get metadata for a song list.\n\n    ### Arguments\n    - url: The url of the song list.\n\n    ### Returns\n    - The metadata.\n    \"\"\"\n\n    raise NotImplementedError\n</code></pre>"},{"location":"reference/types/song/#spotdl.types.song.SongListError","title":"<code>SongListError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to song lists.</p>"},{"location":"reference/utils/","title":"utils","text":"<p>Utility functions for spotdl. These functions are used in every stage of the download process.</p>"},{"location":"reference/utils/archive/","title":"archive","text":"<p>Module for archiving sets of data</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive","title":"<code>Archive</code>","text":"<p>               Bases: <code>Set</code></p> <p>Archive class. A file-persistable set.</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.load","title":"<code>load(file)</code>","text":"<p>Imports the archive from the file.</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.load--arguments","title":"Arguments","text":"<ul> <li>file: the file name of the archive</li> </ul>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.load--returns","title":"Returns","text":"<ul> <li>if the file exists</li> </ul> Source code in <code>spotdl/utils/archive.py</code> <pre><code>def load(self, file: str) -&gt; bool:\n    \"\"\"\n    Imports the archive from the file.\n\n    ### Arguments\n    - file: the file name of the archive\n\n    ### Returns\n    - if the file exists\n    \"\"\"\n\n    if not Path(file).exists():\n        return False\n\n    with open(file, \"r\", encoding=\"utf-8\") as archive:\n        self.clear()\n        self.update([line.strip() for line in archive])\n\n    return True\n</code></pre>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.save","title":"<code>save(file)</code>","text":"<p>Exports the current archive to the file.</p>"},{"location":"reference/utils/archive/#spotdl.utils.archive.Archive.save--arguments","title":"Arguments","text":"<ul> <li>file: the file name of the archive</li> </ul> Source code in <code>spotdl/utils/archive.py</code> <pre><code>def save(self, file: str) -&gt; bool:\n    \"\"\"\n    Exports the current archive to the file.\n\n    ### Arguments\n    - file: the file name of the archive\n    \"\"\"\n\n    with open(file, \"w\", encoding=\"utf-8\") as archive:\n        for element in sorted(self):\n            archive.write(f\"{element}\\n\")\n\n    return True\n</code></pre>"},{"location":"reference/utils/arguments/","title":"arguments","text":"<p>Module that handles the command line arguments.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.SmartFormatter","title":"<code>SmartFormatter</code>","text":"<p>               Bases: <code>HelpFormatter</code></p> <p>Class that overrides the default help formatter.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.create_parser","title":"<code>create_parser()</code>","text":"<p>Parse arguments from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.create_parser--returns","title":"Returns","text":"<ul> <li>A Namespace object containing the parsed arguments.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def create_parser() -&gt; ArgumentParser:\n    \"\"\"\n    Parse arguments from the command line.\n\n    ### Returns\n    - A Namespace object containing the parsed arguments.\n    \"\"\"\n\n    # Initialize argument parser\n    parser = ArgumentParser(\n        prog=\"spotdl\",\n        description=\"Download your Spotify playlists and songs along with album art and metadata\",\n        formatter_class=SmartFormatter,\n        epilog=(\n            \"For more information, visit http://spotdl.rtfd.io/ \"\n            \"or join our Discord server: https://discord.com/invite/xCa23pwJWY\"\n        ),\n    )\n\n    # Parse main options\n    main_options = parser.add_argument_group(\"Main options\")\n    parse_main_options(main_options)\n\n    # Parse spotify options\n    spotify_options = parser.add_argument_group(\"Spotify options\")\n    parse_spotify_options(spotify_options)\n\n    # Parse ffmpeg options\n    ffmpeg_options = parser.add_argument_group(\"FFmpeg options\")\n    parse_ffmpeg_options(ffmpeg_options)\n\n    # Parse output options\n    output_options = parser.add_argument_group(\"Output options\")\n    parse_output_options(output_options)\n\n    # Parse web options\n    web_options = parser.add_argument_group(\"Web options\")\n    parse_web_options(web_options)\n\n    # Parse misc options\n    misc_options = parser.add_argument_group(\"Misc options\")\n    parse_misc_options(misc_options)\n\n    # Parse other options\n    other_options = parser.add_argument_group(\"Other options\")\n    parse_other_options(other_options)\n\n    return parser\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_arguments","title":"<code>parse_arguments()</code>","text":"<p>Parse arguments from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_arguments--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to parse the arguments from.</li> </ul>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_arguments--returns","title":"Returns","text":"<ul> <li>A Namespace object containing the parsed arguments.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_arguments() -&gt; Namespace:\n    \"\"\"\n    Parse arguments from the command line.\n\n    ### Arguments\n    - parser: The argument parser to parse the arguments from.\n\n    ### Returns\n    - A Namespace object containing the parsed arguments.\n    \"\"\"\n\n    # Create parser\n    parser = create_parser()\n\n    # Parse arguments\n    return parser.parse_args()\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_ffmpeg_options","title":"<code>parse_ffmpeg_options(parser)</code>","text":"<p>Parse ffmpeg options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_ffmpeg_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_ffmpeg_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse ffmpeg options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add ffmpeg executable argument\n    parser.add_argument(\n        \"--ffmpeg\",\n        help=\"The ffmpeg executable to use.\",\n        type=str,\n    )\n\n    # Add search threads argument\n    parser.add_argument(\n        \"--threads\",\n        type=int,\n        help=\"The number of threads to use when downloading songs.\",\n    )\n\n    # Add constant bit rate argument\n    parser.add_argument(\n        \"--bitrate\",\n        choices=[\n            \"auto\",\n            \"disable\",\n            \"8k\",\n            \"16k\",\n            \"24k\",\n            \"32k\",\n            \"40k\",\n            \"48k\",\n            \"64k\",\n            \"80k\",\n            \"96k\",\n            \"112k\",\n            \"128k\",\n            \"160k\",\n            \"192k\",\n            \"224k\",\n            \"256k\",\n            \"320k\",\n        ]\n        + list(map(str, range(0, 10))),\n        type=str.lower,\n        help=(\n            \"The constant/variable bitrate to use for the output file. \"\n            \"Values from 0 to 9 are variable bitrates. \"\n            \"Auto will use the bitrate of the original file. \"\n            \"Disable will disable the bitrate option. \"\n            \"(In case of m4a and opus files, auto and disable will skip the conversion)\"\n        ),\n    )\n\n    # Additional ffmpeg arguments\n    parser.add_argument(\n        \"--ffmpeg-args\",\n        type=str,\n        help=\"Additional ffmpeg arguments passed as a string.\",\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_main_options","title":"<code>parse_main_options(parser)</code>","text":"<p>Parse main options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_main_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_main_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse main options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add operation argument\n    operation = parser.add_argument(\n        \"operation\",\n        choices=OPERATIONS,\n        default=\"download\",\n        const=\"download\",\n        nargs=\"?\",\n        help=(\n            \"N|The operation to perform.\\n\"\n            \"download: Download the songs to the disk and embed metadata.\\n\"\n            \"save: Saves the songs metadata to a file for further use.\\n\"\n            \"web: Starts a web interface to simplify the download process.\\n\"\n            \"sync: Removes songs that are no longer present, downloads new ones\\n\"\n            \"meta: Update your audio files with metadata\\n\"\n            \"url: Get the download URL for songs\\n\\n\"\n        ),\n    )\n\n    # Add query argument\n    query = parser.add_argument(\n        \"query\",\n        nargs=\"+\",\n        type=str,\n        help=(\n            \"N|Spotify/YouTube URL for a song/playlist/album/artist/etc. to download.\\n\\n\"\n            \"For album/playlist/artist searching, include 'album:', 'playlist:', 'artist:' \\n\"\n            \"(ie. 'album:the album name' you can mix these options to get more accurate results)\"\n            \".\\n\\n\"\n            \"To download liked songs use 'saved' as the query, to download all user playlists\\n\"\n            \"use 'all-user-playlists, to download playlists that the user has created\\n\"\n            \"use 'all-saved-playlists', to download all user liked playlists\\n\"\n            \"use 'all-user-followed-artists', to download all user saved albums \"\n            \"use 'all-user-saved-albums' \\n\\n\"\n            \"For manual audio matching, you can use the format 'YouTubeURL|SpotifyURL'\\n\"\n            \"You can only use album/playlist/tracks urls when \"\n            \"downloading/matching youtube urls.\\n\"\n            \"When using youtube url without spotify url, \"\n            \"you won't be able to use `--fetch-albums` option.\\n\\n\"\n        ),\n    )\n\n    try:\n        is_web = sys.argv[1] == \"web\"\n    except IndexError:\n        is_web = False\n\n    is_frozen = getattr(sys, \"frozen\", False)\n\n    # If the program is frozen, we and user didn't pass any arguments,\n    # or if the user is using the web interface, we don't need to parse\n    # the query\n    if (is_frozen and len(sys.argv) &lt; 2) or (len(sys.argv) &gt; 1 and is_web):\n        # If we are running the web interface\n        # or we are in the frozen env and not running web interface\n        # don't remove the operation from the arg parser\n        if not is_web or (is_frozen and not is_web):\n            parser._remove_action(operation)  # pylint: disable=protected-access\n\n        parser._remove_action(query)  # pylint: disable=protected-access\n\n    # Audio provider argument\n    parser.add_argument(\n        \"--audio\",\n        dest=\"audio_providers\",\n        nargs=\"*\",\n        choices=AUDIO_PROVIDERS,\n        help=\"The audio provider to use. You can provide more than one for fallback.\",\n    )\n\n    # Lyrics provider argument\n    parser.add_argument(\n        \"--lyrics\",\n        dest=\"lyrics_providers\",\n        nargs=\"*\",\n        choices=LYRICS_PROVIDERS.keys(),\n        help=(\n            \"The lyrics provider to use. You can provide more than one for fallback. \"\n            \"Synced lyrics might not work correctly with some music players. \"\n            \"For such cases it's better to use `--generate-lrc` option.\"\n        ),\n    )\n\n    parser.add_argument(\n        \"--genius-access-token\",\n        dest=\"genius_token\",\n        help=\"Lets you choose your own Genius access token.\",\n    )\n\n    # Add config argument\n    parser.add_argument(\n        \"--config\",\n        action=\"store_true\",\n        help=(\n            \"Use the config file to download songs. \"\n            \"It's located under C:\\\\Users\\\\user\\\\.spotdl\\\\config.json \"\n            \"or ~/.spotdl/config.json under linux\"\n        ),\n    )\n\n    # Add search query argument\n    parser.add_argument(\n        \"--search-query\",\n        help=f\"The search query to use, available variables: {', '.join(VARS)}\",\n        type=str,\n    )\n\n    # Add don't filter results argument\n    parser.add_argument(\n        \"--dont-filter-results\",\n        dest=\"filter_results\",\n        action=\"store_const\",\n        const=False,\n        help=\"Disable filtering results.\",\n    )\n\n    # Add use only verified results argument\n    parser.add_argument(\n        \"--album-type\",\n        choices={\"album\", \"single\"},\n        help=\"Type of the album to search for. (album, single)\",\n        type=str,\n    )\n\n    # Add use only verified results argument\n    parser.add_argument(\n        \"--only-verified-results\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use only verified results. (Not all providers support this)\",\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_misc_options","title":"<code>parse_misc_options(parser)</code>","text":"<p>Parse misc options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_misc_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_misc_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse misc options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add verbose argument\n    parser.add_argument(\n        \"--log-level\",\n        choices=NAME_TO_LEVEL.keys(),\n        help=\"Select log level.\",\n    )\n\n    # Add simple tui argument\n    parser.add_argument(\n        \"--simple-tui\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use a simple tui.\",\n    )\n\n    # Add log format argument\n    parser.add_argument(\n        \"--log-format\",\n        help=(\n            \"Custom logging format to use. More info: \"\n            \"https://docs.python.org/3/library/logging.html#logrecord-attributes\"\n        ),\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_other_options","title":"<code>parse_other_options(parser)</code>","text":"<p>Parse other options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_other_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_other_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse other options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    parser.add_argument(\n        \"--download-ffmpeg\",\n        action=\"store_true\",\n        help=\"Download ffmpeg to spotdl directory.\",\n    )\n\n    parser.add_argument(\n        \"--generate-config\",\n        action=\"store_true\",\n        help=\"Generate a config file. This will overwrite current config if present.\",\n    )\n\n    parser.add_argument(\n        \"--check-for-updates\", action=\"store_true\", help=\"Check for new version.\"\n    )\n\n    parser.add_argument(\n        \"--profile\",\n        action=\"store_true\",\n        help=\"Run in profile mode. Useful for debugging.\",\n    )\n\n    parser.add_argument(\n        \"--version\",\n        \"-v\",\n        action=\"version\",\n        help=\"Show the version number and exit.\",\n        version=_version.__version__,\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_output_options","title":"<code>parse_output_options(parser)</code>","text":"<p>Parse output options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_output_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_output_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse output options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add output format argument\n    parser.add_argument(\n        \"--format\",\n        choices=FFMPEG_FORMATS.keys(),\n        help=\"The format to download the song in.\",\n        type=str,\n    )\n\n    # Add save file argument\n    parser.add_argument(\n        \"--save-file\",\n        type=str,\n        help=(\n            \"The file to save/load the songs data from/to. \"\n            \"It has to end with .spotdl. \"\n            \"If combined with the download operation, it will save the songs data to the file. \"\n            \"Required for save/sync (use - to print to stdout when using save). \"\n        ),\n        required=len(sys.argv) &gt; 1 and sys.argv[1] in [\"save\"],\n    )\n\n    # Add preload argument\n    parser.add_argument(\n        \"--preload\",\n        action=\"store_const\",\n        const=True,\n        help=\"Preload the download url to speed up the download process.\",\n    )\n\n    # Add name format argument\n    parser.add_argument(\n        \"--output\",\n        type=str,\n        help=f\"Specify the downloaded file name format, available variables: {', '.join(VARS)}\",\n    )\n\n    # Add m3u argument\n    parser.add_argument(\n        \"--m3u\",\n        type=str,\n        nargs=\"?\",\n        help=(\n            \"Name of the m3u file to save the songs to. \"\n            \"Defaults to {list[0]}.m3u8 \"\n            \"If you want to generate a m3u for each list in the query use {list}, \"\n            \"If you want to generate a m3u file based on the first list in the query use {list[0]}\"\n            \", (0 is the first list in the query, 1 is the second, etc. \"\n            \"songs don't count towards the list number) \"\n        ),\n        const=\"{list[0]}.m3u8\",\n    )\n\n    # Add cookie file argument\n    parser.add_argument(\n        \"--cookie-file\",\n        help=\"Path to cookies file.\",\n        type=str,\n    )\n\n    # Add overwrite argument\n    parser.add_argument(\n        \"--overwrite\",\n        choices={\"force\", \"skip\", \"metadata\"},\n        help=(\n            \"How to handle existing/duplicate files. \"\n            \"(When combined with --scan-for-songs force will remove \"\n            \"all duplicates, and metadata will only apply metadata to the \"\n            \"latest song and will remove the rest. )\"\n        ),\n        type=str,\n    )\n\n    # Option to increase compatibility of filenames and easier handling in the shell\n    parser.add_argument(\n        \"--restrict\",\n        choices={\"strict\", \"ascii\", \"none\"},\n        const=\"strict\",\n        nargs=\"?\",\n        help=\"Restrict filenames to a sanitized set of characters for better compatibility\",\n        type=str,\n    )\n\n    # Option to print errors on exit, useful for long playlist\n    parser.add_argument(\n        \"--print-errors\",\n        action=\"store_const\",\n        const=True,\n        help=\"Print errors (wrong songs, failed downloads etc) on exit, useful for long playlist\",\n    )\n\n    # Option to save errors to a file\n    parser.add_argument(\n        \"--save-errors\",\n        type=str,\n        help=\"Save errors (wrong songs, failed downloads etc) to a file\",\n    )\n\n    # Option to use sponsor block\n    parser.add_argument(\n        \"--sponsor-block\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use the sponsor block to download songs from yt/ytm.\",\n    )\n\n    # Add archive_file argument\n    parser.add_argument(\n        \"--archive\",\n        type=str,\n        help=\"Specify the file name for an archive of already downloaded songs\",\n    )\n\n    # Option to set the track number &amp; album of tracks in a playlist to their index in the playlist\n    # &amp; the name of playlist respectively.\n    parser.add_argument(\n        \"--playlist-numbering\",\n        action=\"store_const\",\n        dest=\"playlist_numbering\",\n        const=True,\n        help=\"Sets each track in a playlist to have the playlist's name as its album,\\\n            and album art as the playlist's icon\",\n    )\n\n    # Option to set the track number &amp; album of tracks, while retaining album art of each track, in\n    # a playlist to their index in the playlist &amp; the name of playlist respectively.\n    parser.add_argument(\n        \"--playlist-retain-track-cover\",\n        action=\"store_const\",\n        dest=\"playlist_retain_track_cover\",\n        const=True,\n        help=\"Sets each track in a playlist to have the playlist's name as its album,\\\n            while retaining album art of each track\",\n    )\n\n    # Option to scan the output directory for existing files\n    parser.add_argument(\n        \"--scan-for-songs\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Scan the output directory for existing files. \"\n            \"This option should be combined with the --overwrite option \"\n            \"to control how existing files are handled. (Output directory is the last directory \"\n            \"that is not a template variable in the output template)\"\n        ),\n    )\n\n    # Option to fetch all albums from songs in query\n    parser.add_argument(\n        \"--fetch-albums\",\n        action=\"store_const\",\n        const=True,\n        help=\"Fetch all albums from songs in query\",\n    )\n\n    # Option to change the id3 separator\n    parser.add_argument(\n        \"--id3-separator\",\n        type=str,\n        help=\"Change the separator used in the id3 tags. Only supported for mp3 files.\",\n    )\n\n    # Option to use ytm data instead of spotify data\n    # when downloading using ytm link\n    parser.add_argument(\n        \"--ytm-data\",\n        action=\"store_const\",\n        const=True,\n        help=\"Use ytm data instead of spotify data when downloading using ytm link.\",\n    )\n\n    # Option whether to add unavailable songs to the m3u file\n    parser.add_argument(\n        \"--add-unavailable\",\n        action=\"store_const\",\n        const=True,\n        help=\"Add unavailable songs to the m3u/archive files when downloading\",\n    )\n\n    # Generate lrc files\n    parser.add_argument(\n        \"--generate-lrc\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Generate lrc files for downloaded songs. \"\n            \"Requires `synced` provider to be present in the lyrics providers list.\"\n        ),\n    )\n\n    # Force update metadata\n    parser.add_argument(\n        \"--force-update-metadata\",\n        action=\"store_const\",\n        const=True,\n        help=\"Force update metadata for songs that already have metadata.\",\n    )\n\n    # Sync without deleting\n    parser.add_argument(\n        \"--sync-without-deleting\",\n        action=\"store_const\",\n        const=True,\n        help=\"Sync without deleting songs that are not in the query.\",\n    )\n\n    # Max file name length\n    parser.add_argument(\n        \"--max-filename-length\",\n        type=int,\n        help=(\n            \"Max file name length. \"\n            \"(This won't override the max file name length enforced by the OS)\"\n        ),\n    )\n\n    # YT-DlP options\n    parser.add_argument(\n        \"--yt-dlp-args\",\n        type=str,\n        help=\"Arguments to pass to yt-dlp\",\n    )\n\n    # Detect formats option\n    parser.add_argument(\n        \"--detect-formats\",\n        type=str,\n        nargs=\"*\",\n        help=(\n            \"Detect already downloaded songs with file format different from the --format option \"\n            \"(When combined with --m3u option, \"\n            \"only first detected format will be added to m3u file)\"\n        ),\n        choices=FFMPEG_FORMATS.keys(),\n    )\n\n    # download song in meta operation\n    parser.add_argument(\n        \"--redownload\",\n        action=\"store_const\",\n        const=True,\n        help=\"to redownload the local song in diffrent format using --format for meta operation\",\n    )\n\n    # skip album art for meta operation\n    parser.add_argument(\n        \"--skip-album-art\",\n        action=\"store_const\",\n        const=True,\n        help=\"skip downloading album art for meta operation\",\n    )\n\n    # Ignore songs from a paticular album\n    parser.add_argument(\n        \"--ignore-albums\",\n        type=str,\n        nargs=\"*\",\n        help=\"ignores the song of the given albums\",\n    )\n\n    # Skip explicit songs options\n    parser.add_argument(\n        \"--skip-explicit\", action=\"store_const\", const=True, help=\"Skip explicit songs\"\n    )\n\n    parser.add_argument(\n        \"--proxy\",\n        help=\"Http(s) proxy server for download song. Example: http://host:port\",\n    )\n\n    # Skip songs having a skip flag file\n    parser.add_argument(\n        \"--create-skip-file\",\n        action=\"store_const\",\n        const=True,\n        help=\"Create skip file for successfully downloaded file\",\n    )\n\n    # Skip songs having a skip flag file\n    parser.add_argument(\n        \"--respect-skip-file\",\n        action=\"store_const\",\n        const=True,\n        help=\"If a file with the extension .skip exists, skip download\",\n    )\n\n    # Sync remove lrc files\n    parser.add_argument(\n        \"--sync-remove-lrc\",\n        action=\"store_const\",\n        const=True,\n        help=\"Remove lrc files when using sync operation when downloading songs\",\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_spotify_options","title":"<code>parse_spotify_options(parser)</code>","text":"<p>Parse spotify options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_spotify_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_spotify_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse spotify options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add login argument\n    parser.add_argument(\n        \"--user-auth\",\n        action=\"store_const\",\n        const=True,\n        help=\"Login to Spotify using OAuth.\",\n    )\n\n    # Add client id argument\n    parser.add_argument(\n        \"--client-id\",\n        help=\"The client id to use when logging in to Spotify.\",\n        type=str,\n    )\n\n    # Add client secret argument\n    parser.add_argument(\n        \"--client-secret\",\n        help=\"The client secret to use when logging in to Spotify.\",\n        type=str,\n    )\n\n    # Add auth token argument\n    parser.add_argument(\n        \"--auth-token\",\n        help=\"The authorization token to use directly to log in to Spotify.\",\n        type=str,\n    )\n\n    # Add cache path argument\n    parser.add_argument(\n        \"--cache-path\",\n        type=str,\n        help=\"The path where spotipy cache file will be stored.\",\n    )\n\n    # Add no cache argument\n    parser.add_argument(\n        \"--no-cache\",\n        action=\"store_const\",\n        const=True,\n        help=\"Disable caching (both requests and token).\",\n    )\n\n    # Add max retries argument\n    parser.add_argument(\n        \"--max-retries\",\n        type=int,\n        help=\"The maximum number of retries to perform when getting metadata.\",\n    )\n\n    # Add headless argument\n    parser.add_argument(\n        \"--headless\",\n        action=\"store_const\",\n        const=True,\n        help=\"Run in headless mode.\",\n    )\n\n    # Add use cache file argument\n    parser.add_argument(\n        \"--use-cache-file\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Use the cache file to get metadata. \"\n            \"It's located under C:\\\\Users\\\\user\\\\.spotdl\\\\.spotify_cache \"\n            \"or ~/.spotdl/.spotify_cache under linux. \"\n            \"It only caches tracks and \"\n            \"gets updated whenever spotDL gets metadata from Spotify. \"\n            \"(It may provide outdated metadata use with caution)\"\n        ),\n    )\n</code></pre>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_web_options","title":"<code>parse_web_options(parser)</code>","text":"<p>Parse web options from the command line.</p>"},{"location":"reference/utils/arguments/#spotdl.utils.arguments.parse_web_options--arguments","title":"Arguments","text":"<ul> <li>parser: The argument parser to add the options to.</li> </ul> Source code in <code>spotdl/utils/arguments.py</code> <pre><code>def parse_web_options(parser: _ArgumentGroup):\n    \"\"\"\n    Parse web options from the command line.\n\n    ### Arguments\n    - parser: The argument parser to add the options to.\n    \"\"\"\n\n    # Add host argument\n    parser.add_argument(\n        \"--host\",\n        type=str,\n        help=\"The host to use for the web server.\",\n    )\n\n    # Add port argument\n    parser.add_argument(\n        \"--port\",\n        type=int,\n        help=\"The port to run the web server on.\",\n    )\n\n    # Add keep alive argument\n    parser.add_argument(\n        \"--keep-alive\",\n        action=\"store_const\",\n        const=True,\n        help=\"Keep the web server alive even when no clients are connected.\",\n    )\n\n    # Add allowed origins argument\n    parser.add_argument(\n        \"--allowed-origins\",\n        nargs=\"*\",\n        help=\"The allowed origins for the web server.\",\n    )\n\n    # Add use output directory argument\n    parser.add_argument(\n        \"--web-use-output-dir\",\n        action=\"store_const\",\n        const=True,\n        help=(\n            \"Use the output directory instead of the session directory for downloads. (\"\n            \"This might cause issues if you have multiple users using the web-ui at the same time)\"\n        ),\n    )\n\n    # Add keep sessions argument\n    parser.add_argument(\n        \"--keep-sessions\",\n        action=\"store_const\",\n        const=True,\n        help=\"Keep the session directory after the web server is closed.\",\n    )\n\n    # Add keep sessions argument\n    parser.add_argument(\n        \"--force-update-gui\",\n        action=\"store_const\",\n        const=True,\n        default=False,\n        help=\"Refresh the web server directory with a fresh git checkout\",\n    )\n\n    # Add custom web gui repo\n    parser.add_argument(\n        \"--web-gui-repo\",\n        type=str,\n        help=(\n            \"Custom web gui repo to use for the web server. \"\n            \"Example: /~https://github.com/spotdl/web-ui/tree/master/dist\"\n        ),\n    )\n\n    # Add custom web gui repo\n    parser.add_argument(\n        \"--web-gui-location\",\n        type=str,\n        help=\"Path to the web gui directory to use for the web server.\",\n    )\n\n    # Enable TLS for the web server\n    parser.add_argument(\n        \"--enable-tls\",\n        action=\"store_const\",\n        const=True,\n        help=\"Enable TLS on the web server.\",\n    )\n\n    # Add File Location of the TLS Certificate file (Pem Format)\n    parser.add_argument(\n        \"--cert-file\", type=str, help=\"File Path to the TLS Certificate (PEM format).\"\n    )\n\n    # Add File Location of the TLS Private Key file (Pem Format)\n    parser.add_argument(\n        \"--key-file\", type=str, help=\"File Path to the TLS Private Key (PEM format).\"\n    )\n\n    # Add File Location of the TLS Certificate Authority file (Pem Format)\n    parser.add_argument(\n        \"--ca-file\",\n        type=str,\n        help=\"File Path to the TLS Certificate Authority File (PEM format).\",\n    )\n</code></pre>"},{"location":"reference/utils/config/","title":"config","text":"<p>Module related to managing reading and writing to the config file.</p> <p>Default config - spotdl.utils.config.DEFAULT_CONFIG</p>"},{"location":"reference/utils/config/#spotdl.utils.config.ConfigError","title":"<code>ConfigError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to config.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.GlobalConfig","title":"<code>GlobalConfig</code>","text":"<p>Class to store global configuration</p>"},{"location":"reference/utils/config/#spotdl.utils.config.GlobalConfig.get_parameter","title":"<code>get_parameter(key)</code>  <code>classmethod</code>","text":"<p>Get a parameter from the download config</p> Source code in <code>spotdl/utils/config.py</code> <pre><code>@classmethod\ndef get_parameter(cls, key):\n    \"\"\"\n    Get a parameter from the download config\n    \"\"\"\n\n    return cls.parameters.get(key, None)\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.GlobalConfig.set_parameter","title":"<code>set_parameter(key, value)</code>  <code>classmethod</code>","text":"<p>Set a parameter for the download config</p> Source code in <code>spotdl/utils/config.py</code> <pre><code>@classmethod\ndef set_parameter(cls, key, value):\n    \"\"\"\n    Set a parameter for the download config\n    \"\"\"\n\n    cls.parameters[key] = value\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings","title":"<code>create_settings(arguments)</code>","text":"<p>Create settings dicts for Spotify, Downloader and Web based on the arguments and config file (if enabled)</p>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings--arguments","title":"Arguments","text":"<ul> <li>arguments: Namespace from argparse</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings--returns","title":"Returns","text":"<ul> <li>spotify_options: SpotifyOptions</li> <li>downloader_options: DownloaderOptions</li> <li>web_options: WebOptions</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def create_settings(\n    arguments: Namespace,\n) -&gt; Tuple[SpotifyOptions, DownloaderOptions, WebOptions]:\n    \"\"\"\n    Create settings dicts for Spotify, Downloader and Web\n    based on the arguments and config file (if enabled)\n\n    ### Arguments\n    - arguments: Namespace from argparse\n\n    ### Returns\n    - spotify_options: SpotifyOptions\n    - downloader_options: DownloaderOptions\n    - web_options: WebOptions\n    \"\"\"\n\n    # Get the config file\n    # It will automatically load if the `load_config` is set to True\n    # in the config file\n    config = {}\n    if arguments.config or (\n        get_config_file().exists() and get_config().get(\"load_config\")\n    ):\n        config = get_config()\n\n    # Type: ignore because of the issues below\n    # /~https://github.com/python/mypy/issues/8890\n    # /~https://github.com/python/mypy/issues/5382\n    spotify_options = SpotifyOptions(\n        **create_settings_type(arguments, config, SPOTIFY_OPTIONS)  # type: ignore\n    )\n    downloader_options = DownloaderOptions(\n        **create_settings_type(arguments, config, DOWNLOADER_OPTIONS)  # type: ignore\n    )\n    web_options = WebOptions(**create_settings_type(arguments, config, WEB_OPTIONS))  # type: ignore\n\n    return spotify_options, downloader_options, web_options\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings_type","title":"<code>create_settings_type(arguments, config, default)</code>","text":"<p>Create settings dict Argument value has always the priority, then the config file value, and if neither are set, use default value</p>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings_type--arguments","title":"Arguments","text":"<ul> <li>arguments: Namespace from argparse</li> <li>default: dict</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.create_settings_type--returns","title":"Returns","text":"<ul> <li>settings: dict</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def create_settings_type(\n    arguments: Namespace,\n    config: Dict[str, Any],\n    default: Union[SpotifyOptions, DownloaderOptions, WebOptions],\n) -&gt; Dict[str, Any]:\n    \"\"\"\n    Create settings dict\n    Argument value has always the priority, then the config file\n    value, and if neither are set, use default value\n\n    ### Arguments\n    - arguments: Namespace from argparse\n    - default: dict\n\n    ### Returns\n    - settings: dict\n    \"\"\"\n\n    settings = {}\n    for key, default_value in default.items():\n        argument_val = arguments.__dict__.get(key)\n        config_val = config.get(key)\n\n        if argument_val is not None:\n            settings[key] = argument_val\n        elif config_val is not None:\n            settings[key] = config_val\n        else:\n            settings[key] = default_value\n\n    return settings\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_cache_path","title":"<code>get_cache_path()</code>","text":"<p>Get the path to the cache folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_cache_path--returns","title":"Returns","text":"<ul> <li>The path to the spotipy cache file.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_cache_path() -&gt; Path:\n    \"\"\"\n    Get the path to the cache folder.\n\n    ### Returns\n    - The path to the spotipy cache file.\n    \"\"\"\n\n    return get_spotdl_path() / \".spotipy\"\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config","title":"<code>get_config()</code>","text":"<p>Get the config.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config--returns","title":"Returns","text":"<ul> <li>The dictionary with the config.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config--errors","title":"Errors","text":"<ul> <li>ConfigError: If the config file does not exist.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_config() -&gt; Dict[str, Any]:\n    \"\"\"\n    Get the config.\n\n    ### Returns\n    - The dictionary with the config.\n\n    ### Errors\n    - ConfigError: If the config file does not exist.\n    \"\"\"\n\n    config_path = get_config_file()\n\n    if not config_path.exists():\n        raise ConfigError(\n            \"Config file not found.\"\n            \"Please run `spotdl --generate-config` to create a config file.\"\n        )\n\n    with open(config_path, \"r\", encoding=\"utf-8\") as config_file:\n        return json.load(config_file)\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config_file","title":"<code>get_config_file()</code>","text":"<p>Get config file path</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_config_file--returns","title":"Returns","text":"<ul> <li>The path to the config file.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_config_file() -&gt; Path:\n    \"\"\"\n    Get config file path\n\n    ### Returns\n    - The path to the config file.\n    \"\"\"\n\n    return get_spotdl_path() / \"config.json\"\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_errors_path","title":"<code>get_errors_path()</code>","text":"<p>Get the path to the errors folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_errors_path--returns","title":"Returns","text":"<ul> <li>The path to the errors folder.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_errors_path--notes","title":"Notes","text":"<ul> <li>If the errors directory does not exist, it will be created.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_errors_path() -&gt; Path:\n    \"\"\"\n    Get the path to the errors folder.\n\n    ### Returns\n    - The path to the errors folder.\n\n    ### Notes\n    - If the errors directory does not exist, it will be created.\n    \"\"\"\n\n    errors_path = get_spotdl_path() / \"errors\"\n\n    if not errors_path.exists():\n        os.mkdir(errors_path)\n\n    return errors_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotdl_path","title":"<code>get_spotdl_path()</code>","text":"<p>Get the path to the spotdl folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotdl_path--returns","title":"Returns","text":"<ul> <li>The path to the spotdl folder.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotdl_path--notes","title":"Notes","text":"<ul> <li>If the spotdl directory does not exist, it will be created.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_spotdl_path() -&gt; Path:\n    \"\"\"\n    Get the path to the spotdl folder.\n\n    ### Returns\n    - The path to the spotdl folder.\n\n    ### Notes\n    - If the spotdl directory does not exist, it will be created.\n    \"\"\"\n\n    # Check if os is linux\n    if platform.system() == \"Linux\":\n        # if platform is linux, and XDG DATA HOME spotdl folder exists, use it\n        user_data_dir = Path(platformdirs.user_data_dir(\"spotdl\", \"spotDL\"))\n        if user_data_dir.exists():\n            return user_data_dir\n\n    spotdl_path = Path(os.path.expanduser(\"~\"), \".spotdl\")\n    if not spotdl_path.exists():\n        os.mkdir(spotdl_path)\n\n    return spotdl_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotify_cache_path","title":"<code>get_spotify_cache_path()</code>","text":"<p>Get the path to the spotify cache folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_spotify_cache_path--returns","title":"Returns","text":"<ul> <li>The path to the spotipy cache file.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_spotify_cache_path() -&gt; Path:\n    \"\"\"\n    Get the path to the spotify cache folder.\n\n    ### Returns\n    - The path to the spotipy cache file.\n    \"\"\"\n\n    return get_spotdl_path() / \".spotify_cache\"\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_temp_path","title":"<code>get_temp_path()</code>","text":"<p>Get the path to the temp folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_temp_path--returns","title":"Returns","text":"<ul> <li>The path to the temp folder.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_temp_path() -&gt; Path:\n    \"\"\"\n    Get the path to the temp folder.\n\n    ### Returns\n    - The path to the temp folder.\n    \"\"\"\n\n    temp_path = get_spotdl_path() / \"temp\"\n    if not temp_path.exists():\n        os.mkdir(temp_path)\n\n    return temp_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.get_web_ui_path","title":"<code>get_web_ui_path()</code>","text":"<p>Get the path to the web-ui folder.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.get_web_ui_path--returns","title":"Returns","text":"<ul> <li>The path to the web-ui folder.</li> </ul>"},{"location":"reference/utils/config/#spotdl.utils.config.get_web_ui_path--notes","title":"Notes","text":"<ul> <li>If the web-ui directory does not exist, it will be created.</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def get_web_ui_path() -&gt; Path:\n    \"\"\"\n    Get the path to the web-ui folder.\n\n    ### Returns\n    - The path to the web-ui folder.\n\n    ### Notes\n    - If the web-ui directory does not exist, it will be created.\n    \"\"\"\n\n    web_ui_path = get_spotdl_path() / \"web-ui\"\n\n    if not web_ui_path.exists():\n        os.mkdir(web_ui_path)\n\n    return web_ui_path\n</code></pre>"},{"location":"reference/utils/config/#spotdl.utils.config.modernize_settings","title":"<code>modernize_settings(options)</code>","text":"<p>Handle deprecated values in config file.</p>"},{"location":"reference/utils/config/#spotdl.utils.config.modernize_settings--arguments","title":"Arguments","text":"<ul> <li>options: DownloaderOptions to modernize</li> </ul> Source code in <code>spotdl/utils/config.py</code> <pre><code>def modernize_settings(options: DownloaderOptions):\n    \"\"\"Handle deprecated values in config file.\n\n    ### Arguments\n    - options: DownloaderOptions to modernize\n    \"\"\"\n\n    warning_msg = \"Deprecated '%s' value found for '%s' setting in config file. Using '%s' instead.\"\n\n    # Respect backward compatibility with old boolean --restrict flag\n    if options[\"restrict\"] is True:\n        logger.warning(warning_msg, True, \"restrict\", \"strict\")\n        options[\"restrict\"] = \"strict\"\n</code></pre>"},{"location":"reference/utils/console/","title":"console","text":"<p>Module for holding console related actions.</p>"},{"location":"reference/utils/console/#spotdl.utils.console.check_for_updates","title":"<code>check_for_updates()</code>","text":"<p>Check for updates to the current version.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def check_for_updates():\n    \"\"\"\n    Check for updates to the current version.\n    \"\"\"\n\n    version_message = get_update_status()\n\n    print(version_message)\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.download_ffmpeg","title":"<code>download_ffmpeg()</code>","text":"<p>Handle ffmpeg download process and print the result.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def download_ffmpeg():\n    \"\"\"\n    Handle ffmpeg download process and print the result.\n    \"\"\"\n\n    if get_local_ffmpeg() is not None or is_ffmpeg_installed():\n        overwrite_ffmpeg = input(\n            \"FFmpeg is already installed. Do you want to overwrite it? (y/N): \"\n        )\n\n        if overwrite_ffmpeg.lower() == \"y\":\n            local_ffmpeg = ffmpeg_download()\n\n            if local_ffmpeg.is_file():\n                print(f\"FFmpeg successfully downloaded to {local_ffmpeg.absolute()}\")\n            else:\n                print(\"FFmpeg download failed\")\n    else:\n        print(\"Downloading FFmpeg...\")\n        download_path = ffmpeg_download()\n\n        if download_path.is_file():\n            print(f\"FFmpeg successfully downloaded to {download_path.absolute()}\")\n        else:\n            print(\"FFmpeg download failed\")\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.generate_config","title":"<code>generate_config()</code>","text":"<p>Generate the config file if it doesn't exist This is done before the argument parser so it doesn't requires <code>operation</code> and <code>query</code> to be passed.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def generate_config():\n    \"\"\"\n    Generate the config file if it doesn't exist\n    This is done before the argument parser so it doesn't requires `operation`\n    and `query` to be passed.\n    \"\"\"\n\n    config_path = get_config_file()\n    if config_path.exists():\n        overwrite_config = input(\"Config file already exists. Overwrite? (y/N): \")\n\n        if overwrite_config.lower() != \"y\":\n            print(\"Exiting...\")\n            return None\n\n    with open(config_path, \"w\", encoding=\"utf-8\") as config_file:\n        json.dump(DEFAULT_CONFIG, config_file, indent=4)\n\n    print(f\"Config file generated at {config_path}\")\n\n    return None\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.generate_initial_config","title":"<code>generate_initial_config()</code>","text":"<p>Generate the initial config file if it doesn't exist.</p> Source code in <code>spotdl/utils/console.py</code> <pre><code>def generate_initial_config():\n    \"\"\"\n    Generate the initial config file if it doesn't exist.\n    \"\"\"\n\n    if get_config_file().is_file() is False:\n        config_path = get_config_file()\n        with open(config_path, \"w\", encoding=\"utf-8\") as config_file:\n            json.dump(DEFAULT_CONFIG, config_file, indent=4)\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.is_executable","title":"<code>is_executable()</code>","text":"<p>Check if the application is an prebuilt executable. And has been launched with double click.</p>"},{"location":"reference/utils/console/#spotdl.utils.console.is_executable--returns","title":"Returns","text":"<ul> <li><code>True</code> if the application is an prebuilt executable, <code>False</code> otherwise.</li> </ul> Source code in <code>spotdl/utils/console.py</code> <pre><code>def is_executable():\n    \"\"\"\n    Check if the application is an prebuilt executable.\n    And has been launched with double click.\n\n    ### Returns\n    - `True` if the application is an prebuilt executable, `False` otherwise.\n    \"\"\"\n\n    return is_frozen() and len(sys.argv) == 1\n</code></pre>"},{"location":"reference/utils/console/#spotdl.utils.console.is_frozen","title":"<code>is_frozen()</code>","text":"<p>Check if the application is frozen.</p>"},{"location":"reference/utils/console/#spotdl.utils.console.is_frozen--returns","title":"Returns","text":"<ul> <li><code>True</code> if the application is frozen, <code>False</code> otherwise.</li> </ul> Source code in <code>spotdl/utils/console.py</code> <pre><code>def is_frozen():\n    \"\"\"\n    Check if the application is frozen.\n\n    ### Returns\n    - `True` if the application is frozen, `False` otherwise.\n    \"\"\"\n\n    return getattr(sys, \"frozen\", False)\n</code></pre>"},{"location":"reference/utils/downloader/","title":"downloader","text":"<p>Module for functions related to downloading songs.</p>"},{"location":"reference/utils/downloader/#spotdl.utils.downloader.check_ytmusic_connection","title":"<code>check_ytmusic_connection()</code>","text":"<p>Check if we can connect to YouTube Music API</p>"},{"location":"reference/utils/downloader/#spotdl.utils.downloader.check_ytmusic_connection--returns","title":"Returns","text":"<ul> <li><code>True</code> if we can connect to YouTube Music API</li> <li><code>False</code> if we can't connect to YouTube Music API</li> </ul> Source code in <code>spotdl/utils/downloader.py</code> <pre><code>def check_ytmusic_connection() -&gt; bool:\n    \"\"\"\n    Check if we can connect to YouTube Music API\n\n    ### Returns\n    - `True` if we can connect to YouTube Music API\n    - `False` if we can't connect to YouTube Music API\n    \"\"\"\n\n    # Check if we are getting results from YouTube Music\n    ytm = YouTubeMusic()\n    test_results = ytm.get_results(\"a\")\n    if len(test_results) == 0:\n        return False\n\n    return True\n</code></pre>"},{"location":"reference/utils/ffmpeg/","title":"ffmpeg","text":"<p>Module for converting audio files to different formats and checking for ffmpeg binary, and downloading it if not found.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.FFmpegError","title":"<code>FFmpegError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to FFmpeg.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert","title":"<code>convert(input_file, output_file, ffmpeg='ffmpeg', output_format='mp3', bitrate=None, ffmpeg_args=None, progress_handler=None)</code>","text":"<p>Convert the input file to the output file synchronously with progress handler.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert--arguments","title":"Arguments","text":"<ul> <li>input_file: Path to input file or tuple of (url, file_format).</li> <li>output_file: Path to output file.</li> <li>ffmpeg: ffmpeg executable to use.</li> <li>output_format: output format.</li> <li>bitrate: constant/variable bitrate.</li> <li>ffmpeg_args: ffmpeg arguments.</li> <li>progress_handler: progress handler, has to accept an integer as argument.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert--returns","title":"Returns","text":"<ul> <li>Tuple of conversion status and error dictionary.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.convert--notes","title":"Notes","text":"<ul> <li>Make sure to check if ffmpeg is installed before calling this function.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def convert(\n    input_file: Union[Path, Tuple[str, str]],\n    output_file: Path,\n    ffmpeg: str = \"ffmpeg\",\n    output_format: str = \"mp3\",\n    bitrate: Optional[str] = None,\n    ffmpeg_args: Optional[str] = None,\n    progress_handler: Optional[Callable[[int], None]] = None,\n) -&gt; Tuple[bool, Optional[Dict[str, Any]]]:\n    \"\"\"\n    Convert the input file to the output file synchronously with progress handler.\n\n    ### Arguments\n    - input_file: Path to input file or tuple of (url, file_format).\n    - output_file: Path to output file.\n    - ffmpeg: ffmpeg executable to use.\n    - output_format: output format.\n    - bitrate: constant/variable bitrate.\n    - ffmpeg_args: ffmpeg arguments.\n    - progress_handler: progress handler, has to accept an integer as argument.\n\n    ### Returns\n    - Tuple of conversion status and error dictionary.\n\n    ### Notes\n    - Make sure to check if ffmpeg is installed before calling this function.\n    \"\"\"\n\n    # Initialize ffmpeg command\n    # -i is the input file\n    arguments: List[str] = [\n        \"-nostdin\",\n        \"-y\",\n        \"-i\",\n        str(input_file.resolve()) if isinstance(input_file, Path) else input_file[0],\n        \"-movflags\",\n        \"+faststart\",\n        \"-v\",\n        \"debug\",\n        \"-progress\",\n        \"-\",\n        \"-nostats\",\n    ]\n\n    file_format = (\n        str(input_file.suffix).split(\".\")[1]\n        if isinstance(input_file, Path)\n        else input_file[1]\n    )\n\n    # Add output format to command\n    # -c:a is used if the file is not an matroska container\n    # and we want to convert to opus\n    # otherwise we use arguments from FFMPEG_FORMATS\n    if output_format == \"opus\" and file_format != \"webm\":\n        arguments.extend([\"-c:a\", \"libopus\"])\n    else:\n        if (\n            (output_format == \"opus\" and file_format == \"webm\")\n            or (output_format == \"m4a\" and file_format == \"m4a\")\n            and not (bitrate or ffmpeg_args)\n        ):\n            # Copy the audio stream to the output file\n            arguments.extend([\"-vn\", \"-c:a\", \"copy\"])\n        else:\n            arguments.extend(FFMPEG_FORMATS[output_format])\n\n    # Add bitrate if specified\n    if bitrate:\n        # Check if bitrate is an integer\n        # if it is then use it as variable bitrate\n        if bitrate.isdigit():\n            arguments.extend([\"-q:a\", bitrate])\n        else:\n            arguments.extend([\"-b:a\", bitrate])\n\n    # Add other ffmpeg arguments if specified\n    if ffmpeg_args:\n        arguments.extend(shlex.split(ffmpeg_args))\n\n    # Add output file at the end\n    arguments.append(str(output_file.resolve()))\n\n    # Run ffmpeg\n    with subprocess.Popen(\n        [ffmpeg, *arguments],\n        stdin=subprocess.PIPE,\n        stdout=subprocess.PIPE,\n        stderr=subprocess.STDOUT,\n        universal_newlines=False,\n    ) as process:\n        if not progress_handler:\n            # Wait for process to finish\n            proc_out = process.communicate()\n\n            if process.returncode != 0:\n                # get version and build year\n                version = get_ffmpeg_version(ffmpeg)\n\n                # join stdout and stderr and decode to utf-8\n                message = b\"\".join([out for out in proc_out if out]).decode(\"utf-8\")\n\n                # return error dictionary\n                return False, {\n                    \"return_code\": process.returncode,\n                    \"arguments\": arguments,\n                    \"ffmpeg\": ffmpeg,\n                    \"version\": version[0],\n                    \"build_year\": version[1],\n                    \"error\": message,\n                }\n\n            return True, None\n\n        progress_handler(0)\n\n        out_buffer = []\n        total_dur = None\n        while True:\n            if process.stdout is None:\n                continue\n\n            out_line = (\n                process.stdout.readline().decode(\"utf-8\", errors=\"replace\").strip()\n            )\n\n            if out_line == \"\" and process.poll() is not None:\n                break\n\n            out_buffer.append(out_line.strip())\n\n            total_dur_match = DUR_REGEX.search(out_line)\n            if total_dur is None and total_dur_match:\n                total_dur = to_ms(**total_dur_match.groupdict())  # type: ignore\n                continue\n            if total_dur:\n                progress_time = TIME_REGEX.search(out_line)\n                if progress_time:\n                    elapsed_time = to_ms(**progress_time.groupdict())  # type: ignore\n                    progress_handler(int(elapsed_time / total_dur * 100))  # type: ignore\n\n        if process.returncode != 0:\n            # get version and build year\n            version = get_ffmpeg_version(ffmpeg)\n\n            return False, {\n                \"return_code\": process.returncode,\n                \"arguments\": arguments,\n                \"ffmpeg\": ffmpeg,\n                \"version\": version[0],\n                \"build_year\": version[1],\n                \"error\": \"\\n\".join(out_buffer),\n            }\n\n        progress_handler(100)\n\n        return True, None\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.download_ffmpeg","title":"<code>download_ffmpeg()</code>","text":"<p>Download ffmpeg binary to spotdl directory.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.download_ffmpeg--returns","title":"Returns","text":"<ul> <li>Path to ffmpeg binary.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.download_ffmpeg--notes","title":"Notes","text":"<ul> <li>ffmpeg is downloaded from github releases     for current platform and architecture.</li> <li>executable permission is set for ffmpeg binary.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def download_ffmpeg() -&gt; Path:\n    \"\"\"\n    Download ffmpeg binary to spotdl directory.\n\n    ### Returns\n    - Path to ffmpeg binary.\n\n    ### Notes\n    - ffmpeg is downloaded from github releases\n        for current platform and architecture.\n    - executable permission is set for ffmpeg binary.\n    \"\"\"\n\n    os_name = platform.system().lower()\n    os_arch = platform.machine().lower()\n    ffmpeg_url: Optional[str] = None\n\n    # if platform.system() == \"Darwin\" and (\n    #     platform.processor() == \"arm\"\n    #     or subprocess.run([\"sysctl\", \"-n\", \"sysctl.proc_translated\"], check=False)\n    # ):\n    #     ffmpeg_url = FFMPEG_URLS[\"darwin\"][\"arm\"]\n    # else:\n    #     ffmpeg_url = FFMPEG_URLS.get(os_name, {}).get(os_arch)\n\n    ffmpeg_url = FFMPEG_URLS.get(os_name, {}).get(os_arch)\n\n    if ffmpeg_url is None:\n        raise FFmpegError(\"FFmpeg binary is not available for your system.\")\n\n    ffmpeg_path = Path(\n        os.path.join(\n            get_spotdl_path(), \"ffmpeg\" + (\".exe\" if os_name == \"windows\" else \"\")\n        )\n    )\n\n    # Download binary and save it to a file in spotdl directory\n    ffmpeg_binary = requests.get(ffmpeg_url, allow_redirects=True, timeout=10).content\n    with open(ffmpeg_path, \"wb\") as ffmpeg_file:\n        ffmpeg_file.write(ffmpeg_binary)\n\n    # Set executable permission on linux and mac\n    if os_name in [\"linux\", \"darwin\"]:\n        ffmpeg_path.chmod(ffmpeg_path.stat().st_mode | stat.S_IEXEC)\n\n    return ffmpeg_path\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_path","title":"<code>get_ffmpeg_path()</code>","text":"<p>Get path to global ffmpeg binary or a local ffmpeg binary.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_path--returns","title":"Returns","text":"<ul> <li>Path to ffmpeg binary or None if not found.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def get_ffmpeg_path() -&gt; Optional[Path]:\n    \"\"\"\n    Get path to global ffmpeg binary or a local ffmpeg binary.\n\n    ### Returns\n    - Path to ffmpeg binary or None if not found.\n    \"\"\"\n\n    # Check if ffmpeg is installed\n    global_ffmpeg = shutil.which(\"ffmpeg\")\n    if global_ffmpeg:\n        return Path(global_ffmpeg)\n\n    # Get local ffmpeg path\n    return get_local_ffmpeg()\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version","title":"<code>get_ffmpeg_version(ffmpeg='ffmpeg')</code>","text":"<p>Get ffmpeg version.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version--arguments","title":"Arguments","text":"<ul> <li>ffmpeg: ffmpeg executable to check</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version--returns","title":"Returns","text":"<ul> <li>Tuple of optional version and optional year.</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_ffmpeg_version--errors","title":"Errors","text":"<ul> <li>FFmpegError if ffmpeg is not installed.</li> <li>FFmpegError if ffmpeg version is not found.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def get_ffmpeg_version(ffmpeg: str = \"ffmpeg\") -&gt; Tuple[Optional[float], Optional[int]]:\n    \"\"\"\n    Get ffmpeg version.\n\n    ### Arguments\n    - ffmpeg: ffmpeg executable to check\n\n    ### Returns\n    - Tuple of optional version and optional year.\n\n    ### Errors\n    - FFmpegError if ffmpeg is not installed.\n    - FFmpegError if ffmpeg version is not found.\n    \"\"\"\n\n    # Check if ffmpeg is installed\n    if not is_ffmpeg_installed(ffmpeg):\n        if ffmpeg == \"ffmpeg\":\n            raise FFmpegError(\"ffmpeg is not installed.\")\n\n        raise FFmpegError(f\"{ffmpeg} is not a valid ffmpeg executable.\")\n\n    with subprocess.Popen(\n        [ffmpeg, \"-version\"],\n        stdout=subprocess.PIPE,\n        stderr=subprocess.PIPE,\n        encoding=\"utf-8\",\n    ) as process:\n        output = \"\".join(process.communicate())\n\n    # Search for version and build year in output\n    version_result = VERSION_REGEX.search(output)\n    year_result = YEAR_REGEX.search(output)\n\n    build_year = None\n    version = None\n\n    if version_result is not None:\n        # remove all non numeric characters from string example: n4.3\n        version_str = re.sub(r\"[a-zA-Z]\", \"\", version_result.group(0))\n\n        # parse version string to float\n        version = float(version_str) if version_str else None\n\n    if year_result is not None:\n        # get build years from string example: Copyright (c) 2019-2020\n        build_years = [\n            int(\n                re.sub(r\"[^0-9]\", \"\", year)\n            )  # remove all non numeric characters from string\n            for year in year_result.group(0).split(\n                \"-\"\n            )  # split string into list of years\n        ]\n\n        # get the highest build year\n        build_year = max(build_years)\n\n    return (version, build_year)\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_local_ffmpeg","title":"<code>get_local_ffmpeg()</code>","text":"<p>Get local ffmpeg binary path.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.get_local_ffmpeg--returns","title":"Returns","text":"<ul> <li>Path to ffmpeg binary or None if not found.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def get_local_ffmpeg() -&gt; Optional[Path]:\n    \"\"\"\n    Get local ffmpeg binary path.\n\n    ### Returns\n    - Path to ffmpeg binary or None if not found.\n    \"\"\"\n\n    ffmpeg_path = Path(get_spotdl_path()) / (\n        \"ffmpeg\" + (\".exe\" if platform.system() == \"Windows\" else \"\")\n    )\n\n    if ffmpeg_path.is_file():\n        return ffmpeg_path\n\n    return None\n</code></pre>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.is_ffmpeg_installed","title":"<code>is_ffmpeg_installed(ffmpeg='ffmpeg')</code>","text":"<p>Check if ffmpeg is installed.</p>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.is_ffmpeg_installed--arguments","title":"Arguments","text":"<ul> <li>ffmpeg: ffmpeg executable to check</li> </ul>"},{"location":"reference/utils/ffmpeg/#spotdl.utils.ffmpeg.is_ffmpeg_installed--returns","title":"Returns","text":"<ul> <li>True if ffmpeg is installed, False otherwise.</li> </ul> Source code in <code>spotdl/utils/ffmpeg.py</code> <pre><code>def is_ffmpeg_installed(ffmpeg: str = \"ffmpeg\") -&gt; bool:\n    \"\"\"\n    Check if ffmpeg is installed.\n\n    ### Arguments\n    - ffmpeg: ffmpeg executable to check\n\n    ### Returns\n    - True if ffmpeg is installed, False otherwise.\n    \"\"\"\n\n    if ffmpeg == \"ffmpeg\":\n        global_ffmpeg = shutil.which(\"ffmpeg\")\n        if global_ffmpeg is None:\n            ffmpeg_path = get_ffmpeg_path()\n        else:\n            ffmpeg_path = Path(global_ffmpeg)\n    else:\n        ffmpeg_path = Path(ffmpeg)\n\n    if ffmpeg_path is None:\n        return False\n\n    # else check if path to ffmpeg is valid\n    # and if ffmpeg has the correct access rights\n    return ffmpeg_path.exists() and os.access(ffmpeg_path, os.X_OK)\n</code></pre>"},{"location":"reference/utils/formatter/","title":"formatter","text":"<p>Module for formatting songs into strings. Contains functions to create search queries and song titles and file names.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.args_to_ytdlp_options","title":"<code>args_to_ytdlp_options(argument_list, defaults=None)</code>","text":"<p>Convert a list of arguments to a dictionary of options.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.args_to_ytdlp_options--arguments","title":"Arguments","text":"<ul> <li>argument_list: the list of arguments</li> <li>defaults: the default options</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.args_to_ytdlp_options--returns","title":"Returns","text":"<ul> <li>the dictionary of options</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def args_to_ytdlp_options(\n    argument_list: List[str], defaults: Optional[Dict[str, Any]] = None\n) -&gt; Dict[str, Any]:\n    \"\"\"\n    Convert a list of arguments to a dictionary of options.\n\n    ### Arguments\n    - argument_list: the list of arguments\n    - defaults: the default options\n\n    ### Returns\n    - the dictionary of options\n    \"\"\"\n\n    new_args = YT_DLP_PARSER.parse_args(argument_list, yt_dlp_optparse.Values(defaults))\n\n    return vars(new_args[0])\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_file_name","title":"<code>create_file_name(song, template, file_extension, restrict=None, short=False, file_name_length=None)</code>","text":"<p>Create the file name for the song, by replacing template variables with the actual values.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_file_name--arguments","title":"Arguments","text":"<ul> <li>song: the song object</li> <li>template: the template string</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>file_name_length: the maximum length of the file name</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_file_name--returns","title":"Returns","text":"<ul> <li>the formatted string as a Path object</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_file_name(\n    song: Song,\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    file_name_length: Optional[int] = None,\n) -&gt; Path:\n    \"\"\"\n    Create the file name for the song, by replacing template variables with the actual values.\n\n    ### Arguments\n    - song: the song object\n    - template: the template string\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - file_name_length: the maximum length of the file name\n\n    ### Returns\n    - the formatted string as a Path object\n    \"\"\"\n\n    temp_song = copy.deepcopy(song)\n\n    # If template does not contain any of the keys,\n    # append {artists} - {title}.{output-ext} to it\n    if not any(key in template for key in VARS) and template != \"\":\n        template += \"/{artists} - {title}.{output-ext}\"\n\n    if template == \"\":\n        template = \"{artists} - {title}.{output-ext}\"\n\n    # If template ends with a slash. Does not have a file name with extension\n    # at the end of the template, append {artists} - {title}.{output-ext} to it\n    if template.endswith(\"/\") or template.endswith(r\"\\\\\") or template.endswith(\"\\\\\\\\\"):\n        template += \"/{artists} - {title}.{output-ext}\"\n\n    # If template does not end with {output-ext}, append it to the end of the template\n    if not template.endswith(\".{output-ext}\"):\n        template += \".{output-ext}\"\n\n    formatted_string = format_query(\n        song=song,\n        template=template,\n        santitize=True,\n        file_extension=file_extension,\n        short=short,\n    )\n\n    file = create_path_object(formatted_string)\n\n    length_limit = file_name_length or 255\n\n    # Check if the file name length is greater than the limit\n    if len(file.name) &lt; length_limit:\n        # Restrict the filename if needed\n        if restrict and restrict != \"none\":\n            return restrict_filename(file, restrict == \"strict\")\n\n        return file\n\n    if short is False:\n        return create_file_name(\n            song,\n            template,\n            file_extension,\n            restrict=restrict,\n            short=True,\n            file_name_length=length_limit,\n        )\n\n    non_template_chars = re.findall(r\"(?&lt;!{)[^{}]+(?![^{}]*})\", template)\n    half_length = int((length_limit * 0.50) - (len(\"\".join(non_template_chars)) / 2))\n\n    # Path template is already short, but we still can't create a file\n    # so we reduce it even further\n    is_long_artist = len(temp_song.artist) &gt; half_length\n    is_long_title = len(temp_song.name) &gt; half_length\n\n    path_separator = \"/\" if \"/\" in template else \"\\\\\"\n    name_template_parts = template.rsplit(path_separator, 1)\n    name_template = (\n        name_template_parts[1]\n        if len(name_template_parts) &gt; 1\n        else name_template_parts[0]\n    )\n\n    if is_long_artist:\n        logger.warning(\n            \"%s: Song artist is too long. Using only part of song artist.\",\n            temp_song.display_name,\n        )\n\n        temp_song.artist = smart_split(temp_song.artist, half_length, None)\n        temp_song.artists = [temp_song.artist]\n\n    if is_long_title:\n        logger.warning(\n            \"%s: File name is too long. Using only part of the song title.\",\n            temp_song.display_name,\n        )\n\n        temp_song.name = smart_split(temp_song.name, half_length, None)\n\n    new_file = create_path_object(\n        format_query(\n            song=temp_song,\n            template=name_template,\n            santitize=True,\n            file_extension=file_extension,\n            short=short,\n        )\n    )\n\n    if len(new_file.name) &gt; length_limit:\n        logger.warning(\n            \"File name is still too long. \"\n            \"Using default file name with shortened artist and title.\"\n        )\n\n        if template == \"{artist} - {title}.{output-ext}\":\n            raise ValueError(\n                \"File name is still too long, \"\n                \"but the template is already short. \"\n                \"Please try other template, \"\n                \"increase the file name length limit.\"\n            )\n\n        return create_file_name(\n            temp_song,\n            \"{artist} - {title}.{output-ext}\",\n            file_extension,\n            restrict=restrict,\n            short=True,\n            file_name_length=length_limit,\n        )\n\n    return new_file\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_path_object","title":"<code>create_path_object(string)</code>","text":"<p>Create a Path object from a string. Sanitizes the filename part of the Path object.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_path_object--arguments","title":"Arguments","text":"<ul> <li>string: the string to convert</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_path_object--returns","title":"Returns","text":"<ul> <li>the Path object</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_path_object(string: str) -&gt; Path:\n    \"\"\"\n    Create a Path object from a string.\n    Sanitizes the filename part of the Path object.\n\n    ### Arguments\n    - string: the string to convert\n\n    ### Returns\n    - the Path object\n    \"\"\"\n\n    # Parse template as Path object\n    file = Path(string)\n\n    santitized_parts = []\n    for part in file.parts:\n        match = re.search(r\"[^\\.*](.*)[^\\.*$]\", part)\n        if match and part != \".spotdl\":\n            santitized_parts.append(match.group(0))\n        else:\n            santitized_parts.append(part)\n\n    # Join the parts of the path\n    return Path(*santitized_parts)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_search_query","title":"<code>create_search_query(song, template, santitize, file_extension=None, short=False)</code>","text":"<p>Create the search query for the song.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_search_query--arguments","title":"Arguments","text":"<ul> <li>song: the song object</li> <li>template: the template string</li> <li>santitize: whether to sanitize the string</li> <li>file_extension: the file extension to use</li> <li>short: whether to use the short version of the template</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_search_query--returns","title":"Returns","text":"<ul> <li>the formatted string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_search_query(\n    song: Song,\n    template: str,\n    santitize: bool,\n    file_extension: Optional[str] = None,\n    short: bool = False,\n) -&gt; str:\n    \"\"\"\n    Create the search query for the song.\n\n    ### Arguments\n    - song: the song object\n    - template: the template string\n    - santitize: whether to sanitize the string\n    - file_extension: the file extension to use\n    - short: whether to use the short version of the template\n\n    ### Returns\n    - the formatted string\n    \"\"\"\n\n    # If template does not contain any of the keys,\n    # append {artist} - {title} at the beginning of the template\n    if not any(key in template for key in VARS):\n        template = \"{artist} - {title}\" + template\n\n    return format_query(song, template, santitize, file_extension, short=short)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title","title":"<code>create_song_title(song_name, song_artists)</code>","text":"<p>Create the song title.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title--arguments","title":"Arguments","text":"<ul> <li>song_name: the name of the song</li> <li>song_artists: the list of artists of the song</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title--returns","title":"Returns","text":"<ul> <li>the song title</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.create_song_title--notes","title":"Notes","text":"<ul> <li>Example: \"Artist1, Artist2 - Song Name\"</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def create_song_title(song_name: str, song_artists: List[str]) -&gt; str:\n    \"\"\"\n    Create the song title.\n\n    ### Arguments\n    - song_name: the name of the song\n    - song_artists: the list of artists of the song\n\n    ### Returns\n    - the song title\n\n    ### Notes\n    - Example: \"Artist1, Artist2 - Song Name\"\n\n    \"\"\"\n\n    joined_artists = \", \".join(song_artists)\n    if len(song_artists) &gt;= 1:\n        return f\"{joined_artists} - {song_name}\"\n\n    return song_name\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.format_query","title":"<code>format_query(song, template, santitize, file_extension=None, short=False)</code>","text":"<p>Replace template variables with the actual values.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.format_query--arguments","title":"Arguments","text":"<ul> <li>song: the song object</li> <li>template: the template string</li> <li>santitize: whether to sanitize the string</li> <li>file_extension: the file extension to use</li> <li>short: whether to use the short version of the template</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.format_query--returns","title":"Returns","text":"<ul> <li>the formatted string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def format_query(\n    song: Song,\n    template: str,\n    santitize: bool,\n    file_extension: Optional[str] = None,\n    short: bool = False,\n) -&gt; str:\n    \"\"\"\n    Replace template variables with the actual values.\n\n    ### Arguments\n    - song: the song object\n    - template: the template string\n    - santitize: whether to sanitize the string\n    - file_extension: the file extension to use\n    - short: whether to use the short version of the template\n\n    ### Returns\n    - the formatted string\n    \"\"\"\n\n    if \"{output-ext}\" in template and file_extension is None:\n        raise ValueError(\"file_extension is None, but template contains {output-ext}\")\n\n    for key, val in [\n        (\"{list-length}\", song.list_length),\n        (\"{list-position}\", song.list_position),\n        (\"{list-name}\", song.list_name),\n    ]:\n        if not (key in template and val is None):\n            continue\n\n        logger.warning(\n            \"Template contains %s, but it's value is None. Replacing with empty string.\",\n            key,\n        )\n\n        template = template.replace(key, \"\")\n        template = template.replace(r\"//\", r\"/\")\n\n    # If template has only {output-ext}, fix it\n    if template in [\"/.{output-ext}\", \".{output-ext}\"]:\n        template = \"{artists} - {title}.{output-ext}\"\n\n    # Remove artists from the list that are already in the title\n    if short:\n        artists = [\n            artist\n            for artist in song.artists\n            if slugify(artist) not in slugify(song.name)\n        ]\n\n        # Add the main artist again to the list\n        if len(artists) == 0 or artists[0] != song.artists[0]:\n            artists.insert(0, song.artists[0])\n    else:\n        artists = song.artists\n\n    artists_str = \", \".join(artists)\n\n    # the code below is valid, song_list is actually checked for None\n    formats = {\n        \"{title}\": song.name,\n        \"{artists}\": song.artists[0] if short is True else artists_str,\n        \"{artist}\": song.artists[0],\n        \"{album}\": song.album_name,\n        \"{album-artist}\": song.album_artist,\n        \"{genre}\": song.genres[0] if song.genres else \"\",\n        \"{disc-number}\": song.disc_number,\n        \"{disc-count}\": song.disc_count,\n        \"{duration}\": song.duration,\n        \"{year}\": song.year,\n        \"{original-date}\": song.date,\n        \"{track-number}\": f\"{int(song.track_number):02d}\" if song.track_number else \"\",\n        \"{tracks-count}\": song.tracks_count,\n        \"{isrc}\": song.isrc,\n        \"{track-id}\": song.song_id,\n        \"{publisher}\": song.publisher,\n        \"{output-ext}\": file_extension,\n        \"{list-name}\": song.list_name,\n        \"{list-position}\": str(song.list_position).zfill(len(str(song.list_length))),\n        \"{list-length}\": song.list_length,\n    }\n\n    if santitize:\n        # sanitize the values in formats dict\n        for key, value in formats.items():\n            if value is None:\n                continue\n\n            formats[key] = sanitize_string(str(value))\n\n    # Replace all the keys with the values\n    for key, value in formats.items():\n        template = template.replace(key, str(value))\n\n    return template\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.parse_duration","title":"<code>parse_duration(duration)</code>","text":"<p>Convert string value of time (duration: \"25:36:59\") to a float value of seconds (92219.0)</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.parse_duration--arguments","title":"Arguments","text":"<ul> <li>duration: the string value of time</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.parse_duration--returns","title":"Returns","text":"<ul> <li>the float value of seconds</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def parse_duration(duration: Optional[str]) -&gt; float:\n    \"\"\"\n    Convert string value of time (duration: \"25:36:59\") to a float value of seconds (92219.0)\n\n    ### Arguments\n    - duration: the string value of time\n\n    ### Returns\n    - the float value of seconds\n    \"\"\"\n\n    if duration is None:\n        return 0.0\n\n    try:\n        # {(1, \"s\"), (60, \"m\"), (3600, \"h\")}\n        mapped_increments = zip([1, 60, 3600], reversed(duration.split(\":\")))\n        seconds = sum(multiplier * int(time) for multiplier, time in mapped_increments)\n        return float(seconds)\n\n    # This usually occurs when the wrong string is mistaken for the duration\n    except (ValueError, TypeError, AttributeError):\n        return 0.0\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.ratio","title":"<code>ratio(string1, string2)</code>  <code>cached</code>","text":"<p>Wrapper for fuzz.ratio with lru_cache</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.ratio--arguments","title":"Arguments","text":"<ul> <li>string1: the first string</li> <li>string2: the second string</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.ratio--returns","title":"Returns","text":"<ul> <li>the ratio</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>@lru_cache()\ndef ratio(string1: str, string2: str) -&gt; float:\n    \"\"\"\n    Wrapper for fuzz.ratio\n    with lru_cache\n\n    ### Arguments\n    - string1: the first string\n    - string2: the second string\n\n    ### Returns\n    - the ratio\n    \"\"\"\n\n    return fuzz.ratio(string1, string2)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename","title":"<code>restrict_filename(pathobj, strict=True)</code>","text":"<p>Sanitizes the filename part of a Path object. Returns modified object.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename--arguments","title":"Arguments","text":"<ul> <li>pathobj: the Path object to sanitize</li> <li>strict: whether sanitization should be strict</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename--returns","title":"Returns","text":"<ul> <li>the modified Path object</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.restrict_filename--notes","title":"Notes","text":"<ul> <li>Based on the <code>sanitize_filename</code> function from yt-dlp</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def restrict_filename(pathobj: Path, strict: bool = True) -&gt; Path:\n    \"\"\"\n    Sanitizes the filename part of a Path object. Returns modified object.\n\n    ### Arguments\n    - pathobj: the Path object to sanitize\n    - strict: whether sanitization should be strict\n\n    ### Returns\n    - the modified Path object\n\n    ### Notes\n    - Based on the `sanitize_filename` function from yt-dlp\n    \"\"\"\n    if strict:\n        result = sanitize_filename(pathobj.name, True, False)  # type: ignore\n        result = result.replace(\"_-_\", \"-\")\n    else:\n        result = (\n            normalize(\"NFKD\", pathobj.name).encode(\"ascii\", \"ignore\").decode(\"utf-8\")\n        )\n\n    if not result:\n        result = \"_\"\n\n    return pathobj.with_name(result)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.sanitize_string","title":"<code>sanitize_string(string)</code>","text":"<p>Sanitize the filename to be used in the file system.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.sanitize_string--arguments","title":"Arguments","text":"<ul> <li>string: the string to sanitize</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.sanitize_string--returns","title":"Returns","text":"<ul> <li>the sanitized string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def sanitize_string(string: str) -&gt; str:\n    \"\"\"\n    Sanitize the filename to be used in the file system.\n\n    ### Arguments\n    - string: the string to sanitize\n\n    ### Returns\n    - the sanitized string\n    \"\"\"\n\n    output = string\n\n    # this is windows specific (disallowed chars)\n    output = \"\".join(char for char in output if char not in \"/?\\\\*|&lt;&gt;\")\n\n    # double quotes (\") and semi-colons (:) are also disallowed characters but we would\n    # like to retain their equivalents, so they aren't removed in the prior loop\n    output = output.replace('\"', \"'\").replace(\":\", \"-\")\n\n    return output\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.slugify","title":"<code>slugify(string)</code>  <code>cached</code>","text":"<p>Slugify the string.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.slugify--arguments","title":"Arguments","text":"<ul> <li>string: the string to slugify</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.slugify--returns","title":"Returns","text":"<ul> <li>the slugified string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>@lru_cache()\ndef slugify(string: str) -&gt; str:\n    \"\"\"\n    Slugify the string.\n\n    ### Arguments\n    - string: the string to slugify\n\n    ### Returns\n    - the slugified string\n    \"\"\"\n\n    # Replace ambiguous characters\n    if not JAP_REGEX.search(string):\n        # If string doesn't have japanese characters\n        # return early\n        return py_slugify(string, regex_pattern=DISALLOWED_REGEX.pattern)\n\n    # Workaround for japanese characters\n    # because slugify incorrectly converts them\n    # to latin characters\n    normal_slug = py_slugify(\n        string,\n        regex_pattern=JAP_REGEX.pattern,\n    )\n\n    results = KKS.convert(normal_slug)\n\n    result = \"\"\n    for index, item in enumerate(results):\n        result += item[\"hepburn\"]\n        if not (\n            item[\"kana\"] == item[\"hepburn\"]\n            or item[\"kana\"] == item[\"hepburn\"]\n            or (\n                item == results[-1]\n                or results[index + 1][\"kana\"] == results[index + 1][\"hepburn\"]\n            )\n        ):\n            result += \"-\"\n\n    return py_slugify(result, regex_pattern=DISALLOWED_REGEX.pattern)\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.smart_split","title":"<code>smart_split(string, max_length, separators=None)</code>","text":"<p>Split a string into a list of strings with a maximum length of max_length. Stops at the first separator that produces a string with a length less than max_length.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.smart_split--arguments","title":"Arguments","text":"<ul> <li>string: the string to split</li> <li>max_length: the maximum length of string</li> <li>separators: the separators to split the string with</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.smart_split--returns","title":"Returns","text":"<ul> <li>the new string</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def smart_split(\n    string: str, max_length: int, separators: Optional[List[str]] = None\n) -&gt; str:\n    \"\"\"\n    Split a string into a list of strings\n    with a maximum length of max_length.\n    Stops at the first separator that produces a string\n    with a length less than max_length.\n\n    ### Arguments\n    - string: the string to split\n    - max_length: the maximum length of string\n    - separators: the separators to split the string with\n\n    ### Returns\n    - the new string\n    \"\"\"\n\n    if separators is None:\n        separators = [\"-\", \",\", \" \", \"\"]\n\n    for separator in separators:\n        parts = string.split(separator if separator != \"\" else None)\n        new_string = separator.join(parts[:1])\n        for part in parts[1:]:\n            if len(new_string) + len(separator) + len(part) &gt; max_length:\n                break\n            new_string += separator + part\n\n        if len(new_string) &lt;= max_length:\n            return new_string\n\n    return string[:max_length]\n</code></pre>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms","title":"<code>to_ms(string=None, precision=None, **kwargs)</code>","text":"<p>Convert a string to milliseconds.</p>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms--arguments","title":"Arguments","text":"<ul> <li>string: the string to convert</li> <li>precision: the number of decimals to round to</li> <li>kwargs: the keyword args to convert</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms--returns","title":"Returns","text":"<ul> <li>the milliseconds</li> </ul>"},{"location":"reference/utils/formatter/#spotdl.utils.formatter.to_ms--notes","title":"Notes","text":"<ul> <li>You can either pass a string,</li> <li>or a set of keyword args (\"hour\", \"min\", \"sec\", \"ms\") to convert.</li> <li>If \"precision\" is set, the result is rounded to the number of decimals given.</li> <li>From: https://gist.github.com/Hellowlol/5f8545e999259b4371c91ac223409209</li> </ul> Source code in <code>spotdl/utils/formatter.py</code> <pre><code>def to_ms(\n    string: Optional[str] = None, precision: Optional[int] = None, **kwargs\n) -&gt; float:\n    \"\"\"\n    Convert a string to milliseconds.\n\n    ### Arguments\n    - string: the string to convert\n    - precision: the number of decimals to round to\n    - kwargs: the keyword args to convert\n\n    ### Returns\n    - the milliseconds\n\n    ### Notes\n    - You can either pass a string,\n    - or a set of keyword args (\"hour\", \"min\", \"sec\", \"ms\") to convert.\n    - If \"precision\" is set, the result is rounded to the number of decimals given.\n    - From: https://gist.github.com/Hellowlol/5f8545e999259b4371c91ac223409209\n    \"\"\"\n\n    if string:\n        hour = int(string[0:2])\n        minute = int(string[3:5])\n        sec = int(string[6:8])\n        milliseconds = int(string[10:11])\n    else:\n        hour = int(kwargs.get(\"hour\", 0))\n        minute = int(kwargs.get(\"min\", 0))\n        sec = int(kwargs.get(\"sec\", 0))\n        milliseconds = int(kwargs.get(\"ms\", 0))\n\n    result = (\n        (hour * 60 * 60 * 1000) + (minute * 60 * 1000) + (sec * 1000) + milliseconds\n    )\n\n    if precision and isinstance(precision, int):\n        return round(result, precision)\n\n    return result\n</code></pre>"},{"location":"reference/utils/github/","title":"github","text":"<p>Module for getting information about the current version of spotdl from GitHub, downloading the latest version, and checking for updates.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.RateLimitError","title":"<code>RateLimitError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Raised when the GitHub API rate limit is exceeded.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.check_for_updates","title":"<code>check_for_updates(repo=REPO)</code>","text":"<p>Check for updates to the current version.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.check_for_updates--arguments","title":"Arguments","text":"<ul> <li>repo: the repo to check (defaults to spotdl/spotify-downloader)</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.check_for_updates--returns","title":"Returns","text":"<ul> <li>the latest version</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def check_for_updates(repo: str = REPO) -&gt; str:\n    \"\"\"\n    Check for updates to the current version.\n\n    ### Arguments\n    - repo: the repo to check (defaults to spotdl/spotify-downloader)\n\n    ### Returns\n    - the latest version\n    \"\"\"\n\n    message = \"\"\n\n    latest_version = get_latest_version(repo)\n    current_version = f\"v{_version.__version__}\"  # returns \"vx.x.x\"\n\n    if latest_version != current_version:\n        message = f\"New version available: {latest_version}.\\n\\n\"\n    else:\n        message = \"No updates available.\\n\\n\"\n    try:\n        master = get_status(current_version, \"master\")\n        dev = get_status(current_version, \"dev\")\n    except RuntimeError:\n        message = \"Couldn't check for updates. You might be running a dev version.\\n\"\n        message += \"Current version: \" + current_version + \"\\n\"\n        message += \"Latest version: \" + latest_version\n        return message\n    except RateLimitError:\n        message = \"GitHub API rate limit exceeded. Couldn't check for updates.\\n\"\n        message += \"Current version: \" + current_version + \"\\n\"\n        message += \"Latest version: \" + latest_version + \"\\n\"\n        message += \"Please try again later.\"\n        return message\n\n    for branch in [\"master\", \"dev\"]:\n        name = branch.capitalize()\n        if branch == \"master\":\n            status, ahead_by, behind_by = master\n        else:\n            status, ahead_by, behind_by = dev\n\n        if status == \"behind\":\n            message += f\"{name} is {status} by {behind_by} commits.\\n\"\n        elif status == \"ahead\":\n            message += f\"{name} is {status} by {ahead_by} commits.\\n\"\n        else:\n            message += f\"{name} is up to date.\\n\"\n\n    return message\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.create_github_url","title":"<code>create_github_url(url=WEB_APP_URL)</code>","text":"<p>From the given url, produce a URL that is compatible with Github's REST API.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.create_github_url--arguments","title":"Arguments","text":"<ul> <li>url: the url to convert</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.create_github_url--notes","title":"Notes","text":"<ul> <li>Can handle blob or tree paths.</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def create_github_url(url: str = WEB_APP_URL):\n    \"\"\"\n    From the given url, produce a URL that is compatible with Github's REST API.\n\n    ### Arguments\n    - url: the url to convert\n\n    ### Notes\n    - Can handle blob or tree paths.\n    \"\"\"\n\n    repo_only_url = re.compile(\n        r\"https:\\/\\/github\\.com\\/[a-z\\d](?:[a-z\\d]|-(?=[a-z\\d])){0,38}\\/[a-zA-Z0-9]+$\"\n    )\n    re_branch = re.compile(\"/(tree|blob)/(.+?)/\")\n\n    # Check if the given url is a url to a GitHub repo. If it is, tell the\n    # user to use 'git clone' to download it\n    if re.match(repo_only_url, url):\n        raise ValueError(\n            \"The given URL is a GitHub repo. Please use 'git clone' to download it.\"\n        )\n\n    # extract the branch name from the given url (e.g master)\n    branch = re_branch.search(url)\n    if branch:\n        download_dirs = url[branch.end() :]\n        api_url = (\n            url[: branch.start()].replace(\"github.com\", \"api.github.com/repos\", 1)\n            + \"/contents/\"\n            + download_dirs\n            + \"?ref=\"\n            + branch.group(2)\n        )\n        return api_url\n\n    raise ValueError(\"The given url is not a valid GitHub url\")\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.download_github_dir","title":"<code>download_github_dir(repo_url=WEB_APP_URL, flatten=False, output_dir='./')</code>","text":"<p>Downloads the files and directories in repo_url.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.download_github_dir--arguments","title":"Arguments","text":"<ul> <li>repo_url: the url to the repo to download</li> <li>flatten: whether to flatten the directory structure</li> <li>output_dir: the directory to download the files to</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.download_github_dir--notes","title":"Notes","text":"<ul> <li>Modification of /~https://github.com/sdushantha/gitdir/blob/master/gitdir/gitdir.py</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def download_github_dir(\n    repo_url: str = WEB_APP_URL, flatten: bool = False, output_dir: str = \"./\"\n):\n    \"\"\"\n    Downloads the files and directories in repo_url.\n\n    ### Arguments\n    - repo_url: the url to the repo to download\n    - flatten: whether to flatten the directory structure\n    - output_dir: the directory to download the files to\n\n    ### Notes\n    - Modification of /~https://github.com/sdushantha/gitdir/blob/master/gitdir/gitdir.py\n    \"\"\"\n\n    # generate the url which returns the JSON data\n    api_url = create_github_url(repo_url)\n\n    dir_out = output_dir\n\n    response = requests.get(api_url, timeout=10).json()\n\n    if (\n        isinstance(response, dict)\n        and \"message\" in response.keys()\n        and \"rate limit\" in response[\"message\"]\n    ):\n        logging.error(\n            \"You have been rate limited by Github API attempting to update web client.\"\n            \"Proceeding with cached web client. Please try again later.\"\n            \"See https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting\"\n        )\n        return None\n\n    if not flatten:\n        # make a directory with the name which is taken from\n        # the actual repo\n        os.makedirs(dir_out, exist_ok=True)\n\n    if isinstance(response, dict) and response[\"type\"] == \"file\":\n        response = [response]\n\n    for file in response:\n        file_url = file[\"download_url\"]\n\n        if flatten:\n            path = os.path.join(dir_out, os.path.basename(file[\"path\"]))\n        else:\n            path = os.path.join(dir_out, file[\"path\"])\n\n        dirname = os.path.dirname(path)\n\n        if dirname != \"\":\n            os.makedirs(dirname, exist_ok=True)\n\n        if file_url is not None:\n            with open(path, \"wb\") as new_file:\n                new_file.write(requests.get(file_url, timeout=10).content)\n        else:\n            download_github_dir(file[\"html_url\"], flatten, output_dir)\n\n    return None\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.get_latest_version","title":"<code>get_latest_version(repo=REPO)</code>","text":"<p>Get the latest version of spotdl.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.get_latest_version--arguments","title":"Arguments","text":"<ul> <li>repo: the repo to check (defaults to spotdl/spotify-downloader)</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.get_latest_version--returns","title":"Returns","text":"<ul> <li>the latest version</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def get_latest_version(repo: str = REPO) -&gt; str:\n    \"\"\"\n    Get the latest version of spotdl.\n\n    ### Arguments\n    - repo: the repo to check (defaults to spotdl/spotify-downloader)\n\n    ### Returns\n    - the latest version\n    \"\"\"\n\n    url = f\"https://api.github.com/repos/{repo}/releases/latest\"\n\n    response = requests.get(url, timeout=10)\n\n    if response.status_code != 200:\n        if response.status_code == 403:\n            raise RateLimitError(\"GitHub API rate limit exceeded.\")\n\n        raise RuntimeError(\n            f\"Failed to get commit count. Status code: {response.status_code}\"\n        )\n\n    data = response.json()\n\n    return data[\"name\"]  # returns \"vx.x.x\"\n</code></pre>"},{"location":"reference/utils/github/#spotdl.utils.github.get_status","title":"<code>get_status(start, end, repo=REPO)</code>","text":"<p>Get the status of a commit range.</p>"},{"location":"reference/utils/github/#spotdl.utils.github.get_status--arguments","title":"Arguments","text":"<ul> <li>start: the starting commit/branch/tag</li> <li>end: the ending commit/branch/tag</li> <li>repo: the repo to check (defaults to spotdl/spotify-downloader)</li> </ul>"},{"location":"reference/utils/github/#spotdl.utils.github.get_status--returns","title":"Returns","text":"<ul> <li>tuple of (status, ahead_by, behind_by)</li> </ul> Source code in <code>spotdl/utils/github.py</code> <pre><code>def get_status(start: str, end: str, repo: str = REPO) -&gt; Tuple[str, int, int]:\n    \"\"\"\n    Get the status of a commit range.\n\n    ### Arguments\n    - start: the starting commit/branch/tag\n    - end: the ending commit/branch/tag\n    - repo: the repo to check (defaults to spotdl/spotify-downloader)\n\n    ### Returns\n    - tuple of (status, ahead_by, behind_by)\n    \"\"\"\n\n    url = f\"https://api.github.com/repos/{repo}/compare/{start}...{end}\"\n\n    response = requests.get(url, timeout=10)\n\n    if response.status_code != 200:\n        if response.status_code == 403:\n            raise RateLimitError(\"GitHub API rate limit exceeded.\")\n\n        raise RuntimeError(\n            f\"Failed to get commit count. Status code: {response.status_code}\"\n        )\n\n    data = response.json()\n\n    return (\n        data[\"status\"],\n        data[\"ahead_by\"],\n        data[\"behind_by\"],\n    )\n</code></pre>"},{"location":"reference/utils/logging/","title":"logging","text":"<p>Module for logging</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlFormatter","title":"<code>SpotdlFormatter</code>","text":"<p>               Bases: <code>Formatter</code></p> <p>A custom logger for spotdl.</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlFormatter.format","title":"<code>format(record)</code>","text":"<p>Format a log record.</p> Source code in <code>spotdl/utils/logging.py</code> <pre><code>def format(self, record: logging.LogRecord) -&gt; str:\n    \"\"\"\n    Format a log record.\n    \"\"\"\n\n    result = escape(super().format(record))\n\n    msg = result\n    if record.levelno == DEBUG:\n        msg = f\"[blue]{result}\"\n\n    if record.levelno == MATCH:\n        msg = f\"[magenta]{result}\"\n\n    if record.levelno == INFO:\n        msg = f\"[green]{result}\"\n\n    if record.levelno == WARNING:\n        msg = f\"[yellow]{result}\"\n\n    if record.levelno == ERROR:\n        msg = f\"[red]{result}\"\n\n    if record.levelno == CRITICAL:\n        msg = f\"[bold red]{result}\"\n\n    return msg\n</code></pre>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler","title":"<code>SpotdlHandler</code>","text":"<p>               Bases: <code>RichHandler</code></p> <p>A custom logging handler for spotdl. In this case, it's just a wrapper around the rich handler. To not highlight keywords in info messages</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler.render_message","title":"<code>render_message(record, message)</code>","text":"<p>Render message text in to Text.</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler.render_message--arguments","title":"Arguments","text":"<ul> <li>record: logging Record.</li> <li>message: String containing log message.</li> </ul>"},{"location":"reference/utils/logging/#spotdl.utils.logging.SpotdlHandler.render_message--returns","title":"Returns","text":"<ul> <li>ConsoleRenderable: Renderable to display log message.</li> </ul> Source code in <code>spotdl/utils/logging.py</code> <pre><code>def render_message(\n    self, record: logging.LogRecord, message: str\n) -&gt; \"ConsoleRenderable\":\n    \"\"\"Render message text in to Text.\n\n    ### Arguments\n    - record: logging Record.\n    - message: String containing log message.\n\n    ### Returns\n    - ConsoleRenderable: Renderable to display log message.\n    \"\"\"\n\n    use_markup = getattr(record, \"markup\", self.markup)\n    message_text = Text.from_markup(message) if use_markup else Text(message)\n\n    highlighter = getattr(record, \"highlighter\", self.highlighter)\n\n    # Don't highlight info messages\n    if highlighter and record.levelno != INFO:\n        message_text = highlighter(message_text)\n\n    if not hasattr(self, \"keywords\"):\n        self.keywords = self.KEYWORDS\n\n    # Don't highlight keywords in info messages\n    if self.keywords and record.levelno != INFO:\n        message_text.highlight_words(self.keywords, \"logging.keyword\")\n\n    return message_text\n</code></pre>"},{"location":"reference/utils/logging/#spotdl.utils.logging.init_logging","title":"<code>init_logging(log_level, log_format=None)</code>","text":"<p>Initialize logging for spotdl.</p>"},{"location":"reference/utils/logging/#spotdl.utils.logging.init_logging--arguments","title":"Arguments","text":"<ul> <li><code>console</code>: The console to use.</li> <li><code>log_level</code>: The log level to use.</li> </ul> Source code in <code>spotdl/utils/logging.py</code> <pre><code>def init_logging(log_level: str, log_format: Optional[str] = None):\n    \"\"\"\n    Initialize logging for spotdl.\n\n    ### Arguments\n    - `console`: The console to use.\n    - `log_level`: The log level to use.\n    \"\"\"\n\n    # Don't log too much\n    logging.getLogger(\"requests\").setLevel(logging.WARNING)\n    logging.getLogger(\"urllib3\").setLevel(logging.WARNING)\n    logging.getLogger(\"spotipy\").setLevel(logging.WARNING)\n    logging.getLogger(\"asyncio\").setLevel(logging.WARNING)\n    logging.getLogger(\"syncedlyrics\").setLevel(logging.WARNING)\n    logging.getLogger(\"bandcamp_api\").setLevel(logging.WARNING)\n    logging.getLogger(\"beautifulsoup4\").setLevel(logging.WARNING)\n    logging.getLogger(\"pytube\").setLevel(logging.ERROR)\n\n    # Create console\n    console = get_console()\n    console.push_theme(THEME)\n\n    # Add matching level loggers\n    logging.addLevelName(MATCH, \"MATCH\")\n\n    # Create a rich handler\n    rich_handler = SpotdlHandler(\n        show_time=log_level == \"DEBUG\",\n        log_time_format=\"[%X]\",\n        omit_repeated_times=False,\n        console=console,\n        level=log_level,\n        markup=True,\n        show_path=log_level == \"DEBUG\",\n        show_level=log_level == \"DEBUG\",\n        rich_tracebacks=True,\n    )\n\n    msg_format = \"%(message)s\"\n    if log_format is None:\n        if log_level == \"DEBUG\":\n            msg_format = \"%(threadName)s - %(message)s\"\n    else:\n        msg_format = log_format\n\n    # Add rich handler to spotdl logger\n    rich_handler.setFormatter(SpotdlFormatter(msg_format))\n\n    # Create spotdl logger\n    spotdl_logger = logging.getLogger(\"spotdl\")\n\n    # Setup spotdl logger\n    spotdl_logger.setLevel(log_level)\n    spotdl_logger.addHandler(rich_handler)\n\n    # Install rich traceback handler\n    install(show_locals=False, extra_lines=1, console=console)\n</code></pre>"},{"location":"reference/utils/lrc/","title":"lrc","text":"<p>LRC related functions</p>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.generate_lrc","title":"<code>generate_lrc(song, output_file)</code>","text":"<p>Generates an LRC file for the current song</p>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.generate_lrc--arguments","title":"Arguments","text":"<ul> <li>song: Song object</li> <li>output_file: Path to the output file</li> </ul> Source code in <code>spotdl/utils/lrc.py</code> <pre><code>def generate_lrc(song: Song, output_file: Path):\n    \"\"\"\n    Generates an LRC file for the current song\n\n    ### Arguments\n    - song: Song object\n    - output_file: Path to the output file\n    \"\"\"\n\n    if song.lyrics and has_translation(song.lyrics):\n        lrc_data = song.lyrics\n    else:\n        try:\n            lrc_data = syncedlyrics_search(song.display_name)\n        except Exception:\n            lrc_data = None\n\n    if lrc_data:\n        Lyrics(lrc_data).save_lrc_file(\n            str(output_file.with_suffix(\".lrc\")), TargetType.PREFER_SYNCED\n        )\n        logger.debug(\"Saved lrc file for %s\", song.display_name)\n    else:\n        logger.debug(\"No lrc file found for %s\", song.display_name)\n</code></pre>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.remomve_lrc","title":"<code>remomve_lrc(lyrics)</code>","text":"<p>Removes lrc tags from lyrics</p>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.remomve_lrc--arguments","title":"Arguments","text":"<ul> <li>lyrics: Lyrics string</li> </ul>"},{"location":"reference/utils/lrc/#spotdl.utils.lrc.remomve_lrc--returns","title":"Returns","text":"<ul> <li>Lyrics string without lrc tags</li> </ul> Source code in <code>spotdl/utils/lrc.py</code> <pre><code>def remomve_lrc(lyrics: str) -&gt; str:\n    \"\"\"\n    Removes lrc tags from lyrics\n\n    ### Arguments\n    - lyrics: Lyrics string\n\n    ### Returns\n    - Lyrics string without lrc tags\n    \"\"\"\n\n    return re.sub(r\"\\[.*?\\]\", \"\", lyrics)\n</code></pre>"},{"location":"reference/utils/m3u/","title":"m3u","text":"<p>Module for creating m3u content and writing it to a file.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_content","title":"<code>create_m3u_content(song_list, template, file_extension, restrict=None, short=False, detect_formats=None)</code>","text":"<p>Create m3u content and return it as a string.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_content--arguments","title":"Arguments","text":"<ul> <li>song_list: the list of songs</li> <li>template: the template to use</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>detect_formats: the formats to detect for existing files</li> </ul>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_content--returns","title":"Returns","text":"<ul> <li>the m3u content as a string</li> </ul> Source code in <code>spotdl/utils/m3u.py</code> <pre><code>def create_m3u_content(\n    song_list: List[Song],\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    detect_formats: Optional[List[str]] = None,\n) -&gt; str:\n    \"\"\"\n    Create m3u content and return it as a string.\n\n    ### Arguments\n    - song_list: the list of songs\n    - template: the template to use\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - detect_formats: the formats to detect for existing files\n\n    ### Returns\n    - the m3u content as a string\n    \"\"\"\n\n    text = \"#EXTM3U\\n\"\n\n    for song in song_list:\n        metadata = create_file_name(\n            song, \"#EXTINF:{duration},{album-artist} - {title}\", \"\"\n        )\n        text += str(metadata) + \"\\n\"\n\n        if not detect_formats:\n            file_name = create_file_name(\n                song, template, file_extension, restrict, short\n            )\n\n            text += str(file_name) + \"\\n\"\n        else:\n            for file_ext in detect_formats:\n                file_name = create_file_name(song, template, file_ext, restrict, short)\n\n                if file_name.exists():\n                    text += str(file_name) + \"\\n\"\n                    break\n\n                file_name = create_file_name(\n                    song, template, file_extension, restrict, short\n                )\n                text += str(file_name) + \"\\n\"\n\n    return text\n</code></pre>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_file","title":"<code>create_m3u_file(file_name, song_list, template, file_extension, restrict=None, short=False, detect_formats=None)</code>","text":"<p>Create the m3u file.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_file--arguments","title":"Arguments","text":"<ul> <li>file_name: the file name to use</li> <li>song_list: the list of songs</li> <li>template: the template to use</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>detect_formats: the formats to detect</li> </ul>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.create_m3u_file--returns","title":"Returns","text":"<ul> <li>the m3u content as a string</li> </ul> Source code in <code>spotdl/utils/m3u.py</code> <pre><code>def create_m3u_file(\n    file_name: str,\n    song_list: List[Song],\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    detect_formats: Optional[List[str]] = None,\n) -&gt; str:\n    \"\"\"\n    Create the m3u file.\n\n    ### Arguments\n    - file_name: the file name to use\n    - song_list: the list of songs\n    - template: the template to use\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - detect_formats: the formats to detect\n\n    ### Returns\n    - the m3u content as a string\n    \"\"\"\n\n    m3u_content = create_m3u_content(\n        song_list,\n        template,\n        file_extension,\n        restrict,\n        short,\n        detect_formats,\n    )\n\n    file_path = Path(\n        *(sanitize_string(part) for part in Path(file_name).parts)\n    ).absolute()\n\n    with open(file_path, \"w\", encoding=\"utf-8\") as m3u_file:\n        m3u_file.write(m3u_content)\n\n    return m3u_content\n</code></pre>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.gen_m3u_files","title":"<code>gen_m3u_files(songs, file_name, template, file_extension, restrict=None, short=False, detect_formats=None)</code>","text":"<p>Create an m3u8 filename from the query.</p>"},{"location":"reference/utils/m3u/#spotdl.utils.m3u.gen_m3u_files--arguments","title":"Arguments","text":"<ul> <li>songs: the list of songs</li> <li>file_name: the file name to use</li> <li>template: the output file template to use</li> <li>file_extension: the file extension to use</li> <li>restrict: sanitization to apply to the filename</li> <li>short: whether to use the short version of the template</li> <li>detect_formats: the formats to detect</li> </ul> Source code in <code>spotdl/utils/m3u.py</code> <pre><code>def gen_m3u_files(\n    songs: List[Song],\n    file_name: Optional[str],\n    template: str,\n    file_extension: str,\n    restrict: Optional[str] = None,\n    short: bool = False,\n    detect_formats: Optional[List[str]] = None,\n):\n    \"\"\"\n    Create an m3u8 filename from the query.\n\n    ### Arguments\n    - songs: the list of songs\n    - file_name: the file name to use\n    - template: the output file template to use\n    - file_extension: the file extension to use\n    - restrict: sanitization to apply to the filename\n    - short: whether to use the short version of the template\n    - detect_formats: the formats to detect\n    \"\"\"\n\n    # If no file name is provided, use the first list's name\n    if not file_name:\n        file_name = \"{list[0]}.m3u8\"\n\n    # If file_name ends with a slash. Does not have a m3u8 name with extension\n    # at the end of the template, append `{list[0]}`` to it\n    if (\n        file_name.endswith(\"/\")\n        or file_name.endswith(r\"\\\\\")\n        or file_name.endswith(\"\\\\\\\\\")\n    ):\n        file_name += \"/{list[0]}.m3u8\"\n\n    # Check if the file name ends with .m3u or .m3u8\n    if not file_name.endswith(\".m3u\") and not file_name.endswith(\".m3u8\"):\n        file_name += \".m3u8\"\n\n    lists_object: Dict[str, List[Song]] = {}\n    for song in songs:\n        if song.list_name is None:\n            continue\n\n        if song.list_name not in lists_object:\n            lists_object[song.list_name] = []\n\n        lists_object[song.list_name].append(song)\n\n    if \"{list}\" in file_name:\n        # Create multiple m3u files if there are multiple lists\n        for list_name, song_list in lists_object.items():\n            create_m3u_file(\n                file_name.format(\n                    list=list_name,\n                ),\n                song_list,\n                template,\n                file_extension,\n                restrict,\n                short,\n                detect_formats,\n            )\n    elif \"{list[\" in file_name and \"]}\" in file_name:\n        # Create a single m3u file for specified song list name\n        create_m3u_file(\n            file_name.format(list=list(lists_object.keys())),\n            songs,\n            template,\n            file_extension,\n            restrict,\n            short,\n            detect_formats,\n        )\n    else:\n        # Use the provided file name\n        create_m3u_file(\n            file_name,\n            songs,\n            template,\n            file_extension,\n            restrict,\n            short,\n            detect_formats,\n        )\n</code></pre>"},{"location":"reference/utils/matching/","title":"matching","text":"<p>Module for all things matching related</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup1","title":"<code>artists_match_fixup1(song, result, score)</code>","text":"<p>Multiple fixes to the artists score for not verified results to improve the accuracy</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup1--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> <li>score: current score</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup1--returns","title":"Returns","text":"<ul> <li>new score</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def artists_match_fixup1(song: Song, result: Result, score: float) -&gt; float:\n    \"\"\"\n    Multiple fixes to the artists score for\n    not verified results to improve the accuracy\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n    - score: current score\n\n    ### Returns\n    - new score\n    \"\"\"\n\n    # If we have a verified result, we don't have to fix anything\n    if result.verified or score &gt; 50:\n        return score\n\n    # If we didn't find any artist match,\n    # we fallback to channel name match\n    channel_name_match = ratio(\n        slugify(song.artist),\n        slugify(\", \".join(result.artists)) if result.artists else \"\",\n    )\n\n    score = max(score, channel_name_match)\n\n    # If artist match is still too low,\n    # we fallback to matching all song artist names\n    # with the result's title\n    if score &lt;= 70:\n        artist_title_match = 0.0\n        result_name = slugify(result.name).replace(\"-\", \"\")\n        for artist in song.artists:\n            slug_artist = slugify(artist).replace(\"-\", \"\")\n\n            if slug_artist in result_name:\n                artist_title_match += 1.0\n\n        artist_title_match = (artist_title_match / len(song.artists)) * 100\n\n        score = max(score, artist_title_match)\n\n    # If artist match is still too low,\n    # we fallback to matching all song artist names\n    # with the result's artists\n    if score &lt;= 70:\n        # Song artists: ['charlie-moncler', 'fukaj', 'mata', 'pedro']\n        # Result artists: ['fukaj-mata-charlie-moncler-und-pedro']\n\n        # For artist_list1\n        artist_list1 = []\n        for artist in song.artists:\n            artist_list1.extend(slugify(artist).split(\"-\"))\n\n        # For artist_list2\n        artist_list2 = []\n        if result.artists:\n            for artist in result.artists:\n                artist_list2.extend(slugify(artist).split(\"-\"))\n\n        artist_tuple1 = tuple(artist_list1)\n        artist_tuple2 = tuple(artist_list2)\n\n        artist_title_match = ratio(artist_tuple1, artist_tuple2)\n\n        score = max(score, artist_title_match)\n\n    return score\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup2","title":"<code>artists_match_fixup2(song, result, score, search_query=None)</code>","text":"<p>Multiple fixes to the artists score for verified results to improve the accuracy</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup2--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> <li>score: current score</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup2--returns","title":"Returns","text":"<ul> <li>new score</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def artists_match_fixup2(\n    song: Song, result: Result, score: float, search_query: Optional[str] = None\n) -&gt; float:\n    \"\"\"\n    Multiple fixes to the artists score for\n    verified results to improve the accuracy\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n    - score: current score\n\n    ### Returns\n    - new score\n    \"\"\"\n\n    if score &gt; 70 or not result.verified:\n        # Don't fixup the score\n        # if the artist match is already high\n        # or if the result is not verified\n        return score\n\n    # Slugify some variables\n    slug_song_name = slugify(song.name)\n    slug_result_name = slugify(result.name)\n\n    # # Check if the main artist is simlar\n    has_main_artist = (score / (2 if len(song.artists) &gt; 1 else 1)) &gt; 50\n\n    _, match_str2 = create_match_strings(song, result, search_query)\n\n    # Check if other song artists are in the result name\n    # if they are, we increase the artist match\n    # (main artist is already checked, so we skip it)\n    artists_to_check = song.artists[int(has_main_artist) :]\n    for artist in artists_to_check:\n        artist = slugify(artist).replace(\"-\", \"\")\n        if artist in match_str2.replace(\"-\", \"\"):\n            score += 5\n\n    # if the artist match is still too low,\n    # we fallback to matching all song artist names\n    # with the result's artists\n    if score &lt;= 70:\n        # Artists from song/result name without the song/result name words\n        artist_list1 = create_clean_string(song.artists, slug_song_name, True)\n        artist_list2 = create_clean_string(\n            list(result.artists) if result.artists else [result.author],\n            slug_result_name,\n            True,\n        )\n\n        artist_title_match = ratio(artist_list1, artist_list2)\n\n        score = max(score, artist_title_match)\n\n    return score\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup3","title":"<code>artists_match_fixup3(song, result, score)</code>","text":"<p>Calculate match percentage based result's name and song's title if the result has exactly one artist and the song has more than one artist</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup3--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> <li>score: current score</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.artists_match_fixup3--returns","title":"Returns","text":"<ul> <li>new score</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def artists_match_fixup3(song: Song, result: Result, score: float) -&gt; float:\n    \"\"\"\n    Calculate match percentage based result's name\n    and song's title if the result has exactly one artist\n    and the song has more than one artist\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n    - score: current score\n\n    ### Returns\n    - new score\n    \"\"\"\n\n    if (\n        score &gt; 70\n        or not result.artists\n        or len(result.artists) &gt; 1\n        or len(song.artists) == 1\n    ):\n        # Don't fixup the score\n        # if the score is already high\n        # or if the result has more than one artist\n        # or if the song has only one artist\n        return score\n\n    artists_score_fixup = ratio(\n        slugify(result.name),\n        slugify(create_song_title(song.name, [song.artist])),\n    )\n\n    if artists_score_fixup &gt;= 80:\n        score = (score + artists_score_fixup) / 2\n\n    # Make sure that the score is not higher than 100\n    score = min(score, 100)\n\n    return score\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.based_sort","title":"<code>based_sort(strings, based_on)</code>","text":"<p>Sort strings in list based on the order of strings in <code>based_on</code> list</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.based_sort--arguments","title":"Arguments","text":"<ul> <li>strings: strings to sort</li> <li>based_on: strings to sort <code>strings</code> list based on</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.based_sort--returns","title":"Returns","text":"<ul> <li>sorted list of strings</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def based_sort(strings: List[str], based_on: List[str]) -&gt; Tuple[List[str], List[str]]:\n    \"\"\"\n    Sort strings in list based on the order of strings in `based_on` list\n\n    ### Arguments\n    - strings: strings to sort\n    - based_on: strings to sort `strings` list based on\n\n    ### Returns\n    - sorted list of strings\n    \"\"\"\n\n    strings.sort()\n    based_on.sort()\n\n    list_map = {value: index for index, value in enumerate(based_on)}\n\n    strings = sorted(\n        strings,\n        key=lambda x: list_map.get(x, -1),\n        reverse=True,\n    )\n\n    based_on.reverse()\n\n    return strings, based_on\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_album_match","title":"<code>calc_album_match(song, result)</code>","text":"<p>Calculate album match percentage</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_album_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_album_match--returns","title":"Returns","text":"<ul> <li>album match percentage</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_album_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Calculate album match percentage\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - album match percentage\n    \"\"\"\n\n    if not result.album:\n        return 0.0\n\n    return ratio(slugify(song.album_name), slugify(result.album))\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_artists_match","title":"<code>calc_artists_match(song, result)</code>","text":"<p>Check if all artists are present in list of artists</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_artists_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_artists_match--returns","title":"Returns","text":"<ul> <li>artists match percentage</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_artists_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Check if all artists are present in list of artists\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - artists match percentage\n    \"\"\"\n\n    artist_match_number = 0.0\n\n    # Result has only one artist, return 0.0\n    if len(song.artists) == 1 or not result.artists:\n        return artist_match_number\n\n    artist1_list, artist2_list = based_sort(\n        list(map(slugify, song.artists)), list(map(slugify, result.artists))\n    )\n\n    # Remove main artist from the lists\n    artist1_list, artist2_list = artist1_list[1:], artist2_list[1:]\n\n    artists_match = 0.0\n    for artist1, artist2 in zip_longest(artist1_list, artist2_list):\n        artist12_match = ratio(artist1, artist2)\n        artists_match += artist12_match\n\n    artist_match_number = artists_match / len(artist1_list)\n\n    return artist_match_number\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_main_artist_match","title":"<code>calc_main_artist_match(song, result)</code>","text":"<p>Check if main artist is present in list of artists</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_main_artist_match--arguments","title":"Arguments","text":"<ul> <li>main_artist: main artist to check</li> <li>artists: list of artists to check</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_main_artist_match--returns","title":"Returns","text":"<ul> <li>True if main artist is present in list of artists, False otherwise</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_main_artist_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Check if main artist is present in list of artists\n\n    ### Arguments\n    - main_artist: main artist to check\n    - artists: list of artists to check\n\n    ### Returns\n    - True if main artist is present in list of artists, False otherwise\n    \"\"\"\n\n    main_artist_match = 0.0\n\n    # Result has no artists, return 0.0\n    if not result.artists:\n        return main_artist_match\n\n    song_artists, result_artists = list(map(slugify, song.artists)), list(\n        map(slugify, result.artists)\n    )\n    sorted_song_artists, sorted_result_artists = based_sort(\n        song_artists, result_artists\n    )\n\n    debug(song.song_id, result.result_id, f\"Song artists: {sorted_song_artists}\")\n    debug(song.song_id, result.result_id, f\"Result artists: {sorted_result_artists}\")\n\n    slug_song_main_artist = slugify(song.artists[0])\n    slug_result_main_artist = sorted_result_artists[0]\n\n    # Result has only one artist, but song has multiple artists\n    # we can assume that other artists are in the main artist name\n    if len(song.artists) &gt; 1 and len(result.artists) == 1:\n        for artist in map(slugify, song.artists[1:]):\n            artist = sort_string(slugify(artist).split(\"-\"), \"-\")\n\n            res_main_artist = sort_string(slug_result_main_artist.split(\"-\"), \"-\")\n\n            if artist in res_main_artist:\n                main_artist_match += 100 / len(song.artists)\n\n        return main_artist_match\n\n    # Match main result artist with main song artist\n    main_artist_match = ratio(slug_song_main_artist, slug_result_main_artist)\n\n    debug(\n        song.song_id, result.result_id, f\"First main artist match: {main_artist_match}\"\n    )\n\n    # Use second artist from the sorted list to\n    # calculate the match if the first artist match is too low\n    if main_artist_match &lt; 50 and len(song_artists) &gt; 1:\n        for song_artist, result_artist in product(\n            song_artists[:2], sorted_result_artists[:2]\n        ):\n            new_artist_match = ratio(song_artist, result_artist)\n            debug(\n                song.song_id,\n                result.result_id,\n                f\"Matched {song_artist} with {result_artist}: {new_artist_match}\",\n            )\n\n            main_artist_match = max(main_artist_match, new_artist_match)\n\n    return main_artist_match\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_name_match","title":"<code>calc_name_match(song, result, search_query=None)</code>","text":"<p>Calculate name match percentage</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_name_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_name_match--returns","title":"Returns","text":"<ul> <li>name match percentage</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_name_match(\n    song: Song, result: Result, search_query: Optional[str] = None\n) -&gt; float:\n    \"\"\"\n    Calculate name match percentage\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - name match percentage\n    \"\"\"\n\n    # Create match strings that will be used\n    # to calculate name match value\n    match_str1, match_str2 = create_match_strings(song, result, search_query)\n    result_name, song_name = slugify(result.name), slugify(song.name)\n\n    res_list, song_list = based_sort(result_name.split(\"-\"), song_name.split(\"-\"))\n    result_name, song_name = \"-\".join(res_list), \"-\".join(song_list)\n\n    # Calculate initial name match\n    name_match = ratio(result_name, song_name)\n\n    debug(song.song_id, result.result_id, f\"MATCH STRINGS: {match_str1} - {match_str2}\")\n    debug(\n        song.song_id,\n        result.result_id,\n        f\"SLUG MATCH STRINGS: {song_name} - {result_name}\",\n    )\n    debug(song.song_id, result.result_id, f\"First name match: {name_match}\")\n\n    # If name match is lower than 60%,\n    # we try to match using the test strings\n    if name_match &lt;= 75:\n        second_name_match = ratio(\n            match_str1,\n            match_str2,\n        )\n\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Second name match: {second_name_match}\",\n        )\n\n        name_match = max(name_match, second_name_match)\n\n    return name_match\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_time_match","title":"<code>calc_time_match(song, result)</code>","text":"<p>Calculate time difference between song and result</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_time_match--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.calc_time_match--returns","title":"Returns","text":"<ul> <li>time difference between song and result</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def calc_time_match(song: Song, result: Result) -&gt; float:\n    \"\"\"\n    Calculate time difference between song and result\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - time difference between song and result\n    \"\"\"\n\n    time_diff = abs(song.duration - result.duration)\n    score = exp(-0.1 * time_diff)\n    return score * 100\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_common_word","title":"<code>check_common_word(song, result)</code>","text":"<p>Check if a word is present in a sentence</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_common_word--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_common_word--returns","title":"Returns","text":"<ul> <li>True if word is present in sentence, False otherwise</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def check_common_word(song: Song, result: Result) -&gt; bool:\n    \"\"\"\n    Check if a word is present in a sentence\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - True if word is present in sentence, False otherwise\n    \"\"\"\n\n    sentence_words = slugify(song.name).split(\"-\")\n    to_check = slugify(result.name).replace(\"-\", \"\")\n\n    for word in sentence_words:\n        if word != \"\" and word in to_check:\n            return True\n\n    return False\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_forbidden_words","title":"<code>check_forbidden_words(song, result)</code>","text":"<p>Check if a forbidden word is present in the result name</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_forbidden_words--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.check_forbidden_words--returns","title":"Returns","text":"<ul> <li>True if forbidden word is present in result name, False otherwise</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def check_forbidden_words(song: Song, result: Result) -&gt; Tuple[bool, List[str]]:\n    \"\"\"\n    Check if a forbidden word is present in the result name\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - True if forbidden word is present in result name, False otherwise\n    \"\"\"\n\n    song_name = slugify(song.name).replace(\"-\", \"\")\n    to_check = slugify(result.name).replace(\"-\", \"\")\n\n    words = []\n    for word in FORBIDDEN_WORDS:\n        if word in to_check and word not in song_name:\n            words.append(word)\n\n    return len(words) &gt; 0, words\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_clean_string","title":"<code>create_clean_string(words, string, sort=False, join_str='-')</code>","text":"<p>Create a string with strings from <code>words</code> list if they are not yet present in <code>string</code></p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_clean_string--arguments","title":"Arguments","text":"<ul> <li>words: strings to check</li> <li>string: string to check if strings are present in</li> <li>sort: sort strings in list</li> <li>join_str: string to join strings with</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_clean_string--returns","title":"Returns","text":"<ul> <li>string with strings from <code>words</code> list</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def create_clean_string(\n    words: List[str], string: str, sort: bool = False, join_str: str = \"-\"\n) -&gt; str:\n    \"\"\"\n    Create a string with strings from `words` list\n    if they are not yet present in `string`\n\n    ### Arguments\n    - words: strings to check\n    - string: string to check if strings are present in\n    - sort: sort strings in list\n    - join_str: string to join strings with\n\n    ### Returns\n    - string with strings from `words` list\n    \"\"\"\n\n    string = slugify(string).replace(\"-\", \"\")\n\n    final = []\n    for word in words:\n        word = slugify(word).replace(\"-\", \"\")\n\n        if word in string:\n            continue\n\n        final.append(word)\n\n    if sort:\n        return sort_string(final, join_str)\n\n    return f\"{join_str}\".join(final)\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_match_strings","title":"<code>create_match_strings(song, result, search_query=None)</code>","text":"<p>Create strings based on song and result to match fill strings with missing artists</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_match_strings--arguments","title":"Arguments","text":"<ul> <li>song: song to match</li> <li>result: result to match</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.create_match_strings--returns","title":"Returns","text":"<ul> <li>tuple of strings to match</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def create_match_strings(\n    song: Song, result: Result, search_query: Optional[str] = None\n) -&gt; Tuple[str, str]:\n    \"\"\"\n    Create strings based on song and result to match\n    fill strings with missing artists\n\n    ### Arguments\n    - song: song to match\n    - result: result to match\n\n    ### Returns\n    - tuple of strings to match\n    \"\"\"\n\n    slug_song_name = slugify(song.name)\n    slug_song_title = slugify(\n        create_song_title(song.name, song.artists)\n        if not search_query\n        else create_search_query(song, search_query, False, None, True)\n    )\n\n    test_str1 = slugify(result.name)\n    test_str2 = slug_song_name if result.verified else slug_song_title\n\n    # Fill strings with missing artists\n    test_str1 = fill_string(song.artists, test_str1, test_str2)\n    test_str2 = fill_string(song.artists, test_str2, test_str1)\n\n    # Sort both strings and then join them\n    test_list1, test_list2 = based_sort(test_str1.split(\"-\"), test_str2.split(\"-\"))\n    test_str1, test_str2 = \"-\".join(test_list1), \"-\".join(test_list2)\n\n    return test_str1, test_str2\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.debug","title":"<code>debug(song_id, result_id, message)</code>","text":"<p>Log a message with MATCH level</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.debug--arguments","title":"Arguments","text":"<ul> <li>message: message to log</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def debug(song_id: str, result_id: str, message: str) -&gt; None:\n    \"\"\"\n    Log a message with MATCH level\n\n    ### Arguments\n    - message: message to log\n    \"\"\"\n\n    logger.log(MATCH, \"[%s|%s] %s\", song_id, result_id, message)\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.fill_string","title":"<code>fill_string(strings, main_string, string_to_check)</code>","text":"<p>Create a string with strings from <code>strings</code> list if they are not yet present in main_string but are present in string_to_check</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.fill_string--arguments","title":"Arguments","text":"<ul> <li>strings: strings to check</li> <li>main_string: string to add strings to</li> <li>string_to_check: string to check if strings are present in</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.fill_string--returns","title":"Returns","text":"<ul> <li>string with strings from <code>strings</code> list</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def fill_string(strings: List[str], main_string: str, string_to_check: str) -&gt; str:\n    \"\"\"\n    Create a string with strings from `strings` list\n    if they are not yet present in main_string\n    but are present in string_to_check\n\n    ### Arguments\n    - strings: strings to check\n    - main_string: string to add strings to\n    - string_to_check: string to check if strings are present in\n\n    ### Returns\n    - string with strings from `strings` list\n    \"\"\"\n\n    final_str = main_string\n    test_str = final_str.replace(\"-\", \"\")\n    simple_test_str = string_to_check.replace(\"-\", \"\")\n    for string in strings:\n        slug_str = slugify(string).replace(\"-\", \"\")\n\n        if slug_str in simple_test_str and slug_str not in test_str:\n            final_str += f\"-{slug_str}\"\n            test_str += slug_str\n\n    return final_str\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.get_best_matches","title":"<code>get_best_matches(results, score_threshold)</code>","text":"<p>Get best matches from a list of results</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.get_best_matches--arguments","title":"Arguments","text":"<ul> <li>results: list of results to match</li> <li>score_threshold: threshold to match results</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.get_best_matches--returns","title":"Returns","text":"<ul> <li>list of best matches</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def get_best_matches(\n    results: Dict[Result, float], score_threshold: float\n) -&gt; List[Tuple[Result, float]]:\n    \"\"\"\n    Get best matches from a list of results\n\n    ### Arguments\n    - results: list of results to match\n    - score_threshold: threshold to match results\n\n    ### Returns\n    - list of best matches\n    \"\"\"\n\n    result_items = list(results.items())\n\n    # Sort results by highest score\n    sorted_results = sorted(result_items, key=lambda x: x[1], reverse=True)\n\n    best_score = sorted_results[0][1]\n\n    return [\n        result\n        for result in sorted_results\n        if (best_score - result[1]) &lt;= score_threshold\n    ]\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.order_results","title":"<code>order_results(results, song, search_query=None)</code>","text":"<p>Order results.</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.order_results--arguments","title":"Arguments","text":"<ul> <li>results: The results to order.</li> <li>song: The song to order for.</li> <li>search_query: The search query.</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.order_results--returns","title":"Returns","text":"<ul> <li>The ordered results.</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def order_results(\n    results: List[Result],\n    song: Song,\n    search_query: Optional[str] = None,\n) -&gt; Dict[Result, float]:\n    \"\"\"\n    Order results.\n\n    ### Arguments\n    - results: The results to order.\n    - song: The song to order for.\n    - search_query: The search query.\n\n    ### Returns\n    - The ordered results.\n    \"\"\"\n\n    # Assign an overall avg match value to each result\n    links_with_match_value = {}\n\n    # Iterate over all results\n    for result in results:\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Calculating match value for {result.url} - {result.json}\",\n        )\n\n        # skip results that have no common words in their name\n        if not check_common_word(song, result):\n            debug(\n                song.song_id, result.result_id, \"Skipping result due to no common words\"\n            )\n\n            continue\n\n        # Calculate match value for main artist\n        artists_match = calc_main_artist_match(song, result)\n        debug(song.song_id, result.result_id, f\"Main artist match: {artists_match}\")\n\n        # Calculate match value for all artists\n        other_artists_match = calc_artists_match(song, result)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Other artists match: {other_artists_match}\",\n        )\n\n        artists_match += other_artists_match\n\n        # Calculate initial artist match value\n        debug(song.song_id, result.result_id, f\"Initial artists match: {artists_match}\")\n        artists_match = artists_match / (2 if len(song.artists) &gt; 1 else 1)\n        debug(song.song_id, result.result_id, f\"First artists match: {artists_match}\")\n\n        # First attempt to fix artist match\n        artists_match = artists_match_fixup1(song, result, artists_match)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Artists match after fixup1: {artists_match}\",\n        )\n\n        # Second attempt to fix artist match\n        artists_match = artists_match_fixup2(song, result, artists_match)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Artists match after fixup2: {artists_match}\",\n        )\n\n        # Third attempt to fix artist match\n        artists_match = artists_match_fixup3(song, result, artists_match)\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Artists match after fixup3: {artists_match}\",\n        )\n\n        debug(song.song_id, result.result_id, f\"Final artists match: {artists_match}\")\n\n        # Calculate name match\n        name_match = calc_name_match(song, result, search_query)\n        debug(song.song_id, result.result_id, f\"Initial name match: {name_match}\")\n\n        # Check if result contains forbidden words\n        contains_fwords, found_fwords = check_forbidden_words(song, result)\n        if contains_fwords:\n            for _ in found_fwords:\n                name_match -= 15\n\n        debug(\n            song.song_id,\n            result.result_id,\n            f\"Contains forbidden words: {contains_fwords}, {found_fwords}\",\n        )\n        debug(song.song_id, result.result_id, f\"Final name match: {name_match}\")\n\n        # Calculate album match\n        album_match = calc_album_match(song, result)\n        debug(song.song_id, result.result_id, f\"Final album match: {album_match}\")\n\n        # Calculate time match\n        time_match = calc_time_match(song, result)\n        debug(song.song_id, result.result_id, f\"Final time match: {time_match}\")\n\n        # Ignore results with name match lower than 60%\n        if name_match &lt;= 60:\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to name match lower than 60%\",\n            )\n            continue\n\n        # Ignore results with artists match lower than 70%\n        if artists_match &lt; 70 and result.source != \"slider.kz\":\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to artists match lower than 70%\",\n            )\n            continue\n\n        # Calculate total match\n        average_match = (artists_match + name_match) / 2\n        debug(song.song_id, result.result_id, f\"Average match: {average_match}\")\n\n        if (\n            result.verified\n            and not result.isrc_search\n            and result.album\n            and album_match &lt;= 80\n        ):\n            # we are almost certain that this is the correct result\n            # so we add the album match to the average match\n            average_match = (average_match + album_match) / 2\n            debug(\n                song.song_id,\n                result.result_id,\n                f\"Average match /w album match: {average_match}\",\n            )\n\n        # Skip results with time match lower than 25%\n        if time_match &lt; 25:\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to time match lower than 25%\",\n            )\n            continue\n\n        # If the time match is lower than 50%\n        # and the average match is lower than 75%\n        # we skip the result\n        if time_match &lt; 50 and average_match &lt; 75:\n            debug(\n                song.song_id,\n                result.result_id,\n                \"Skipping result due to time match &lt; 50% and average match &lt; 75%\",\n            )\n            continue\n\n        if (\n            (not result.isrc_search and average_match &lt;= 85)\n            or result.source == \"slider.kz\"\n            or time_match &lt; 0\n        ):\n            # Don't add time to avg match if average match is not the best\n            # (lower than 85%), always include time match if result is from\n            # slider.kz or if time match is lower than 0\n            average_match = (average_match + time_match) / 2\n\n            debug(\n                song.song_id,\n                result.result_id,\n                f\"Average match /w time match: {average_match}\",\n            )\n\n            if (result.explicit is not None and song.explicit is not None) and (\n                result.explicit != song.explicit\n            ):\n                debug(\n                    song.song_id,\n                    result.result_id,\n                    \"Lowering average match due to explicit mismatch\",\n                )\n\n                average_match -= 5\n\n        average_match = min(average_match, 100)\n        debug(song.song_id, result.result_id, f\"Final average match: {average_match}\")\n\n        # the results along with the avg Match\n        links_with_match_value[result] = average_match\n\n    return links_with_match_value\n</code></pre>"},{"location":"reference/utils/matching/#spotdl.utils.matching.sort_string","title":"<code>sort_string(strings, join_str)</code>","text":"<p>Sort strings in list and join them with <code>join</code> string</p>"},{"location":"reference/utils/matching/#spotdl.utils.matching.sort_string--arguments","title":"Arguments","text":"<ul> <li>strings: strings to sort</li> <li>join: string to join strings with</li> </ul>"},{"location":"reference/utils/matching/#spotdl.utils.matching.sort_string--returns","title":"Returns","text":"<ul> <li>joined sorted string</li> </ul> Source code in <code>spotdl/utils/matching.py</code> <pre><code>def sort_string(strings: List[str], join_str: str) -&gt; str:\n    \"\"\"\n    Sort strings in list and join them with `join` string\n\n    ### Arguments\n    - strings: strings to sort\n    - join: string to join strings with\n\n    ### Returns\n    - joined sorted string\n    \"\"\"\n\n    final_str = strings\n    final_str.sort()\n\n    return f\"{join_str}\".join(final_str)\n</code></pre>"},{"location":"reference/utils/metadata/","title":"metadata","text":"<p>Module for embedding metadata into audio files using Mutagen.</p> <pre><code>embed_metadata(\n    output_file=Path(\"test.mp3\"),\n    song=song_object,\n    file_format=\"mp3\",\n)\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.MetadataError","title":"<code>MetadataError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to metadata and id3 embedding.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_cover","title":"<code>embed_cover(audio_file, song, encoding)</code>","text":"<p>Embed the album art in the audio file.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_cover--arguments","title":"Arguments","text":"<ul> <li>audio_file: Audio file object.</li> <li>song: Song object.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_cover(audio_file, song: Song, encoding: str):\n    \"\"\"\n    Embed the album art in the audio file.\n\n    ### Arguments\n    - audio_file: Audio file object.\n    - song: Song object.\n    \"\"\"\n\n    if not song.cover_url:\n        return audio_file\n\n    # Try to download the cover art\n    try:\n        cover_data = requests.get(\n            song.cover_url,\n            timeout=10,\n            proxies=GlobalConfig.get_parameter(\"proxies\"),\n        ).content\n    except Exception:\n        return audio_file\n\n    # Create the image object for the file type\n    if encoding in [\"flac\", \"ogg\", \"opus\"]:\n        picture = Picture()\n        picture.type = 3\n        picture.desc = \"Cover\"\n        picture.mime = \"image/jpeg\"\n        picture.data = cover_data\n\n        if encoding in [\"ogg\", \"opus\"]:\n            image_data = picture.write()\n            encoded_data = base64.b64encode(image_data)\n            vcomment_value = encoded_data.decode(\"ascii\")\n            if \"metadata_block_picture\" in audio_file.keys():\n                audio_file.pop(\"metadata_block_picture\")\n            audio_file[\"metadata_block_picture\"] = [vcomment_value]\n        elif encoding == \"flac\":\n            if audio_file.pictures:\n                audio_file.clear_pictures()\n            audio_file.add_picture(picture)\n    elif encoding == \"m4a\":\n        if M4A_TAG_PRESET[\"albumart\"] in audio_file.keys():\n            audio_file.pop(M4A_TAG_PRESET[\"albumart\"])\n        audio_file[M4A_TAG_PRESET[\"albumart\"]] = [\n            MP4Cover(\n                cover_data,\n                imageformat=MP4Cover.FORMAT_JPEG,\n            )\n        ]\n    elif encoding == \"mp3\":\n        if \"APIC:Cover\" in audio_file.keys():\n            audio_file.pop(\"APIC:Cover\")\n        audio_file[\"APIC\"] = APIC(\n            encoding=3,\n            mime=\"image/jpeg\",\n            type=3,\n            desc=\"Cover\",\n            data=cover_data,\n        )\n\n    return audio_file\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_lyrics","title":"<code>embed_lyrics(audio_file, song, encoding)</code>","text":"<p>Detect lyrics type (lrc or txt) and embed them in the audio file.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_lyrics--arguments","title":"Arguments","text":"<ul> <li>audio_file: Audio file object.</li> <li>song: Song object.</li> <li>encoding: Encoding type.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_lyrics(audio_file, song: Song, encoding: str):\n    \"\"\"\n    Detect lyrics type (lrc or txt) and embed them in the audio file.\n\n    ### Arguments\n    - audio_file: Audio file object.\n    - song: Song object.\n    - encoding: Encoding type.\n    \"\"\"\n\n    lyrics = song.lyrics\n    if not lyrics:\n        return audio_file\n\n    tag_preset = TAG_PRESET if encoding != \"m4a\" else M4A_TAG_PRESET\n\n    # Check if the lyrics are in lrc format\n    # using regex on the first 5 lines\n    lrc_lines = lyrics.splitlines()[:5]\n    lrc_lines = [line for line in lrc_lines if line and LRC_REGEX.match(line)]\n\n    if len(lrc_lines) == 0:\n        # Lyrics are not in lrc format\n        # Embed them normally\n        if encoding == \"mp3\":\n            audio_file.add(USLT(encoding=Encoding.UTF8, text=song.lyrics))\n        else:\n            audio_file[tag_preset[\"lyrics\"]] = song.lyrics\n    else:\n        # Lyrics are in lrc format\n        # Embed them as SYLT id3 tag\n        clean_lyrics = remomve_lrc(lyrics)\n        if encoding == \"mp3\":\n            lrc_data = []\n            for line in lyrics.splitlines():\n                time_tag = line.split(\"]\", 1)[0] + \"]\"\n                text = line.replace(time_tag, \"\")\n\n                time_tag = time_tag.replace(\"[\", \"\")\n                time_tag = time_tag.replace(\"]\", \"\")\n                time_tag = time_tag.replace(\".\", \":\")\n                time_tag_vals = time_tag.split(\":\")\n                if len(time_tag_vals) != 3 or any(\n                    not isinstance(tag, int) for tag in time_tag_vals\n                ):\n                    continue\n\n                minute, sec, millisecond = time_tag_vals\n                time = to_ms(min=minute, sec=sec, ms=millisecond)\n                lrc_data.append((text, time))\n\n            audio_file.add(USLT(encoding=3, text=clean_lyrics))\n            audio_file.add(SYLT(encoding=3, text=lrc_data, format=2, type=1))\n        else:\n            audio_file[tag_preset[\"lyrics\"]] = song.lyrics\n\n    return audio_file\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_metadata","title":"<code>embed_metadata(output_file, song, id3_separator='/', skip_album_art=False)</code>","text":"<p>Set ID3 tags for generic files (FLAC, OPUS, OGG)</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_metadata--arguments","title":"Arguments","text":"<ul> <li>output_file: Path to the output file.</li> <li>song: Song object.</li> <li>id3_separator: The separator used for the id3 tags.</li> <li>skip_album_art: Boolean to skip album art embedding.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_metadata(\n    output_file: Path,\n    song: Song,\n    id3_separator: str = \"/\",\n    skip_album_art: Optional[bool] = False,\n):\n    \"\"\"\n    Set ID3 tags for generic files (FLAC, OPUS, OGG)\n\n    ### Arguments\n    - output_file: Path to the output file.\n    - song: Song object.\n    - id3_separator: The separator used for the id3 tags.\n    - skip_album_art: Boolean to skip album art embedding.\n    \"\"\"\n\n    # Get the file extension for the output file\n    encoding = output_file.suffix[1:]\n\n    if encoding == \"wav\":\n        embed_wav_file(output_file, song)\n        return\n\n    # Get the tag preset for the file extension\n    tag_preset = TAG_PRESET if encoding != \"m4a\" else M4A_TAG_PRESET\n\n    try:\n        audio_file = File(str(output_file.resolve()), easy=encoding == \"mp3\")\n\n        if audio_file is None:\n            raise MetadataError(\n                f\"Unrecognized file format for {output_file} from {song.url}\"\n            )\n    except Exception as exc:\n        raise MetadataError(\"Unable to load file.\") from exc\n\n    # Embed basic metadata\n    audio_file[tag_preset[\"artist\"]] = song.artists\n    audio_file[tag_preset[\"albumartist\"]] = (\n        song.album_artist if song.album_artist else song.artist\n    )\n    audio_file[tag_preset[\"title\"]] = song.name\n    audio_file[tag_preset[\"date\"]] = song.date\n    audio_file[tag_preset[\"encodedby\"]] = song.publisher\n\n    # Embed metadata that isn't always present\n    album_name = song.album_name\n    if album_name:\n        audio_file[tag_preset[\"album\"]] = album_name\n\n    if song.genres:\n        audio_file[tag_preset[\"genre\"]] = song.genres[0].title()\n\n    if song.copyright_text:\n        audio_file[tag_preset[\"copyright\"]] = song.copyright_text\n\n    if song.download_url and encoding != \"mp3\":\n        audio_file[tag_preset[\"comment\"]] = song.download_url\n\n    # Embed some metadata in format specific ways\n    if encoding in [\"flac\", \"ogg\", \"opus\"]:\n        audio_file[\"discnumber\"] = str(song.disc_number)\n        audio_file[\"disctotal\"] = str(song.disc_count)\n        audio_file[\"tracktotal\"] = str(song.tracks_count)\n        audio_file[\"tracknumber\"] = str(song.track_number)\n        audio_file[\"woas\"] = song.url\n        audio_file[\"isrc\"] = song.isrc\n    elif encoding == \"m4a\":\n        audio_file[tag_preset[\"discnumber\"]] = [(song.disc_number, song.disc_count)]\n        audio_file[tag_preset[\"tracknumber\"]] = [(song.track_number, song.tracks_count)]\n        audio_file[tag_preset[\"explicit\"]] = (4 if song.explicit is True else 2,)\n        audio_file[tag_preset[\"woas\"]] = song.url.encode(\"utf-8\")\n    elif encoding == \"mp3\":\n        audio_file[\"tracknumber\"] = f\"{str(song.track_number)}/{str(song.tracks_count)}\"\n        audio_file[\"discnumber\"] = f\"{str(song.disc_number)}/{str(song.disc_count)}\"\n        audio_file[\"isrc\"] = song.isrc\n\n    # Mp3 specific encoding\n    if encoding == \"mp3\":\n        if id3_separator != \"/\":\n            audio_file.save(v23_sep=id3_separator, v2_version=3)\n        else:\n            audio_file.save(v2_version=3)\n\n        audio_file = ID3(str(output_file.resolve()))\n\n        audio_file.add(WOAS(encoding=3, url=song.url))\n\n        if song.download_url:\n            audio_file.add(COMM(encoding=3, text=song.download_url))\n\n        if song.popularity:\n            audio_file.add(\n                POPM(\n                    rating=int(song.popularity * 255 / 100),\n                )\n            )\n\n        if song.year:\n            audio_file.add(TYER(encoding=3, text=str(song.year)))\n\n    if not skip_album_art:\n        # Embed album art\n        audio_file = embed_cover(audio_file, song, encoding)\n\n    # Embed lyrics\n    audio_file = embed_lyrics(audio_file, song, encoding)\n\n    # Mp3 specific encoding\n    if encoding == \"mp3\":\n        audio_file.save(v23_sep=id3_separator, v2_version=3)\n    else:\n        audio_file.save()\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_wav_file","title":"<code>embed_wav_file(output_file, song)</code>","text":"<p>Embeds the song metadata into the wav file</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.embed_wav_file--arguments","title":"Arguments","text":"<ul> <li>output_file: The output file path</li> <li>song: The song object</li> <li>id3_separator: The separator used for the id3 tags</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def embed_wav_file(output_file: Path, song: Song):\n    \"\"\"\n    Embeds the song metadata into the wav file\n\n    ### Arguments\n    - output_file: The output file path\n    - song: The song object\n    - id3_separator: The separator used for the id3 tags\n    \"\"\"\n    audio = WAVE(output_file)\n    if audio is None:\n        raise ValueError(\"Invalid audio file\")\n\n    if audio.tags:\n        audio.tags.clear()\n\n    audio.add_tags()\n\n    audio.tags.add(TIT2(encoding=3, text=song.name))  # type: ignore\n    audio.tags.add(TPE1(encoding=3, text=song.artists))  # type: ignore\n    audio.tags.add(TALB(encoding=3, text=song.album_name))  # type: ignore\n    audio.tags.add(TCOM(encoding=3, text=song.publisher))  # type: ignore\n    audio.tags.add(TCON(encoding=3, text=song.genres))  # type: ignore\n    audio.tags.add(TDRC(encoding=3, text=song.date))  # type: ignore\n    audio.tags.add(  # type: ignore\n        TRCK(encoding=3, text=f\"{song.track_number}/{song.tracks_count}\")  # type: ignore\n    )\n    audio.tags.add(TDRC(encoding=3, text=song.date))  # type: ignore\n    audio.tags.add(WOAS(encoding=3, text=song.url))  # type: ignore\n    audio.tags.add(TSRC(encoding=3, text=song.isrc))  # type: ignore\n\n    if song.download_url:\n        audio.tags.add(COMM(encoding=3, text=song.download_url))  # type: ignore\n\n    if song.copyright_text:\n        audio.tags.add(TCOP(encoding=3, text=song.copyright_text))  # type: ignore\n\n    if song.popularity:\n        audio.tags.add(  # type: ignore\n            COMM(\n                encoding=3,\n                lang=\"eng\",\n                text=\"Spotify Popularity: \" + str(song.popularity),\n            )\n        )\n\n    if song.cover_url:\n        try:\n            cover_data = requests.get(song.cover_url, timeout=10).content\n            audio.tags.add(  # type: ignore\n                APIC(\n                    encoding=3, mime=\"image/jpeg\", type=3, desc=\"Cover\", data=cover_data\n                )\n            )\n        except Exception:\n            pass\n\n    if song.lyrics:\n        # Check if the lyrics are in lrc format\n        # using regex on the first 5 lines\n        lrc_lines = song.lyrics.splitlines()[:5]\n        lrc_lines = [line for line in lrc_lines if line and LRC_REGEX.match(line)]\n\n        if len(lrc_lines) == 0:\n            audio.tags.add(USLT(encoding=Encoding.UTF8, text=song.lyrics))  # type: ignore\n        else:\n            lrc_data = []\n            clean_lyrics = remomve_lrc(song.lyrics)\n            for line in song.lyrics.splitlines():\n                time_tag = line.split(\"]\", 1)[0] + \"]\"\n                text = line.replace(time_tag, \"\")\n\n                time_tag = time_tag.replace(\"[\", \"\")\n                time_tag = time_tag.replace(\"]\", \"\")\n                time_tag = time_tag.replace(\".\", \":\")\n                time_tag_vals = time_tag.split(\":\")\n                if len(time_tag_vals) != 3 or any(\n                    not isinstance(tag, int) for tag in time_tag_vals\n                ):\n                    continue\n\n                minute, sec, millisecond = time_tag_vals\n                time = to_ms(min=minute, sec=sec, ms=millisecond)\n                lrc_data.append((text, time))\n\n            audio.tags.add(USLT(encoding=3, text=clean_lyrics))  # type: ignore\n            audio.tags.add(SYLT(encoding=3, text=lrc_data, format=2, type=1))  # type: ignore\n\n    audio.save()\n</code></pre>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata","title":"<code>get_file_metadata(path, id3_separator='/')</code>","text":"<p>Get song metadata.</p>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata--arguments","title":"Arguments","text":"<ul> <li>path: Path to the song.</li> </ul>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata--returns","title":"Returns","text":"<ul> <li>Dict of song metadata.</li> </ul>"},{"location":"reference/utils/metadata/#spotdl.utils.metadata.get_file_metadata--raises","title":"Raises","text":"<ul> <li>OSError: If the file is not found.</li> <li>MetadataError: If the file is not a valid audio file.</li> </ul> Source code in <code>spotdl/utils/metadata.py</code> <pre><code>def get_file_metadata(path: Path, id3_separator: str = \"/\") -&gt; Optional[Dict[str, Any]]:\n    \"\"\"\n    Get song metadata.\n\n    ### Arguments\n    - path: Path to the song.\n\n    ### Returns\n    - Dict of song metadata.\n\n    ### Raises\n    - OSError: If the file is not found.\n    - MetadataError: If the file is not a valid audio file.\n    \"\"\"\n\n    if path.exists() is False:\n        raise OSError(f\"File not found: {path}\")\n\n    audio_file = File(str(path.resolve()))\n\n    if audio_file is None or audio_file == {}:\n        return None\n\n    song_meta: Dict[str, Any] = {}\n    for key in TAG_PRESET:\n        if path.suffix == \".m4a\":\n            val = audio_file.get(M4A_TAG_PRESET[key])\n        elif path.suffix == \".mp3\":\n            val = audio_file.get(MP3_TAG_PRESET[key])\n        else:\n            val = audio_file.get(key)\n\n        # Cover art is a special case and\n        # has to be handled before checking the val\n        # M4A is handled in the m4a section since it\n        # has data in the val variable\n        if key == \"albumart\":\n            if path.suffix == \".mp3\":\n                cover = audio_file.get(\"APIC:Cover\")\n                if cover:\n                    song_meta[\"album_art\"] = cover.data\n                else:\n                    song_meta[\"album_art\"] = None\n\n                continue\n\n            if path.suffix == \".flac\":\n                if audio_file.pictures:\n                    song_meta[\"album_art\"] = audio_file.pictures[0].data\n                else:\n                    song_meta[\"album_art\"] = None\n\n                continue\n\n            if path.suffix in [\".ogg\", \".opus\"]:\n                pictures = audio_file.get(\"metadata_block_picture\")\n                if pictures and pictures[0]:\n                    song_meta[\"album_art\"] = pictures[0]\n                else:\n                    song_meta[\"album_art\"] = None\n\n                continue\n\n        # If the tag is empty, skip it\n        if val is None:\n            # If the tag is empty but it's key is in the\n            # song object, set it to None\n            empty_key = TAG_TO_SONG.get(key)\n            if empty_key:\n                song_meta[empty_key] = None\n\n            continue\n\n        # MP3 specific decoding\n        if path.suffix == \".mp3\":\n            if key == \"woas\":\n                song_meta[\"url\"] = val.url\n            elif key == \"comment\":\n                song_meta[\"download_url\"] = val.text[0]\n            elif key == \"year\":\n                song_meta[\"year\"] = int(str(val.text[0])[:4])\n            elif key == \"date\":\n                song_meta[\"date\"] = str(val.text[0])\n            elif key in [\"tracknumber\", \"trackcount\"]:\n                count = val.text[0].split(id3_separator)\n                if len(count) == 2:\n                    song_meta[\"track_number\"] = int(count[0])\n                    song_meta[\"tracks_count\"] = int(count[1])\n                else:\n                    song_meta[\"track_number\"] = val.text[0]\n            elif key in [\"discnumber\", \"disccount\"]:\n                count = val.text[0].split(id3_separator)\n                if len(count) == 2:\n                    song_meta[\"disc_number\"] = int(count[0])\n                    song_meta[\"disc_count\"] = int(count[1])\n                else:\n                    song_meta[\"disc_number\"] = val.text[0]\n            elif key == \"artist\":\n                artists_val: str = (\n                    val.text[0] if isinstance(val.text, list) else val.text\n                )\n                song_meta[\"artists\"] = artists_val.split(id3_separator)\n            else:\n                meta_key = TAG_TO_SONG.get(key)\n                if meta_key and song_meta.get(meta_key) is None:\n                    song_meta[meta_key] = (\n                        val.text[0]\n                        if isinstance(val.text, list) and len(val.text) == 1\n                        else val.text\n                    )\n\n        # M4A specific decoding\n        elif path.suffix == \".m4a\":\n            if key == \"artist\":\n                song_meta[\"artists\"] = val\n            elif key == \"woas\":\n                song_meta[\"url\"] = val[0].decode(\"utf-8\")\n            elif key == \"explicit\":\n                song_meta[\"explicit\"] = val == [4] if val else None\n            elif key == \"year\":\n                song_meta[\"year\"] = int(str(val[0])[:4])\n            elif key == \"discnumber\":\n                song_meta[\"disc_number\"] = val[0][0]\n                song_meta[\"disc_count\"] = val[0][1]\n            elif key == \"tracknumber\":\n                song_meta[\"track_number\"] = val[0][0]\n                song_meta[\"tracks_count\"] = val[0][1]\n            else:\n                meta_key = TAG_TO_SONG.get(key)\n                if meta_key:\n                    song_meta[meta_key] = (\n                        val[0] if isinstance(val, list) and len(val) == 1 else val\n                    )\n\n        # FLAC, OGG, OPUS specific decoding\n        else:\n            if key == \"artist\":\n                song_meta[\"artists\"] = val\n            elif key == \"tracknumber\":\n                song_meta[\"track_number\"] = int(val[0])\n            elif key == \"discnumber\":\n                song_meta[\"disc_count\"] = int(val[0])\n                song_meta[\"disc_number\"] = int(val[0])\n            else:\n                meta_key = TAG_TO_SONG.get(key)\n                if meta_key:\n                    song_meta[meta_key] = (\n                        val[0] if isinstance(val, list) and len(val) == 1 else val\n                    )\n\n    # Make sure that artists is a list\n    if isinstance(song_meta[\"artists\"], str):\n        song_meta[\"artists\"] = [song_meta[\"artists\"]]\n    elif song_meta[\"artists\"] is not None:\n        song_meta[\"artists\"] = list(song_meta[\"artists\"])\n    else:\n        song_meta[\"artists\"] = []\n\n    # Make sure that genres is a list\n    if isinstance(song_meta[\"genres\"], str):\n        song_meta[\"genres\"] = [song_meta[\"genres\"]]\n\n    # Add main artist to the song meta object\n    if song_meta[\"artists\"]:\n        song_meta[\"artist\"] = song_meta[\"artists\"][0]\n    else:\n        song_meta[\"artist\"] = None\n\n    return song_meta\n</code></pre>"},{"location":"reference/utils/search/","title":"search","text":"<p>Module for creating Song objects by interacting with Spotify API or by parsing a query.</p> <p>To use this module you must first initialize the SpotifyClient.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.QueryError","title":"<code>QueryError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to query.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_album","title":"<code>create_ytm_album(url, fetch_songs=True)</code>","text":"<p>Creates a list of Song objects from an album query.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_album--arguments","title":"Arguments","text":"<ul> <li>album_query: the url of the album</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_album--returns","title":"Returns","text":"<ul> <li>a list of Song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def create_ytm_album(url: str, fetch_songs: bool = True) -&gt; Album:\n    \"\"\"\n    Creates a list of Song objects from an album query.\n\n    ### Arguments\n    - album_query: the url of the album\n\n    ### Returns\n    - a list of Song objects\n    \"\"\"\n\n    if \"?list=\" not in url or not url.startswith(\"https://music.youtube.com/\"):\n        raise ValueError(f\"Invalid album url: {url}\")\n\n    browse_id = get_ytm_client().get_album_browse_id(\n        url.split(\"?list=\")[1].split(\"&amp;\")[0]\n    )\n    if browse_id is None:\n        raise ValueError(f\"Invalid album url: {url}\")\n\n    album = get_ytm_client().get_album(browse_id)\n\n    if album is None:\n        raise ValueError(f\"Couldn't fetch album: {url}\")\n\n    metadata = {\n        \"artist\": album[\"artists\"][0][\"name\"],\n        \"name\": album[\"title\"],\n        \"url\": url,\n    }\n\n    songs = []\n    for track in album[\"tracks\"]:\n        artists = [artist[\"name\"] for artist in track[\"artists\"]]\n\n        song = Song.from_missing_data(\n            name=track[\"title\"],\n            artists=artists,\n            artist=artists[0],\n            album_name=metadata[\"name\"],\n            album_artist=metadata[\"artist\"],\n            duration=track[\"duration_seconds\"],\n            download_url=f\"https://music.youtube.com/watch?v={track['videoId']}\",\n        )\n\n        if fetch_songs:\n            song = Song.from_search_term(f\"{song.artist} - {song.name}\")\n\n        songs.append(song)\n\n    return Album(**metadata, songs=songs, urls=[song.url for song in songs])\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_playlist","title":"<code>create_ytm_playlist(url, fetch_songs=True)</code>","text":"<p>Returns a playlist object from a youtube playlist url</p>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_playlist--arguments","title":"Arguments","text":"<ul> <li>url: the url of the playlist</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.create_ytm_playlist--returns","title":"Returns","text":"<ul> <li>a Playlist object</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def create_ytm_playlist(url: str, fetch_songs: bool = True) -&gt; Playlist:\n    \"\"\"\n    Returns a playlist object from a youtube playlist url\n\n    ### Arguments\n    - url: the url of the playlist\n\n    ### Returns\n    - a Playlist object\n    \"\"\"\n\n    if not (\"?list=\" in url or \"/browse/VLPL\" in url) or not url.startswith(\n        \"https://music.youtube.com/\"\n    ):\n        raise ValueError(f\"Invalid playlist url: {url}\")\n\n    if \"/browse/VLPL\" in url:\n        playlist_id = url.split(\"/browse/\")[1]\n    else:\n        playlist_id = url.split(\"?list=\")[1]\n    playlist = get_ytm_client().get_playlist(playlist_id, None)  # type: ignore\n\n    if playlist is None:\n        raise ValueError(f\"Couldn't fetch playlist: {url}\")\n\n    metadata = {\n        \"description\": (\n            playlist[\"description\"] if playlist[\"description\"] is not None else \"\"\n        ),\n        \"author_url\": (\n            f\"https://music.youtube.com/channel/{playlist['author']['id']}\"\n            if playlist.get(\"author\") is not None\n            else \"Missing author url\"\n        ),\n        \"author_name\": (\n            playlist[\"author\"][\"name\"]\n            if playlist.get(\"author\") is not None\n            else \"Missing author\"\n        ),\n        \"cover_url\": (\n            playlist[\"thumbnails\"][0][\"url\"]\n            if playlist.get(\"thumbnails\") is not None\n            else \"Missing thumbnails\"\n        ),\n        \"name\": playlist[\"title\"],\n        \"url\": url,\n    }\n\n    songs = []\n    for track in playlist[\"tracks\"]:\n        if track[\"videoId\"] is None or track[\"isAvailable\"] is False:\n            continue\n\n        song = Song.from_missing_data(\n            name=track[\"title\"],\n            artists=(\n                [artist[\"name\"] for artist in track[\"artists\"]]\n                if track.get(\"artists\") is not None\n                else []\n            ),\n            artist=(\n                track[\"artists\"][0][\"name\"]\n                if track.get(\"artists\") is not None\n                else None\n            ),\n            album_name=(\n                track.get(\"album\", {}).get(\"name\")\n                if track.get(\"album\") is not None\n                else None\n            ),\n            duration=track.get(\"duration_seconds\"),\n            explicit=track.get(\"isExplicit\"),\n            download_url=f\"https://music.youtube.com/watch?v={track['videoId']}\",\n        )\n\n        if fetch_songs:\n            song = reinit_song(song)\n\n        songs.append(song)\n\n    return Playlist(**metadata, songs=songs, urls=[song.url for song in songs])\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.gather_known_songs","title":"<code>gather_known_songs(output, output_format)</code>","text":"<p>Gather all known songs from the output directory</p>"},{"location":"reference/utils/search/#spotdl.utils.search.gather_known_songs--arguments","title":"Arguments","text":"<ul> <li>output: Output path template</li> <li>output_format: Output format</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.gather_known_songs--returns","title":"Returns","text":"<ul> <li>Dictionary containing all known songs and their paths</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def gather_known_songs(output: str, output_format: str) -&gt; Dict[str, List[Path]]:\n    \"\"\"\n    Gather all known songs from the output directory\n\n    ### Arguments\n    - output: Output path template\n    - output_format: Output format\n\n    ### Returns\n    - Dictionary containing all known songs and their paths\n    \"\"\"\n\n    # Get the base directory from the path template\n    # Path(\"/Music/test/{artist}/{artists} - {title}.{output-ext}\") -&gt; \"/Music/test\"\n    base_dir = output.split(\"{\", 1)[0]\n    paths = Path(base_dir).glob(f\"**/*.{output_format}\")\n\n    known_songs: Dict[str, List[Path]] = {}\n    for path in paths:\n        # Try to get the song from the metadata\n        song = get_song_from_file_metadata(path)\n\n        # If the songs doesn't have metadata, try to get it from the filename\n        if song is None or song.url is None:\n            search_results = get_search_results(path.stem)\n            if len(search_results) == 0:\n                continue\n\n            song = search_results[0]\n\n        known_paths = known_songs.get(song.url)\n        if known_paths is None:\n            known_songs[song.url] = [path]\n        else:\n            known_songs[song.url].append(path)\n\n    return known_songs\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_saved_playlists","title":"<code>get_all_saved_playlists()</code>","text":"<p>Get all user playlists.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_saved_playlists--args-optional","title":"Args (optional)","text":"<ul> <li>user_url: Spotify user profile url.     If a url is mentioned, get all public playlists of that specific user.</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_saved_playlists--returns","title":"Returns","text":"<ul> <li>List of all user playlists</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_all_saved_playlists() -&gt; List[Playlist]:\n    \"\"\"\n    Get all user playlists.\n\n    ### Args (optional)\n    - user_url: Spotify user profile url.\n        If a url is mentioned, get all public playlists of that specific user.\n\n    ### Returns\n    - List of all user playlists\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    user_playlists_response = spotify_client.current_user_playlists()\n\n    if user_playlists_response is None:\n        raise SpotifyError(\"Couldn't get user playlists\")\n\n    user_playlists = user_playlists_response[\"items\"]\n    user_id = user_playlists_response[\"href\"].split(\"users/\")[-1].split(\"/\")[0]\n\n    # Fetch all saved tracks\n    while user_playlists_response and user_playlists_response[\"next\"]:\n        response = spotify_client.next(user_playlists_response)\n        if response is None:\n            break\n\n        user_playlists_response = response\n        user_playlists.extend(user_playlists_response[\"items\"])\n\n    return [\n        Playlist.from_url(playlist[\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for playlist in user_playlists\n        if playlist[\"owner\"][\"id\"] != user_id\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_user_playlists","title":"<code>get_all_user_playlists(user_url='')</code>","text":"<p>Get all user playlists.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_user_playlists--args-optional","title":"Args (optional)","text":"<ul> <li>user_url: Spotify user profile url.     If a url is mentioned, get all public playlists of that specific user.</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_all_user_playlists--returns","title":"Returns","text":"<ul> <li>List of all user playlists</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_all_user_playlists(user_url: str = \"\") -&gt; List[Playlist]:\n    \"\"\"\n    Get all user playlists.\n\n    ### Args (optional)\n    - user_url: Spotify user profile url.\n        If a url is mentioned, get all public playlists of that specific user.\n\n    ### Returns\n    - List of all user playlists\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    if user_url and not user_url.startswith(\"https://open.spotify.com/user/\"):\n        raise ValueError(f\"Invalid user profile url: {user_url}\")\n\n    user_id = user_url.split(\"https://open.spotify.com/user/\")[-1].replace(\"/\", \"\")\n\n    if user_id:\n        user_playlists_response = spotify_client.user_playlists(user_id)\n    else:\n        user_playlists_response = spotify_client.current_user_playlists()\n        user_resp = spotify_client.current_user()\n        if user_resp is None:\n            raise SpotifyError(\"Couldn't get user info\")\n\n        user_id = user_resp[\"id\"]\n\n    if user_playlists_response is None:\n        raise SpotifyError(\"Couldn't get user playlists\")\n\n    user_playlists = user_playlists_response[\"items\"]\n\n    # Fetch all saved tracks\n    while user_playlists_response and user_playlists_response[\"next\"]:\n        response = spotify_client.next(user_playlists_response)\n        if response is None:\n            break\n\n        user_playlists_response = response\n        user_playlists.extend(user_playlists_response[\"items\"])\n\n    return [\n        Playlist.from_url(playlist[\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for playlist in user_playlists\n        if playlist[\"owner\"][\"id\"] == user_id\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_search_results","title":"<code>get_search_results(search_term)</code>","text":"<p>Creates a list of Song objects from a search term.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_search_results--arguments","title":"Arguments","text":"<ul> <li>search_term: the search term to use</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_search_results--returns","title":"Returns","text":"<ul> <li>a list of Song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_search_results(search_term: str) -&gt; List[Song]:\n    \"\"\"\n    Creates a list of Song objects from a search term.\n\n    ### Arguments\n    - search_term: the search term to use\n\n    ### Returns\n    - a list of Song objects\n    \"\"\"\n\n    return Song.list_from_search_term(search_term)\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_simple_songs","title":"<code>get_simple_songs(query, use_ytm_data=False, playlist_numbering=False, albums_to_ignore=None, album_type=None, playlist_retain_track_cover=False)</code>","text":"<p>Parse query and return list containing simple song objects</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_simple_songs--arguments","title":"Arguments","text":"<ul> <li>query: List of strings containing query</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_simple_songs--returns","title":"Returns","text":"<ul> <li>List of simple song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_simple_songs(\n    query: List[str],\n    use_ytm_data: bool = False,\n    playlist_numbering: bool = False,\n    albums_to_ignore=None,\n    album_type=None,\n    playlist_retain_track_cover: bool = False,\n) -&gt; List[Song]:\n    \"\"\"\n    Parse query and return list containing simple song objects\n\n    ### Arguments\n    - query: List of strings containing query\n\n    ### Returns\n    - List of simple song objects\n    \"\"\"\n\n    songs: List[Song] = []\n    lists: List[SongList] = []\n    for request in query:\n        logger.info(\"Processing query: %s\", request)\n\n        # Remove /intl-xxx/ from Spotify URLs with regex\n        request = re.sub(r\"\\/intl-\\w+\\/\", \"/\", request)\n\n        if (\n            (  # pylint: disable=too-many-boolean-expressions\n                \"watch?v=\" in request\n                or \"youtu.be/\" in request\n                or \"soundcloud.com/\" in request\n                or \"bandcamp.com/\" in request\n            )\n            and \"open.spotify.com\" in request\n            and \"track\" in request\n            and \"|\" in request\n        ):\n            split_urls = request.split(\"|\")\n            if (\n                len(split_urls) &lt;= 1\n                or not (\n                    \"watch?v=\" in split_urls[0]\n                    or \"youtu.be\" in split_urls[0]\n                    or \"soundcloud.com/\" in split_urls[0]\n                    or \"bandcamp.com/\" in split_urls[0]\n                )\n                or \"spotify\" not in split_urls[1]\n            ):\n                raise QueryError(\n                    'Incorrect format used, please use \"YouTubeURL|SpotifyURL\"'\n                )\n\n            songs.append(\n                Song.from_missing_data(url=split_urls[1], download_url=split_urls[0])\n            )\n        elif \"music.youtube.com/watch?v\" in request:\n            track_data = get_ytm_client().get_song(request.split(\"?v=\", 1)[1])\n\n            yt_song = Song.from_search_term(\n                f\"{track_data['videoDetails']['author']} - {track_data['videoDetails']['title']}\"\n            )\n\n            if use_ytm_data:\n                yt_song.name = track_data[\"title\"]\n                yt_song.artist = track_data[\"author\"]\n                yt_song.artists = [track_data[\"author\"]]\n                yt_song.duration = track_data[\"lengthSeconds\"]\n\n            yt_song.download_url = request\n            songs.append(yt_song)\n        elif (\n            \"youtube.com/playlist?list=\" in request\n            or \"youtube.com/browse/VLPL\" in request\n        ):\n            request = request.replace(\n                \"https://www.youtube.com/\", \"https://music.youtube.com/\"\n            )\n            request = request.replace(\n                \"https://youtube.com/\", \"https://music.youtube.com/\"\n            )\n\n            split_urls = request.split(\"|\")\n            if len(split_urls) == 1:\n                if \"?list=OLAK5uy_\" in request:\n                    lists.append(create_ytm_album(request, fetch_songs=False))\n                elif \"?list=PL\" in request or \"browse/VLPL\" in request:\n                    lists.append(create_ytm_playlist(request, fetch_songs=False))\n            else:\n                if (\"spotify\" not in split_urls[1]) or not any(\n                    x in split_urls[0]\n                    for x in [\"?list=PL\", \"?list=OLAK5uy_\", \"browse/VLPL\"]\n                ):\n                    raise QueryError(\n                        'Incorrect format used, please use \"YouTubeMusicURL|SpotifyURL\". '\n                        \"Currently only supports YouTube Music playlists and albums.\"\n                    )\n\n                if (\"open.spotify.com\" in request and \"album\" in request) and (\n                    \"?list=OLAK5uy_\" in request\n                ):\n                    ytm_list: SongList = create_ytm_album(\n                        split_urls[0], fetch_songs=False\n                    )\n                    spot_list = Album.from_url(split_urls[1], fetch_songs=False)\n                elif (\"open.spotify.com\" in request and \"playlist\" in request) and (\n                    \"?list=PL\" in request or \"browse/VLPL\" in request\n                ):\n                    ytm_list = create_ytm_playlist(split_urls[0], fetch_songs=False)\n                    spot_list = Playlist.from_url(split_urls[1], fetch_songs=False)\n                else:\n                    raise QueryError(\n                        f\"URLs are not of the same type, {split_urls[0]} is not \"\n                        f\"the same type as {split_urls[1]}.\"\n                    )\n\n                if ytm_list.length != spot_list.length:\n                    raise QueryError(\n                        f\"The YouTube Music ({ytm_list.length}) \"\n                        f\"and Spotify ({spot_list.length}) lists have different lengths. \"\n                    )\n\n                if use_ytm_data:\n                    for index, song in enumerate(ytm_list.songs):\n                        song.url = spot_list.songs[index].url\n\n                    lists.append(ytm_list)\n                else:\n                    for index, song in enumerate(spot_list.songs):\n                        song.download_url = ytm_list.songs[index].download_url\n\n                    lists.append(spot_list)\n        elif \"open.spotify.com\" in request and \"track\" in request:\n            songs.append(Song.from_url(url=request))\n        elif \"https://spotify.link/\" in request:\n            resp = requests.head(request, allow_redirects=True, timeout=10)\n            full_url = resp.url\n            full_lists = get_simple_songs(\n                [full_url],\n                use_ytm_data=use_ytm_data,\n                playlist_numbering=playlist_numbering,\n                album_type=album_type,\n                playlist_retain_track_cover=playlist_retain_track_cover,\n            )\n            songs.extend(full_lists)\n        elif \"open.spotify.com\" in request and \"playlist\" in request:\n            lists.append(Playlist.from_url(request, fetch_songs=False))\n        elif \"open.spotify.com\" in request and \"album\" in request:\n            lists.append(Album.from_url(request, fetch_songs=False))\n        elif \"open.spotify.com\" in request and \"artist\" in request:\n            lists.append(Artist.from_url(request, fetch_songs=False))\n        elif \"open.spotify.com\" in request and \"user\" in request:\n            lists.extend(get_all_user_playlists(request))\n        elif \"album:\" in request:\n            lists.append(Album.from_search_term(request, fetch_songs=False))\n        elif \"playlist:\" in request:\n            lists.append(Playlist.from_search_term(request, fetch_songs=False))\n        elif \"artist:\" in request:\n            lists.append(Artist.from_search_term(request, fetch_songs=False))\n        elif request == \"saved\":\n            lists.append(Saved.from_url(request, fetch_songs=False))\n        elif request == \"all-user-playlists\":\n            lists.extend(get_all_user_playlists())\n        elif request == \"all-user-followed-artists\":\n            lists.extend(get_user_followed_artists())\n        elif request == \"all-user-saved-albums\":\n            lists.extend(get_user_saved_albums())\n        elif request == \"all-saved-playlists\":\n            lists.extend(get_all_saved_playlists())\n        elif request.endswith(\".spotdl\"):\n            with open(request, \"r\", encoding=\"utf-8\") as save_file:\n                for track in json.load(save_file):\n                    # Append to songs\n                    songs.append(Song.from_dict(track))\n        else:\n            songs.append(Song.from_search_term(request))\n\n    for song_list in lists:\n        logger.info(\n            \"Found %s songs in %s (%s)\",\n            len(song_list.urls),\n            song_list.name,\n            song_list.__class__.__name__,\n        )\n\n        for index, song in enumerate(song_list.songs):\n            song_data = song.json\n            song_data[\"list_name\"] = song_list.name\n            song_data[\"list_url\"] = song_list.url\n            song_data[\"list_position\"] = song.list_position\n            song_data[\"list_length\"] = song_list.length\n\n            if playlist_numbering:\n                song_data[\"track_number\"] = song_data[\"list_position\"]\n                song_data[\"tracks_count\"] = song_data[\"list_length\"]\n                song_data[\"album_name\"] = song_data[\"list_name\"]\n                song_data[\"disc_number\"] = 1\n                song_data[\"disc_count\"] = 1\n                if isinstance(song_list, Playlist):\n                    song_data[\"album_artist\"] = song_list.author_name\n                    song_data[\"cover_url\"] = song_list.cover_url\n\n            if playlist_retain_track_cover:\n                song_data[\"track_number\"] = song_data[\"list_position\"]\n                song_data[\"tracks_count\"] = song_data[\"list_length\"]\n                song_data[\"album_name\"] = song_data[\"list_name\"]\n                song_data[\"disc_number\"] = 1\n                song_data[\"disc_count\"] = 1\n                song_data[\"cover_url\"] = song_data[\"cover_url\"]\n                if isinstance(song_list, Playlist):\n                    song_data[\"album_artist\"] = song_list.author_name\n\n            songs.append(Song.from_dict(song_data))\n\n    # removing songs for --ignore-albums\n    original_length = len(songs)\n    if albums_to_ignore:\n        songs = [\n            song\n            for song in songs\n            if all(\n                keyword not in song.album_name.lower() for keyword in albums_to_ignore\n            )\n        ]\n        logger.info(\"Skipped %s songs (Ignored albums)\", (original_length - len(songs)))\n\n    if album_type:\n        songs = [song for song in songs if song.album_type == album_type]\n\n        logger.info(\n            \"Skipped %s songs for Album Type %s\",\n            (original_length - len(songs)),\n            album_type,\n        )\n\n    logger.debug(\"Found %s songs in %s lists\", len(songs), len(lists))\n\n    return songs\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_song_from_file_metadata","title":"<code>get_song_from_file_metadata(file, id3_separator='/')</code>","text":"<p>Get song based on the file metadata or file name</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_song_from_file_metadata--arguments","title":"Arguments","text":"<ul> <li>file: Path to file</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.get_song_from_file_metadata--returns","title":"Returns","text":"<ul> <li>Song object</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_song_from_file_metadata(file: Path, id3_separator: str = \"/\") -&gt; Optional[Song]:\n    \"\"\"\n    Get song based on the file metadata or file name\n\n    ### Arguments\n    - file: Path to file\n\n    ### Returns\n    - Song object\n    \"\"\"\n\n    file_metadata = get_file_metadata(file, id3_separator)\n\n    if file_metadata is None:\n        return None\n\n    return Song.from_missing_data(**file_metadata)\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_followed_artists","title":"<code>get_user_followed_artists()</code>","text":"<p>Get all user playlists</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_followed_artists--returns","title":"Returns","text":"<ul> <li>List of all user playlists</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_user_followed_artists() -&gt; List[Artist]:\n    \"\"\"\n    Get all user playlists\n\n    ### Returns\n    - List of all user playlists\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    user_followed_response = spotify_client.current_user_followed_artists()\n    if user_followed_response is None:\n        raise SpotifyError(\"Couldn't get user followed artists\")\n\n    user_followed_response = user_followed_response[\"artists\"]\n    user_followed = user_followed_response[\"items\"]\n\n    # Fetch all artists\n    while user_followed_response and user_followed_response[\"next\"]:\n        response = spotify_client.next(user_followed_response)\n        if response is None:\n            break\n\n        user_followed_response = response[\"artists\"]\n        user_followed.extend(user_followed_response[\"items\"])\n\n    return [\n        Artist.from_url(followed_artist[\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for followed_artist in user_followed\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_saved_albums","title":"<code>get_user_saved_albums()</code>","text":"<p>Get all user saved albums</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_user_saved_albums--returns","title":"Returns","text":"<ul> <li>List of all user saved albums</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_user_saved_albums() -&gt; List[Album]:\n    \"\"\"\n    Get all user saved albums\n\n    ### Returns\n    - List of all user saved albums\n    \"\"\"\n\n    spotify_client = SpotifyClient()\n    if spotify_client.user_auth is False:  # type: ignore\n        raise SpotifyError(\"You must be logged in to use this function\")\n\n    user_saved_albums_response = spotify_client.current_user_saved_albums()\n    if user_saved_albums_response is None:\n        raise SpotifyError(\"Couldn't get user saved albums\")\n\n    user_saved_albums = user_saved_albums_response[\"items\"]\n\n    # Fetch all saved tracks\n    while user_saved_albums_response and user_saved_albums_response[\"next\"]:\n        response = spotify_client.next(user_saved_albums_response)\n        if response is None:\n            break\n\n        user_saved_albums_response = response\n        user_saved_albums.extend(user_saved_albums_response[\"items\"])\n\n    return [\n        Album.from_url(item[\"album\"][\"external_urls\"][\"spotify\"], fetch_songs=False)\n        for item in user_saved_albums\n    ]\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.get_ytm_client","title":"<code>get_ytm_client()</code>","text":"<p>Lazily initialize the YTMusic client.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.get_ytm_client--returns","title":"Returns","text":"<ul> <li>the YTMusic client</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def get_ytm_client() -&gt; YTMusic:\n    \"\"\"\n    Lazily initialize the YTMusic client.\n\n    ### Returns\n    - the YTMusic client\n    \"\"\"\n\n    global client  # pylint: disable=global-statement\n    if client is None:\n        client = YTMusic()\n\n    return client\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.parse_query","title":"<code>parse_query(query, threads=1, use_ytm_data=False, playlist_numbering=False, album_type=None, playlist_retain_track_cover=False)</code>","text":"<p>Parse query and return list containing song object</p>"},{"location":"reference/utils/search/#spotdl.utils.search.parse_query--arguments","title":"Arguments","text":"<ul> <li>query: List of strings containing query</li> <li>threads: Number of threads to use</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.parse_query--returns","title":"Returns","text":"<ul> <li>List of song objects</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def parse_query(\n    query: List[str],\n    threads: int = 1,\n    use_ytm_data: bool = False,\n    playlist_numbering: bool = False,\n    album_type=None,\n    playlist_retain_track_cover: bool = False,\n) -&gt; List[Song]:\n    \"\"\"\n    Parse query and return list containing song object\n\n    ### Arguments\n    - query: List of strings containing query\n    - threads: Number of threads to use\n\n    ### Returns\n    - List of song objects\n    \"\"\"\n\n    songs: List[Song] = get_simple_songs(\n        query,\n        use_ytm_data=use_ytm_data,\n        playlist_numbering=playlist_numbering,\n        album_type=album_type,\n        playlist_retain_track_cover=playlist_retain_track_cover,\n    )\n\n    results = []\n    with concurrent.futures.ThreadPoolExecutor(max_workers=threads) as executor:\n        future_to_song = {executor.submit(reinit_song, song): song for song in songs}\n        for future in concurrent.futures.as_completed(future_to_song):\n            song = future_to_song[future]\n            try:\n                results.append(future.result())\n            except Exception as exc:\n                logger.error(\"%s generated an exception: %s\", song.display_name, exc)\n\n    return results\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.reinit_song","title":"<code>reinit_song(song)</code>","text":"<p>Update song object with new data from Spotify</p>"},{"location":"reference/utils/search/#spotdl.utils.search.reinit_song--arguments","title":"Arguments","text":"<ul> <li>song: Song object</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.reinit_song--returns","title":"Returns","text":"<ul> <li>Updated song object</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def reinit_song(song: Song) -&gt; Song:\n    \"\"\"\n    Update song object with new data\n    from Spotify\n\n    ### Arguments\n    - song: Song object\n\n    ### Returns\n    - Updated song object\n    \"\"\"\n\n    data = song.json\n    if data.get(\"url\"):\n        new_data = Song.from_url(data[\"url\"]).json\n    elif data.get(\"song_id\"):\n        new_data = Song.from_url(\n            \"https://open.spotify.com/track/\" + data[\"song_id\"]\n        ).json\n    elif data.get(\"name\") and data.get(\"artist\"):\n        new_data = Song.from_search_term(f\"{data['artist']} - {data['name']}\").json\n    else:\n        raise QueryError(\"Song object is missing required data to be reinitialized\")\n\n    for key in Song.__dataclass_fields__:  # type: ignore # pylint: disable=E1101\n        val = data.get(key)\n        new_val = new_data.get(key)\n        if new_val is not None and val is None:\n            data[key] = new_val\n        elif new_val is not None and val is not None:\n            data[key] = val\n\n    # return reinitialized song object\n    return Song(**data)\n</code></pre>"},{"location":"reference/utils/search/#spotdl.utils.search.songs_from_albums","title":"<code>songs_from_albums(albums)</code>","text":"<p>Get all songs from albums ids/urls/etc.</p>"},{"location":"reference/utils/search/#spotdl.utils.search.songs_from_albums--arguments","title":"Arguments","text":"<ul> <li>albums: List of albums ids</li> </ul>"},{"location":"reference/utils/search/#spotdl.utils.search.songs_from_albums--returns","title":"Returns","text":"<ul> <li>List of songs</li> </ul> Source code in <code>spotdl/utils/search.py</code> <pre><code>def songs_from_albums(albums: List[str]):\n    \"\"\"\n    Get all songs from albums ids/urls/etc.\n\n    ### Arguments\n    - albums: List of albums ids\n\n    ### Returns\n    - List of songs\n    \"\"\"\n\n    songs: List[Song] = []\n    for album_id in albums:\n        album = Album.from_url(album_id, fetch_songs=False)\n\n        songs.extend([Song.from_missing_data(**song.json) for song in album.songs])\n\n    return songs\n</code></pre>"},{"location":"reference/utils/spotify/","title":"spotify","text":"<p>Module for interacting with Spotify API. To use this module, you must have a Spotify API key and Spotify API secret.</p> <pre><code>import spotdl.utils.spotify\nspotify.Spotify.init(client_id, client_secret)\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton","title":"<code>Singleton</code>","text":"<p>               Bases: <code>type</code></p> <p>Singleton metaclass for SpotifyClient. Ensures that SpotifyClient is not instantiated without prior initialization. Every other instantiation of SpotifyClient will return the same instance.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.__call__","title":"<code>__call__()</code>","text":"<p>Call method for Singleton metaclass.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.__call__--returns","title":"Returns","text":"<ul> <li>The instance of the SpotifyClient.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def __call__(self):  # pylint: disable=bad-mcs-method-argument\n    \"\"\"\n    Call method for Singleton metaclass.\n\n    ### Returns\n    - The instance of the SpotifyClient.\n    \"\"\"\n\n    if self._instance is None:\n        raise SpotifyError(\n            \"Spotify client not created. Call SpotifyClient.init\"\n            \"(client_id, client_secret, user_auth, cache_path, no_cache, open_browser) first.\"\n        )\n    return self._instance\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.init","title":"<code>init(client_id, client_secret, user_auth=False, no_cache=False, headless=False, max_retries=3, use_cache_file=False, auth_token=None, cache_path=None)</code>","text":"<p>Initializes the SpotifyClient.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.init--arguments","title":"Arguments","text":"<ul> <li>client_id: The client ID of the application.</li> <li>client_secret: The client secret of the application.</li> <li>auth_token: The access token to use.</li> <li>user_auth: Whether or not to use user authentication.</li> <li>cache_path: The path to the cache file.</li> <li>no_cache: Whether or not to use the cache.</li> <li>open_browser: Whether or not to open the browser.</li> </ul>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.Singleton.init--returns","title":"Returns","text":"<ul> <li>The instance of the SpotifyClient.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def init(  # pylint: disable=bad-mcs-method-argument\n    self,\n    client_id: str,\n    client_secret: str,\n    user_auth: bool = False,\n    no_cache: bool = False,\n    headless: bool = False,\n    max_retries: int = 3,\n    use_cache_file: bool = False,\n    auth_token: Optional[str] = None,\n    cache_path: Optional[str] = None,\n) -&gt; \"Singleton\":\n    \"\"\"\n    Initializes the SpotifyClient.\n\n    ### Arguments\n    - client_id: The client ID of the application.\n    - client_secret: The client secret of the application.\n    - auth_token: The access token to use.\n    - user_auth: Whether or not to use user authentication.\n    - cache_path: The path to the cache file.\n    - no_cache: Whether or not to use the cache.\n    - open_browser: Whether or not to open the browser.\n\n    ### Returns\n    - The instance of the SpotifyClient.\n    \"\"\"\n\n    # check if initialization has been completed, if yes, raise an Exception\n    if isinstance(self._instance, self):\n        raise SpotifyError(\"A spotify client has already been initialized\")\n\n    credential_manager = None\n\n    cache_handler = (\n        CacheFileHandler(cache_path or get_cache_path())\n        if not no_cache\n        else MemoryCacheHandler()\n    )\n    # Use SpotifyOAuth as auth manager\n    if user_auth:\n        credential_manager = SpotifyOAuth(\n            client_id=client_id,\n            client_secret=client_secret,\n            redirect_uri=\"http://127.0.0.1:9900/\",\n            scope=\"user-library-read,user-follow-read,playlist-read-private\",\n            cache_handler=cache_handler,\n            open_browser=not headless,\n        )\n    # Use SpotifyClientCredentials as auth manager\n    else:\n        credential_manager = SpotifyClientCredentials(\n            client_id=client_id,\n            client_secret=client_secret,\n            cache_handler=cache_handler,\n        )\n    if auth_token is not None:\n        credential_manager = None\n\n    self.user_auth = user_auth\n    self.no_cache = no_cache\n    self.max_retries = max_retries\n    self.use_cache_file = use_cache_file\n\n    # Create instance\n    self._instance = super().__call__(\n        auth=auth_token,\n        auth_manager=credential_manager,\n        status_forcelist=(429, 500, 502, 503, 504, 404),\n    )\n\n    # Return instance\n    return self._instance\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.SpotifyClient","title":"<code>SpotifyClient(*args, **kwargs)</code>","text":"<p>               Bases: <code>Spotify</code></p> <p>This is the Spotify client meant to be used in the app. Has to be initialized first by calling <code>SpotifyClient.init(client_id, client_secret, user_auth, cache_path, no_cache, open_browser)</code>.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.SpotifyClient--arguments","title":"Arguments","text":"<ul> <li>auth: The access token to use.</li> <li>auth_manager: The auth manager to use.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def __init__(self, *args, **kwargs):\n    \"\"\"\n    Initializes the SpotifyClient.\n\n    ### Arguments\n    - auth: The access token to use.\n    - auth_manager: The auth manager to use.\n    \"\"\"\n\n    super().__init__(*args, **kwargs)\n    self._initialized = True\n\n    use_cache_file: bool = self.use_cache_file  # type: ignore # pylint: disable=E1101\n    cache_file_loc = get_spotify_cache_path()\n\n    if use_cache_file and cache_file_loc.exists():\n        with open(cache_file_loc, \"r\", encoding=\"utf-8\") as cache_file:\n            self.cache = json.load(cache_file)\n    elif use_cache_file:\n        with open(cache_file_loc, \"w\", encoding=\"utf-8\") as cache_file:\n            json.dump(self.cache, cache_file)\n</code></pre>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.SpotifyError","title":"<code>SpotifyError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base class for all exceptions related to SpotifyClient.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.save_spotify_cache","title":"<code>save_spotify_cache(cache)</code>","text":"<p>Saves the Spotify cache to a file.</p>"},{"location":"reference/utils/spotify/#spotdl.utils.spotify.save_spotify_cache--arguments","title":"Arguments","text":"<ul> <li>cache: The cache to save.</li> </ul> Source code in <code>spotdl/utils/spotify.py</code> <pre><code>def save_spotify_cache(cache: Dict[str, Optional[Dict]]):\n    \"\"\"\n    Saves the Spotify cache to a file.\n\n    ### Arguments\n    - cache: The cache to save.\n    \"\"\"\n\n    cache_file_loc = get_spotify_cache_path()\n\n    logger.debug(\"Saving Spotify cache to %s\", cache_file_loc)\n\n    # Only cache tracks\n    cache = {\n        key: value\n        for key, value in cache.items()\n        if value is not None and \"tracks/\" in key\n    }\n\n    with open(cache_file_loc, \"w\", encoding=\"utf-8\") as cache_file:\n        json.dump(cache, cache_file)\n</code></pre>"},{"location":"reference/utils/static/","title":"static","text":"<p>Module for holding static variables that are used throughout the project. And are for the most part, not likely to change. (Also holds really large variables, so pylint is disabled here)</p>"},{"location":"reference/utils/web/","title":"web","text":"<p>Module which contains the web server related function FastAPI routes/classes etc.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.ApplicationState","title":"<code>ApplicationState</code>","text":"<p>Class that holds the application state.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client","title":"<code>Client(websocket, client_id)</code>","text":"<p>Holds the client's state.</p> <ul> <li>websocket: The WebSocket instance.</li> <li>client_id: The client's ID.</li> <li>downloader_settings: The downloader settings.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def __init__(\n    self,\n    websocket: WebSocket,\n    client_id: str,\n):\n    \"\"\"\n    Initialize the WebSocket handler.\n    ### Arguments\n    - websocket: The WebSocket instance.\n    - client_id: The client's ID.\n    - downloader_settings: The downloader settings.\n    \"\"\"\n\n    self.downloader_settings = DownloaderOptions(\n        **create_settings_type(\n            Namespace(config=False),\n            dict(app_state.downloader_settings),\n            DOWNLOADER_OPTIONS,\n        )  # type: ignore\n    )\n\n    self.websocket = websocket\n    self.client_id = client_id\n    self.downloader = Downloader(\n        settings=self.downloader_settings, loop=app_state.loop\n    )\n\n    self.downloader.progress_handler.web_ui = True\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.connect","title":"<code>connect()</code>  <code>async</code>","text":"<p>Called when a new client connects to the websocket.</p> Source code in <code>spotdl/utils/web.py</code> <pre><code>async def connect(self):\n    \"\"\"\n    Called when a new client connects to the websocket.\n    \"\"\"\n\n    await self.websocket.accept()\n\n    # Add the connection to the list of connections\n    app_state.clients[self.client_id] = self\n    app_state.logger.info(\"Client %s connected\", self.client_id)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.get_instance","title":"<code>get_instance(client_id)</code>  <code>classmethod</code>","text":"<p>Get the WebSocket instance for a client.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.get_instance--arguments","title":"Arguments","text":"<ul> <li>client_id: The client's ID.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.get_instance--returns","title":"Returns","text":"<ul> <li>returns the WebSocket instance.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@classmethod\ndef get_instance(cls, client_id: str) -&gt; Optional[\"Client\"]:\n    \"\"\"\n    Get the WebSocket instance for a client.\n\n    ### Arguments\n    - client_id: The client's ID.\n\n    ### Returns\n    - returns the WebSocket instance.\n    \"\"\"\n\n    instance = app_state.clients.get(client_id)\n    if instance:\n        return instance\n\n    app_state.logger.error(\"Client %s not found\", client_id)\n\n    return None\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.send_update","title":"<code>send_update(update)</code>  <code>async</code>","text":"<p>Send an update to the client.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.send_update--arguments","title":"Arguments","text":"<ul> <li>update: The update to send.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>async def send_update(self, update: Dict[str, Any]):\n    \"\"\"\n    Send an update to the client.\n\n    ### Arguments\n    - update: The update to send.\n    \"\"\"\n\n    await self.websocket.send_json(update)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.song_update","title":"<code>song_update(progress_handler, message)</code>","text":"<p>Called when a song updates.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.Client.song_update--arguments","title":"Arguments","text":"<ul> <li>progress_handler: The progress handler.</li> <li>message: The message to send.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def song_update(self, progress_handler: SongTracker, message: str):\n    \"\"\"\n    Called when a song updates.\n\n    ### Arguments\n    - progress_handler: The progress handler.\n    - message: The message to send.\n    \"\"\"\n\n    update_message = {\n        \"song\": progress_handler.song.json,\n        \"progress\": progress_handler.progress,\n        \"message\": message,\n    }\n\n    asyncio.run_coroutine_threadsafe(\n        self.send_update(update_message), app_state.loop\n    )\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles","title":"<code>SPAStaticFiles</code>","text":"<p>               Bases: <code>StaticFiles</code></p> <p>Override the static files to serve the index.html and other assets.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles.get_response","title":"<code>get_response(path, scope)</code>  <code>async</code>","text":"<p>Serve static files from the SPA.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles.get_response--arguments","title":"Arguments","text":"<ul> <li>path: The path to the file.</li> <li>scope: The scope of the request.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.SPAStaticFiles.get_response--returns","title":"Returns","text":"<ul> <li>returns the response.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>async def get_response(self, path: str, scope: Scope) -&gt; Response:\n    \"\"\"\n    Serve static files from the SPA.\n\n    ### Arguments\n    - path: The path to the file.\n    - scope: The scope of the request.\n\n    ### Returns\n    - returns the response.\n    \"\"\"\n\n    response = await super().get_response(path, scope)\n    if response.status_code == 404:\n        response = await super().get_response(\".\", scope)\n\n    response.headers.setdefault(\n        \"Cache-Control\", \"max-age=0, no-cache, no-store, , must-revalidate\"\n    )\n    response.headers.setdefault(\"Pragma\", \"no-cache\")\n    response.headers.setdefault(\"Expires\", \"0\")\n\n    return response\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.check_update","title":"<code>check_update()</code>","text":"<p>Check for update.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.check_update--returns","title":"Returns","text":"<ul> <li>returns True if there is an update.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/check_update\")\ndef check_update() -&gt; bool:\n    \"\"\"\n    Check for update.\n\n    ### Returns\n    - returns True if there is an update.\n    \"\"\"\n\n    try:\n        _, ahead, _ = get_status(__version__, \"master\")\n        if ahead &gt; 0:\n            return True\n    except RuntimeError:\n        latest_version = get_latest_version()\n        latest_tuple = tuple(latest_version.replace(\"v\", \"\").split(\".\"))\n        current_tuple = tuple(__version__.split(\".\"))\n        if latest_tuple &gt; current_tuple:\n            return True\n    except RateLimitError:\n        return False\n\n    return False\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.download_file","title":"<code>download_file(file, client=Depends(get_client), state=Depends(get_current_state))</code>  <code>async</code>","text":"<p>Download file using path.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.download_file--arguments","title":"Arguments","text":"<ul> <li>file: The file path.</li> <li>client: The client's state.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.download_file--returns","title":"Returns","text":"<ul> <li>returns the file response, filename specified to return as attachment.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/download/file\")\nasync def download_file(\n    file: str,\n    client: Client = Depends(get_client),\n    state: ApplicationState = Depends(get_current_state),\n):\n    \"\"\"\n    Download file using path.\n\n    ### Arguments\n    - file: The file path.\n    - client: The client's state.\n\n    ### Returns\n    - returns the file response, filename specified to return as attachment.\n    \"\"\"\n\n    expected_path = str((get_spotdl_path() / \"web/sessions\").absolute())\n    if state.web_settings.get(\"web_use_output_dir\", False):\n        expected_path = str(\n            Path(client.downloader_settings[\"output\"].split(\"{\", 1)[0]).absolute()\n        )\n\n    if (not file.endswith(client.downloader_settings[\"format\"])) or (\n        not file.startswith(expected_path)\n    ):\n        raise HTTPException(status_code=400, detail=\"Invalid download path.\")\n\n    return FileResponse(\n        file,\n        filename=os.path.basename(file),\n    )\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.download_url","title":"<code>download_url(url, client=Depends(get_client), state=Depends(get_current_state))</code>  <code>async</code>","text":"<p>Download songs using Song url.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.download_url--arguments","title":"Arguments","text":"<ul> <li>url: The url to download.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.download_url--returns","title":"Returns","text":"<ul> <li>returns the file path if the song was downloaded.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.post(\"/api/download/url\")\nasync def download_url(\n    url: str,\n    client: Client = Depends(get_client),\n    state: ApplicationState = Depends(get_current_state),\n) -&gt; Optional[str]:\n    \"\"\"\n    Download songs using Song url.\n\n    ### Arguments\n    - url: The url to download.\n\n    ### Returns\n    - returns the file path if the song was downloaded.\n    \"\"\"\n\n    if state.web_settings.get(\"web_use_output_dir\", False):\n        client.downloader.settings[\"output\"] = client.downloader_settings[\"output\"]\n    else:\n        client.downloader.settings[\"output\"] = str(\n            (get_spotdl_path() / f\"web/sessions/{client.client_id}\").absolute()\n        )\n\n    client.downloader.progress_handler = ProgressHandler(\n        simple_tui=True,\n        update_callback=client.song_update,\n    )\n\n    try:\n        # Fetch song metadata\n        song = Song.from_url(url)\n\n        # Download Song\n        _, path = await client.downloader.pool_download(song)\n\n        if path is None:\n            state.logger.error(f\"Failure downloading {song.name}\")\n\n            raise HTTPException(\n                status_code=500, detail=f\"Error downloading: {song.name}\"\n            )\n\n        return str(path.absolute())\n\n    except Exception as exception:\n        state.logger.error(f\"Error downloading! {exception}\")\n\n        raise HTTPException(\n            status_code=500, detail=f\"Error downloading: {exception}\"\n        ) from exception\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.fix_mime_types","title":"<code>fix_mime_types()</code>","text":"<p>Fix incorrect entries in the <code>mimetypes</code> registry. On Windows, the Python standard library's <code>mimetypes</code> reads in mappings from file extension to MIME type from the Windows registry. Other applications can and do write incorrect values to this registry, which causes <code>mimetypes.guess_type</code> to return incorrect values, which causes spotDL to fail to render on the frontend. This method hard-codes the correct mappings for certain MIME types that are known to be either used by TensorBoard or problematic in general.</p> Source code in <code>spotdl/utils/web.py</code> <pre><code>def fix_mime_types():\n    \"\"\"Fix incorrect entries in the `mimetypes` registry.\n    On Windows, the Python standard library's `mimetypes` reads in\n    mappings from file extension to MIME type from the Windows\n    registry. Other applications can and do write incorrect values\n    to this registry, which causes `mimetypes.guess_type` to return\n    incorrect values, which causes spotDL to fail to render on\n    the frontend.\n    This method hard-codes the correct mappings for certain MIME\n    types that are known to be either used by TensorBoard or\n    problematic in general.\n    \"\"\"\n\n    # Known to be problematic when Visual Studio is installed:\n    # &lt;/~https://github.com/tensorflow/tensorboard/issues/3120&gt;\n    # /~https://github.com/spotDL/spotify-downloader/issues/1540\n    mimetypes.add_type(\"application/javascript\", \".js\")\n\n    # Not known to be problematic, but used by spotDL:\n    mimetypes.add_type(\"text/css\", \".css\")\n    mimetypes.add_type(\"image/svg+xml\", \".svg\")\n    mimetypes.add_type(\"text/html\", \".html\")\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_client","title":"<code>get_client(client_id=Query(default=None))</code>","text":"<p>Get the client's state.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_client--arguments","title":"Arguments","text":"<ul> <li>client_id: The client's ID.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.get_client--returns","title":"Returns","text":"<ul> <li>returns the client's state.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def get_client(client_id: Union[str, None] = Query(default=None)) -&gt; Client:\n    \"\"\"\n    Get the client's state.\n\n    ### Arguments\n    - client_id: The client's ID.\n\n    ### Returns\n    - returns the client's state.\n    \"\"\"\n\n    if client_id is None:\n        raise HTTPException(status_code=400, detail=\"client_id is required\")\n\n    instance = Client.get_instance(client_id)\n    if instance is None:\n        raise HTTPException(status_code=404, detail=\"client not found\")\n\n    return instance\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_current_state","title":"<code>get_current_state()</code>","text":"<p>Get the current state of the application.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_current_state--returns","title":"Returns","text":"<ul> <li>returns the application state.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>def get_current_state() -&gt; ApplicationState:\n    \"\"\"\n    Get the current state of the application.\n\n    ### Returns\n    - returns the application state.\n    \"\"\"\n\n    return app_state\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_options","title":"<code>get_options()</code>","text":"<p>Get options model (possible settings).</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_options--returns","title":"Returns","text":"<ul> <li>returns the options.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/options_model\")\ndef get_options() -&gt; Dict[str, Any]:\n    \"\"\"\n    Get options model (possible settings).\n\n    ### Returns\n    - returns the options.\n    \"\"\"\n\n    parser = create_parser()\n\n    # Forbidden actions\n    forbidden_actions = [\n        \"help\",\n        \"operation\",\n        \"version\",\n        \"config\",\n        \"user_auth\",\n        \"client_id\",\n        \"client_secret\",\n        \"auth_token\",\n        \"cache_path\",\n        \"no_cache\",\n        \"cookie_file\",\n        \"ffmpeg\",\n        \"archive\",\n        \"host\",\n        \"port\",\n        \"keep_alive\",\n        \"enable_tls\",\n        \"key_file\",\n        \"cert_file\",\n        \"ca_file\",\n        \"allowed_origins\",\n        \"web_use_output_dir\",\n        \"keep_sessions\",\n        \"log_level\",\n        \"simple_tui\",\n        \"headless\",\n        \"download_ffmpeg\",\n        \"generate_config\",\n        \"check_for_updates\",\n        \"profile\",\n        \"version\",\n    ]\n\n    options = {}\n    for action in parser._actions:  # pylint: disable=protected-access\n        if action.dest in forbidden_actions:\n            continue\n\n        default = app_state.downloader_settings.get(action.dest, None)\n        choices = list(action.choices) if action.choices else None\n\n        type_name = \"\"\n        if action.type is not None:\n            if hasattr(action.type, \"__objclass__\"):\n                type_name: str = action.type.__objclass__.__name__  # type: ignore\n            else:\n                type_name: str = action.type.__name__  # type: ignore\n\n        if isinstance(\n            action, argparse._StoreConstAction  # pylint: disable=protected-access\n        ):\n            type_name = \"bool\"\n\n        if choices is not None and action.nargs == \"*\":\n            type_name = \"list\"\n\n        options[action.dest] = {\n            \"type\": type_name,\n            \"choices\": choices,\n            \"default\": default,\n            \"help\": action.help,\n        }\n\n    return options\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.get_settings","title":"<code>get_settings(client=Depends(get_client))</code>","text":"<p>Get client settings.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.get_settings--arguments","title":"Arguments","text":"<ul> <li>client: The client's state.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.get_settings--returns","title":"Returns","text":"<ul> <li>returns the settings.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/settings\")\ndef get_settings(\n    client: Client = Depends(get_client),\n) -&gt; DownloaderOptions:\n    \"\"\"\n    Get client settings.\n\n    ### Arguments\n    - client: The client's state.\n\n    ### Returns\n    - returns the settings.\n    \"\"\"\n\n    return client.downloader_settings\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.query_search","title":"<code>query_search(query)</code>","text":"<p>Parse search term and return list of Song objects.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.query_search--arguments","title":"Arguments","text":"<ul> <li>query: The query to parse.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.query_search--returns","title":"Returns","text":"<ul> <li>returns a list of Song objects.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/songs/search\", response_model=None)\ndef query_search(query: str) -&gt; List[Song]:\n    \"\"\"\n    Parse search term and return list of Song objects.\n\n    ### Arguments\n    - query: The query to parse.\n\n    ### Returns\n    - returns a list of Song objects.\n    \"\"\"\n\n    return get_search_results(query)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.shutdown_event","title":"<code>shutdown_event()</code>  <code>async</code>","text":"<p>Called when the server is shutting down.</p> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.on_event(\"shutdown\")\nasync def shutdown_event():\n    \"\"\"\n    Called when the server is shutting down.\n    \"\"\"\n\n    if (\n        not app_state.web_settings[\"keep_sessions\"]\n        and not app_state.web_settings[\"web_use_output_dir\"]\n    ):\n        app_state.logger.info(\"Removing sessions directories\")\n        sessions_dir = Path(get_spotdl_path(), \"web/sessions\")\n        if sessions_dir.exists():\n            shutil.rmtree(sessions_dir)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.song_from_url","title":"<code>song_from_url(url)</code>","text":"<p>Search for a song on spotify using url.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.song_from_url--arguments","title":"Arguments","text":"<ul> <li>url: The url to search.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.song_from_url--returns","title":"Returns","text":"<ul> <li>returns the first result as a Song object.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/song/url\", response_model=None)\ndef song_from_url(url: str) -&gt; Song:\n    \"\"\"\n    Search for a song on spotify using url.\n\n    ### Arguments\n    - url: The url to search.\n\n    ### Returns\n    - returns the first result as a Song object.\n    \"\"\"\n\n    return Song.from_url(url)\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.songs_from_url","title":"<code>songs_from_url(url)</code>","text":"<p>Search for a song, playlist, artist or album on spotify using url.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.songs_from_url--arguments","title":"Arguments","text":"<ul> <li>url: The url to search.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.songs_from_url--returns","title":"Returns","text":"<ul> <li>returns a list with Song objects to be downloaded.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/url\", response_model=None)\ndef songs_from_url(url: str) -&gt; List[Song]:\n    \"\"\"\n    Search for a song, playlist, artist or album on spotify using url.\n\n    ### Arguments\n    - url: The url to search.\n\n    ### Returns\n    - returns a list with Song objects to be downloaded.\n    \"\"\"\n\n    if \"playlist\" in url:\n        playlist = Playlist.from_url(url)\n        return list(map(Song.from_url, playlist.urls))\n    if \"album\" in url:\n        album = Album.from_url(url)\n        return list(map(Song.from_url, album.urls))\n    if \"artist\" in url:\n        artist = Artist.from_url(url)\n        return list(map(Song.from_url, artist.urls))\n\n    return [Song.from_url(url)]\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.update_settings","title":"<code>update_settings(settings, client=Depends(get_client), state=Depends(get_current_state))</code>","text":"<p>Update client settings, and re-initialize downloader.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.update_settings--arguments","title":"Arguments","text":"<ul> <li>settings: The settings to change.</li> <li>client: The client's state.</li> <li>state: The application state.</li> </ul>"},{"location":"reference/utils/web/#spotdl.utils.web.update_settings--returns","title":"Returns","text":"<ul> <li>returns True if the settings were changed.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.post(\"/api/settings/update\")\ndef update_settings(\n    settings: DownloaderOptionalOptions,\n    client: Client = Depends(get_client),\n    state: ApplicationState = Depends(get_current_state),\n) -&gt; DownloaderOptions:\n    \"\"\"\n    Update client settings, and re-initialize downloader.\n\n    ### Arguments\n    - settings: The settings to change.\n    - client: The client's state.\n    - state: The application state.\n\n    ### Returns\n    - returns True if the settings were changed.\n    \"\"\"\n\n    # Create shallow copy of settings\n    settings_cpy = client.downloader_settings.copy()\n\n    # Update settings with new settings that are not None\n    settings_cpy.update({k: v for k, v in settings.items() if v is not None})  # type: ignore\n\n    state.logger.info(f\"Applying settings: {settings_cpy}\")\n\n    new_settings = DownloaderOptions(**settings_cpy)  # type: ignore\n\n    # Re-initialize downloader\n    client.downloader_settings = new_settings\n    client.downloader = Downloader(\n        new_settings,\n        loop=state.loop,\n    )\n\n    return new_settings\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.version","title":"<code>version()</code>","text":"<p>Get the current version This method is created to ensure backward compatibility of the web app, as the web app is updated with the latest regardless of the backend version</p>"},{"location":"reference/utils/web/#spotdl.utils.web.version--returns","title":"Returns","text":"<ul> <li>returns the version of the app</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.get(\"/api/version\", response_model=None)\ndef version() -&gt; str:\n    \"\"\"\n    Get the current version\n    This method is created to ensure backward compatibility of the web app,\n    as the web app is updated with the latest regardless of the backend version\n\n    ### Returns\n    -  returns the version of the app\n    \"\"\"\n\n    return __version__\n</code></pre>"},{"location":"reference/utils/web/#spotdl.utils.web.websocket_endpoint","title":"<code>websocket_endpoint(websocket, client_id)</code>  <code>async</code>","text":"<p>Websocket endpoint.</p>"},{"location":"reference/utils/web/#spotdl.utils.web.websocket_endpoint--arguments","title":"Arguments","text":"<ul> <li>websocket: The WebSocket instance.</li> </ul> Source code in <code>spotdl/utils/web.py</code> <pre><code>@router.websocket(\"/api/ws\")\nasync def websocket_endpoint(websocket: WebSocket, client_id: str):\n    \"\"\"\n    Websocket endpoint.\n\n    ### Arguments\n    - websocket: The WebSocket instance.\n    \"\"\"\n\n    await Client(websocket, client_id).connect()\n\n    try:\n        while True:\n            await websocket.receive_json()\n    except WebSocketDisconnect:\n        app_state.clients.pop(client_id, None)\n\n        if (\n            len(app_state.clients) == 0\n            and app_state.web_settings[\"keep_alive\"] is False\n        ):\n            app_state.logger.debug(\n                \"No active connections, waiting 1s before shutting down\"\n            )\n\n            await asyncio.sleep(1)\n\n            # Wait 1 second before shutting down\n            # This is to prevent the server from shutting down when a client\n            # disconnects and reconnects quickly (e.g. when refreshing the page)\n            if len(app_state.clients) == 0:\n                # Perform a clean exit\n                app_state.logger.info(\"Shutting down server, no active connections\")\n                app_state.server.force_exit = True\n                app_state.server.should_exit = True\n                await app_state.server.shutdown()\n</code></pre>"}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 314ca3187..e4e78e33a 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,242 +2,242 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/CODE_OF_CONDUCT/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/CONTRIBUTING/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/installation/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/troubleshooting/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/usage/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/SUMMARY/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/download/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/entry_point/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/meta/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/save/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/sync/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/url/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/console/web/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/download/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/download/downloader/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/download/progress_handler/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/bandcamp/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/base/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/piped/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/sliderkz/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/soundcloud/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/youtube/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/audio/ytmusic/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/azlyrics/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/base/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/genius/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/musixmatch/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/providers/lyrics/synced/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/album/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/artist/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/options/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/playlist/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/result/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/saved/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/types/song/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/archive/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/arguments/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/config/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/console/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/downloader/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/ffmpeg/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/formatter/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/github/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/logging/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/lrc/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/m3u/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/matching/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/metadata/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/search/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/spotify/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/static/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
     <url>
          <loc>https://spotdl.github.io/spotify-downloader/reference/utils/web/</loc>
-         <lastmod>2024-11-18</lastmod>
+         <lastmod>2025-01-16</lastmod>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 11ee2aba0..4a69ee3b6 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/troubleshooting/index.html b/troubleshooting/index.html
index 9ff531efc..6323c008e 100644
--- a/troubleshooting/index.html
+++ b/troubleshooting/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -852,11 +852,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/download/" class="md-nav__link ">
+            <a href="../reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -872,7 +872,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -882,56 +882,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -943,32 +893,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/types/" class="md-nav__link ">
+            <a href="../reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -979,53 +929,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/album/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -1042,11 +950,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/saved/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1063,11 +971,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/result/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1084,11 +992,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/song/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1105,11 +1013,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/options/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1144,32 +1052,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/console/" class="md-nav__link ">
+            <a href="../reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1180,11 +1088,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/save/" class="md-nav__link">
+      <a href="../reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1201,11 +1109,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/url/" class="md-nav__link">
+      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1222,11 +1130,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/meta/" class="md-nav__link">
+      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1243,11 +1151,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/web/" class="md-nav__link">
+      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1264,11 +1172,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/sync/" class="md-nav__link">
+      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1285,11 +1193,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/download/" class="md-nav__link">
+      <a href="../reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1306,11 +1214,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/entry_point/" class="md-nav__link">
+      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1328,6 +1236,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1345,7 +1261,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1361,14 +1277,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1381,11 +1297,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/console/" class="md-nav__link">
+      <a href="../reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1402,11 +1318,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/formatter/" class="md-nav__link">
+      <a href="../reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1423,11 +1339,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/arguments/" class="md-nav__link">
+      <a href="../reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1444,11 +1360,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/metadata/" class="md-nav__link">
+      <a href="../reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1465,11 +1381,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/downloader/" class="md-nav__link">
+      <a href="../reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1486,11 +1402,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/github/" class="md-nav__link">
+      <a href="../reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1507,11 +1423,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/static/" class="md-nav__link">
+      <a href="../reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1528,11 +1444,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/search/" class="md-nav__link">
+      <a href="../reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1549,11 +1465,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/web/" class="md-nav__link">
+      <a href="../reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1570,11 +1486,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/logging/" class="md-nav__link">
+      <a href="../reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1591,11 +1507,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/spotify/" class="md-nav__link">
+      <a href="../reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1612,11 +1528,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/matching/" class="md-nav__link">
+      <a href="../reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1633,11 +1549,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="../reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1654,11 +1570,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/m3u/" class="md-nav__link">
+      <a href="../reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1675,11 +1591,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/config/" class="md-nav__link">
+      <a href="../reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1696,11 +1612,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/lrc/" class="md-nav__link">
+      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1717,11 +1633,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/archive/" class="md-nav__link">
+      <a href="../reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1756,32 +1672,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/" class="md-nav__link ">
+            <a href="../reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1791,45 +1707,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1838,11 +1750,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="../reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1859,11 +1771,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1880,11 +1792,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1901,11 +1813,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="../reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1922,11 +1834,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="../reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1961,32 +1873,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/audio/" class="md-nav__link ">
+            <a href="../reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1997,11 +1909,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2018,11 +1930,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2032,6 +1944,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2039,11 +2005,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/piped/" class="md-nav__link">
+      <a href="../reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2060,11 +2026,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="../reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2081,11 +2047,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2102,11 +2068,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/base/" class="md-nav__link">
+      <a href="../reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2123,11 +2089,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2137,9 +2103,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2322,7 +2322,7 @@ <h3 id="solution_7">Solution<a class="headerlink" href="#solution_7" title="Perm
     <script id="__config" type="application/json">{"base": "..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>
diff --git a/usage/index.html b/usage/index.html
index e9396b80e..cb0b36f8a 100644
--- a/usage/index.html
+++ b/usage/index.html
@@ -22,7 +22,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.44">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -30,7 +30,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0253249f.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.6f8fc17f.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
@@ -194,7 +194,7 @@
         <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -343,7 +343,7 @@
       <a href="/~https://github.com/spotDL/spotify-downloader" title="Go to repository" class="md-source" data-md-component="source">
   <div class="md-source__icon md-icon">
     
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
   </div>
   <div class="md-source__repository">
     spotdl/spotify-downloader
@@ -858,11 +858,11 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/download/" class="md-nav__link ">
+            <a href="../reference/providers/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    download
+    providers
   </span>
   
 
@@ -878,7 +878,7 @@
         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5_2">
             <span class="md-nav__icon md-icon"></span>
-            download
+            providers
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -888,56 +888,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/download/downloader/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    downloader
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/download/progress_handler/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    progress_handler
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     
     
     
@@ -949,32 +899,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_1" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/types/" class="md-nav__link ">
+            <a href="../reference/providers/lyrics/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    types
+    lyrics
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_1" id="__nav_5_2_1_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_1">
             <span class="md-nav__icon md-icon"></span>
-            types
+            lyrics
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -985,53 +935,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/artist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    artist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/playlist/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    playlist
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/types/album/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    album
+    synced
   </span>
   
 
@@ -1048,11 +956,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/saved/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    saved
+    musixmatch
   </span>
   
 
@@ -1069,11 +977,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/result/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    result
+    azlyrics
   </span>
   
 
@@ -1090,11 +998,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/song/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    song
+    base
   </span>
   
 
@@ -1111,11 +1019,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/types/options/" class="md-nav__link">
+      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    options
+    genius
   </span>
   
 
@@ -1150,32 +1058,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2_2" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/console/" class="md-nav__link ">
+            <a href="../reference/providers/audio/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    console
+    audio
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_2_2" id="__nav_5_2_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2_2">
             <span class="md-nav__icon md-icon"></span>
-            console
+            audio
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1186,11 +1094,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/save/" class="md-nav__link">
+      <a href="../reference/providers/audio/piped/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    save
+    piped
   </span>
   
 
@@ -1207,11 +1115,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/url/" class="md-nav__link">
+      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    url
+    youtube
   </span>
   
 
@@ -1228,11 +1136,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/meta/" class="md-nav__link">
+      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    meta
+    soundcloud
   </span>
   
 
@@ -1249,11 +1157,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/web/" class="md-nav__link">
+      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    bandcamp
   </span>
   
 
@@ -1270,11 +1178,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/sync/" class="md-nav__link">
+      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sync
+    ytmusic
   </span>
   
 
@@ -1291,11 +1199,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/download/" class="md-nav__link">
+      <a href="../reference/providers/audio/base/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    download
+    base
   </span>
   
 
@@ -1312,11 +1220,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/console/entry_point/" class="md-nav__link">
+      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    entry_point
+    sliderkz
   </span>
   
 
@@ -1334,6 +1242,14 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
               
                 
   
@@ -1351,7 +1267,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
         
           
           
@@ -1367,14 +1283,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_5">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
             <span class="md-nav__icon md-icon"></span>
             utils
           </label>
@@ -1387,11 +1303,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/console/" class="md-nav__link">
+      <a href="../reference/utils/spotify/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    console
+    spotify
   </span>
   
 
@@ -1408,11 +1324,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/formatter/" class="md-nav__link">
+      <a href="../reference/utils/m3u/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    formatter
+    m3u
   </span>
   
 
@@ -1429,11 +1345,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/arguments/" class="md-nav__link">
+      <a href="../reference/utils/metadata/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    arguments
+    metadata
   </span>
   
 
@@ -1450,11 +1366,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/metadata/" class="md-nav__link">
+      <a href="../reference/utils/logging/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    metadata
+    logging
   </span>
   
 
@@ -1471,11 +1387,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/downloader/" class="md-nav__link">
+      <a href="../reference/utils/static/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    downloader
+    static
   </span>
   
 
@@ -1492,11 +1408,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/github/" class="md-nav__link">
+      <a href="../reference/utils/matching/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    github
+    matching
   </span>
   
 
@@ -1513,11 +1429,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/static/" class="md-nav__link">
+      <a href="../reference/utils/search/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    static
+    search
   </span>
   
 
@@ -1534,11 +1450,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/search/" class="md-nav__link">
+      <a href="../reference/utils/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    search
+    downloader
   </span>
   
 
@@ -1555,11 +1471,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/web/" class="md-nav__link">
+      <a href="../reference/utils/archive/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    web
+    archive
   </span>
   
 
@@ -1576,11 +1492,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/logging/" class="md-nav__link">
+      <a href="../reference/utils/lrc/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    logging
+    lrc
   </span>
   
 
@@ -1597,11 +1513,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/spotify/" class="md-nav__link">
+      <a href="../reference/utils/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    spotify
+    config
   </span>
   
 
@@ -1618,11 +1534,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/matching/" class="md-nav__link">
+      <a href="../reference/utils/arguments/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    matching
+    arguments
   </span>
   
 
@@ -1639,11 +1555,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
+      <a href="../reference/utils/console/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ffmpeg
+    console
   </span>
   
 
@@ -1660,11 +1576,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/m3u/" class="md-nav__link">
+      <a href="../reference/utils/github/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    m3u
+    github
   </span>
   
 
@@ -1681,11 +1597,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/config/" class="md-nav__link">
+      <a href="../reference/utils/web/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    config
+    web
   </span>
   
 
@@ -1702,11 +1618,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/lrc/" class="md-nav__link">
+      <a href="../reference/utils/ffmpeg/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    lrc
+    ffmpeg
   </span>
   
 
@@ -1723,11 +1639,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/utils/archive/" class="md-nav__link">
+      <a href="../reference/utils/formatter/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    archive
+    formatter
   </span>
   
 
@@ -1762,32 +1678,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/" class="md-nav__link ">
+            <a href="../reference/types/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    providers
+    types
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
             <span class="md-nav__icon md-icon"></span>
-            providers
+            types
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -1797,45 +1713,41 @@
   
   
   
-    
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_1" >
+    <li class="md-nav__item">
+      <a href="../reference/types/options/" class="md-nav__link">
         
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/lyrics/" class="md-nav__link ">
-              
   
   <span class="md-ellipsis">
-    lyrics
+    options
   </span>
   
 
-            </a>
-            
+      </a>
+    </li>
+  
+
               
-              <label class="md-nav__link " for="__nav_5_6_1" id="__nav_5_6_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
             
-          </div>
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/types/saved/" class="md-nav__link">
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_1">
-            <span class="md-nav__icon md-icon"></span>
-            lyrics
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
+  
+  <span class="md-ellipsis">
+    saved
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
             
               
                 
@@ -1844,11 +1756,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/synced/" class="md-nav__link">
+      <a href="../reference/types/artist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    synced
+    artist
   </span>
   
 
@@ -1865,11 +1777,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/musixmatch/" class="md-nav__link">
+      <a href="../reference/types/result/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    musixmatch
+    result
   </span>
   
 
@@ -1886,11 +1798,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/azlyrics/" class="md-nav__link">
+      <a href="../reference/types/playlist/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    azlyrics
+    playlist
   </span>
   
 
@@ -1907,11 +1819,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/genius/" class="md-nav__link">
+      <a href="../reference/types/song/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    genius
+    song
   </span>
   
 
@@ -1928,11 +1840,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/lyrics/base/" class="md-nav__link">
+      <a href="../reference/types/album/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    album
   </span>
   
 
@@ -1967,32 +1879,32 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
         
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../reference/providers/audio/" class="md-nav__link ">
+            <a href="../reference/download/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
-    audio
+    download
   </span>
   
 
             </a>
             
               
-              <label class="md-nav__link " for="__nav_5_6_2" id="__nav_5_6_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_5_6_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_6_2">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
             <span class="md-nav__icon md-icon"></span>
-            audio
+            download
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -2003,11 +1915,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/bandcamp/" class="md-nav__link">
+      <a href="../reference/download/downloader/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    bandcamp
+    downloader
   </span>
   
 
@@ -2024,11 +1936,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/sliderkz/" class="md-nav__link">
+      <a href="../reference/download/progress_handler/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    sliderkz
+    progress_handler
   </span>
   
 
@@ -2038,6 +1950,60 @@
 
               
             
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    
+    
+    
+      
+      
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../reference/console/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    console
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5_6" id="__nav_5_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_6">
+            <span class="md-nav__icon md-icon"></span>
+            console
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
               
                 
   
@@ -2045,11 +2011,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/piped/" class="md-nav__link">
+      <a href="../reference/console/save/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    piped
+    save
   </span>
   
 
@@ -2066,11 +2032,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/youtube/" class="md-nav__link">
+      <a href="../reference/console/url/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    youtube
+    url
   </span>
   
 
@@ -2087,11 +2053,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/soundcloud/" class="md-nav__link">
+      <a href="../reference/console/entry_point/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    soundcloud
+    entry_point
   </span>
   
 
@@ -2108,11 +2074,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/base/" class="md-nav__link">
+      <a href="../reference/console/sync/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    base
+    sync
   </span>
   
 
@@ -2129,11 +2095,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../reference/providers/audio/ytmusic/" class="md-nav__link">
+      <a href="../reference/console/meta/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    ytmusic
+    meta
   </span>
   
 
@@ -2143,9 +2109,43 @@
 
               
             
-          </ul>
-        </nav>
-      
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/download/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    download
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/console/web/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    web
+  </span>
+  
+
+      </a>
     </li>
   
 
@@ -2403,7 +2403,6 @@ <h3 id="default-config">Default config<a class="headerlink" href="#default-confi
 <span class="w">    </span><span class="nt">&quot;scan_for_songs&quot;</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span>
 <span class="w">    </span><span class="nt">&quot;m3u&quot;</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
 <span class="w">    </span><span class="nt">&quot;output&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;{artists} - {title}.{output-ext}&quot;</span><span class="p">,</span>
-<span class="w">    </span><span class="nt">&quot;m3u_output&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;#EXTINF:{duration}, {artists} - {title}.{output-ext}&quot;</span><span class="p">,</span>
 <span class="w">    </span><span class="nt">&quot;overwrite&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;skip&quot;</span><span class="p">,</span>
 <span class="w">    </span><span class="nt">&quot;search_query&quot;</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
 <span class="w">    </span><span class="nt">&quot;ffmpeg&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;ffmpeg&quot;</span><span class="p">,</span>
@@ -2787,7 +2786,7 @@ <h3 id="command-line-options">Command line options<a class="headerlink" href="#c
     <script id="__config" type="application/json">{"base": "..", "features": ["content.code.annotate", "navigation.tabs", "navigation.top", "toc.integrate"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
     
   </body>