Aller au contenu principal

Lignes de Commande

Résumé​

Cette page décrit les fonctionnalités et options disponibles en ligne de commande qui peuvent être exécutées depuis la console. Sans avoir besoin de l'interface graphique, certaines tâches peuvent donc être automatisées.
Ces commandes fonctionnent actuellement uniquement sous Linux.

Synopsis​

./Katalog.sh [ACTION] [OPTIONS] [ARGUMENTS]

Actions​

Les actions suivantes sont disponibles comme arguments positionnels :

list_catalogs​

Liste tous les catalogues avec leur ID, état actif et nom.

Utilisation :

./Katalog.sh list_catalogs [OPTIONS]

Exemple :

./Katalog.sh list_catalogs --verbose

update_catalog​

Met à jour un catalogue spécifique par ID de périphérique.

Utilisation :

./Katalog.sh update_catalog <deviceID> [OPTIONS]

Arguments :

  • deviceID - L'ID du périphérique du catalogue à mettre à jour

Exemple :

./Katalog.sh update_catalog 5 --report

update_all_active​

Met à jour tous les catalogues actifs dans la collection.

Utilisation :

./Katalog.sh update_all_active [OPTIONS]

Exemple :

./Katalog.sh update_all_active --report --verbose

Exécute une recherche en utilisant les derniers critères de recherche de l'historique, avec des remplacements optionnels.

Utilisation :

./Katalog.sh search [OPTIONS]

Exemple :

./Katalog.sh search --text "vacances" --type image --limit 100

restart​

Redémarre l'application (utilisé en interne pour la gestion du cycle de vie de l'application).

Utilisation :

./Katalog.sh restart

Options Générales​

-h, --help​

Affiche les informations d'aide et quitte.

-v, --version​

Affiche les informations de version et quitte.

-c, --collection <chemin>​

Spécifie le chemin vers le dossier de collection.

Exemple :

./Katalog.sh search --collection "/chemin/vers/ma/collection"

-r, --report​

