---

categories:

  - folder: dock
    name: Dock
    description: |
      Le Dock est une composante importante de macOS.
      Il est utilisé pour lancer des applications et pour naviguer entre les applications lancées.
      Par défaut il est placé en bas de votre écran.

      Il est personnalisable à souhait.
    image:
      filename: "dock.png"
      width: 740
      height: 41
    keys:
      - key: orientation
        domain: com.apple.dock
        title: Position
        description: Choisir la position du Dock
        param:
          type: string
          values: [left, bottom, right]
        examples:
          - value: left
            image:
              filename: "left.png"
              width: 740
              height: 463
            text: Placer le Dock sur la gauche de l'écran
          - value: bottom
            default: true
            image:
              filename: "bottom.png"
              width: 740
              height: 463
            text: Placer le Dock en bas de l'écran
          - value: right
            image:
              filename: "right.png"
              width: 740
              height: 463
            text: Placer le Dock sur la droite de l'écran
        versions: [Big Sur, Catalina, Mojave]
        after: killall Dock
      - key: tilesize
        domain: com.apple.dock
        title: Taille des icônes
        description: Paramétrer le taille des icônes du Dock
        param:
          type: int
        examples:
          - value: 36
            image:
              filename: "36.png"
              width: 740
              height: 463
            text: Taille des icônes du Dock de 36 pixels
          - value: 48
            default: true
            image:
              filename: "48.png"
              width: 740
              height: 463
            text: Taille des icônes du Dock de 48 pixels
        versions: [Big Sur, Catalina]
        after: killall Dock
      - key: autohide
        domain: com.apple.dock
        title: Caché automatiquement
        description: Cacher le Dock automatiquement. Vous pouvez afficher/cacher le Dock avec `⌥ alt`+`⌘ cmd`+`d`.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Toujours afficher le Dock
          - value: true
            text: Cacher le Dock automatiquement lorsque votre souris n'est pas dessus
        versions: [Big Sur, Catalina, Mojave]
        after: killall Dock
      - key: autohide-time-modifier
        domain: com.apple.dock
        title: Durée de l'animation d'affichage
        description: Changer la durée d'animation d'affichage et de cachage du Dock.
        param:
          type: float
        examples:
          - value: 0.5
            default: true
            video:
              filename: "0.5.mp4"
              width: 742
              height: 202
            text: Par défaut, l'animation d'affichage et de cachage prends 0.5 secondes
          - value: 2
            video:
              filename: "2.mp4"
              width: 742
              height: 202
            text: Allonger la durée d'animation du Dock
          - value: 0
            video:
              filename: "0.mp4"
              width: 742
              height: 202
            text: Supprimer la durée d'animation du Dock
        versions: [Big Sur, Catalina, Mojave]
        requirements:
          - folder: dock
            key: autohide
            name: com.apple.dock autohide
            value: true
        after: killall Dock
      - key: autohide-delay
        domain: com.apple.dock
        title: Délai avant affichage
        description: Change the Dock opening delay.
        param:
          type: float
        examples:
          - value: 0.5
            default: true
            video:
              filename: "0.5.mp4"
              width: 742
              height: 202
            text: By default, the Dock only opens if the mouse doesn't move for 0.5 seconds
          - value: 0
            video:
              filename: "0.mp4"
              width: 742
              height: 202
            text: Remove the autohide delay, the Dock appears instantly
        versions: [Big Sur, Catalina, Mojave]
        requirements:
          - folder: dock
            key: autohide
            name: com.apple.dock autohide
            value: true
        after: killall Dock
      - key: show-recents
        domain: com.apple.dock
        title: Afficher les Apps récentes
        description: Afficher ou non les applications utilisées récemment dans une section à part.
        param:
          type: bool
        examples:
          - value: true
            default: true
            image:
              filename: "true.png"
              width: 740
              height: 82
            text: Afficher la section des applications utilisées récemment.
          - value: false
            image:
              filename: "false.png"
              width: 740
              height: 82
            text: Ne pas afficher la section des applications utilisées récemment.
        versions: [Big Sur, Catalina, Mojave]
        after: killall Dock
      - key: mineffect
        domain: com.apple.dock
        title: Animation de minimisation
        description: Changer le style d'animation de minimisation des applications.
        param:
          type: string
          values: [genie, scale, suck]
        examples:
          - value: "genie"
            default: true
            video:
              filename: "genie.mp4"
              width: 740
              height: 740
          - value: "scale"
            video:
              filename: "scale.mp4"
              width: 740
              height: 740
          - value: "suck"
            video:
              filename: "suck.mp4"
              width: 740
              height: 740
            text: "\"suck\" est une valeur secrète qui n'est pas disponible dans les Préférénces Systèmes"
        versions: [Big Sur, Catalina, Mojave]
        requirements:
          - folder: dock
            key: autohide
            name: com.apple.dock autohide
            value: true
        after: killall Dock

  - folder: screenshots
    name: Capture d'écran
    description: |
      Sur un Mac, il est possible de prendre des captures d'écran avec:

      - `⌘ cmd`+`⇧ maj`+`3` pour l'écran complet.
      - `⌘ cmd`+`⇧ maj`+`4` pour une sous partie de l'écran. Ajoutez `espace` pour prendre une application entière.
      - `⌘ cmd`+`⇧ maj`+`5` pour ouvrir l'appli de capture.

      Il est possible de personnaliser quelques trucs.
    keys:
      - key: disable-shadow
        domain: com.apple.screencapture
        title: Enlever l'ombre
        description:
          Afficher ou non une ombre en prenant une capture d'une app (`⌘ cmd`+`⇧ shift`+`4` puis `espace`).
        param:
          type: bool
        examples:
          - value: false
            default: true
            image:
              filename: "false.png"
              width: 740
              height: 574
            text: Ajouter l'ombre aux captures
          - value: true
            image:
              filename: "true.png"
              width: 740
              height: 550
            text: Supprimer l'ombre des captures
        versions: [Big Sur, Catalina]
      - key: include-date
        domain: com.apple.screencapture
        title: Inclure la date
        description: Inclure la date et l'heure dans le nom du fichier.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Screenshot 2020-01-09 at 13.27.20.png
          - value: false
            text: |
              - Screenshot.png
              - Screenshot 1.png
        versions: [Big Sur, Catalina, Mojave]
      - key: location
        domain: com.apple.screencapture
        title: Emplacement
        description: Préciser l'emplacement par défaut des captures.
        param:
          type: string
        examples:
          - value: ~/Desktop
            default: true
          - value: ~/Pictures
        versions: [Big Sur, Catalina, Mojave]
        after: killall SystemUIServer
      - key: show-thumbnail
        domain: com.apple.screencapture
        title: Afficher la vignette
        description: Afficher ou non la vignette après avoir fait une capture.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Afficher la vignette après avoir fait une capture
          - value: false
            text: Ne pas afficher la vignette
        versions: [Big Sur, Catalina]
      - key: type
        domain: com.apple.screencapture
        title: Choisir le format de la capture
        description: Choisir le format de fichier de l'image dans lequel la capture est enregistrée.
        param:
          type: string
        examples:
          - value: png
            default: true
            text: L'image générée est au format png
          - value: jpg
            text: L'image générée est au format jpg
        versions: [Big Sur, Catalina, Mojave]

  - folder: finder
    name: Finder
    description: |
      Le Finder est le gestionnaire de fichier de macOS.
      Il est responsable du lancement d'autres applications,
      et pour la gestion générique des fichiers, disques externes, et volumes réseaux.
      Depuis les années 80-90, l'icône du Finder est un écran souriant d'ordinateur, connu sous le nom "Happy Mac".

      Certaines de ses fonctionnalités sont personnalisables.
    keys:
      - key: QuitMenuItem
        domain: com.apple.finder
        title: Quitter
        description: Afficher ou non l'option pour quitter le Finder.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Cacher l'option "Quitter" du Finder
          - value: true
            text: Afficher l'option "Quitter" du Finder
        versions: [Big Sur, Catalina, Mojave]
        after: killall Finder
      - key: AppleShowAllExtensions
        domain: NSGlobalDomain
        title: Afficher les extensions
        description: Afficher toutes les extensions de fichier ou non.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Ne pas afficher toutes les extensions dans le Finder
          - value: true
            text: Afficher toutes les extensions de fichier dans le Finder
        versions: [Big Sur, Catalina, Mojave]
        after: killall Finder
      - key: AppleShowAllFiles
        domain: com.apple.Finder
        title: Afficher les fichiers cachés
        description: Afficher les fichiers cachés dans le Finder.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Ne pas afficher les fichiers cachés dans le Finder
            image:
              filename: "false.png"
              width: 740
              height: 451
          - value: true
            text: Afficher les fichiers cachés dans le Finder
            image:
              filename: "true.png"
              width: 740
              height: 451
        versions: [Big Sur, Catalina]
        after: killall Finder
      - key: FXEnableExtensionChangeWarning
        domain: com.apple.finder
        title: Alerte au changement d'extension
        description: Choisir si il faut afficher une alerte au changement de format de fichier ou non.
        param:
          type: bool
        examples:
          - value: true
            default: true
            video:
              filename: "true.mp4"
              width: 739
              height: 416
            text: Afficher une alerte au changement de format de fichier
          - value: false
            video:
              filename: "false.mp4"
              width: 739
              height: 416
            text: Ne pas afficher d'alerte au changement
        versions: [Big Sur, Catalina, Mojave]
        after: killall Finder
      - key: NSDocumentSaveNewDocumentsToCloud
        domain: NSGlobalDomain
        title: Sauvegarder sur le disque ou dans iCloud par défaut
        description: Définir si l'emplacement de sauvegarde par défaut est sur le disque ou dans iCloud
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: iCloud Documents est le dossier ouvert par défaut lors de la sauvegarde d'un nouveau document
          - value: false
            text: Le répertoire utilisateur est ouvert par défaut lors de la sauvegarde d'un nouveau document
        versions: [Catalina]
      - key: NSToolbarTitleViewRolloverDelay
        domain: NSGlobalDomain
        title: Délai au survol du titre
        description: Choisir le délai d'affichage du titre complet.
        param:
          type: float
        examples:
          - value: 0.5
            default: true
            video:
              filename: "0.5.mp4"
              width: 741
              height: 416
            text: Par défaut, le titre met 0.5 secondes à s'afficher
          - value: 0
            video:
              filename: "0.mp4"
              width: 741
              height: 416
            text: Supprimer le délai au survol du titre
          - value: 1
            video:
              filename: "1.mp4"
              width: 741
              height: 416
            text: Ajouter du délai au survol du titre
        versions: [Big Sur]
        after: killall Finder
      - key: NSTableViewDefaultSizeMode
        domain: NSGlobalDomain
        title: Taille des icônes de la barre latérale
        description: Personnaliser la taille des icônes dans la barre latérale du Finder
        param:
          type: int
        examples:
          - value: 1
            image:
              filename: "1.png"
              width: 740
              height: 415
            text: Petites
          - value: 2
            default: true
            image:
              filename: "2.png"
              width: 740
              height: 415
            text: Moyennes
          - value: 3
            image:
              filename: "3.png"
              width: 740
              height: 415
            text: Grosses
        versions: [Big Sur, Catalina]
        after: killall Finder

  - folder: menubar
    name: Barre des menus
    description:
      La barre des menus est située en haut de l’écran.
      Utilisez les menus et les icônes de la barre des menus pour choisir des commandes, réaliser des tâches et vérifier un état.
    keys:
      - key: FlashDateSeparators
        domain: com.apple.menuextra.clock
        title: Faire clignoter les séparateurs de l'horloge
        description:
          "Permet de faire clignoter ou non les séparateurs de l'horloge numérique (par défaut, ce sont des deux points)."
        param:
          type: bool
        examples:
          - value: false
            default: true
            video:
              filename: "false.mp4"
              width: 727
              height: 40
            text: Les séparateurs restent toujours solides.
          - value: true
            video:
              filename: "true.mp4"
              width: 727
              height: 40
            text: Les séparateurs clignotent toutes les secondes.
        versions: [Big Sur, Catalina, Mojave]
        after: killall SystemUIServer
      - key: DateFormat
        domain: com.apple.menuextra.clock
        title: Format de date et heure
        description: |
          Ce paramètre permet de préciser le format de date et heure de la barre de menus.
          Les valeurs acceptées dépendent de vos paramètres de Langue & région.

          - `ss` pour les secondes.
          - `HH` pour l'heure (24h).
          - `EEE` pour le jour de la semaine en 3 lettres.
          - `d MMM` pour le jour dans le mois et le mois en 3 lettres.
        param:
          type: string
        examples:
          - value: '"EEE d MMM HH:mm:ss"'
            video:
              filename: "EEE_d_MMM_HH.mm.ss.mp4"
              width: 727
              height: 40
            text: Lun. 5 oct. à 21:56:12
          - value: '"EEE h:mm:ss"'
            video:
              filename: "EEE_h.mm.ss.mp4"
              width: 727
              height: 40
            text: Lun. 21:56:40
          - value: '"MMM d HH:mm:ss"'
            text: 5 oct. à 21:58:33
        versions: [Big Sur, Catalina]

  - folder: mission-control
    name: Mission Control
    description: |
      Anciennement connu sous le nom d'Exposé, Mission Control permet :

      - `⌃ ctrl`+`↑ haut` voir toutes les fenêtres d'applications ouvertes.
      - `⌃ ctrl`+`↓ bas` voir toutes les fenêtres de l'application courante.
      - `⌘ cmd`+`F3 Mission Control` cacher toutes les applications et afficher le bureau.
      - `⌃ ctrl`+`← gauche`/`→ droite` se déplacer entre les bureaux virtuels.
      - déplacer des applications entre plusieurs écrans.
    keys:
      - key: mru-spaces
        domain: com.apple.dock
        title: Réorganiser automatiquement
        description: Réorganiser les bureaux virtuels automatiquement.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Déplacer les bureaux virtuels les plus récemment utilisés
          - value: false
            text: Toujours conserver l'arrangement de bureaux virtuels
        versions: [Big Sur, Catalina, Mojave]
        after: killall Dock

  - folder: feedback-assistant
    name: Assistant d'évaluation
    description:
      L'application "Assistant d'évaluation" permet d'envoyer des comptes rendus développeur.
    keys:
      - key: Autogather
        domain: com.apple.appleseed.FeedbackAssistant
        title: Collecte automatique
        description: |
          Collecter automatiquement des larges fichiers lors de la soumission de compte rendu.

          Peut ralentir significativement le Mac et envoyer de grosses quantités de données.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: L'assistant d'évaluation récupère de gros fichiers lors de la soumission
          - value: false
            text: Ne pas collecter ces fichiers lors de l'envoi
        versions: [Big Sur]

  - folder: xcode
    name: Xcode
    description:
      Xcode est un environnement de développement pour macOS, ainsi que pour iOS, watchOS et tvOS.
    keys:
      - key: IDEAdditionalCounterpartSuffixes
        domain: com.apple.dt.Xcode
        title: Ajouter des suffixes dans les Counterparts
        description:
          Ajouter des suffixes supplémentaires que Xcode place dans le menu "Related Items > Counterparts".
        param:
          type: array
        examples:
          - command: array-add
            value:
              - ViewModel
              - View
            text: Ajoute les suffixes "ViewModel" et "View" (pratique pour les architectures Model-View-ViewModel (MVVM)).
          - command: array-add
            value:
              - Router
              - Interactor
              - Builder
            text: Ajoute les suffixes "Router", "Interactor" et "Builder" (pratique pour les architectures RIB).
        versions: [Catalina]
        after: killall Xcode
      - key: ShowBuildOperationDuration
        domain: com.apple.dt.Xcode
        title: Afficher la durée de build
        description:
          Afficher la durée de build dans la toolbar en haut de la fenêtre d'Xcode
        param:
          type: bool
        examples:
          - value: true
            text: Afficher la durée de build dans la toolbar
          - value: false
            default: true
            text: Ne pas afficher la durée de build dans la toolbar
        versions: [Catalina]
        after: killall Xcode

  - folder: simulator
    name: Simulateur
    description:
      Installé avec les outils d'Xcode, le Simulateur est une application Mac pour simuler
      un iPhone, un Ipad, une Apple Watch ou une Apple TV.
    keys:
      - key: ScreenShotSaveLocation
        domain: com.apple.iphonesimulator
        title: Emplacement des screenshots
        description: |
          Préciser le chemin par défaut des screenshots du Simulateur.

          Le dossier doit obligatoirement exister dans le système.
        param:
          type: string
        examples:
          - value: ~/Pictures/Screenshots
            default: true
          - value: "~/Pictures/Simulator Screenshots"
        versions: [Catalina]

  - folder: textedit
    name: TextEdit
    description:
      TextEdit permet d'ouvrir et de modifier des documents de texte enrichi (rich text), texte brut (plain text) et HTML.
    keys:
      - key: RichText
        domain: com.apple.TextEdit
        title: Définir le format de document par défaut
        description:
          Définir le format de document par défaut comme texte enrichi (.rtf) ou texte brut (.txt).
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Texte enrichi activé.
            image:
              filename: "true.png"
              width: 740
              height: 451
          - value: false
            text: Texte enrichi désactivé.
            image:
              filename: "false.png"
              width: 740
              height: 451
        versions: [Big Sur]
        after: killall TextEdit

  - folder: timemachine
    name: Time Machine
    description:
      Time Machine permet de sauvegarder l'état de son système au cours du temps.
    keys:
      - key: DoNotOfferNewDisksForBackup
        domain: com.apple.TimeMachine
        title: Eviter les nouveaux disques
        description:
          Ne pas proposer les périphériques de stockage nouvellement branchés en tant que disque de sauvegarde
        param:
          type: bool
        examples:
          - value: false
            default: true
            text:
              Lorsqu'un nouveau périphérique de stockage est branché,
              l'ordinateur propose de l'ajouter en tant que disque de sauvegarde
          - value: true
            text:
              Ne pas proposer les nouveaux périphériques de stockage connectés comme disque de sauvegarde
        versions: [Catalina]

  - folder: misc
    name: Divers
    description: Tous les `defaults` qui n'ont pas leur place ailleurs.
    keys:
      - key: DevMode
        domain: com.apple.helpviewer
        title: Position du menu d'Aide
        description: Choisir si le menu d'Aide doit être au-dessus de toutes les applications.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Par défaut, le menu d'Aide est au-dessus de n'importe quel fenêtre
          - value: true
            text: Laisser le menu d'Aide passer derrière les autres fenêtres
        versions: [Big Sur, Catalina, Mojave]
      - key: enable-spring-load-actions-on-all-items
        domain: com.apple.dock
        title: Activer le spring loading dans le Dock
        description:
          Glisser un fichier au dessus d'une icône du Dock et l'application va s'ouvrir.
          Ne permet de le faire que si l'application n'est pas déjà ouverte.
          Nous avons réussi à le faire fonctionner sur Aperçu, QuickTime et iWork (Keynote, Pages, Numbers).
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Le spring loading est désactivé
          - value: true
            text: Le spring loading est activé
        versions: [Big Sur, Catalina]
        after: killall Dock
      - key: userWantsPlaybackNotifications
        domain: com.apple.Music
        title: Afficher les notifications de Musique
        description:
          Afficher une notification lorsqu'une nouvelle chanson commence dans
          l'application Musique.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: L'affichage des notifications est désactivé.
          - value: true
            text: L'affichage des notifications est activé.
        versions: [Catalina]
        after: killall Music