Installation¶

HistorySync fonctionne sur Windows, macOS et Linux. Choisissez la méthode qui vous convient le mieux.

Paquets Pré-compilés (Recommandé)¶

Téléchargez la dernière version depuis la page GitHub Releases.

WindowsmacOSLinux

Paquet	Remarques
`HistorySync-vX.Y.Z-windows-x64-setup.exe`	Installateur complet, ajoute une entrée dans le menu Démarrer et démarrage automatique optionnel
`HistorySync-vX.Y.Z-windows-x64-portable.zip`	Portable — extrayez et exécutez n'importe où, aucune installation nécessaire

Lancez l'installateur et suivez les instructions à l'écran. Aucune dépendance supplémentaire n'est requise.

Paquet	Remarques
`HistorySync-vX.Y.Z-macos-arm64.dmg`	Installation par glisser-déposer

Ouvrez le fichier .dmg.
Faites glisser HistorySync dans votre dossier Applications.
Au premier lancement, macOS peut afficher une invite de sécurité — cliquez sur Ouvrir pour continuer.

Permission Accessibilité

Le raccourci global Ctrl+Shift+H nécessite la permission Accessibilité. macOS vous en fera la demande la première fois que vous l'utiliserez. Accordez l'accès dans Réglages Système → Confidentialité et sécurité → Accessibilité.

Paquet	Remarques
`HistorySync-vX.Y.Z-linux-x86_64.AppImage`	Fonctionne sur toutes les distributions Linux modernes
`HistorySync-vX.Y.Z-linux-x86_64.tar.gz`	Archive tar générique pour toute distribution Linux
`historysync_X.Y.Z_amd64.deb`	Pour les distributions basées sur Debian/Ubuntu

AppImage :

chmod +x HistorySync-*.AppImage
./HistorySync-*.AppImage

Debian/Ubuntu .deb :

sudo dpkg -i HistorySync-*.deb
sudo apt-get install -f   # corriger les dépendances manquantes

Raccourcis globaux sur Linux/Wayland

Les raccourcis globaux via pynput ne sont pas pris en charge sur Wayland. Le raccourci de superposition Ctrl+Shift+H ne fonctionnera pas dans une session Wayland. Envisagez d'utiliser --quick avec un raccourci au niveau système comme solution de contournement (voir Raccourcis Clavier).

Installation depuis les Sources¶

Utilisez cette méthode si vous souhaitez exécuter le dernier code de développement ou contribuer au projet.

Prérequis¶

Python 3.10+ (Python 3.12 recommandé — correspond à la CI)
Git

Étapes¶

# 1. Cloner le dépôt
git clone https://github.com/TheSkyC/HistorySync.git
cd HistorySync

# 2. Créer et activer un environnement virtuel (fortement recommandé)
python -m venv venv

# Windows
.\venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

# 3. Installer les dépendances d'exécution
pip install -r requirements.txt

# 4. Lancer l'application
python -m src.main

Installer la CLI `hsync` (optionnel)¶

Des binaires hsync pré-compilés sont disponibles sur la page GitHub Releases :

Paquet	Plateforme
`hsync-vX.Y.Z-windows-x64-setup.exe`	Installateur Windows
`hsync-vX.Y.Z-windows-x64.zip`	Windows portable
`hsync-vX.Y.Z-macos-arm64.tar.gz`	macOS (Apple Silicon)
`hsync-vX.Y.Z-linux-x86_64.tar.gz`	Linux x86-64

La CLI sans interface graphique peut également être invoquée directement avec Python :

python -m src.cli --help

Pour l'installer comme commande hsync dans votre PATH :

# Créer un script wrapper simple (Linux / macOS)
echo '#!/bin/sh\npython -m src.cli "$@"' > /usr/local/bin/hsync
chmod +x /usr/local/bin/hsync

Vérification de l'Installation¶

Lancez l'interface graphique et vérifiez le numéro de version dans la barre de titre, ou exécutez :

# Interface graphique
python -m src.main --version

# CLI
python -m src.cli --version
# ou si installé :
hsync --version

Mise à Jour¶

Remplacez le binaire existant par le nouveau depuis la page Releases. HistorySync stocke sa configuration et sa base de données séparément du binaire de l'application, donc la mise à jour ne touche jamais vos données.

Emplacements par défaut des données :

Plateforme	Répertoire
Windows	`%APPDATA%\HistorySync\`
macOS	`~/Library/Application Support/HistorySync/`
Linux	`~/.config/HistorySync/`

Vous pouvez remplacer cela avec --config-dir ou utiliser le mode --portable pour conserver toutes les données à côté de l'exécutable.

Désinstallation¶

Supprimez le binaire de l'application / AppImage / paquet.
Supprimez éventuellement le répertoire de données ci-dessus pour effacer toutes les données de navigation et les paramètres.

Warning

La suppression du répertoire de données est irréversible. Sauvegardez votre base de données au préalable si vous souhaitez conserver votre historique.