Ligne de commande : piloter le service depuis un terminal

Tout ce que fait la fenêtre se pilote aussi avec htkcloudsync-cli, pour les scripts, les sessions distantes et les ordinateurs sans affichage. L'outil parle au même service que la fenêtre et démarre ce service s'il ne tourne pas encore. Ses messages sont en français.

Options générales

Option	Effet
`--json`	sortie en JSON, pour les scripts
`--no-autostart`	ne pas lancer le service s'il est absent
`--version`	version de l'outil

Code de sortie : 0 en cas de succès, 1 si le service a refusé la commande (le motif est affiché), 2 si le service est injoignable.

Identifier un compte

La plupart des commandes prennent l'identifiant d'un compte. status et accounts l'affichent, à côté de l'adresse :

htkcloudsync-cli status
htkcloudsync-cli accounts

Les commandes

État et journal

Commande	Effet
`status`	état général et état de chaque compte, avec l'heure de la dernière synchronisation et, pour un compte neuf, la marche à suivre
`accounts`	détail des comptes
`activity [ID] [-n N]`	les derniers événements du journal (30 par défaut)
`activity --export FICHIER [--since DATE] [--until DATE] [--level NIVEAU] [--format csv\|json]`	exporte le journal ; le format suit l'extension du fichier, les dates s'écrivent `AAAA-MM-JJ` ou `AAAA-MM-JJTHH:MM`, et `--level` (info, warning, error) se répète

Comptes

Commande	Effet
`add-account [--root DOSSIER] [--timeout SECONDES]`	ajoute un compte Google Drive : l'adresse à ouvrir dans le navigateur s'affiche, la commande attend votre autorisation (dix minutes par défaut)
`reconnect ID`	renouvelle la connexion d'un compte, de la même façon
`remove-account ID [--delete-local]`	déconnecte le compte ; avec l'option, met aussi le dossier local à la corbeille

Synchronisation

Commande	Effet
`sync [ID]`	lance un cycle maintenant, sur un compte ou sur tous
`pause ID`, `resume ID`	met en pause, reprend
`confirm ID accept` ou `confirm ID refuse`	répond à une demande de confirmation de suppressions ; refuser met le compte en pause
`rebuild ID`	reconstruit l'index local sans transférer les fichiers inchangés, puis affiche le nombre d'éléments reconnus

Dossiers et première synchronisation

Commande	Effet
`folders ID [--depth N]`	l'arbre des dossiers du cloud, avec leur identifiant, leur sélection et leur taille
`estimate ID`	ce que la sélection téléchargerait, face à l'espace libre du disque et à l'espace du Drive
`exclude ID DOSSIER… [--include] [--yes]`	exclut des dossiers (ou les ré-inclut avec `--include`) ; exclure met les copies locales à la corbeille, d'où une question, que `--yes` saute
`selection ID`	pour un compte neuf : affiche l'estimation et rappelle la marche à suivre
`selection ID --confirm [--force]`	lance la première synchronisation ; refusée si la sélection ne tient pas sur le disque, sauf avec `--force`

Pour un compte neuf, la première synchronisation se fait ainsi :

htkcloudsync-cli folders gdrive-123456abcdef
htkcloudsync-cli exclude gdrive-123456abcdef ID_DU_DOSSIER_ARCHIVES
htkcloudsync-cli estimate gdrive-123456abcdef
htkcloudsync-cli selection gdrive-123456abcdef --confirm

Corbeille du cloud

Commande	Effet
`trash ID`	nombre d'éléments et taille de la corbeille Google Drive
`trash ID --empty [--yes]`	la vide définitivement, après une question qui rappelle ce qui va disparaître ; refusé si la corbeille a changé entre la lecture et le vidage

Réglages et service

Commande	Effet
`config`	tous les réglages généraux
`config CLÉ`	la valeur d'un réglage
`config CLÉ VALEUR`	change un réglage ; le service vérifie bornes et valeurs admises
`quit`	arrête le service

Par exemple, pour désactiver le lancement avec la session et limiter l'envoi à 500 Ko/s :

htkcloudsync-cli config autostart false
htkcloudsync-cli config upload_limit_kbps 500

Les fichiers-liens

Le gestionnaire qui ouvre les documents Google s'appelle aussi depuis un terminal. Avec --print, il affiche l'adresse qu'il ouvrirait sans lancer le navigateur :

htkcloudsync-open-link --print "Brief étiquettes 2026.gdoc"

Note : la ligne de commande applique les mêmes garde-fous que la fenêtre. Une exclusion de dossiers ou un vidage de corbeille demandent confirmation ; dans un script, passez --yes en connaissance de cause.