added option to skip explicit songs

spotdl/download/downloader.py

@@ -452,6 +452,10 @@ def search_and_download(self, song: Song) -> Tuple[Song, Optional[Path]]:
 
             reinitialized = True
 
+        if song.explicit is True and self.settings["skip_explicit"] is True:
+            logger.info("Skipping explicit song: %s", song.display_name)
+            return song, None
+
         # Initalize the progress tracker
         display_progress_tracker = self.progress_handler.get_new_tracker(song)
 

spotdl/types/options.py

@@ -78,6 +78,7 @@ class DownloaderOptions(TypedDict):
     detect_formats: Optional[List[str]]
     save_errors: Optional[str]
     proxy: Optional[str]
+    skip_explicit: Optional[bool]
 
 
 class WebOptions(TypedDict):
@@ -156,6 +157,8 @@ class DownloaderOptionalOptions(TypedDict, total=False):
     yt_dlp_args: Optional[str]
     detect_formats: Optional[List[str]]
     save_errors: Optional[str]
+    proxy: Optional[str]
+    skip_explicit: Optional[bool]
 
 
 class WebOptionalOptions(TypedDict, total=False):

spotdl/utils/arguments.py

@@ -542,6 +542,16 @@ def parse_output_options(parser: _ArgumentGroup):
         choices=FFMPEG_FORMATS.keys(),
     )
 
+    # Skip explicit songs options
+    parser.add_argument(
+        "--skip-explicit", action="store_const", const=True, help="Skip explicit songs"
+    )
+
+    parser.add_argument(
+        "--proxy",
+        help="Http(s) proxy server for download song. Example: http://host:port",
+    )
+
 
 def parse_web_options(parser: _ArgumentGroup):
     """
@@ -654,11 +664,6 @@ def parse_other_options(parser: _ArgumentGroup):
         help="Run in profile mode. Useful for debugging.",
     )
 
-    parser.add_argument(
-        "--proxy",
-        help="Http(s) proxy server for download song. Example: http://host:port",
-    )
-
     parser.add_argument(
         "--version",
         "-v",

spotdl/utils/config.py

@@ -298,6 +298,7 @@ def modernize_settings(options: DownloaderOptions):
     "detect_formats": None,
     "save_errors": None,
     "proxy": None,
+    "skip_explicit": False,
 }
 
 WEB_OPTIONS: WebOptions = {

spotdl/utils/search.py

@@ -320,7 +320,8 @@ def get_all_user_playlists(user_url: str = "") -> List[Playlist]:
     Get all user playlists.
 
     ### Args (optional)
-    - user_url: Spotify user profile url. If a url is mentioned, get all public playlists of that specific user.
+    - user_url: Spotify user profile url.
+        If a url is mentioned, get all public playlists of that specific user.
 
     ### Returns
     - List of all user playlists
@@ -522,6 +523,7 @@ def create_ytm_album(url: str, fetch_songs: bool = True) -> Album:
     songs = []
     for track in album["tracks"]:
         artists = [artist["name"] for artist in track["artists"]]
+
         song = Song.from_missing_data(
             name=track["title"],
             artists=artists,