2020-06-16 21:00 UTC

Due to a lack of time to continue with maintenance at this point Marginal (also known as Otis on the Discord) has kindly transferred ownership of this github repository to the EDCD Organisation.

EDCD has some volunteers ready to take over maintenance, so over the next few days you can expect at least one fresh release to get things fully transferred (necessary to change the URL that EDMC uses to check for new versions). After that we'll work hard at getting all of the Pull Requests addressed before moving on to any other outstanding Issues.

Initially Athanasius will be the principle maintainer and releaser before passing the reins over to "LCU No Fool Like One" who has kindly agreed to take over as primary maintainer.

Any questions or further offers of help can be directed to the Discord #edmc channel as below.

Discord chat

Elite: Dangerous Market Connector (EDMC)

This app downloads your Cmdr's details and system, faction, scan and station data from the game Elite: Dangerous and, at your choice, either:

You can run the app on the same PC or Mac on which you're running Elite: Dangerous or on another PC connected via a network share. PS4 and Xbox are not supported, sorry.

Usage

The user-interface is deliberately minimal - your choice of data is automatically downloaded, transmitted and/or saved when you start Elite: Dangerous, land at a station, jump to a system or scan a body. Start the app before entering the game to ensure that you don't miss any data - some data is only available at game start.

Click on the ship name to view its loadout on E:D Shipyard (“EDSY”) or Coriolis in your web browser.

Click on the system name to view its entry in Elite: Dangerous Database (“eddb”), Elite Dangerous Star Map (“EDSM”) or Inara in your web browser.

Click on the station name to view its entry in eddb, EDSM or Inara in your web browser.

Windows screenshot   Mac screenshot

Windows screenshot   Mac screenshot

Windows screenshot

Installation

Mac:

Windows:

Linux with Steam Play:

Linux with Wine:

Setup

The first time that you run the app while playing the game you are redirected to Frontier's authentication website and prompted for your username and password. This is the same username and password combination that you use to log into the Elite: Dangerous launcher.

This step is required so that the Frontier servers can send the app your data and the data for the station that you are docked at. Refer to the Privacy Policy for how this app handles your data.

Some options work by reading the Elite: Dangerous game's log files. If you're running this app on a different machine from the Elite: Dangerous game then adjust the “E:D journal file location” setting on the Configuration tab to point to the game's log files.

Output

This app can save a variety of data in a variety of formats:

By default these files will be placed in your Documents folder. Since this app will create a lot of files if you use it for a while you may wish to create a separate folder for the files and tell the app to place them there.

EDDN

EDSM

You can send a record of your Cmdr's details, ship details, cargo, materials, missions and flight log to Elite Dangerous Star Map. You will need to register for an account and then follow the “Elite Dangerous Star Map credentials” link to obtain your API key.

Inara

You can send a record of your Cmdr's details, ship details, cargo, materials, missions, community goal progress, and flight log to Inara. You will need to register for an account and then follow the “Inara credentials” link to obtain your API key. Your flight log on Inara is updated in real-time. Other information is updated on startup and then less frequently - typically on leaving a station.

Uninstall

Mac:

Windows:

Note: Uninstalling the app does not delete any output files that it has previously written.

Plugins

Plugins extend the behaviour of this app. To install a downloaded plugin:

You will need to re-start EDMC for it to notice the new plugin.

The plugins folder is located at:

Refer to PLUGINS.md if you would like to write a plugin.

Troubleshooting

App repeatedly opens the Frontier authentication website

The authentication didn't complete correctly for some reason. This can be caused by:

Error: Invalid Credentials

See above.

Error: An error occured

The Frontier authentication website is confused. Visit the Frontier authentication website, log in and deauthorize "Elite Dangerous Market Connector". Then restart the app.

500 internal server error

Either:

Error: User not found

Your Steam account may not be linked to your Frontier account (you can check whether you have any external accounts linked on the Frontier store).

Please enter your Frontier credentials into the authentication website, not your Steam credentials.

Doesn't auto-update and/or persistently gives “Server is lagging” error

This app uses Elite: Dangerous' log files to track the systems and stations that you visit. If you're running this app on a different machine from the Elite: Dangerous game, or if you find that this app isn't automatically tracking the systems that you visit and/or isn't automatically “updating” on docking (if you have that option selected), then adjust the “E:D journal file location” setting on the Configuration tab to point to the game's log files.

The default location is typically:

Credentials settings are greyed out

You won't be redirected to Frontier's authentication website and can't edit your EDSM or Inara credentials if:

Error: Wrong Cmdr

