Command Line Usage fr

ngPost

Langues: English | Français

Utilisation en ligne de commande

Syntaxe : ngPost (options)* (-i <fichier ou dossier> | --auto <dossier> | --monitor <dossier>)+
        --help             : aide : affiche la syntaxe
        -v ou --version    : version de l'application
        -c ou --conf       : utilise un fichier de configuration (sinon, ngPost utilise le chemin de configuration utilisateur decrit ci-dessous)
        --disp_progress    : affiche la barre de progression en ligne de commande : NONE (defaut), BAR ou FILES
        -d ou --debug      : affiche des informations supplementaires
        --fulldebug        : affiche toutes les informations de debug
        -l ou --lang       : langue de l'application
        --check            : verifie un fichier nzb (si les articles sont disponibles sur Usenet)
        -q ou --quiet      : mode silencieux (aucune sortie sur stdout)

// historique structure et reprise au niveau des articles (base SQLite)
// toutes les options ci-dessous acceptent les formes _ et - (ex. --history_show ou --history-show)
        --history             : liste l'historique structure des posts (ajouter --json pour une sortie exploitable par script)
        --history_show <id>   : affiche les details d'un post de l'historique
        --history_import_csv <file> : importe un ancien POST_HISTORY csv dans la base
        --regenerate_nzb <id> : regenere un nzb depuis l'historique (utiliser -o pour definir le chemin de sortie)
        --include_password    : inclut le mot de passe d'archive stocke dans la sortie regeneree/affichee
        --post_db <file>      : chemin vers la base SQLite de l'historique structure
        --resume_list         : liste les posts partiels ou pouvant etre repris (ajouter --json)
        --resume_check <id>   : affiche l'etat de reprise d'un post
        --resume_post <ids>   : reprend un ou plusieurs ids de posts (separes par des virgules)
        --resume_all          : reprend tous les posts pouvant l'etre
        --resume_abandon <id> : marque un post incomplet comme abandonne (requiert --yes)
        --resume_purge <id>   : purge les donnees techniques de reprise d'un post (requiert --yes)
        --dry_run             : simule une commande de reprise sans poster reellement
        --yes                 : repond oui aux commandes destructives non interactives
        --json                : emet une sortie JSON pour l'utilisation dans des scripts

// post automatise (scan et/ou surveillance)
        --auto             : parcourt un dossier et poste chaque fichier/dossier separement. Vous devez utiliser --compress, et devriez ajouter --gen_par2, --gen_name et --gen_pass
        --monitor          : surveille un dossier et poste chaque nouveau fichier/dossier. Vous devez utiliser --compress, et devriez ajouter --gen_par2, --gen_name et --gen_pass
        --rm_posted        : supprime le fichier/dossier une fois poste. Vous devez utiliser --auto ou --monitor avec cette option.

// post rapide (plusieurs fichiers/dossiers)
        -i ou --input      : fichier d'entree a uploader (fichier seul ou dossier), utilisable plusieurs fois
        -o ou --output     : chemin du fichier de sortie (nzb)
        -x ou --obfuscate  : obfusque les sujets des articles (ATTENTION : vous ne retrouverez pas votre post si vous perdez le fichier nzb)
        -g ou --groups     : newsgroups ou poster les fichiers (separes par des virgules, sans espace)
        -m ou --meta       : metadonnees supplementaires dans l'en-tete (typiquement "password=qwerty42")
        -f ou --from       : email du posteur (aleatoire s'il n'est pas fourni)
        -a ou --article_size: taille des articles (valeur par defaut : 716800)
        -z ou --msg_id     : signature du msg id, apres le @ (valeur par defaut : ngPost)
        -r ou --retry      : nombre de tentatives pour un article en erreur (defaut : 5)
        -t ou --thread     : nombre de threads (les connexions seront reparties entre eux)
        --gen_from         : genere un nouvel email aleatoire pour chaque post (--auto ou --monitor)

