FUN SFX
Utilisez ce dossier comme racine de la compétence. Résolvez son emplacement avant d'exécuter des commandes ; le répertoire de travail de l'utilisateur peut être ailleurs. Python 3.10+ est nécessaire pour la découverte ; l'export audio nécessite également FFmpeg dans le PATH.
Trouver le son
Exécutez python3 <chemin-racine>/scripts/sfx.py search "whoosh" --json pour obtenir des candidats avec des chemins audio absolus. La recherche accepte également des descriptions de scène comme "tentative échouée" ou "prise de photo". Elle correspond aux titres, identifiants, catégories, tags, utilisations recommandées et exemples ; plusieurs mots doivent tous correspondre. Elle exclut délibérément les indications négatives. Exécutez list --json pour la collection complète ou show <id> pour un enregistrement complet. Lisez le catalogue pour un aperçu lisible par un humain.
Chaque enregistrement fourni possède un guide d'utilisation individuel : scènes recommandées, timing, situations à éviter et un exemple de montage. Utilisez les champs usage de l'enregistrement pour choisir un son pour la scène, pas seulement une catégorie correspondante. Ce sont des recommandations créatives, pas des utilisations obligatoires.
Les tags restent dérivés des noms de fichiers. Vérifiez audio_review.status : sept enregistrements ont des notes d'analyse audio automatisées ; les 64 autres ont des recommandations basées sur les noms de fichiers avec des contenus audibles non confirmés. Les notes automatisées peuvent également mal interpréter la parole ; tenez compte de audio_review.uncertainty. Aucun enregistrement n'est présenté comme ayant été écouté par un humain. Écoutez les candidats avant de les choisir, en particulier les noms vagues comme Walmart, Whoop ou Spotlight. Les fichiers peuvent contenir de la parole, de la musique, du silence, plusieurs effets ou des changements brusques de volume. La collection cinematic-whoosh et le long clip d'horreur nécessitent des extraits sélectionnés. Les indications de timing sont relatives à l'action visuelle, pas à un point d'entrée/sortie vérifié.
Préparer le cue
python3 <chemin-racine>/scripts/sfx.py export <id> /sortie/absolue/cue.wav --start 0.2 --duration 0.8 --gain-db -8 --fade-ms 10
La sortie est un PCM stéréo WAV à 48 kHz. --start est un décalage source ; le placement dans la timeline est un montage séparé. La commande refuse une sortie existante. Conservez les enregistrements originaux intacts. Utilisez un gain modéré, préservez l'intelligibilité des dialogues et écoutez le mix final ; un seul réglage de volume ne conviendra pas à tous les enregistrements.
Utilisez l'éditeur vidéo existant de l'utilisateur ou des outils de montage pour placer le cue préparé. Lisez editing.md pour les champs de la feuille de cue, les conseils de timing et les exemples de mixage FFmpeg. Notez l'ID choisi, l'extrait source, la position dans la timeline et le gain pour que le montage soit reproductible. N'ajoutez pas de son à chaque coupe par défaut.
Droits et intégrité
Le mainteneur de FUN SFX ne possède aucun des sons inclus. Tous les droits restent avec leurs propriétaires respectifs. Conservez cette mention de propriété lorsque vous présentez ou empaquetez la collection sonore.
Le code et la documentation sont sous licence MIT. Les enregistrements inclus et l'audio extrait ont des droits non vérifiés et sont exclus de cette licence ; voir ASSET_LICENSE.md. Ne décrivez pas les enregistrements comme MIT, libres de droits ou autorisés pour redistribution. Un nom de fichier contenant "no copyright" n'est pas une preuve de licence. Conservez cette distinction lors de la remise d'un montage ou de l'empaquetage de cette compétence.
Exécutez python3 <chemin-racine>/scripts/sfx.py verify lors de la vérification d'un téléchargement ou d'un pack modifié. catalog.json contient des chemins portables, des métadonnées techniques et des sommes de contrôle SHA-256 pour chaque fichier audio original et utilisable.