Documentation application Launcher

Documentation complète de l'application desktop Launcher - Une application Electron moderne pour l'automatisation de votre environnement de travail.

Qu'est-ce que Launcher ?

Launcher est une application desktop multi-plateforme qui vous permet d'automatiser le lancement et la gestion de vos applications et outils de travail. En un clic, configurez et exécutez des scénarios complets pour démarrer votre environnement de développement, de design, ou tout autre workflow.

Fonctionnalités principales

Plateformes supportées

• macOS : macOS 13 (Ventura) et supérieur (Intel & Apple Silicon)
• Windows : Windows 10/11 (64-bit)
• Linux : Ubuntu 20.04+, Debian 11+, Fedora 35+

Installation

Téléchargez et installez Launcher sur votre système d'exploitation. L'installation prend moins de 2 minutes.

Configuration système requise

Installation macOS

Prérequis

• macOS 13 (Ventura) ou supérieur
• Processeur Intel ou Apple Silicon (M1/M2/M3)
• 200 MB d'espace disque disponible

Installation via DMG

1. Téléchargez le fichier Launcher-1.0.0.dmg
2. Double-cliquez sur le fichier DMG pour le monter
3. Glissez Launcher.app dans le dossier Applications
4. Éjectez l'image disque

# Installation via terminal (optionnel)
# Ouvrir le DMG
open Launcher-1.0.0.dmg

# Copier vers Applications
cp -R /Volumes/Launcher/Launcher.app /Applications/

Premier lancement

Installation via Homebrew (alternative)

# Ajouter le tap Launcher
brew tap launcher-app/launcher

# Installer Launcher
brew install --cask launcher

Vérification de l'installation

# Vérifier que l'app est bien installée
ls -la /Applications/Launcher.app

# Vérifier la signature
codesign -dv /Applications/Launcher.app

Installation Windows

Prérequis

• Windows 10 (version 1809) ou Windows 11
• Architecture 64-bit
• 200 MB d'espace disque disponible

Option 1 : installateur (recommandé)

1. Téléchargez Launcher-Setup-1.0.0.exe
2. Double-cliquez sur le fichier pour lancer l'installateur
3. Suivez l'assistant d'installation
4. Choisissez le dossier d'installation (par défaut : C:\Program Files\Launcher)
5. Cliquez sur "Installer"

Option 2 : version portable

Idéal pour une utilisation sans installation ou sur clé USB :

1. Téléchargez Launcher-1.0.0-portable.zip
2. Décompressez l'archive dans le dossier de votre choix
3. Lancez Launcher.exe

# Décompresser via PowerShell
Expand-Archive -Path Launcher-1.0.0-portable.zip -DestinationPath C:\Launcher

# Lancer l'application
Start-Process "C:\Launcher\Launcher.exe"

Installation silencieuse (IT/Admin)

# Installation silencieuse pour déploiement en entreprise
Launcher-Setup-1.0.0.exe /S /D=C:\Program Files\Launcher

# Installation avec log
Launcher-Setup-1.0.0.exe /S /D=C:\Program Files\Launcher /LOG=install.log

Windows Defender

Installation Linux

Prérequis

• Distribution Linux récente (Ubuntu 20.04+, Debian 11+, Fedora 35+)
• Architecture 64-bit (x86_64 ou ARM64)
• 200 MB d'espace disque disponible

Option 1 : AppImage (universel)

Fonctionne sur toutes les distributions Linux modernes :

# Télécharger l'AppImage
wget https://launcher-app.com/downloads/Launcher-1.0.0.AppImage

# Rendre exécutable
chmod +x Launcher-1.0.0.AppImage

# Lancer l'application
./Launcher-1.0.0.AppImage

Intégration au système

# Déplacer dans /opt
sudo mv Launcher-1.0.0.AppImage /opt/launcher.appimage

# Créer un raccourci desktop
cat > ~/.local/share/applications/launcher.desktop << EOF
[Desktop Entry]
Name=Launcher
Exec=/opt/launcher.appimage
Icon=launcher
Type=Application
Categories=Utility;
EOF

Option 2 : Debian/Ubuntu (.deb)

# Télécharger le package
wget https://launcher-app.com/downloads/launcher_1.0.0_amd64.deb

# Installer via dpkg
sudo dpkg -i launcher_1.0.0_amd64.deb

