2019-09-17 08:28:31 +02:00
|
|
|
|
# A collection of useful scripts around Elite Dangerous #
|
2019-09-03 21:00:51 +02:00
|
|
|
|
|
2020-01-08 08:30:27 +01:00
|
|
|
|
## Requirements ##
|
|
|
|
|
|
|
|
|
|
* argcomplete
|
|
|
|
|
* argparse
|
|
|
|
|
* requests
|
|
|
|
|
* Tkinter
|
|
|
|
|
|
|
|
|
|
You probably want to install your distribution/OS package for Tkinter instead of
|
2020-01-13 21:33:54 +01:00
|
|
|
|
using pip. Then do the good old `pip install --user -r requirements.txt`.
|
|
|
|
|
|
|
|
|
|
You’ll also need to install pyEDSM’s dependencies:
|
|
|
|
|
`pip install --user -r pyEDSM/requirements.txt`
|
2020-01-08 08:30:27 +01:00
|
|
|
|
|
2020-01-08 15:13:10 +01:00
|
|
|
|
## Pre-Compiled Version (Windows) ##
|
|
|
|
|
|
|
|
|
|
If you check the
|
|
|
|
|
[releases](https://github.com/alterNERDtive/elite-scripts/releases) you’ll find
|
|
|
|
|
a .zip file with pre-compiled scripts that don’t need Python installed. Mostly
|
|
|
|
|
a) for saving myself some hassle and b) because that’s easier to distribute with
|
|
|
|
|
my
|
|
|
|
|
[VoiceAttack profiles](https://github.com/alterNERDtive/VoiceAttack-profiles).
|
|
|
|
|
|
|
|
|
|
## Scripts ##
|
|
|
|
|
|
|
|
|
|
### edsm-getnearest.py ###
|
2019-09-03 21:00:51 +02:00
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
usage: edsm-getnearest.py [-h] --system SYSTEM [--short] [--gui | --text]
|
|
|
|
|
CMDR [CMDR ...]
|
|
|
|
|
|
|
|
|
|
Locate your CMDRs using EDSM and find their distance to a given system.
|
|
|
|
|
|
|
|
|
|
positional arguments:
|
|
|
|
|
CMDR a list of CMDR names (must have their location public on
|
|
|
|
|
EDSM!)
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
--system SYSTEM the target system (must be in EDDN!)
|
|
|
|
|
--short short output (only makes sense with `--text`)
|
|
|
|
|
--gui explicitly run the GUI
|
|
|
|
|
--text explicitly give text output
|
|
|
|
|
```
|
2019-10-04 00:45:33 +02:00
|
|
|
|
|
2020-01-08 15:13:10 +01:00
|
|
|
|
### explorationtools.py ###
|
2019-10-04 00:45:33 +02:00
|
|
|
|
|
|
|
|
|
```
|
2020-01-08 14:54:39 +01:00
|
|
|
|
usage: explorationtools.py [-h]
|
2020-01-13 21:23:41 +01:00
|
|
|
|
{bodycount,distancebetween,findcommander,findsystem,systemlist}
|
2020-01-08 14:54:39 +01:00
|
|
|
|
...
|
2019-10-04 00:45:33 +02:00
|
|
|
|
|
|
|
|
|
A collection of tools useful for exploration.
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
2019-10-04 05:09:33 +02:00
|
|
|
|
-h, --help show this help message and exit
|
2019-10-04 00:45:33 +02:00
|
|
|
|
|
|
|
|
|
subcommands:
|
2020-01-13 21:23:41 +01:00
|
|
|
|
{bodycount,distancebetween,findcommander,findsystem,systemlist}
|
2019-10-04 05:09:33 +02:00
|
|
|
|
sub-command help
|
|
|
|
|
bodycount Returns the number of bodies in a system. Will exit
|
|
|
|
|
with code 1 on server error and code 2 if the system
|
|
|
|
|
could not be found in EDSM.
|
2019-11-12 10:31:51 +01:00
|
|
|
|
distancebetween Calculates the distance between two systems. Will exit
|
2019-10-04 05:09:33 +02:00
|
|
|
|
with code 1 on server error and code 2 if (one of) the
|
2019-11-12 10:31:51 +01:00
|
|
|
|
systems could not be found on EDSM.
|
2020-01-06 17:28:40 +01:00
|
|
|
|
findcommander Attempts to find a CMDR’s last known position. Will
|
2020-01-05 19:20:20 +01:00
|
|
|
|
exit with code 1 on server error and code 2 if the
|
2020-01-16 18:50:23 +01:00
|
|
|
|
CMDR could not be found on EDSM. Will also give you
|
|
|
|
|
the time of last activity if you search for their
|
|
|
|
|
system.
|
2020-01-13 21:23:41 +01:00
|
|
|
|
findsystem Attempts to find a partially matching system that
|
|
|
|
|
should then hopefully be in the vicinity of the given
|
|
|
|
|
system
|
2020-01-08 14:54:39 +01:00
|
|
|
|
systemlist Pulls all system names starting with the given string
|
|
|
|
|
from EDSM
|
2019-10-04 00:45:33 +02:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
usage: explorationtools.py bodycount [-h] system
|
|
|
|
|
|
|
|
|
|
positional arguments:
|
2020-01-06 17:28:40 +01:00
|
|
|
|
system system to query
|
2019-10-04 05:09:33 +02:00
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
2020-01-09 21:37:42 +01:00
|
|
|
|
usage: explorationtools.py distancebetween [-h] [--roundto [ROUNDTO]]
|
|
|
|
|
system system
|
2019-10-04 05:09:33 +02:00
|
|
|
|
|
|
|
|
|
positional arguments:
|
2020-01-09 21:37:42 +01:00
|
|
|
|
system the systems to measure
|
2019-10-04 00:45:33 +02:00
|
|
|
|
|
|
|
|
|
optional arguments:
|
2020-01-09 21:37:42 +01:00
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
--roundto [ROUNDTO] the number of digits to round to (default: 2)
|
2019-10-04 00:45:33 +02:00
|
|
|
|
```
|
2020-01-05 19:20:20 +01:00
|
|
|
|
|
|
|
|
|
```
|
2020-01-08 08:49:53 +01:00
|
|
|
|
usage: explorationtools.py findcommander [-h] [--system | --coords | --url]
|
|
|
|
|
name [apikey]
|
2020-01-05 19:20:20 +01:00
|
|
|
|
|
|
|
|
|
positional arguments:
|
2020-01-06 17:28:40 +01:00
|
|
|
|
name the commander in question
|
|
|
|
|
apikey the commander’s EDSM API key. Can be empty for public profiles.
|
2020-01-05 19:20:20 +01:00
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
2020-01-07 17:27:31 +01:00
|
|
|
|
--system output the commander’s last known system (default)
|
2020-01-08 08:49:53 +01:00
|
|
|
|
--coords output the commander’s last known position in {x,y,z}
|
|
|
|
|
coordinates
|
2020-01-07 17:27:31 +01:00
|
|
|
|
--url output the commander’s profile URL
|
2020-01-05 19:20:20 +01:00
|
|
|
|
```
|
2020-01-08 08:30:27 +01:00
|
|
|
|
|
2020-01-13 21:23:41 +01:00
|
|
|
|
```
|
|
|
|
|
usage: explorationtools.py findsystem [-h] system
|
|
|
|
|
|
|
|
|
|
positional arguments:
|
|
|
|
|
system the system in question
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
```
|
|
|
|
|
|
2020-01-08 14:54:39 +01:00
|
|
|
|
```
|
|
|
|
|
usage: explorationtools.py systemlist [-h] partialsystem
|
|
|
|
|
|
|
|
|
|
positional arguments:
|
|
|
|
|
partialsystem the partial system name to query against
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-04 18:07:56 +01:00
|
|
|
|
### spansh.py ###
|
|
|
|
|
|
|
|
|
|
```
|
2020-03-09 19:53:49 +01:00
|
|
|
|
usage: spansh.py [-h] {nearestsystem,oldstations,systemexists} ...
|
2020-03-04 18:07:56 +01:00
|
|
|
|
|
|
|
|
|
Script for interfacing with Spansh’s API.
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
2020-03-09 17:39:44 +01:00
|
|
|
|
-h, --help show this help message and exit
|
2020-03-04 18:07:56 +01:00
|
|
|
|
|
|
|
|
|
subcommands:
|
2020-03-09 19:53:49 +01:00
|
|
|
|
{nearestsystem,oldstations,systemexists}
|
2020-03-09 17:39:44 +01:00
|
|
|
|
sub-command help
|
|
|
|
|
nearestsystem Searches for the nearest system in the database to
|
|
|
|
|
given coordinates.
|
|
|
|
|
oldstations Searches for stations with old data (>1 year without
|
|
|
|
|
an update.
|
2020-03-09 19:53:49 +01:00
|
|
|
|
systemexists Checks if a given system exists in the search
|
|
|
|
|
database.
|
2020-03-09 17:39:44 +01:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
2020-03-09 17:51:36 +01:00
|
|
|
|
usage: spansh.py nearestsystem [-h] [--short | --parsable]
|
|
|
|
|
coordinate coordinate coordinate
|
2020-03-09 17:39:44 +01:00
|
|
|
|
|
|
|
|
|
positional arguments:
|
|
|
|
|
coordinate the coordinates to search for (order: x, y, z)
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
--short short output format (system name only)
|
2020-03-09 17:51:36 +01:00
|
|
|
|
--parsable parsable output format (<name>|<x>,<y>,<z>|<distance>)
|
2020-03-04 18:07:56 +01:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
usage: spansh.py oldstations [-h] [--system [SYSTEM]] [--count [COUNT]]
|
2020-03-08 00:59:55 +01:00
|
|
|
|
[--short]
|
2020-03-04 18:07:56 +01:00
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
--system [SYSTEM] a single system to query. If not present, get the oldest
|
|
|
|
|
stations overall.
|
|
|
|
|
--count [COUNT] how many stations to output. Defaults to 50.
|
2020-03-08 00:59:55 +01:00
|
|
|
|
--short short output format (system/station names only)
|
2020-03-04 18:07:56 +01:00
|
|
|
|
```
|
|
|
|
|
|
2020-03-09 19:53:49 +01:00
|
|
|
|
```
|
|
|
|
|
usage: spansh.py systemexists [-h] system
|
|
|
|
|
|
|
|
|
|
positional arguments:
|
|
|
|
|
system the system to search for
|
|
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
|
-h, --help show this help message and exit
|
|
|
|
|
```
|
|
|
|
|
|
2020-01-08 08:30:27 +01:00
|
|
|
|
## Need Help / Want to Contribute? ##
|
|
|
|
|
|
|
|
|
|
Just [file an issue](https://github.com/alterNERDtive/elite-scripts/issues/new)
|
2020-04-24 10:22:28 +02:00
|
|
|
|
here or [hop into Discord](https://discord.gg/XHNX7jN) if that is your thing.
|