Skip to content

Configuration fr

Hydro74000 edited this page May 31, 2026 · 2 revisions
ngPost

Configuration

Langues: English | Français

Cette page regroupe les informations pratiques de configuration qui étaient auparavant dispersées entre la page CLI, les exemples et les notes de version.

Où ngPost stocke la configuration

Depuis la v5.4.0, ngPost utilise un dossier de configuration utilisateur dédié à l'application :

Plateforme Fichier de configuration par défaut
Linux $XDG_CONFIG_HOME/ngPost/ngPost.conf ou ~/.config/ngPost/ngPost.conf
Windows %LOCALAPPDATA%\ngPost\ngPost.conf
macOS ~/Library/Application Support/ngPost/ngPost.conf

Vous pouvez toujours utiliser un fichier spécifique pour une exécution :

ngPost -c /path/to/ngPost.conf

Migration depuis les anciens chemins

Les anciennes versions utilisaient d'autres emplacements :

Plateforme Ancien chemin
Linux/macOS ~/.ngPost
Windows ngPost.conf à côté de l'exécutable

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 l'original. La v5.4+ peut ainsi utiliser la nouvelle organisation sans casser les installations plus anciennes.

Fichiers associés dans le dossier de configuration

Le même dossier sert aussi aux données utilisateur de ngPost :

  • ngPost.conf : fichier de configuration principal.
  • ngPost_history.sqlite : base SQLite d'historique structurée par défaut.
  • vpn/ : profils OpenVPN/WireGuard importés.
  • vpn/runtime/ : fichiers d'authentification VPN temporaires pendant une connexion active.

Base d'historique

POST_HISTORY était l'ancien fichier d'historique CSV. Depuis la v5.4.0, l'historique principal est une base SQLite.

POST_DB = /path/to/ngPost_history.sqlite
HISTORY_STORE_PASSWORDS = true

Utilisez POST_DB pour placer la base ailleurs. Un ancien historique CSV peut être importé depuis la CLI :

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

Consultez Historique et reprise pour le workflow complet.

Options de configuration courantes

Clé Rôle
nzbPath Dossier par défaut des fichiers NZB générés.
GROUPS Newsgroups utilisés pour poster.
GROUP_POLICY Répartition des posts lorsque plusieurs groupes sont configurés.
FROM / GEN_FROM Email du posteur fixe ou généré.
POST_DB Chemin de la base SQLite d'historique structurée.
RAR_PATH, PAR2_PATH Chemins des outils externes lorsque les outils intégrés ne sont pas utilisés.
VPN_AUTO_CONNECT Démarre/arrête automatiquement le profil VPN configuré lorsque nécessaire.

Pour toutes les options CLI et d'automatisation, consultez Ligne de commande.

Pour la référence complète du fichier de configuration, avec toutes les clés supportées et des exemples, consultez Référence ngPost.conf.

Clone this wiki locally