Skip to main content

Příkazová Řádka

3.0

Shrnutí​

Tato stránka popisuje dostupné funkce a možnosti příkazové řádky, které lze spouštět z konzole. Bez potřeby grafického rozhraní lze tedy automatizovat některé úkoly.

Tyto příkazy aktuálně fungují pouze pod Linuxem.

Výstup nápovědy příkazové řádky zobrazující dostupné akce a možnosti

Syntaxe​

Katalog [AKCE] [MOŽNOSTI] [ARGUMENTY]

Spuštění příkazu Katalog​

Příklady na této stránce používají jako název příkazu Katalog. Způsob, jak Katalog spustit z terminálu, závisí na způsobu instalace:

  • Flatpak (Flathub): akce a možnosti se zadávají za identifikátor aplikace. 
    flatpak run io.github.stephanecouturier.Katalog list_catalogs
    Flatpak také instaluje spouštěč s názvem io.github.stephanecouturier.Katalog, který lze volat přímo, pokud je jeho složka v PATH.
  • AppImage: akce a možnosti se zadávají za soubor AppImage. 
    ./Katalog_linux_v3.0-qt6.AppImage list_catalogs

Chcete-li psát Katalog jako v příkladech, definujte alias, například v ~/.bashrc:

alias Katalog='flatpak run io.github.stephanecouturier.Katalog'

Příkazová řádka používá stejný soubor nastavení jako okno, takže bez --collection pracuje s kolekcí naposledy otevřenou v Katalogu.

Akce​

Následující akce jsou dostupné jako poziční argumenty:

list_catalogs​

Vypíše všechny katalogy s jejich ID, aktivním stavem a názvem.

Použití:

Katalog list_catalogs [MOŽNOSTI]

Příklad:

Katalog list_catalogs --verbose

Výstup příkazové řádky se seznamem všech katalogů s ID, stavem a názvem

update_catalog​

Aktualizuje konkrétní Katalog podle ID zařízení.

Použití:

Katalog update_catalog <deviceID> [MOŽNOSTI]

Argumenty:

  • deviceID - ID zařízení katalogu k aktualizaci

Příklad:

Katalog update_catalog 5

Výstup příkazové řádky po aktualizaci konkrétního katalogu

update_all_active​

Aktualizuje všechny aktivní katalogy v kolekci.

Použití:

Katalog update_all_active [MOŽNOSTI]

Příklad:

Katalog update_all_active --verbose

Výstup příkazové řádky po aktualizaci všech aktivních katalogů

Provede vyhledávání pomocí posledních kritérií vyhledávání z historie, s volitelnými přepsáními.

Použití:

Katalog search [MOŽNOSTI]

Příklad:

Katalog search --text "dovolená" --type image --limit 100

Obecné Možnosti​

-h, --help​

Zobrazí informace o nápovědě a ukončí program.

-v, --version​

Zobrazí informace o verzi a ukončí program.

-c, --collection <cesta>​

Určuje cestu ke složce kolekce.

Příklad:

Katalog search --collection "/cesta/k/mé/kolekci"

--verbose​

Povolí podrobný výstup pro ladění a detailní informace.

Příklad:

Katalog list_catalogs --verbose

Možnosti Vyhledávání​

Tyto možnosti jsou dostupné při použití akce search pro přepsání kritérií vyhledávání:

--limit <číslo>​

Omezí počet souborů k zobrazení ve výsledcích vyhledávání.

Příklad:

Katalog search --limit 50

--selectedDeviceID <deviceID>​

Určuje ID zařízení, ve kterém se má vyhledávat.

  • Výchozí: používá hodnotu ze souboru nastavení
  • Při použití s --collection: výchozí je 0 (Všechna zařízení)

Příklad:

Katalog search --selectedDeviceID 2

--text <hledaný-výraz>​

Určuje text nebo frázi k vyhledání.

Příklad:

Katalog search --text "rodinné fotky"

--type <typ-souboru>​

Filtruje výsledky podle typu souboru.

Platné hodnoty:

  • all (výchozí)
  • audio
  • image
  • text
  • video

Příklad:

Katalog search --type audio

--size-min <velikost>​

Nastaví filtr minimální velikosti souboru.