# Résoudre les dépendances si nécessaire
sudo apt-get install -f

# Lancer Launcher
launcher

Option 3 : Fedora/RedHat (.rpm)

# Télécharger le package
wget https://launcher-app.com/downloads/launcher-1.0.0.x86_64.rpm

# Installer via dnf (Fedora)
sudo dnf install launcher-1.0.0.x86_64.rpm

# Ou via rpm (RedHat/CentOS)
sudo rpm -i launcher-1.0.0.x86_64.rpm

# Lancer Launcher
launcher

Option 4 : Snap (Ubuntu/autres)

# Installer via Snap
sudo snap install launcher

# Lancer
snap run launcher

Option 5 : Flatpak

# Ajouter le repository Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Installer Launcher
flatpak install flathub com.launcher.Launcher

# Lancer
flatpak run com.launcher.Launcher

Dépendances

Launcher nécessite les bibliothèques suivantes (généralement déjà installées) :

# Ubuntu/Debian
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils

# Fedora
sudo dnf install gtk3 libnotify nss libXScrnSaver libXtst xdg-utils

Configuration post-installation

Permissions

Selon votre système, Launcher peut nécessiter certaines permissions :

macOS

• Accessibilité : Pour contrôler d'autres applications
• Automatisation : Pour exécuter les scénarios
• Accès complet au disque : Pour détecter les applications (optionnel)

Préférences Système > Sécurité et confidentialité > Confidentialité
→ Accessibilité : Cocher "Launcher"
→ Automatisation : Autoriser Launcher pour les apps nécessaires

Windows

• Pare-feu : Autoriser Launcher dans le pare-feu Windows
• Antivirus : Ajouter une exception si nécessaire

Linux

• Wayland : Certaines fonctionnalités peuvent nécessiter X11
• Permissions : Vérifier les permissions d'exécution

Configuration réseau

Launcher nécessite une connexion internet pour :

• Synchroniser vos scénarios
• Vérifier les mises à jour
• Télécharger les métadonnées d'applications

Proxy d'entreprise

# Configurer le proxy (variables d'environnement)
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# Lancer Launcher avec le proxy
launcher

Désinstallation

macOS

# Supprimer l'application
rm -rf /Applications/Launcher.app

# Supprimer les données utilisateur (optionnel)
rm -rf ~/Library/Application\ Support/Launcher
rm -rf ~/Library/Logs/Launcher

Windows

Via Paramètres > Applications > Launcher > Désinstaller

Ou via l'invite de commande :

# Désinstallation silencieuse
"C:\Program Files\Launcher\Uninstall.exe" /S

Linux

# Debian/Ubuntu
sudo apt-get remove launcher

# Fedora
sudo dnf remove launcher

# AppImage
rm /opt/launcher.appimage
rm ~/.local/share/applications/launcher.desktop

Premier lancement

Connexion

Au premier lancement, vous devrez créer un compte ou vous connecter :

1. Saisissez votre adresse email
2. Choisissez un mot de passe sécurisé
3. Validez votre compte via l'email reçu

Scan initial

Launcher effectue un scan automatique de votre système pour détecter les applications installées. Ce processus prend généralement 10-30 secondes.

Onboarding

Un tutoriel interactif vous guide à travers les fonctionnalités principales :

• Créer votre premier scénario
• Ajouter des applications
• Exécuter un scénario
• Gérer vos profils

Guide utilisateur

Interface principale

L'interface Launcher est organisée en plusieurs sections pour une navigation intuitive. La barre latérale vous permet d'accéder rapidement à toutes les fonctionnalités.

Barre de navigation

• Scénarios : Créez, gérez et exécutez vos scénarios de travail
• Applications : Consultez les applications détectées sur votre système
• Profils : Changez rapidement de contexte (dev, design, réunion...)
• Compte : Gérez vos paramètres, abonnement et préférences

Zone principale

La zone centrale affiche le contenu de la section sélectionnée :

• Liste de vos scénarios avec aperçu rapide
• Bouton d'action rapide en haut à droite
• Filtres et recherche pour trouver rapidement
• Statistiques d'utilisation (temps économisé, scénarios favoris)

Créer un scénario

Création rapide

Créez un scénario en quelques clics avec le builder intuitif :

