{"id":35136668,"url":"https://github.com/dwomble/edmc-neutrondancer","last_synced_at":"2026-04-22T23:00:29.618Z","repository":{"id":328076145,"uuid":"1109373310","full_name":"dwomble/EDMC-NeutronDancer","owner":"dwomble","description":"Neutron Jump Plotter for EDMC","archived":false,"fork":false,"pushed_at":"2026-04-22T17:32:55.000Z","size":2380,"stargazers_count":12,"open_issues_count":4,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-22T19:25:58.977Z","etag":null,"topics":["edmarketconnector","edmc","edmc-plugin","elite-dangerous","neutronboost","neutronplotter","spansh"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"CMDR-Kiel42/EDMC_SpanshRouter","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dwomble.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-03T18:01:43.000Z","updated_at":"2026-04-22T17:32:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dwomble/EDMC-NeutronDancer","commit_stats":null,"previous_names":["dwomble/edmc-neutrondancer"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/dwomble/EDMC-NeutronDancer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwomble%2FEDMC-NeutronDancer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwomble%2FEDMC-NeutronDancer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwomble%2FEDMC-NeutronDancer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwomble%2FEDMC-NeutronDancer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dwomble","download_url":"https://codeload.github.com/dwomble/EDMC-NeutronDancer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwomble%2FEDMC-NeutronDancer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32158346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["edmarketconnector","edmc","edmc-plugin","elite-dangerous","neutronboost","neutronplotter","spansh"],"created_at":"2025-12-28T09:32:36.708Z","updated_at":"2026-04-22T23:00:29.612Z","avatar_url":"https://github.com/dwomble.png","language":"Python","funding_links":["https://www.patreon.com/spansh"],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"125\" height=\"125\" align=\"left\" alt=\"neutrondancer_logo125\" src=\"https://github.com/user-attachments/assets/53f26bf9-4db3-4199-a94e-4cebbe5ed081\" /\u003e\r\n\r\n# Navl's Neutron Dancer\r\n\r\n![Python](https://img.shields.io/badge/Python-3.x-blue?logo=python)\r\n[![CodeQL](https://github.com/dwomble/EDMC-NeutronDancer/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/dwomble/EDMC-NeutronDancer/actions/workflows/github-code-scanning/codeql)\r\n[![GitHub Latest Version](https://img.shields.io/github/v/release/dwomble/EDMC-NeutronDancer)](https://github.com/dwomble/EDMC-NeutronDancer/releases/latest)\r\n[![Github All Releases](https://img.shields.io/github/downloads/dwomble/EDMC-NeutronDancer/total.svg)](https://github.com/dwomble/EDMC-NEutronDancer/releases/latest)\r\n\r\nNeutron Dancer makes neutron jumping easier by plotting a route using [Spansh](https://www.spansh.co.uk/plotter) within [EDMC](https://github.com/EDCD/EDMarketConnector) and automatically copying the next waypoint on the route to your clipboard. It can work for almost any router by importing a CSV of the jumps.\r\n\r\nThe original goal of this fork was support for the new 6x overcharge of the Caspian and a cleaner UI. It has grown beyond that into a significant rewrite.\r\n\r\n\u003cimg width=\"429\" height=\"87\" alt=\"Screenshot 2025-12-27 164511\" src=\"https://github.com/user-attachments/assets/fafd8ae6-4fc1-49e2-9afd-707c7a394984\" /\u003e\r\n\r\n## Key Features\r\n\r\n- The easiest way to use Spansh' sophisticated **Galaxy Plotter** from within EDMC\r\n- Spansh **Neutron Plotting** directly from within EDMC\r\n- CSV import supports almost any route file including Road to Riches, Expressway to Exomastery, Tourist planner, and Fleetcarrier plotter\r\n- Next jump is automatically put into the paste buffer\r\n- History tracking remembers your current waypoint as well as ships, loadouts, and destinations\r\n- Route export makes it easy to save a route for later reuse\r\n- Fleet carrier support includes jump countdown and cooldown tracking and cooldown notifications\r\n- Tracks and reports statistics including jumps and distance per hour\r\n- Supports [Modern Overlay](https://github.com/SweetJonnySauce/EDMCModernOverlay) for in game display of routes and countdown timers\r\n- Supports chat commands (`!nd next`, `!nd previous`, `!nd copy`) for single screen operation\r\n- Supports [Hotkeys](https://github.com/SweetJonnySauce/EDMCHotkeys) for next waypoint, previous waypoint, and copy to clipboard operations.\r\n\r\n## Installation\r\n\r\n- Open your EDMC plugins folder - in EDMC settings, select \"Plugins\" tab, click the \"Open\" button.\r\n- Create a folder inside the plugins folder and call it whatever you want, **NeutronDancer** for instance\r\n- Download the latest release [here](https://github.com/dwomble/EDMC-NeutronDancer/releases/latest) and unzip it.\r\n- Open the folder you created and put all the files and folders you extracted inside\r\n- Restart EDMC\r\n\r\n## Usage\r\n\r\n\u003cimg width=\"481\" height=\"53\" alt=\"neutron_dance\" src=\"https://github.com/user-attachments/assets/32a2034a-06f6-4805-87c6-dab7fbddd57a\" /\u003e\r\n\r\nBy default Neutron Dancer starts in a minimized mode in order to be as unobtrusive as possible when not in use. To plot a route click **do the neutron dance** to open the route plotting form.\r\n\r\nNeutron dancer supports two direct route creation methods:\r\n\r\n1. The simpler Spansh Neutron Plotter\r\n1. The more sophisticated Spansh Galaxy Plotter\r\n\r\nit also supports CSV file import in a wide variety of formats\r\n\r\n1. Road to Riches\r\n1. Expressway to Exomastery\r\n1. Tourist planner\r\n1. Fleetcarrier plotter, etc.\r\n\r\n### Neutron Plotting\r\n\r\nTo use the Neutron Plotter, enter your source and destination systems, ship range, routing efficiency, and neutron jump multiplier. When you complete a route Neutron Dancer saves the source, destination, and ship details for easy entry. These are available from a right click menu to simplify entry.\r\n\r\n\u003cimg width=\"384\" height=\"163\" alt=\"Screenshot 2025-12-27 164632\" src=\"https://github.com/user-attachments/assets/fdc5f3f6-a904-476a-a6c6-1b7b8364ccd2\" /\u003e\r\n\r\nNext click **Calculate** to query Spansh and plot your route.\r\n\r\n### Galaxy Plotting\r\n\r\nThis works the same as the Neutron Plotter but because the Galaxy Plotter is much more sophisticated the options available are also more complex and using the wrong values can lead to **getting stuck** so make sure you understand them before taking a route.\r\n\r\n\u003cimg width=\"439\" height=\"239\" alt=\"Screenshot 2026-01-16 173246\" src=\"https://github.com/user-attachments/assets/106097f3-c72f-4add-88c1-56d4e01a463f\" /\u003e\r\n\r\n**Note** In order to perform a galaxy plot the Neutron Dancer needs the full loadout of the ship you intend to use. This means you need to have switched to this ship for it to be able to plot it.\r\n\r\n### CSV Import\r\n\r\nNeutron Dancer is very flexible about CSV formats. It requires a column called \"System Name\" or \"system\" and will accept any other columns provided. If there are columns for remaining distance or number of jumps it will use those to calculate those values. If there is a column for refueling it will use that too.\r\n\r\nTo import a CSV click **Import** and select an appropriate file such as that exported by the various Spansh route plotters.\r\n\r\n### Following the route\r\n\r\n\u003cimg width=\"429\" height=\"87\" alt=\"Screenshot 2025-12-27 164511\" src=\"https://github.com/user-attachments/assets/3e44b43e-919d-46f9-82ef-fdb0d1a0e19d\" /\u003e\r\n\r\nOnce your route is plotted, and every time you reach a waypoint, the next one is automatically copied to your clipboard. In Elite Dangerous bring up the Galaxy Map, paste in the waypoint, and click **Plot route**.\r\n\r\nIf for some reason, your clipboard should be empty or contain other stuff that you copied yourself, click on the **System Name** button, and the waypoint will be copied again to your clipboard.\r\n\r\nThe progress bar has a Tooltip that provides the number of jumps remaining and distance remaining if those values are known.\r\n\r\n### Viewing the Route\r\n\r\n\u003cimg width=\"1164\" height=\"361\" alt=\"route_window\" src=\"https://github.com/user-attachments/assets/37d0080d-30bc-41f1-a992-701474b605ef\" /\u003e\r\n\r\nThe **Show route** button will open a window showing progress and the details of the plotted route. The current waypoint is hightlighted and progress includes waypoints completed and remaining, distance completed and remaining, jumps and lightyears per hour. For each jump the details include waypoints, distance traveled and remaining, fuel used and remaining, tritium used and remaining, whether to refueld and whether a star is a neutron star or scoopable depending on the type of route being followed.\r\n\r\n### Export Route\r\n\r\nThe **Export route** button will open a file dialog allowing you to save the current route as a CSV.\r\n\r\n### Overlay Support\r\n\r\nThis requires the EDMC Modern Overlay to be installed, older overlays aren't supported.\r\n\r\nTo enable overlay display, in the EDMC select File -\u003e Settings and in the settings window select Navl's Neutron Dancer, activate the overlay frames you want and choose the text colour.\r\n\r\nThree overlays are available.\r\n\r\n1. _Default_ when enabled this will display the next jump in the current route and other details in the ship main window\r\n2. _Galaxy Map_, this displays the same information as _Default_ but only shows in the Galaxy Map so the colour and location can be distinct\r\n3. _Carrier_, this displays carrier jump and cooldown timers\r\n\r\nTo change overlay frame positions, set backgrounds, text alignment etc. use Modern Overlay's controller.\r\n\r\n### Chat Commands\r\n\r\nThis enables management of Neutron Dancer without tabbing out of the game. Simply bring up a chat window and type in `!nd` and a command. Supported commands are:\r\n\r\n- `next` – move to the next waypoint\r\n- `previous` (or just `prev`) – move to the previous waypoint\r\n- `copy` – re-insert the next waypoint into the past buffer\r\n\r\n### Hotkeys\r\n\r\nIf you install the [EDMC Hotkeys](https://github.com/SweetJonnySauce/EDMCHotkeys) plugin you can define hotkeys for the chat commands listed above.\r\n\r\n### Saving State\r\n\r\nIf you close EDMC, the plugin will save your progress. The next time you run EDMC, it will continue from where you left off and catch up any jumps made while EDMC was inactive.\r\n\r\nIt also saves ship details and source and destination systems for easy entry.\r\n\r\n### Linux Clipboard\r\n\r\nThis is notoriously variable and problematic. Neutron Dancer tries to find `wl-copy`, `xsel` and `xclip` based on the current session. If it doesn't find anything appropriate it runs _all_ of them that exist. If it can't find any of them it falls back to using the Tk native method.\r\n\r\nIf you have problems with waypoints not being put into the clipboard you can override all of this by setting an environment variable `EDMC_CLIPBOARD_CLI` to the command you wish to use before running EDMC. e.g.\r\n\r\n```shell\r\nexport EDMC_CLIPBOARD_CLI=\"/usr/local/random/xsel --clipboard --input\"\r\n/usr/bin/python EDMarketConnector.py\r\n```\r\n\r\nNote, if you're running Flatpak and still having problems even with the environment variable set, check that EDMC is allowed to run the command you're referencing and allowed to follow any symlinks.\r\n\r\n## Credits\r\n\r\nThe biggest thank you must go to [CMDR Spansh](https://www.patreon.com/spansh) for the amazing [Spansh Route Planners](https://spansh.co.uk/plotter).\r\n\r\nThis code is based on the original [Spansh router](https://github.com/CMDR-Kiel42/EDMC_SpanshRouter) by CMDR Kiel42, [RadarCZ's](https://github.com/RadarCZ/EDMC_SpanshRouter), and [Norohind's](https://github.com/norohind/EDMC_SpanshRouter) forks.\r\n\r\n## Suggestions\r\n\r\nPlease let me know if you have any suggestions or find any bugs by submitting an [issue](https://github.com/dwomble/EDMC-NeutronDancer/issues), and if you like Neutron Dancer I don't need a coffee, I live in Seattle so I'm plenty caffeinated already, but please give it a star.\r\n\r\nFly dangerous! o7\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwomble%2Fedmc-neutrondancer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdwomble%2Fedmc-neutrondancer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwomble%2Fedmc-neutrondancer/lists"}