Repository navigation
Configuration
✅ = Hot-reloadable — takes effect within ~1 second of saving
config.toml❌ = Restart required — when changed via the Preferences dialog, EDLD restarts automatically
| Key | Default | Hot | Description |
|---|---|---|---|
JournalFolder |
(required) | ❌ | Path to your Elite Dangerous journal directory |
UseUTC |
false |
✅ | Use UTC timestamps instead of local time |
WarnKillRate |
20 |
✅ | Alert when average kills/hour drops below this value |
WarnNoKills |
60 |
✅ | Alert after this many minutes without a kill |
BountyValue |
false |
✅ | Show credit value on each kill line |
BountyFaction |
false |
✅ | Show victim faction on each kill line |
PirateNames |
false |
✅ | Show pirate pilot names in kill and scan messages |
ExtendedStats |
false |
✅ | Show running kill counts and per-faction tallies |
MinScanLevel |
1 |
✅ | Minimum scan stage required to log an outbound scan (0 = all) |
PrimaryInstance |
true |
❌ | Set to false on secondary/remote instances to suppress uploads to EDDN, EDSM, and EDAstro — monitoring, alerts, and GUI remain fully active |
FullStackSize |
20 |
✅ | Mission stack size that triggers the "stack full" announcement |
WarnCooldown |
15 |
✅ | Minutes between repeated inactivity / kill-rate alerts |
TruncateNames |
30 |
✅ | Maximum character length for pilot/faction names in output |
| Key | Default | Hot | Description |
|---|---|---|---|
WebhookURL |
'' |
❌ | Discord webhook URL |
UserID |
0 |
❌ | Your Discord user ID for @mention pings on level-3 events |
Identity |
true |
❌ | Use EDLD's name and avatar on the webhook |
Timestamp |
false |
❌ | Append a timestamp to each Discord message |
ForumChannel |
false |
❌ | Enable forum channel thread support |
ThreadCmdrNames |
false |
❌ | Use commander name as forum thread title |
PrependCmdrName |
false |
✅ | Prefix every Discord message with your commander name |
| Key | Default | Hot | Description |
|---|---|---|---|
Mode |
"terminal" |
❌ | UI mode: terminal (plain output), textual (TUI dashboard), or gtk4 (GTK4 GUI) |
Theme |
"default" |
❌ | Theme name — changing this in Preferences triggers an automatic restart |
All entries are hot-reloadable. Controls terminal, Discord, and GUI event log output independently per event type.
| Level | Behaviour |
|---|---|
0 |
Disabled entirely |
1 |
Terminal/GUI only |
2 |
Terminal/GUI + Discord |
3 |
Terminal/GUI + Discord + @mention ping |
| Key | Default | Event |
|---|---|---|
RewardEvent |
2 |
Each kill — bounty or combat bond |
FighterDamage |
2 |
Fighter hull damage (every ~20%) |
FighterLost |
3 |
Fighter destroyed |
ShieldEvent |
3 |
Ship shield dropped or raised |
HullEvent |
3 |
Ship hull damaged |
Died |
3 |
Ship destroyed |
CargoLost |
3 |
Cargo stolen |
LowCargoValue |
2 |
Pirate declined to attack (insufficient cargo) |
PoliceScan |
0 |
Security vessel scanned your ship |
PoliceAttack |
3 |
Security vessel is attacking you |
FuelStatus |
1 |
Routine fuel level report |
FuelWarning |
2 |
Fuel level below warning threshold |
FuelCritical |
3 |
Fuel level below critical threshold |
MissionUpdate |
2 |
Mission accepted, completed, redirected, or removed |
AllMissionsReady |
3 |
All active massacre missions ready to turn in |
MeritEvent |
0 |
Individual merit gain from a kill |
InactiveAlert |
3 |
No kills for the configured time period |
RateAlert |
3 |
Kill rate below the configured threshold |
InboundScan |
0 |
Incoming cargo scan from a pirate |
python edld.py [-p PROFILE] [-g] [-t] [-d] [--mode MODE] [--log-file PATH]
| Flag | Description |
|---|---|
-p, --config_profile
|
Load a named config profile |
-t, --test
|
Re-route Discord output to terminal instead of sending to webhook |
-d, --trace
|
Print verbose debug and trace output to terminal |
-g, --gui
|
Alias for --mode gtk4
|
--mode MODE |
UI mode: terminal (default), textual, or gtk4
|
--log-file PATH |
Tee all terminal output to PATH (safe with --mode gtk4; avoids pipe-buffer deadlock) |
When a new release is available on GitHub, EDLD displays a notification at startup (terminal) or in the title bar (TUI / GTK4). Updating is performed manually — pull the new source from the releases page and re-run install.sh.
Profiles let you override any setting for a specific commander or purpose. Define them as named sections in config.toml:
[MyProfile]
Settings.JournalFolder = "/path/to/alternate/journals"
Discord.WebhookURL = 'https://discord.com/api/webhooks/...'
Discord.UserID = 123456789012345678
UI.Theme = "default-green"Load explicitly with -p MyProfile, or name the profile after your commander name for automatic selection at startup.
Multiple profiles coexist in the same config file — useful for multi-account setups:
[EDP1]
Settings.JournalFolder = "/home/user/games/ED-Logs/EDP1"
Discord.WebhookURL = 'https://discord.com/api/webhooks/...'
[EDP2]
Settings.JournalFolder = "/home/user/games/ED-Logs/EDP2"
Discord.WebhookURL = 'https://discord.com/api/webhooks/...'- Fuel alerts trigger on either the percentage threshold or the estimated time-remaining threshold — whichever fires first.
- Duplicate suppression caps repeated identical Discord messages at 5 before switching to a suppression notice, preventing notification floods.
-
Journal path (Linux/Proton): varies — use
find ~/ -name "Journal*.log"to locate it.
All data contribution features are opt-in and disabled by default. They are configured in their own [SECTION] blocks and all require a restart when changed (❌). Settings can be managed in the Preferences → Data & Integrations tab.
If you run EDLD on multiple machines reading the same journal share (e.g. a remote monitor over NFS), set PrimaryInstance = false in [Settings] on the secondary machine to prevent duplicate uploads. See [Settings] above.
EDLD can connect to Frontier's Companion API (CAPI) to retrieve authoritative fleet data, market prices, carrier state, and squadron information.
Use File → CAPI Authentication to complete the OAuth2 flow. You will be redirected to Frontier's login page in your browser. On success, tokens are
| Data | CAPI enabled | CAPI disabled |
|---|---|---|
| Fleet roster | Authoritative — Frontier server | Most recent StoredShips event |
| Sold ship exclusion | Automatic | May show sold ships until next dock |
| Stored ship hull % | ✓ | ✗ |
| Stored ship rebuy cost | ✓ | ✗ |
| Current ship loadout | ✓ (immediate) | ✓ (from journal) |
| Stored ship loadout | ✓ (from journal, CAPI-validated) | ✓ (from journal, unvalidated) |
| Market prices | ✓ (live on dock) | From Market.json
|
| Squadron identity | ✓ | ✗ |
| Community Goals | ✓ | ✗ |
After each poll, raw endpoint responses are written to fleet data is available immediately without waiting for a re-poll:
| File | Source | Updated |
|---|---|---|
capi_profile.json |
/profile |
Every dock |
capi_market.json |
/market |
Every dock (outfitting station) |
capi_shipyard.json |
/shipyard |
Every dock (outfitting station) |
capi_fleetcarrier.json |
/fleetcarrier |
Every dock |
capi_communitygoals.json |
/communitygoals |
Every dock, 5-min cooldown |
CAPI is polled on every dock event and 10 seconds after startup. Per-endpoint cooldowns prevent over-polling: profile/carrier 30s, market/shipyard 60s, community goals 300s.
Frontier requests no more than 1 query per minute in normal use. EDLD respects this by batching all endpoint polls on dock rather than polling continuously.
Contributes exploration, market, outfitting, and shipyard data to the Elite Dangerous Data Network — the shared relay used by EDSM, Inara, and most third-party tools.
| Key | Default | Description |
|---|---|---|
Enabled |
false |
❌ Enable EDDN uploads |
UploaderID |
"" |
❌ Anonymous uploader tag shown in EDDN messages — defaults to your commander name if blank |
TestMode |
false |
❌ Send to /test schemas only (development use) |
Uploads your flight log and discoveries to edsm.net. Requires a free EDSM account. Generate your API key at EDSM → Settings → API Key.
| Key | Default | Description |
|---|---|---|
Enabled |
false |
❌ Enable EDSM uploads |
CommanderName |
"" |
❌ Your EDSM commander name — must match your account exactly |
ApiKey |
"" |
❌ Your EDSM API key |
Events are batched and flushed on session transitions (FSDJump, Docked, LoadGame) to stay well within EDSM's rate limit. A discard list is fetched from EDSM at startup so only requested events are sent.
Uploads exploration, Odyssey organic scan, and fleet carrier data to edastro.com. No account or API key required — uploads are anonymous.
| Key | Default | Description |
|---|---|---|
Enabled |
false |
❌ Enable EDAstro uploads |
UploadCarrierEvents |
false |
❌ Include CarrierStatus and CarrierJumpRequest events — note that these reveal your carrier's location to EDAstro |
An event-interest list is fetched from EDAstro at startup so only the events EDAstro wants are sent.
Uploads your flight log, ranks, credits, missions, and ship loadout to inara.cz. Requires a free Inara account. Generate your API key at inara.cz → Settings → API.
| Key | Default | Description |
|---|---|---|
Enabled |
false |
❌ Enable Inara uploads |
CommanderName |
"" |
❌ Your in-game commander name — must match your Inara profile exactly |
ApiKey |
"" |
❌ Your Inara API key |
Syncs colonisation construction supply needs and commander contributions to Raven Colonial — a community tool for tracking colonisation projects. Local tracking of resource requirements and delivery progress works without an API key.
Note: Colonisation support is experimental and under active development.
| Key | Default | Description |
|---|---|---|
ApiKey |
"" |
Your Raven Colonial API key — obtain from ravencolonial.com → Account Settings. Leave blank to disable API sync; local tracking is always active |
The API key can be set at runtime via Preferences → Data → Raven Colonial API Key without restarting EDLD.
All three sections can be scoped to a profile like any other setting:
[EDP1.EDDN]
Enabled = true
[EDP1.EDSM]
Enabled = true
CommanderName = "YourCmdrName"
ApiKey = "your-api-key-here"
[EDP1.EDAstro]
Enabled = trueGetting Started
Guides
Reference
- Automation
- Building
- Configuration
- Dossier
- Edcars
- Exploration Exobiology Plan
- Licensing
- Mission Bootstrap
- Privacy
- Roadmap
- Server
- Signing
- Startup
- Streamer Stats Overlay
- Surface Survey
- Terminal Output
- Theming
Releases