1. Cliquez sur le bouton "+ Nouveau Scénario" en haut à droite
2. Donnez un nom descriptif (ex: "Session Dev Frontend")
3. Sélectionnez les applications à lancer dans la liste
4. Pour chaque app, configurez les options :
   • VS Code : Workspace à ouvrir
   • Docker : Containers à démarrer
   • Chrome : URLs à ouvrir
   • Slack : Canaux à afficher
5. Définissez l'ordre d'exécution (drag & drop)
6. Cliquez sur "Créer le scénario"

Astuce : Utilisez le bouton "Quick Start" pour créer un scénario depuis un template prédéfini (Dev, Design, Réunion...)

Démonstration : Créer un scénario en 30 secondes

{
  "name": "Dev Session",
  "description": "Environnement de développement complet",
  "applications": [
    {
      "id": "vscode",
      "config": {
        "workspace": "~/projects/mon-app"
      }
    },
    {
      "id": "docker",
      "config": {
        "containers": ["backend", "redis"]
      }
    },
    {
      "id": "chrome",
      "config": {
        "urls": ["http://localhost:3000"]
      }
    }
  ]
}

Création avancée

Pour des scénarios plus complexes, utilisez le mode avancé :

• Ordre d'exécution : Définissez l'ordre de lancement
• Délais : Ajoutez des pauses entre les actions
• Conditions : Exécutez selon des critères
• Scripts : Intégrez des commandes shell

Configuration d'une application

Chaque application peut être configurée avec des options spécifiques :

Exécuter un scénario

Lancement en un clic

Exécutez vos scénarios d'un simple clic et suivez la progression en temps réel :

1. Sélectionnez le scénario dans votre liste
2. Cliquez sur le bouton "▶ Lancer"
3. Le panel d'exécution s'ouvre automatiquement
4. Observez chaque étape se dérouler en temps réel

Panel d'exécution en direct

Le panel vous montre tout ce qui se passe :

• Progression générale : Barre de progression du scénario complet
• Étapes détaillées : Chaque application avec son statut
  • En cours : L'application est en cours de lancement
  • Terminé : Application lancée avec succès
  • Erreur : Problème détecté avec détails
• Logs en direct : Messages détaillés de chaque action
• ⏱️ Temps d'exécution : Durée de chaque étape et temps total
• Résumé final : Récapitulatif avec statistiques

Raccourcis clavier

keyboard

⌘/Ctrl + Enter  → Lancer le scénario sélectionné
⌘/Ctrl + L      → Ouvrir la liste des scénarios
Esc             → Fermer le panel d'exécution
Space           → Lancer/Pause

Panel d'exécution en temps réel

Gestion des erreurs

Si une erreur survient pendant l'exécution :

• Le scénario s'arrête automatiquement
• Un message d'erreur détaillé est affiché
• Vous pouvez réessayer ou passer à l'étape suivante
• Les logs sont sauvegardés pour analyse

Gestion des profils

Qu'est-ce qu'un profil ?

Un profil regroupe un ensemble de scénarios adaptés à un contexte de travail spécifique. C'est comme avoir plusieurs "modes" pour votre environnement de travail.

Pourquoi utiliser des profils ?

• Organisation : Séparez vos contextes (travail, perso, client A, client B...)
• Rapidité : Changez de contexte en un clic
• Flexibilité : Adaptez-vous à chaque situation
• Partage : Partagez des profils avec votre équipe

Créer un profil

1. Cliquez sur "Profils" dans la barre latérale
2. Cliquez sur "+ Nouveau Profil"
3. Nommez votre profil (ex: "Frontend Dev")
4. Ajoutez une description et une icône
5. Glissez-déposez vos scénarios dans le profil
6. Définissez un scénario par défaut (optionnel)

Changer de profil

Plusieurs méthodes pour basculer rapidement :

• Sélecteur rapide : En haut de l'interface
• Raccourci : ⌘/Ctrl + P
• Menu profils : Liste complète dans la section dédiée
• Automatique : Changement selon l'heure (planifiable)

Exemples de profils

Changer de profil

Vous pouvez basculer rapidement entre profils :

• Via le sélecteur en haut de l'interface
• Via un raccourci clavier (⌘/Ctrl + P)
• Automatiquement selon l'heure de la journée

Applications

Détection automatique

Au premier lancement, Launcher scanne votre système pour détecter toutes les applications installées. Le processus prend 10-30 secondes selon votre système.