// compression et support par2
        --tmp_dir          : dossier temporaire ou seront stockes les fichiers compresses et par2
        --rar_path         : chemin absolu vers RAR (application externe)
        --rar_size         : taille en Mo des volumes RAR (0 par defaut signifie PAS de decoupage)
        --rar_max          : nombre maximum de volumes d'archive
        --par2_pct         : pourcentage de redondance par2 (0 par defaut signifie PAS de generation par2)
        --par2_path        : chemin absolu vers par2
        --pack             : prepare les posts avec la definition PACK de la config (sous-ensemble de COMPRESS, GEN_NAME, GEN_PASS, GEN_PAR2)
        --auto_compress    : alias de --pack : active le packaging automatique avec la definition PACK de la config
        --compress         : compresse les entrees avec RAR ou 7z
        --gen_par2         : genere les par2 (a utiliser avec --compress)
        --rar_name         : fournit le nom du fichier RAR (a utiliser avec --compress)
        --rar_pass         : fournit le mot de passe RAR (a utiliser avec --compress)
        --gen_name         : genere un nom RAR aleatoire (a utiliser avec --compress)
        --gen_pass         : genere un mot de passe RAR aleatoire (a utiliser avec --compress)
        --length_name      : longueur du nom RAR aleatoire (a utiliser avec --gen_name), defaut : 17
        --length_pass      : longueur du mot de passe RAR aleatoire (a utiliser avec --gen_pass), defaut : 13
        --rar_no_root_folder: retire le dossier racine (parent) lors de la compression de dossiers avec RAR

// options NFO
        --keep_nfo_extension: conserve l'extension .nfo visible lors de l'obfuscation des noms de fichiers
        --nzb_copy_nfo     : copie le fichier .nfo original a cote du nzb genere
        --auto_include_nfo : auto-post : inclut un .nfo voisin (meme nom, autre extension) dans le meme post

// surcharges VPN (uniquement pour cette execution, non sauvegardees dans la config)
        --vpn              : force toutes les connexions NNTP a passer par le VPN configure (interrupteur global ON)
        --no_vpn           : desactive le VPN pour cette execution (interrupteur global OFF, useVpn par serveur ignore)
        --vpn_profile      : selectionne le profil VPN actif par nom (doit exister dans la config)

// vous pouvez fournir les serveurs dans une seule chaine avec -S et/ou separer les parametres pour UN SEUL serveur
        -S ou --server     : serveur NNTP au format (<user>:<pass>@@@)?<host>:<port>:<nbCons>:(no)?ssl
        -h ou --host       : nom d'hote (ou IP) du serveur NNTP
        -P ou --port       : port du serveur NNTP
        -s ou --ssl        : utilise SSL
        -u ou --user       : nom d'utilisateur du serveur NNTP
        -p ou --pass       : mot de passe du serveur NNTP
        -n ou --connection : nombre de connexions NNTP

Exemples :
  - avec surcharge VPN : ngPost-v5.4.0-x86_64.AppImage -i /data/myPost --pack --vpn --vpn_profile Mullvad-NL
  - avec surveillance : ngPost-v5.4.0-x86_64.AppImage --monitor /data/folder1 --auto_compress --rm_posted --disp_progress files
  - avec auto-post : ngPost-v5.4.0-x86_64.AppImage --auto /data/folder1 --compress --gen_par2 --gen_name --gen_pass --rar_size 42 --disp_progress files
  - avec options NFO : ngPost-v5.4.0-x86_64.AppImage -i /data/myPost --auto_compress --keep_nfo_extension --nzb_copy_nfo
  - lister l'historique en JSON : ngPost-v5.4.0-x86_64.AppImage --history --json
  - reprendre un post echoue : ngPost-v5.4.0-x86_64.AppImage --resume_post 42

Historique & reprise (CLI)

