EDMarketConnector/README.md

Elite: Dangerous Market Connector (EDMC)

This app downloads commodity market and other data from the game Elite: Dangerous and, at your choice, either:

• sends the data to the Elite Dangerous Data Network (“EDDN”) from where you and others can use it via online trading tools such as eddb, Elite Trade Net, Inara, ED-TD, etc.
• saves the data to files on your computer that you can load into trading tools such as Slopey's BPC Market Tool, Trade Dangerous, Thrudd's Trading Tools, Inara, etc.
• saves a record of your ship loadout and/or flight log.

The user-interface is deliberately minimal - when you land at a station just switch to the app and press the “Update” button or press Enter to automatically download and transmit and/or save your choice of data.

Installation

Mac:

• Requires Mac OS 10.9 or later.
• Download the .zip archive of the latest release.
• The zip archive contains the EDMarketConnector app - move this app to Applications or wherever you want it.
• Double-click on the app to run it.

Windows:

• Requires Windows 7 or later.
• Download the .msi package of the latest release.
• Double-click on it to install.
• Run Elite Dangerous Market Connector from the Start Menu or Start Screen.

Setup

The first time that you run the app you are prompted for your username and password. This is the same username and password combination that you use to log into the Elite: Dangerous launcher, and is required so that the Frontier servers can send the app your data and the market data for the station that you are docked at.

You can also choose here what data to save (refer to the next section for details) and whether to attach your Cmdr name or a pseudo-anonymized ID to the data.

You are next prompted to authenticate with a “verification code”, which you will shortly receive by email from Frontier. Note that each “verification code” is one-time only - if you enter the code incorrectly or quit the app before authenticating you will need to wait for Frontier to send you a new code.

If you are not prompted to authenticate, but instead see the message “Error: Invalid Credentials” then choose the menu option EDMarketConnector → Preferences (Mac) or File → Settings (Windows) and double-check your username and password.

Output

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

• Market data

  • Elite Dangerous Data Network - sends commodity market and shipyard data to “EDDN” from where you and others can use it via online trading tools such as eddb, Elite Trade Net, Inara, ED-TD etc.
  • Slopey's BPC format - saves commodity market data as files that you can load into Slopey's BPC Market Tool.
  • Trade Dangerous format - saves commodity market data as files that you can load into Trade Dangerous.
  • CSV format - saves commodity market data as files that you can upload to Thrudd's Trading Tools or Inara.

• Ship loadout

  • After every outfitting change saves a record of your ship loadout as a file that you can open in a text editor and that you can import into E:D Shipyard or Coriolis.

• Flight log

  • Adds a record of your location, ship and cargo to a file that you can open in a text editor or a spreadsheet program such as Excel. Note: Don't edit, rename or move this file - take a copy if you wish to change it.

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.

Uninstall

Mac:

• Delete the EDMarketConnector app.

Windows:

• Uninstall Elite Dangerous Market Connector from Control Panel → Programs.

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

Running from source

Download and extract the source code of the latest release.

Mac:

• Requires the Python “requests” module - install this with easy_install requests .
• Run with ./EDMarketConnector.py .

Windows:

• Requires Python2.7 and the Python “requests” module.
• Run with EDMarketConnector.py .

Linux:

• Requires the Python “imaging-tk”, “iniparse” and “requests” modules. On Debian-based systems install these with sudo apt-get install python-imaging-tk python-iniparse python-requests .
• Run with ./EDMarketConnector.py .

Packaging for distribution

Mac:

• requires py2app 0.9.x
• Sparkle.framework installed in /Library/Frameworks
• Run setup.py py2app

Windows:

• requires py2exe 0.6.x
• winsparkle.dll & .pdb from WinSparkle copied to the current directory
• WiX Toolset
• Run setup.py py2exe

Disclaimer

This app uses the “Companion” web API that Frontier supplies to support their Elite Dangerous iOS app. This API isn't officially supported for third-party use, so could go away at some time in the future - in which case this app will cease to work.

Acknowledgements

• “Elite: Dangerous” is © 1984 - 2014 Frontier Developments plc.
• Thanks to Cmdr Anthor for the French translation.
• Thanks to Cmdr Koreldan for the Italian translation.
• Thanks to Cmdr Amarok 73 for the Polish translation.
• Thanks to James Muscat for EDDN and to Cmdr Anthor for the stats.
• Thanks to Andargor for the idea of using the “Companion” interface in edce-client.
• Uses Sparkle by Andy Matuschak and the Sparkle Project.
• Uses WinSparkle by Václav Slavík.
• Uses POEditor for translation management.

License

Copyright © 2015 Jonathan Harris.

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