Catégories d'applications supportées

Actualiser la détection

Si vous installez une nouvelle application :

• Cliquez sur "Actualiser" dans la section Applications
• Ou redémarrez Launcher pour un scan complet

Ajouter une application personnalisée

Si une application n'est pas détectée automatiquement :

{
  "name": "MonApp",
  "displayName": "Mon Application",
  "path": "/Applications/MonApp.app",
  "icon": "path/to/icon.png",
  "launchConfig": {
    "args": ["--custom-arg"],
    "env": {
      "MY_VAR": "value"
    }
  }
}

Demander l'ajout d'une application

Si vous souhaitez qu'une application soit officiellement supportée :

1. Cliquez sur "Support" dans la navigation
2. Sélectionnez "Demander une application"
3. Remplissez le formulaire avec les détails
4. L'équipe Launcher l'ajoutera sous 48h

Composants UI

Architecture des composants

Chaque composant suit une structure modulaire :

// Exemple de composant
class ScenarioComponent {
  constructor() {
    this.state = {};
    this.init();
  }

  init() {
    this.render();
    this.attachEventListeners();
  }

  render() {
    // Génération du HTML
  }

  attachEventListeners() {
    // Gestion des événements
  }
}

Liste des composants

• Landing : Écran de connexion et onboarding
• Scenario : Gestion des scénarios
• ScenarioDetailsPanel : Configuration détaillée
• ScenarioExecutionPanel : Suivi d'exécution
• Application : Catalogue d'applications
• ProfileSelector : Sélecteur de profils
• QuickScenarioBuilder : Création rapide
• CustomScenarioPage : Création avancée
• Compte : Paramètres et abonnement
• Billing : Facturation
• Support : Aide et support

Runner de scénarios

Architecture du runner

Le ScenarioRunner est le moteur qui exécute les scénarios :

const runner = new ScenarioRunner();

const result = await runner.execute({
  scenario: scenarioData,
  onProgress: (step) => {
    console.log(`Step ${step.index}: ${step.status}`);
  },
  onComplete: (results) => {
    console.log('Scenario completed', results);
  },
  onError: (error) => {
    console.error('Scenario failed', error);
  }
});

Runners par plateforme

Le runner utilise des modules spécifiques pour chaque plateforme :

• macOS : AppleScript, osascript, open
• Windows : PowerShell, WScript, Start-Process
• Linux : xdg-open, wmctrl, xdotool

Applications supportées

27+ applications avec runners dédiés :

• VS Code, Cursor
• Docker Desktop
• Chrome, Firefox, Edge
• Slack, Teams, Discord
• Figma, Notion
• Terminal, iTerm, Warp
• Et bien d'autres...

Détection d'applications

Système de détection

Launcher détecte automatiquement les applications installées via plusieurs méthodes :

macOS

• Scan du dossier /Applications
• Détection via mdfind (Spotlight)
• Vérification des processus actifs
• Lecture des bundle IDs

Windows

• Registre Windows (Uninstall keys)
• Scan des dossiers Program Files
• Processus en cours d'exécution
• Raccourcis du menu Démarrer

Linux

• Fichiers .desktop dans /usr/share/applications
• Commandes dans $PATH
• Flatpak et Snap packages
• AppImage dans le home directory

Cache de détection

Les résultats sont mis en cache pour améliorer les performances :

// Durée du cache : 1 heure
// Invalidation automatique si :
// - Nouvelle application installée détectée
// - Scan manuel demandé par l'utilisateur

Snapshot système

Qu'est-ce qu'un snapshot ?

Un snapshot est une capture de l'état actuel de votre système :

• Applications en cours d'exécution
• Fenêtres ouvertes
• Configuration actuelle

Utilisation des snapshots

Les snapshots permettent de :

1. Recréer rapidement un environnement de travail
2. Partager une configuration avec l'équipe
3. Analyser l'utilisation des applications
4. Détecter des anomalies

Créer un snapshot

const snapshot = await window.api.createSnapshot();
// Retourne:
{
  timestamp: '2026-01-14T10:30:00Z',
  applications: [
    { name: 'vscode', windows: [...] },
    { name: 'chrome', windows: [...] }
  ],
  system: {
    platform: 'darwin',
    memory: 16000,
    cpu: 'Apple M1'
  }
}

Distribution

Formats par plateforme

macOS

Windows

Linux