Depuis la v5.4.0, ngPost enregistre chaque post dans une base SQLite structuree (qui remplace l'ancien fichier CSV POST_HISTORY, toujours importable avec --history_import_csv). La base suit chaque post jusqu'au niveau de l'article individuel, ce qui permet d'inspecter l'historique, de regenerer un NZB ou de reprendre un post partiel/echoue directement depuis la ligne de commande.

Par defaut, la base se trouve a cote de la configuration :

Plateforme	Chemin par defaut
Linux	~/.config/ngPost/ngPost_history.sqlite
Windows	%LOCALAPPDATA%\ngPost\ngPost_history.sqlite
macOS	~/Library/Application Support/ngPost/ngPost_history.sqlite

Utilisez --post_db <file> (ou le mot-cle de configuration POST_DB) pour pointer vers une autre base.

Note : chaque option accepte la forme avec underscore ou tiret, par exemple --history_show ou --history-show.

Lire l'historique

# liste tous les posts (colonnes TSV : id, status, created, name, groups, password)
ngPost --history

# meme liste en JSON compact pour les scripts
ngPost --history --json

# details complets d'un post (fichiers, chemin nzb, nom d'archive, nombre d'articles)
ngPost --history_show 42
ngPost --history_show 42 --include_password   # revele le mot de passe d'archive stocke

Les objets JSON retournes par --history exposent : id, name, status, groups, created_at, has_password et password_stored. Cela fonctionne tres bien avec jq :

# noms de tous les posts termines
ngPost --history --json | jq -r '.[] | select(.status=="done") | .name'

Comme il s'agit d'une base SQLite standard, vous pouvez aussi l'interroger directement :

sqlite3 ~/.config/ngPost/ngPost_history.sqlite \
  "SELECT id, status, created_at, nzb_name FROM posts ORDER BY id DESC LIMIT 20;"

Regenerer un NZB

ngPost --regenerate_nzb 42 -o /path/to/output.nzb
ngPost --regenerate_nzb 42 -o output.nzb --include_password

Reprendre des posts partiels ou echoues

Lorsqu'un post est interrompu (perte reseau, crash, etc.), les articles qui n'ont jamais atteint le serveur sont marques et peuvent etre repostes avec un nouveau Message-ID, sans devoir reuploader toute l'archive.

ngPost --resume_list                 # affiche les posts pouvant etre repris / partiels (ajouter --json)
ngPost --resume_check 42             # affiche l'etat de reprise d'un post
ngPost --resume_post 42              # reprend un post
ngPost --resume_post 42,43,57        # reprend plusieurs posts (separes par des virgules)
ngPost --resume_all                  # reprend tout ce qui peut l'etre
ngPost --resume_post 42 --dry_run    # affiche ce qui serait reposte, sans poster

Maintenance (destructif, requiert --yes)

ngPost --resume_abandon 42 --yes     # marque un post incomplet comme abandonne
ngPost --resume_purge 42 --yes       # supprime les donnees techniques de reprise d'un post

Migrer l'ancien CSV

ngPost --history_import_csv /path/to/POST_HISTORY.csv

Le fichier CSV original est conserve ; ngPost l'importe aussi automatiquement au premier lancement.

Chemin de configuration et migration de l'ancien fichier

Depuis la v5.4.0, le fichier de configuration par defaut a ete deplace de l'ancien emplacement vers un dossier de configuration utilisateur dedie a l'application :

Plateforme	Nouveau chemin de configuration par defaut	Ancien chemin
Linux	$XDG_CONFIG_HOME/ngPost/ngPost.conf ou ~/.config/ngPost/ngPost.conf	~/.ngPost
Windows	%LOCALAPPDATA%\ngPost\ngPost.conf	ngPost.conf a cote de l'executable
macOS	~/Library/Application Support/ngPost/ngPost.conf	~/.ngPost

Au premier lancement, si une ancienne configuration existe et que le nouveau fichier n'existe pas encore, ngPost copie l'ancien fichier vers le nouvel emplacement et conserve le fichier original. Les anciennes versions de ngPost restent ainsi utilisables pendant que la v5.4+ adopte la nouvelle organisation.

Le meme dossier de configuration sert aussi aux donnees utilisateur associees, notamment les profils VPN et la base d'historique structuree par defaut ngPost_history.sqlite.

Vous pouvez toujours forcer explicitement un fichier de configuration avec :

ngPost -c /path/to/ngPost.conf