Command Line Usage fr
Langues: English | Français
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 essaie de charger $HOME/.ngPost)
--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
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_showou--history-show.
# 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 stockeLes 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;"ngPost --regenerate_nzb 42 -o /path/to/output.nzb
ngPost --regenerate_nzb 42 -o output.nzb --include_passwordLorsqu'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 posterngPost --resume_abandon 42 --yes # marque un post incomplet comme abandonne
ngPost --resume_purge 42 --yes # supprime les donnees techniques de reprise d'un postngPost --history_import_csv /path/to/POST_HISTORY.csvLe fichier CSV original est conserve ; ngPost l'importe aussi automatiquement au premier lancement.