From f1db40ececee93b9beba96d3c04097d4fb5d8198 Mon Sep 17 00:00:00 2001 From: Lina Fadhli <133816965+luluna02@users.noreply.github.com> Date: Sat, 11 May 2024 21:48:57 +0100 Subject: [PATCH] readme file translated to french --- docs/readme/README-fr.md | 388 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 388 insertions(+) create mode 100644 docs/readme/README-fr.md diff --git a/docs/readme/README-fr.md b/docs/readme/README-fr.md new file mode 100644 index 0000000000..c65c236ec2 --- /dev/null +++ b/docs/readme/README-fr.md @@ -0,0 +1,388 @@ +
+ +# YouTube Music + +[![GitHub release](https://img.shields.io/github/release/th-ch/youtube-music.svg?style=for-the-badge&logo=youtube-music)](https://github.com/th-ch/youtube-music/releases/) +[![Licence GitHub](https://img.shields.io/github/license/th-ch/youtube-music.svg?style=for-the-badge)](https://github.com/th-ch/youtube-music/blob/master/LICENSE) +[![style de code eslint](https://img.shields.io/badge/style_de_code-eslint-5ed9c7.svg?style=for-the-badge)](https://github.com/th-ch/youtube-music/blob/master/.eslintrc.js) +[![Statut de la construction](https://img.shields.io/github/actions/workflow/status/th-ch/youtube-music/build.yml?branch=master&style=for-the-badge&logo=youtube-music)](https://GitHub.com/th-ch/youtube-music/releases/) +[![Toutes les versions GitHub](https://img.shields.io/github/downloads/th-ch/youtube-music/total?style=for-the-badge&logo=youtube-music)](https://GitHub.com/th-ch/youtube-music/releases/) +[![AUR](https://img.shields.io/aur/version/youtube-music-bin?color=blueviolet&style=for-the-badge&logo=youtube-music)](https://aur.archlinux.org/packages/youtube-music-bin) +[![Vulnérabilités connues](https://snyk.io/test/github/th-ch/youtube-music/badge.svg)](https://snyk.io/test/github/th-ch/youtube-music) + +
+ +![Capture d'écran](https://github.com/th-ch/youtube-music/raw/master/web/screenshot.jpg "Capture d'écran") + + +
+ + SVG YouTube Music + +
+ + +**Enveloppe Electron autour de YouTube Music offrant :** + +- Aspect & sensation naturels, vise à conserver l'interface originale +- Cadre pour les plugins personnalisés : modifiez YouTube Music selon vos besoins (style, contenu, fonctionnalités), activez/désactivez les plugins en + un clic + +## Image de démonstration + +| Écran du lecteur (thème de couleur de l'album & lumière ambiante) | +|:---------------------------------------------------------------------------------------------------------:| +|![Capture d'écran1](https://github.com/th-ch/youtube-music/assets/16558115/53efdf73-b8fa-4d7b-a235-b96b91ea77fc)| + +## Contenu + +- [Fonctionnalités](#fonctionnalités) +- [Plugins disponibles](#plugins-disponibles) +- [Traduction](#traduction) +- [Téléchargement](#téléchargement) + - [Arch Linux](#arch-linux) + - [MacOS](#macos) + - [Windows](#windows) + - [Comment installer sans connexion réseau ? (sous Windows)](#comment-installer-sans-connexion-réseau-sous-windows) +- [Thèmes](#thèmes) +- [Dev](#dev) +- [Créez vos propres plugins](#créez-vos-propres-plugins) + - [Créer un plugin](#créer-un-plugin) + - [Cas d'utilisation courants](#cas-dutilisation-courants) +- [Construction](#construction) +- [Aperçu de la production](#aperçu-de-la-production) +- [Tests](#tests) +- [Licence](#licence) +- [FAQ](#faq) + +## Fonctionnalités : + +- **Confirmation automatique lors de la pause** (Toujours activé) : désactiver + la pop-up ["Continuer à regarder ?"](https://user-images.githubusercontent.com/61631665/129977894-01c60740-7ec6-4bf0-9a2c-25da24491b0e.png) + qui pause la musique après un certain temps + + - Et plus encore ... + +## Plugins disponibles : + +- **Bloqueur de publicités** : Bloquez toutes les publicités et le suivi dès le départ + +- **Actions d'album** : Ajoute des boutons Je n'aime pas, Dislike, J'aime, et Unlike pour appliquer cela à toutes les chansons dans une playlist ou un album + +- **Thème de couleur d'album** : Applique un thème dynamique et des effets visuels basés sur la palette de couleurs de l'album + +- **Mode Ambiant** : Applique un effet d'éclairage en projetant des couleurs douces de la vidéo, sur l'arrière-plan de votre écran + +- **Compresseur Audio** : Appliquer une compression audio (diminue le volume des parties les plus fortes du signal et augmente le + volume des parties les plus douces) + +- **Barre de navigation floue** : rend la barre de navigation transparente et floue + +- **Contournement des restrictions d'âge** : contourner la vérification d'âge de YouTube + +- **Sélecteur de sous-titres** : Activer les sous-titres + +- **Barre latérale compacte** : Toujours définir la barre latérale en mode compact + +- **Fondu enchaîné** : Fondu enchaîné entre les chansons + +- **Désactiver la lecture automatique** : Fait démarrer chaque chanson en mode "pause" + +- **[Discord](https://discord.com/) Présence riche** : Montrez à vos amis ce que vous écoutez + avec [Présence riche](https://user-images.githubusercontent.com/28219076/104362104-a7a0b980-5513-11eb-9744-bb89eabe0016.png) + +- **Téléchargeur** : télécharge des + MP3 [directement depuis l'interface](https://user-images.githubusercontent.com/61631665/129977677-83a7d067-c192-45e1-98ae-b5a4927393be.png) [(youtube-dl)](https://github.com/ytdl-org/youtube-dl) + +- **Volume exponentiel** : Rend le curseur de volume + [exponentiel](https://greasyfork.org/en/scripts/397686-youtube-music-fix-volume-ratio/) afin qu'il soit plus facile de + sélectionner des volumes plus bas + +- **Menu In-App** : [donne aux barres un aspect chic et sombre](https://user-images.githubusercontent.com/78568641/112215894-923dbf00-8c29-11eb-95c3-3ce15db27eca.png) + + > (voir [ce poste](https://github.com/th-ch/youtube-music/issues/410#issuecomment-952060709) si vous avez des problèmes + pour accéder au menu après avoir activé ce plugin et l'option masquer-menu) + +- **Scrobbler** : Ajoute le support de scrobbling pour [Last.fm](https://www.last.fm/) et [ListenBrainz](https://listenbrainz.org/) + +- **Lumia Stream** : Ajoute le support de [Lumia Stream](https://lumiastream.com/) + +- **Lyrics Genius** : Ajoute le support des paroles pour la plupart des chansons + +- **Musique Ensemble** : Partagez une playlist avec d'autres. Lorsque l'hôte joue une chanson, tout le monde entendra la même chanson + +- **Navigation** : Flèches de navigation Suivant/Retour directement intégrées dans l'interface, comme dans votre navigateur préféré + +- **Pas de connexion Google** : Supprime les boutons et les liens de connexion Google de l'interface + +- **Notifications** : Affiche une notification lorsqu'une chanson commence à jouer ([notifications interactives](https://user-images.githubusercontent.com/78568641/114102651-63ce0e00-98d0-11eb-9dfe-c5a02bb54f9c.png) + sont disponibles sur Windows) + +- **Image dans l'image** : permet de passer l'application en mode image dans l'image + +- **Vitesse de lecture** : Écoutez rapidement, écoutez lentement ! [Ajoute un curseur qui contrôle la vitesse des chansons](https://user-images.githubusercontent.com/61631665/129976003-e55db5ba-bf42-448c-a059-26a009775e68.png) + +- **Volume précis** : Contrôlez le volume précisément en utilisant la molette de la souris/raccourcis clavier, avec un hud personnalisé et des étapes de volume personnalisables + +- **Raccourcis (& MPRIS)** : Permet de définir des raccourcis globaux pour la lecture (lecture/pause/suivant/précédent) + + désactive [osd média](https://user-images.githubusercontent.com/84923831/128601225-afa38c1f-dea8-4209-9f72-0f84c1dd8b54.png) + en remplaçant les touches multimédias + activer Ctrl/CMD + F pour rechercher + activer le support mpris linux pour + les touches multimédias + [raccourcis personnalisés](https://github.com/Araxeus/youtube-music/blob/1e591d6a3df98449bcda6e63baab249b28026148/providers/song-controls.js#L13-L50) + pour [utilisateurs avancés](https://github.com/th-ch/youtube-music/issues/106#issuecomment-952156902) + +- **Passer la chanson non aimée** : passe les chansons non aimées + +- **Passer les silences** : passe automatiquement les sections silencieuses + +- [**SponsorBlock**](https://github.com/ajayyy/SponsorBlock) : Saute automatiquement les parties non musicales comme les intros/outros ou + les parties des clips vidéo où la chanson n'est pas jouée + +- **Contrôle multimédia de la barre des tâches** : Contrôlez la lecture depuis + votre [barre des tâches Windows](https://user-images.githubusercontent.com/78568641/111916130-24a35e80-8a82-11eb-80c8-5021c1aa27f4.png) + +- **TouchBar** : Disposition personnalisée de la TouchBar pour macOS + +- **Tuna OBS** : Intégration avec le + plugin [Tuna](https://obsproject.com/forum/resources/tuna.843/) d'[OBS](https://obsproject.com/) + +- **Changeur de qualité vidéo** : Permet de changer la qualité vidéo avec + un [bouton](https://user-images.githubusercontent.com/78568641/138574366-70324a5e-2d64-4f6a-acdd-dc2a2b9cecc5.png) sur + l'overlay vidéo + +- **Bascule vidéo** : Ajoute + un [bouton](https://user-images.githubusercontent.com/28893833/173663950-63e6610e-a532-49b7-9afa-54cb57ddfc15.png) pour + basculer entre le mode Vidéo/Chanson. peut également supprimer l'onglet vidéo entier + +- **Visualiseur** : Différents visualiseurs musicaux + +## Traduction + +Vous pouvez aider à la traduction sur [Hosted Weblate](https://hosted.weblate.org/projects/youtube-music/). + + + statut de la traduction + statut de la traduction 2 + + +## Téléchargement + +Vous pouvez consulter la [dernière sortie](https://github.com/th-ch/youtube-music/releases/latest) pour trouver rapidement la +dernière version. + +### Arch Linux + +Installez le paquet [`youtube-music-bin`](https://aur.archlinux.org/packages/youtube-music-bin) depuis l'AUR. Pour les instructions d'installation de l'AUR, consultez +cette [page wiki](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages). + +### MacOS + +Vous pouvez installer l'application en utilisant Homebrew (voir la [définition du fût](https://github.com/th-ch/homebrew-youtube-music)) : + +```bash +brew install th-ch/youtube-music/youtube-music +``` + +Si vous installez l'application manuellement et obtenez une erreur "est endommagé et ne peut pas être ouvert." lors du lancement de l'application, exécutez ce qui suit dans le Terminal : + +```bash +xattr -cr /Applications/YouTube\ Music.app +``` + +### Windows + +Vous pouvez utiliser le [gestionnaire de paquets Scoop](https://scoop.sh) pour installer le paquet `youtube-music` depuis le [seau `extras`](https://github.com/ScoopInstaller/Extras). + +```bash +scoop bucket add extras +scoop install extras/youtube-music +``` + +Alternativement, vous pouvez utiliser [Winget](https://learn.microsoft.com/fr-fr/windows/package-manager/winget/), le gestionnaire de paquets CLI officiel de Windows 11, pour installer le paquet `th-ch.YouTubeMusic`. + +*Note : Microsoft Defender SmartScreen pourrait bloquer l'installation car elle provient d'un "éditeur inconnu". Ceci est également vrai pour l'installation manuelle lors de l'essai d'exécution de l'exécutable (.exe) après un téléchargement manuel ici sur GitHub (même fichier).* + +```bash +winget install th-ch.YouTubeMusic +``` + +#### Comment installer sans connexion réseau ? (sous Windows) + +- Téléchargez le fichier `*.nsis.7z` pour _l'architecture de votre appareil_ sur la [page des versions](https://github.com/th-ch/youtube-music/releases/latest). + - `x64` pour Windows 64 bits + - `ia32` pour Windows 32 bits + - `arm64` pour Windows ARM64 +- Téléchargez l'installeur sur la page des versions. (`*-Setup.exe`) +- Placez-les dans le **même dossier**. +- Exécutez l'installeur. + +## Thèmes + +Vous pouvez charger des fichiers CSS pour changer l'apparence de l'application (Options > Ajustements visuels > Thèmes). + +Certains thèmes prédéfinis sont disponibles sur [https://github.com/kerichdev/themes-for-ytmdesktop-player](https://github.com/kerichdev/themes-for-ytmdesktop-player). + +## Dev + +```bash +git clone https://github.com/th-ch/youtube-music +cd youtube-music +pnpm install --frozen-lockfile +pnpm dev +``` +## Créez vos propres plugins + +En utilisant des plugins, vous pouvez : + +- manipuler l'application - la `BrowserWindow` d'Electron est passée au gestionnaire de plugin +- changer le front en manipulant le HTML/CSS + +### Créer un plugin + +Créez un dossier dans `src/plugins/NOM-DE-VOTRE-PLUGIN` : + +- `index.ts` : le fichier principal du plugin +```typescript +import style from './style.css?inline'; // importez le style comme inline + +import { createPlugin } from '@/utils'; + +export default createPlugin({ + name: 'Étiquette du plugin', + restartNeeded: true, // si la valeur est vraie, ytmusic affichera la boîte de dialogue de redémarrage + config: { + enabled: false, + }, // votre configuration personnalisée + stylesheets: [style], // votre style personnalisé, + menu: async ({ getConfig, setConfig }) => { + // Toutes les méthodes *Config sont des promesses encapsulées + const config = await getConfig(); + return [ + { + label: 'menu', + submenu: [1, 2, 3].map((value) => ({ + label: `valeur ${value}`, + type: 'radio', + checked: config.value === value, + click() { + setConfig({ value }); + }, + })), + }, + ]; + }, + backend: { + start({ window, ipc }) { + window.maximize(); + + // vous pouvez communiquer avec le plugin du rendu + ipc.handle('un événement', () => { + return 'bonjour'; + }); + }, + // il est déclenché lorsque la configuration change + onConfigChange(newConfig) { /* ... */ }, + // il est déclenché lorsque le plugin est désactivé + stop(context) { /* ... */ }, + }, + renderer: { + async start(context) { + console.log(await context.ipc.invoke('un événement')); + }, + // Seul le crochet disponible pour le rendu + onPlayerApiReady(api: YoutubePlayer, context: RendererContext) { + // définir facilement la configuration du plugin + context.setConfig({ myConfig: api.getVolume() }); + }, + onConfigChange(newConfig) { /* ... */ }, + stop(_context) { /* ... */ }, + }, + preload: { + async start({ getConfig }) { + const config is obtained by `getConfig` method. + }, + onConfigChange(newConfig) {}, + stop(_context) {}, + }, +}); + +``` + +### Cas d'utilisation courants + +- **Injection de CSS personnalisé** : créez un fichier `style.css` dans le même dossier puis : + +```typescript +// index.ts +import style from './style.css?inline'; // importez le style comme en ligne + +import { createPlugin } from '@/utils'; + +export default createPlugin({ + name: 'Étiquette du plugin', + restartNeeded: true, // si la valeur est vraie, ytmusic affichera la boîte de dialogue de redémarrage + config: { + enabled: false, + }, // votre configuration personnalisée + stylesheets: [style], // votre style personnalisé + renderer() {} // définissez le crochet de rendu +}); +``` + +- **Si vous voulez modifier le HTML** : + +```typescript +import { createPlugin } from '@/utils'; + +export default createPlugin({ + name: 'Étiquette du plugin', + restartNeeded: true, // si la valeur est vraie, ytmusic affichera la boîte de dialogue de redémarrage + config: { + enabled: false, + }, // votre configuration personnalisée + renderer() { + // Supprimez le bouton de connexion + document.querySelector(".sign-in-link.ytmusic-nav-bar").remove(); + } // définissez le crochet de rendu +}); + +``` + +- **Communication entre le front et le back** : cela peut se faire en utilisant le module ipcMain d'Electron. Voir le fichier `index.ts` et l'exemple dans le plugin `sponsorblock`. + +## Construction + +1. Clonez le dépôt +2. Suivez [ce guide](https://pnpm.io/installation) pour installer `pnpm` +3. Exécutez `pnpm install --frozen-lockfile` pour installer les dépendances +4. Exécutez `pnpm build:OS` + +- `pnpm dist:win` - pour Windows +- `pnpm dist:linux` - pour Linux +- `pnpm dist:mac` - pour MacOS + +Construit l'application pour macOS, Linux et Windows, +en utilisant [electron-builder](https://github.com/electron-userland/electron-builder). + +## Aperçu de la production + +```bash +pnpm start +``` + +## Tests + +```bash +pnpm test +``` + +Utilise [Playwright](https://playwright.dev/) pour tester l'application. + +## Licence + +MIT © [th-ch](https://github.com/th-ch/youtube-music) + +## FAQ + +### Pourquoi le menu de l'application ne s'affiche-t-il pas ? + +Si l'option `Masquer le menu` est activée - vous pouvez afficher le menu avec la touche alt (ou \` [backtick] si vous utilisez le plugin du menu intégré) \ No newline at end of file