Formát: Číslo následované jednotkou (např. 1MB, 5GB)

Příklad:

Katalog search --size-min 1MB

--size-max <velikost>​

Nastaví filtr maximální velikosti souboru.

Formát: Číslo následované jednotkou (např. 100MB, 2GB)

Příklad:

Katalog search --size-max 100MB

--date-after <datum>​

Filtruje soubory upravené po zadaném datu.

Formát: YYYY-MM-DD

Příklad:

Katalog search --date-after 2023-01-01

--date-before <datum>​

Filtruje soubory upravené před zadaným datem.

Formát: YYYY-MM-DD

Příklad:

Katalog search --date-before 2023-12-31

--case-sensitive​

Povolí vyhledávání textu citlivé na velikost písmen.

Příklad:

Katalog search --text "MůjSoubor" --case-sensitive

--search-in <rozsah>​

Definuje rozsah vyhledávání pro shodu textu.

Platné hodnoty:

  • filenames (výchozí)
  • files-and-folders
  • folder-paths

Příklad:

Katalog search --text "dokumenty" --search-in folder-paths

--text-criteria <kritéria>​

Určuje, jak má být vyhledáván text.

Platné hodnoty:

  • all-words (výchozí)
  • exact-phrase
  • begins-with
  • any-word

Příklad:

Katalog search --text "dovolená fotka" --text-criteria exact-phrase

--exclude <výrazy-k-vyloučení>​

Vyloučí soubory obsahující zadané výrazy.

Příklad:

Katalog search --text "fotka" --exclude "záloha temp"

--no-history​

Začne s výchozími kritérii vyhledávání místo načítání z historie vyhledávání.

Příklad:

Katalog search --no-history --text "novýsoubor"

Návratové Kódy​

  • 0: Úspěch
  • 1: Chyba nebo selhání
  • -1: Interní kód pro pokračování v GUI režimu (nevrací se uživateli)

Příklady​

Základní Správa Katalogů​

Vypsat všechny katalogy:

Katalog list_catalogs

Aktualizovat konkrétní Katalog s podrobným výstupem:

Katalog update_catalog 3 --verbose

Aktualizovat všechny aktivní katalogy:

Katalog update_all_active

Příklady Vyhledávání​

Jednoduché textové vyhledávání:

Katalog search --text "dovolená"

Vyhledat obrázky větší než 5MB:

Katalog search --type image --size-min 5MB

Vyhledat soubory upravené v roce 2023:

Katalog search --date-after 2023-01-01 --date-before 2023-12-31

Složité vyhledávání s více kritérii:

Katalog search --text "projekt" --type text --search-in files-and-folders --case-sensitive --limit 200

Vyhledat v konkrétním zařízení:

Katalog search --selectedDeviceID 2 --text "dokumenty" --verbose

Použití Vlastní Cesty Kolekce​

Vyhledat v jiné kolekci:

Katalog --collection "/cesta/ke/kolekci" search --text "fotky"

Aktualizovat katalogy v konkrétní kolekci:

Katalog --collection "/cesta/ke/kolekci" update_all_active

Poznámky​

  • Když není zadána žádná akce, Katalog se spustí v GUI režimu
  • Kritéria vyhledávání jsou ve výchozím nastavení načtena z historie vyhledávání, pokud není použito --no-history
  • Možnosti příkazové řádky přepisují hodnoty z historie vyhledávání
  • Všechny operace vyhledávání respektují aktivní stav katalogů
  • Podporované jednotky velikosti souborů: KB, MB, GB, TB (necitlivé na velikost písmen)
  • Formáty data musí být ve formátu YYYY-MM-DD

Řešení Problémů​

Neplatné ID zařízení: Ujistěte se, že ID zařízení existuje spuštěním Katalog list_catalogs nejprve.

Problémy s připojením k databázi: Ověřte, že cesta kolekce je správná a přístupná.

Vyhledávání nevrací žádné výsledky: Zkuste použít --no-history pro začátek s výchozími kritérii, nebo zkontrolujte, zda vybrané zařízení obsahuje indexované soubory.

Chyby oprávnění: Ujistěte se, že Katalog má přístup pro čtení/zápis ke složce kolekce a souborům databáze.