<img src="https://github.com/Viper-Dude/EliteMining/blob/main/app/Images/logo_multi.ico" width="32" height="32"> EliteMining

EliteMining optimizes your mining efficiency with live analytics, automated announcements, performance tracking, and a comprehensive hotspot finder with 61,000+ mining locations plus Spansh API integration for galaxy-wide ring search, overlaps, and RES sites as a standalone application. Optional VoiceAttack integration enables voice/hotkey mining sequences for complete hands-free operation.

<details open> <summary>Table of Contents</summary>

Features and Usage Options
Requirements
Installation
- Enable VoiceAttack Plugins
VoiceAttack Controls
EliteMining App
Hotspot Finder
Commodity Market
Mining Missions
Ring Mining Reference
Star Systems
Distance Calculator
Backup & Restore
Getting Started
VoiceAttack Commands
Mining Presets
Usage Tips
Known Limitations
Training Speech Recognition
In Development
FAQ
Contact
Community & Resources
License
Credits

</details>

Features and Usage Options

Standalone (Without VoiceAttack)

Full-featured mining companion with GUI controls:

Real-time mining statistics
Automated cargo monitoring
Mining announcements & notifications
Engineering materials tracking – Monitor raw materials by grade
Auto-start mining session – Automatically begins tracking when you fire your first prospector limpet
Auto-Switch Tabs – Automatically switches to Mining Session when you fire a prospector, returns to Hotspots Finder after session ends
Cargo full notification – Prompts you to end session when cargo hold is 100% full and idle for 1 minute
Session tracking & history
Ship configuration management
GUI for firegroups, timers, toggles, and announcements
Detailed HTML Reports – Generate detailed reports with charts, screenshots, and analytics tooltips
Hotspot Finder – Search 61,000+ mining hotspots by minerals, ring type, and distance with detailed location data
Overlaps – Find and tag double/triple hotspot overlaps for maximum yield
RES Sites – Locate Resource Extraction Sites (Hazardous, High, Low)
Commodity Market – Find the best sell prices for your mined commodities with real-time market data and distance calculations
Mining Missions – Track active mining missions and find hotspots directly from mission requirements
Backup & Restore – Save and restore full setup including settings, bookmarks, and reports

With VoiceAttack Integration (Optional)

All standalone features plus voice/hotkey automation:

Voice/hotkey mining sequences
Automated collector & prospector deployment
Smart targeting & laser management
Repeated mining cycles – Configure automated multi-cycle mining (1-10 repeats)
Custom commands & presets
Ship presets
Includes EliteAPI by Somfic (bundled with installer)

Requirements

<details open> <summary>Click to expand</summary>

Essential:

Windows 10/11 (64-bit)
Elite Dangerous (PC version)

For VoiceAttack Integration:

EliteVA (API) by Somfic (included in installer)
VoiceAttack – Paid version
Microphone for voice commands

Keybind Requirement for EliteVA

EliteVA requires a custom keybinds file (such as Custom.binds, Custom.*.binds, or an HCS Custom.*.*.binds file):

If you already use a custom keybinds file (for example, from HCS VoicePacks or your own setup), you’re all set—no changes needed.
If you don’t have a custom keybinds file yet:
1. Open Elite Dangerous → Options → Controls
2. Set preset to Custom
3. For each controller you want to use (keyboard, mouse, joystick, HOTAS, gamepad), make sure to assign at least one key or button in each of the four controller sections (Keyboard, Mouse, Joystick, Gamepad).
  - This ensures Elite Dangerous saves your bindings for all devices.
4. Click Save — this will create or update your Custom.binds file (or a similarly named custom file).

Tip:
If you use multiple controllers, always check that each one is recognized and has at least one binding set before saving. This prevents missing controls in your custom binds file.

Custom Keybinds for Mining Control

VoiceAttack profile includes a dedicated "Custom Keybinds for Mining Control" category. Configure your mining hotkeys here instead of searching through the entire profile.

Note: VoiceAttack is optional. EliteMining App can run standalone.

</details>

Installation

Installer: Run EliteMiningSetup.exe (includes VoiceAttack profile)

Antivirus Notice: If your antivirus flags the application, this is a common false positive with Python-compiled apps - simply add an exclusion for the installation folder.

After Updates and New Installs: System/ring location may appear empty until you relog into Elite Dangerous (one-time refresh).

Included Components

The installer bundles the EliteVA plugin. No separate download required.

VoiceAttack Installation

Open VoiceAttack → Profile → Import Profile
Select EliteMining v4.76-Profile.vap (versioned format)
Configure your mining hotkeys in the "Custom Keybinds for Mining Control" category

Enable VoiceAttack Plugins

VoiceAttack must have plugin support enabled and both EliteMining and EliteAPI plugins activated:

Open VoiceAttack → Options → General
Enable "Enable Plugin Support" checkbox
Click "Plugin Manager"
Enable these plugins:
- ✓ EliteMining Plugin v1.0.0
- ✓ EliteAPI (v4 EliteVA.dll)
Click OK and restart VoiceAttack for changes to take effect

<img src="https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/voiceattack_plugin.png" width="600"> 
Enable both EliteMining and EliteAPI plugins in VoiceAttack

Note: Plugin changes require a VoiceAttack restart.

Note (v4.76+): Keybind preservation is now automatic! When updating, EliteMining will prompt you to export your profile and automatically merge your keybinds into the new version.

Preserving Keybinds During Updates (v4.76+)

EliteMining now automatically detects when a new VoiceAttack profile is available and guides you through keybind preservation:

Start EliteMining after updating
Follow the on-screen prompt to export your current profile as XML
Select the exported file
Your keybinds will be automatically merged into the new profile
Import the updated profile in VoiceAttack

Manual method: You can also export your profile beforehand (Profile → Export Profile, save as XML format) and use it during the merge process.

Adding Custom Commands

Recommended: Create a separate profile for your custom commands instead of editing the EliteMining profile directly.

In VoiceAttack, create a new profile (e.g., "My Custom Commands")
Add your custom commands to this profile
Open the EliteMining profile → Profile Options → Include Commands from Other Profiles
Select your custom profile from the list

<img src="https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/voiceattack_profile_options.png" width="600"> 
Include custom profiles to add your own commands without modifying EliteMining

Benefits:

Your custom commands won't be overwritten during EliteMining updates
Easy to enable/disable your customizations
Clean separation between EliteMining and personal commands
Keybind merger won't affect your custom profile

Note: Commands in EliteMining profile take priority over included profiles if names conflict.

EliteMining App

The EliteMining App provides a comprehensive GUI for configuring mining automation, tracking sessions, and managing all settings. It can run standalone without VoiceAttack.

Start EliteMining

EliteMining Desktop icon or direct: \EliteMining\Configurator\EliteMining.exe

VoiceAttack Controls

Configure automation sequences for VoiceAttack integration. These settings can be adjusted via GUI even if running standalone.

Firegroups & Fire Buttons

Configure Elite Dangerous firegroups (A-H) and fire buttons (Primary/Secondary) for automated mining sequences:

<img src="https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/configurator-main.png" width="600"> 
Firegroups configuration for mining tools and fire button assignments.

Available Tools:

Mining Lasers/MVR – Automated laser mining with configurable duration
Discovery Scanner – System honk on FSD arrival
Prospector Limpet – Launch and auto-target asteroids
Pulse Wave Analyser – Core asteroid scanning
Seismic Charge Launcher – Fissure targeting for core mining
Weapons – Defense firegroup configuration
**Sub-surfac

EliteMining

Install / Use

README