Affiche un rapport détaillé pour les opérations de mise à jour dans une fenêtre graphique (boîte de message habituelle dans l'interface).

Exemple :

./Katalog.sh update_catalog 3 --report

./Katalog update_catalog 4 --report

Ceci affichera :

--verbose​

Active la sortie verbeuse pour le débogage et les informations détaillées.

Exemple :

./Katalog.sh list_catalogs --verbose

Options de Recherche​

Ces options sont disponibles lors de l'utilisation de l'action search pour remplacer les critères de recherche :

--limit <nombre>​

Limite le nombre de fichiers à afficher dans les résultats de recherche.

Exemple :

./Katalog.sh search --limit 50

--selectedDeviceID <deviceID>​

Spécifie dans quel ID de périphérique rechercher.

  • Par défaut : utilise la valeur du fichier de paramètres
  • Lorsqu'utilisé avec --collection : par défaut 0 (Tous les périphériques)

Exemple :

./Katalog.sh search --selectedDeviceID 2

--text <terme-recherche>​

Spécifie le texte ou la phrase de recherche à chercher.

Exemple :

./Katalog.sh search --text "photos de famille"

--type <type-fichier>​

Filtre les résultats par type de fichier.

Valeurs valides :

  • all (par défaut)
  • audio
  • image
  • text
  • video

Exemple :

./Katalog.sh search --type audio

--size-min <taille>​

Définit le filtre de taille minimale du fichier.

Format : Nombre suivi de l'unité (ex. 1MB, 5GB)

Exemple :

./Katalog.sh search --size-min 1MB

--size-max <taille>​

Définit le filtre de taille maximale du fichier.

Format : Nombre suivi de l'unité (ex. 100MB, 2GB)

Exemple :

./Katalog.sh search --size-max 100MB

--date-after <date>​

Filtre les fichiers modifiés après la date spécifiée.

Format : YYYY-MM-DD

Exemple :

./Katalog.sh search --date-after 2023-01-01

--date-before <date>​

Filtre les fichiers modifiés avant la date spécifiée.

Format : YYYY-MM-DD

Exemple :

./Katalog.sh search --date-before 2023-12-31

--case-sensitive​

Active la recherche de texte sensible à la casse.

Exemple :

./Katalog.sh search --text "MonFichier" --case-sensitive

--search-in <portée>​

Définit la portée de recherche pour la correspondance de texte.

Valeurs valides :

  • filenames (par défaut)
  • files-and-folders
  • folder-paths

Exemple :

./Katalog.sh search --text "documents" --search-in folder-paths

--text-criteria <critères>​

Spécifie comment le texte de recherche doit être recherché.

Valeurs valides :

  • all-words (par défaut)
  • exact-phrase
  • begins-with
  • any-word

Exemple :

./Katalog.sh search --text "photo vacances" --text-criteria exact-phrase

--exclude <termes-exclusion>​

Exclut les fichiers contenant les termes spécifiés.

Exemple :

./Katalog.sh search --text "photo" --exclude "sauvegarde temp"

--no-history​

Commence avec les critères de recherche par défaut au lieu de charger depuis l'historique de recherche.

Exemple :

./Katalog.sh search --no-history --text "nouveaufichier"

Options d'Export CSV​

--csv​

Exporte les résultats de recherche vers un fichier CSV. Le fichier est sauvegardé dans le dossier de collection avec un horodatage.

Exemple :

./Katalog.sh search --text "documents" --csv

Codes de Sortie​

  • 0 : Succès
  • 1 : Erreur ou échec
  • -1 : Code interne pour continuer en mode GUI (non retourné à l'utilisateur)

Exemples​

Gestion Basique des Catalogues​

Lister tous les catalogues :

./Katalog.sh list_catalogs

Mettre à jour un catalogue spécifique avec rapport détaillé :

./Katalog.sh update_catalog 3 --report --verbose

Mettre à jour tous les catalogues actifs :

./Katalog.sh update_all_active --report

Exemples de Recherche​

Recherche de texte simple :

./Katalog.sh search --text "vacances"

Rechercher des images de plus de 5MB :

./Katalog.sh search --type image --size-min 5MB

Rechercher des fichiers modifiés en 2023 :

./Katalog.sh search --date-after 2023-01-01 --date-before 2023-12-31

Recherche complexe avec critères multiples :

./Katalog.sh search --text "projet" --type text --search-in files-and-folders --case-sensitive --limit 200

Rechercher dans un périphérique spécifique et exporter en CSV :

./Katalog.sh search --selectedDeviceID 2 --text "documents" --csv --verbose

Utilisation d'un Chemin de Collection Personnalisé​

Rechercher dans une collection différente :

./Katalog.sh --collection "/chemin/vers/collection" search --text "photos"

Mettre à jour les catalogues dans une collection spécifique :

./Katalog.sh --collection "/chemin/vers/collection" update_all_active --report

Notes​

  • Quand aucune action n'est spécifiée, Katalog se lance en mode GUI
  • Les critères de recherche sont chargés depuis l'historique de recherche par défaut, sauf si --no-history est utilisé
  • Les options de ligne de commande remplacent les valeurs de l'historique de recherche
  • L'action restart est principalement utilisée en interne pour la gestion du cycle de vie de l'application
  • Toutes les opérations de recherche respectent l'état actif des catalogues
  • Unités de taille de fichier supportées : KB, MB, GB, TB (insensible à la casse)
  • Les formats de date doivent être au format YYYY-MM-DD
  • Les exports CSV sont automatiquement horodatés et sauvegardés dans le dossier de collection

Dépannage​

ID de périphérique invalide : Assurez-vous que l'ID du périphérique existe en exécutant d'abord ./Katalog.sh list_catalogs.

Problèmes de connexion à la base de données : Vérifiez que le chemin de collection est correct et accessible.

La recherche ne retourne aucun résultat : Essayez d'utiliser --no-history pour commencer avec les critères par défaut, ou vérifiez si le périphérique sélectionné contient des fichiers indexés.

Erreurs de permissions : Assurez-vous que Katalog a un accès en lecture/écriture au dossier de collection et aux fichiers de base de données.