Repository navigation
Configuration & Secrets Guide
mlgitdev edited this page Oct 19, 2026
·
4 revisions
NewsAlerts enforces strict security and environment separation to protect your sensitive API keys, session cookies, and bot tokens.
Under no circumstances are secrets, tokens, or configuration files committed to git repositories or included in build artifacts.
All settings and secrets reside strictly in the operating system's standard user application storage, automatically created and provisioned on first launch:
| Operating System | Central Application Directory (APP_DIR) |
Fallback Location |
|---|---|---|
| Windows |
%APPDATA%\NewsAlerts\ (C:\Users\<user>\AppData\Roaming\NewsAlerts\) |
$HOME/.newsalerts\ |
| macOS | ~/Library/Application Support/NewsAlerts/ |
$HOME/.newsalerts/ |
| Linux / BSD |
$XDG_CONFIG_HOME/NewsAlerts/ (default ~/.config/NewsAlerts/) |
$HOME/.newsalerts/ |
-
Environment Variable: Set
NEWSALERTS_DIRorNEWSALERTS_HOME(e.g.export NEWSALERTS_DIR=$HOME/.newsalerts) to explicitly direct all data storage to any custom folder. -
Dotfolder Detection: If
$HOME/.newsalertsexists on disk, NewsAlerts automatically prioritizes and uses it across all platforms. -
Automated Provisioning: Zero manual directory setup is required. The terminal automatically invokes
mkdir(parents=True, exist_ok=True)and createsconfig.jsonwith default settings upon first launch.
-
config.json: Primary runtime settings (scan filters, strategy toggles, audio preferences, Telegram credentials, TradingView session cookies). -
keys.toml(Optional): Standalone secret storage file for headless environments or manual editing. -
tape_history.json: Rolling 4-day tape history cache (up to 5,000 prints). -
app.log: Rolling terminal diagnostics and connection logs.
- Never commit
.env,keys.toml, orconfig.jsonto any git branch. - In-app settings are automatically validated and written atomically with file locks.
- Automated pre-commit and CI workflows scan for credential patterns on every build.
NewsAlerts v2.12.0 · Institutional Trading Terminal · Maintained by @mlgitdev · GitHub Repository · Wiki Home