scdl est un utilitaire en ligne de commande, développé en Python, conçu pour télécharger de l'audio depuis la plateforme SoundCloud. Il gère les téléchargements de pistes uniques, de listes de lecture complètes, des œuvres d'un utilisateur spécifique, ainsi que des favoris personnels. Cet outil est open source et compatible avec les systèmes d'exploitation Windows, macOS et Linux.

Prérequis techniques

Pour utiliser scdl, assurez-vous d'avoir installé Python 3.10 ou une version ultérieure, ainsi que FFmpeg pour la conversion des formats audio. Une connexion réseau stable est également nécessaire.

Procédure d'installation

Cloner le dépôt de l'outil depuis un miroir git, puis installer les dépendances via pip.

git clone https://gitcode.com/gh_mirrors/sc/scdl
cd scdl
pip install -e .

Après l'installation, un fichier de configuration est créé dans le répertoire ~/.config/scdl/scdl.cfg, où vous pouvez personnaliser le chemin de téléchargement, le format des noms de fichiers et d'autres préférences.

Exemples d'utilisation courants

Téléchargement d'une piste unique

Pour récupérer un morceau spécifique, utilisez la commande suivante avec l'URL de la piste.

scdl --link https://soundcloud.com/artiste/nom-du-morceau

Récupération de l'intégralité des œuvres d'un artiste

Pour télécharger toutes les publications d'un utilisateur, y compris les reposts, ajoutez l'option appropriée. Pour se limiter aux créations originales, une autre option est disponible.

scdl --link https://soundcloud.com/artiste --all-tracks
scdl --link https://soundcloud.com/artiste --originals-only

Sauvegarde d'une liste de lecture

Les listes de lecture peuvent être téléchargées intégralement. Pour synchroniser avec une archive, utilisez les options de déduplication.

scdl --link https://soundcloud.com/utilisateur/sets/playlist
scdl --link https://soundcloud.com/utilisateur/sets/playlist --archive-file sync.txt --continue

Personnalisation avancée

Formats et qualité audio

scdl permet de choisir le format de sortie : MP3 pour une compatibilité maximale, FLAC pour une qualité sans perte, ou le fichier original.

scdl --link [url] --output-format mp3
scdl --link [url] --lossless
scdl --link [url] --keep-original

Nommage personnalisé des fichiers

Le format des noms de fichiers peut être défini via des variables prédéfinies.

scdl --link [url] --template "%(artiste)s - %(titre)s"
scdl --link [url] --template "%(date)s_%(titre)s"

Automatisation avec des scripts

Pour des téléchargements par lots, intégrez scdl dans des scripts shell.

#!/bin/bash
# Téléchargement pour plusieurs artistes
artistes=("artisteA" "artisteB" "artisteC")
for art in "${artistes[@]}"; do
    scdl --link "https://soundcloud.com/$art" --all-tracks --destination "/Musique/$art"
done

Dépannage et bonnes pratiques

En cas de lenteur de téléchargement, vérifiez votre connexion réseau ou utilisez l'option pour masquer la barre de progression. Les téléchargements de collections personnelles nécessitent une authentification valide avec un identifiant client et un jeton. Pour la gestion des fichiers, utilisez l'option --destination pour organiser la hiérarchie des répertoires.

Respectez les droits d'auteur en ne téléchargeant que les contenus partagés publiquement. Évitez les téléchargements massifs en peu de temps pour ne pas surcharger les serveurs. Envisagez de sauvegarder vos collections musicales importantes et de maintenir les fichiers d'archive à jour.

L'architecture modulaire de scdl, basée sur yt-dlp avec des adaptations spécifiques pour SoundCloud, inclut des composants principaux comme le moteur de téléchargement, les utilitaires, les correctifs pour la plateforme et la gestion de configuration. Cette conception assure stabilité et extensibilité face aux évolutions du service SoundCloud.