The Frontier server that supplies data to this app is supplying data for a different Cmdr than the one that you're currently playing. You are redirected to Frontier's authentication website and prompted again for your username and password. Either:

  1. You have multiple accounts and the username/password setting is not for the account that you're currently playing; or
  2. You have reset your Cmdr but Frontier's server is still supplying data for the old Cmdr.

If 1 check your username/password settings.

If 2 this problem may or may not resolve itself in time.

I run two instances of E:D simultaneously, but I can't run two instances of EDMC

EDMC supports this scenario if you run the second instance of E:D in a different user account - e.g. using runas on Windows. Run the second instance of EDMC in the same user account as the second instance of E:D.

EDMC doesn't support running two instances of E:D in the same user account. EDMC will only respond to the instance of E:D that you ran last.

I forgot to run the app - is there a way to process the missing data?

EDMC only processes live data from E:D. But you can upload your journal file(s) for the missing period to EDSM and Inara.

Error: Can't connect to EDDN

EDMC needs to talk to eddn.edcd.io on port 4430. If you consistently receive this error check that your router or VPN configuration allows port 4430 / tcp outbound. If using a proxy add eddn.edcd.io to the exemption list, plus www.edsm.net and/or inara.cz if using EDSM and/or Inara integration.

Import failed: No ship loadout found

Complex ship loadouts with Engineers' mods can cause you to hit an Internet Explorer / Edge limitation on the length of URLs. Switch to a browser that doesn't suck.

Very long "cooldown" period

You'll see a very long cooldown period if your system's time of day changes while you're running the app. To fix this:

Update Error!

The GitHub server that hosts this app's updates only supports TLS 1.2 and higher. Follow these instructions to change your Windows settings to disable the deprecated SSL 2.0 and 3.0 protocols and enable TLS 1.2.

Location of configuration files

If your configuration has been corrupted, or badly set, such that you can't run the program to fix it, or you otherwise need to directly access the configuration then these are the locations of the configuration:

Installing on a different drive

Future updates will also be installed to this location.

PS4 and Xbox support

This app doesn't work with PS4 or Xbox Elite: Dangerous accounts. On these platforms the game lacks support for the API and Journal files that this app relies on.

Reporting a problem

Please report a problem as a new GitHub issue. Please wait for the error to occur and zip up and attach this app's log file to the new issue:

Mac:

Windows:

Running from source

Download and extract the latest source code (or fork and clone if you're comfortable with using git).

Mac:

Windows:

Linux:

Command-line

The command-line program EDMC.py writes the current system and station (if docked) to stdout and optionally writes player status, ship locations, ship loadout and/or station data to file. This program requires that the user has performed setup and verification through the app.

Arguments:

 -h, --help     show this help message and exit
 -v, --version  print program version and exit
 -a FILE        write ship loadout to FILE in Companion API json format
 -e FILE        write ship loadout to FILE in E:D Shipyard plain text format
 -l FILE        write ship locations to FILE in CSV format
 -m FILE        write station commodity market data to FILE in CSV format
 -o FILE        write station outfitting data to FILE in CSV format
 -s FILE        write station shipyard data to FILE in CSV format
 -t FILE        write player status to FILE in CSV format
 -d FILE        write raw JSON data to FILE
 -n             send data to EDDN
 -p CMDR        Returns data from the specified player account

The program returns one of the following exit codes. Further information may be written to stderr.

  1. Success. Note that this doesn't necessarily mean that any requested output files have been produced - for example if the current station doesn't support the facilities for which data was requested.
  2. Server is down.
  3. Invalid Credentials.
  4. Verification Required.
  5. Server is lagging.
  6. I/O or other OS error.

Packaging for distribution

Mac:

Windows:

Disclaimer

This app uses the “Companion” web API that Frontier originally supplied for their Elite Dangerous iOS app and now support for third-party apps. However this API could go away at some time in the future - in which case this app will cease to work.

Acknowledgements

License

Copyright © 2015-2018 Jonathan Harris.

Licensed under the GNU Public License (GPL) version 2 or later.

2020-06-16 21:00 UTC

Due to a lack of time to continue with maintenance at this point Marginal (also known as Otis on the Discord) has kindly transferred ownership of this github repository to the EDCD Organisation.

EDCD has some volunteers ready to take over maintenance, so over the next few days you can expect at least one fresh release to get things fully transferred (necessary to change the URL that EDMC uses to check for new versions). After that we'll work hard at getting all of the Pull Requests addressed before moving on to any other outstanding Issues.

Initially Athanasius will be the principle maintainer and releaser before passing the reins over to "LCU No Fool Like One" who has kindly agreed to take over as primary maintainer.

Any questions or further offers of help can be directed to the Discord #edmc channel as below.

Discord chat