EDMarketConnector/README.md

Elite: Dangerous Market Connector

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

• transmits the data to the Elite Dangerous Data Network ("EDDN") from where you and others can use it via online trading tools such as eddb.
• saves the data to files on your computer that you can load into trading tools such as Slopey's BPC Market Tool, Trade Dangerous and Thrudd's Trading Tools.

The user-interface is deliberately minimal - when you land at a station just switch to the app and press the "Update" button to automatically download and transmit and/or save the station's commodity market 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.
• Windows Installer will walk you through the installation process.
• Run EDMarketConnector from the Start menu.

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 the market data for the station that you are docked at. You can also choose here whether to send the market data that you download to EDDN, or to save it locally.

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.

Uninstall

Mac:

• Delete the EDMarketConnector app.

Windows:

• Uninstall EDMarketConnector from Control Panel → Programs.

Running from source & packaging

The application requires Python 2.7, plus the "requests" module. Run with python EDMarketConnector.py.

To package up 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

Acknowledgements

• "Elite: Dangerous" is © 1984 - 2014 Frontier Developments plc.
• edce-client by Andargor for the idea of using the "Companion" interface.

License

Copyright © 2015 Jonathan Harris.

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