{"id":41879513,"url":"https://github.com/viper-dude/elitemining","last_synced_at":"2026-04-26T22:02:05.673Z","repository":{"id":310031652,"uuid":"1038445527","full_name":"Viper-Dude/EliteMining","owner":"Viper-Dude","description":"Tool for mining operations in Elite Dangerous","archived":false,"fork":false,"pushed_at":"2026-04-23T11:49:49.000Z","size":202673,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T13:31:57.797Z","etag":null,"topics":["eddn","edsm","elite-dangerous","elitedangerous","elitedangerousodyssey","hotspots","hotspots-finder","mining","voiceattack"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Viper-Dude.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-15T07:59:06.000Z","updated_at":"2026-04-23T11:49:53.000Z","dependencies_parsed_at":"2025-09-03T14:13:23.466Z","dependency_job_id":"3077d8a2-37ca-4555-87b1-be46bdfe4da6","html_url":"https://github.com/Viper-Dude/EliteMining","commit_stats":null,"previous_names":["viper-dude/elite-dangerous-elite-mining-voiceattack","viper-dude/elitemining"],"tags_count":146,"template":false,"template_full_name":null,"purl":"pkg:github/Viper-Dude/EliteMining","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viper-Dude%2FEliteMining","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viper-Dude%2FEliteMining/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viper-Dude%2FEliteMining/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viper-Dude%2FEliteMining/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Viper-Dude","download_url":"https://codeload.github.com/Viper-Dude/EliteMining/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viper-Dude%2FEliteMining/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32314116,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T21:09:39.134Z","status":"ssl_error","status_checked_at":"2026-04-26T21:09:21.240Z","response_time":129,"last_error":"SSL_read: 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":["eddn","edsm","elite-dangerous","elitedangerous","elitedangerousodyssey","hotspots","hotspots-finder","mining","voiceattack"],"created_at":"2026-01-25T13:00:55.694Z","updated_at":"2026-04-26T22:02:05.634Z","avatar_url":"https://github.com/Viper-Dude.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"top\"\u003e\u003c/a\u003e\n\n# \u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/app/Images/logo_multi.ico\" width=\"32\" height=\"32\"\u003e EliteMining\n[![Discord](https://img.shields.io/badge/Discord%20Community-Join%20Server-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/5dsF3UshRR)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/app/Images/EliteMining_Main_logo.png\" alt=\"EliteMining Logo\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n**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.\n\n---\n\n\u003cdetails open\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [Features and Usage Options](#features-and-usage-options)\n- [Requirements](#requirements)\n- [Installation](#installation)\n  - [Enable VoiceAttack Plugins](#enable-voiceattack-plugins)\n- [VoiceAttack Controls](#voiceattack-controls)\n- [EliteMining App](#elitemining-app)\n  - [Text Overlay](#text-overlay)\n- [Hotspot Finder](#hotspot-finder)\n- [Commodity Market](#commodity-market)\n- [Mining Missions](#mining-missions)\n- [Ring Mining Reference](#ring-mining-reference)\n- [Star Systems](#star-systems)\n- [Distance Calculator](#distance-calculator)\n- [Fleet Carrier](#fleet-carrier)\n- [Backup \u0026 Restore](#backup--restore)\n- [Getting Started](#getting-started)\n- [VoiceAttack Commands](#voiceattack-commands)\n- [Mining Presets](#mining-presets)\n- [Usage Tips](#usage-tips)\n- [Known Limitations](#known-limitations)\n- [Training Speech Recognition](#training-speech-recognition)\n- [In Development](#in-development)\n- [FAQ](#faq)\n- [Contact](#contact)\n- [Community \u0026 Resources](#community--resources)\n- [License](#license--third-party-notices)\n- [Credits](#credits)\n\n\u003c/details\u003e\n\n---\n\n## Features and Usage Options\n\n### Standalone (Without VoiceAttack)\nFull-featured mining companion with GUI controls:\n- Real-time mining statistics  \n- Automated cargo monitoring  \n- Mining announcements \u0026 notifications  \n- **Engineering materials tracking** – Monitor raw materials by grade\n- **Auto-start mining session** – Automatically begins tracking when you fire your first prospector limpet\n- **Auto-Switch Tabs** – Automatically switches to Mining Session when you fire a prospector, returns to Hotspots Finder after session ends\n- **Cargo full notification** – Prompts you to end session when cargo hold is 100% full and idle for 1 minute\n- Session tracking \u0026 history  \n- Ship configuration management  \n- GUI for firegroups, timers, toggles, and announcements  \n- **Detailed HTML Reports** – Generate detailed reports with charts, screenshots, and analytics tooltips  \n- **Hotspot Finder** – Search 61,000+ mining hotspots by minerals, ring type, and distance with detailed location data  \n- **Overlaps** – Find and tag double/triple hotspot overlaps for maximum yield  \n- **RES Sites** – Locate Resource Extraction Sites (Hazardous, High, Low)  \n- **Commodity Market** – Find the best sell prices for your mined commodities with real-time market data and distance calculations  \n- **Mining Missions** – Track active mining missions and find hotspots directly from mission requirements  \n- **Backup \u0026 Restore** – Save and restore full setup including settings, bookmarks, and reports\n\n### With VoiceAttack Integration (Optional)\nAll standalone features **plus** voice/hotkey automation:\n- Voice/hotkey mining sequences  \n- Automated collector \u0026 prospector deployment  \n- Smart targeting \u0026 laser management  \n- **Repeated mining cycles** – Configure automated multi-cycle mining (1-10 repeats)\n- Custom commands \u0026 presets\n- Ship presets\n- Includes [EliteAPI by Somfic](https://docs.somfic.dev/projects/eliteva) (bundled with installer)  \n\n[Back to Top](#top)\n\n---\n\n## Requirements\n\u003cdetails open\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n**Essential:**  \n- **Windows 10/11** (64-bit)\n- **Elite Dangerous** (PC version)  \n\n**For VoiceAttack Integration:**  \n- **[EliteVA (API) by Somfic](https://docs.somfic.dev/projects/eliteva)** *(included in installer)*  \n- **[VoiceAttack](https://voiceattack.com/)** – Paid version  \n- **Microphone** for voice commands  \n\n\n### Keybind Requirement for EliteVA\n\nEliteVA requires a custom keybinds file (such as `Custom.binds`, `Custom.*.binds`, or an HCS `Custom.*.*.binds` file):\n\n- If you already use a custom keybinds file (for example, from HCS VoicePacks or your own setup), you’re all set—no changes needed.\n- If you don’t have a custom keybinds file yet:\n  1. Open **Elite Dangerous → Options → Controls**\n  2. Set preset to **Custom**\n  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).  \n     - This ensures Elite Dangerous saves your bindings for all devices.\n  4. Click **Save** — this will create or update your `Custom.binds` file (or a similarly named custom file).\n\n**Tip:**  \nIf 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.\n\n### Custom Keybinds for Mining Control  \nVoiceAttack profile includes a dedicated **\"Custom Keybinds for Mining Control\"** category. Configure your mining hotkeys here instead of searching through the entire profile.\n\n**Note:** VoiceAttack is optional. EliteMining App can run standalone.  \n\n\u003c/details\u003e\n\n[Back to Top](#top)\n\n---\n\n## Installation\n\n- **Installer:** Run `EliteMiningSetup.exe` (includes VoiceAttack profile)  \n\n\u003e **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.\n\u003e \n\u003e **After Updates and New Installs:** System/ring location may appear empty until you relog into Elite Dangerous (one-time refresh).\n\n### Included Components  \nThe installer bundles the **EliteVA plugin**. No separate download required.  \n\n### VoiceAttack  Installation  \n1. Open VoiceAttack → Profile → Import Profile  \n2. Select **EliteMining v4.76-Profile.vap** (versioned format)  \n3. Configure your mining hotkeys in the **\"Custom Keybinds for Mining Control\"** category\n\n### Enable VoiceAttack Plugins\nVoiceAttack must have plugin support enabled and the EliteAPI plugin activated:\n\n1. Open **VoiceAttack → Options → General**\n2. Enable **\"Enable Plugin Support\"** checkbox\n3. Click **\"Plugin Manager\"**\n4. Enable this plugin:\n   - ✓ **EliteAPI (v4 EliteVA.dll)**\n5. Click **OK** and **restart VoiceAttack** for changes to take effect\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/voiceattack_plugin.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Enable the EliteAPI plugin in VoiceAttack*\n\n**Note:** Plugin changes require a VoiceAttack restart.\n\n**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.\n\n### Preserving Keybinds During Updates (v4.76+)\nEliteMining now automatically detects when a new VoiceAttack profile is available and guides you through keybind preservation:\n1. Start EliteMining after updating\n2. Follow the on-screen prompt to export your current profile as XML\n3. Select the exported file\n4. Your keybinds will be automatically merged into the new profile\n5. Import the updated profile in VoiceAttack\n\n**Manual method:** You can also export your profile beforehand (Profile → Export Profile, save as XML format) and use it during the merge process.\n\n### Adding Custom Commands\n\n**Recommended:** Create a separate profile for your custom commands instead of editing the EliteMining profile directly.\n\n1. In VoiceAttack, create a new profile (e.g., \"My Custom Commands\")\n2. Add your custom commands to this profile\n3. Open the EliteMining profile → **Profile Options** → **Include Commands from Other Profiles**\n4. Select your custom profile from the list\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/voiceattack_profile_options.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Include custom profiles to add your own commands without modifying EliteMining*\n\n**Benefits:**\n- Your custom commands won't be overwritten during EliteMining updates\n- Easy to enable/disable your customizations\n- Clean separation between EliteMining and personal commands\n- Keybind merger won't affect your custom profile\n\n**Note:** Commands in EliteMining profile take priority over included profiles if names conflict.\n\n[Back to Top](#top)\n\n---\n\n## EliteMining App  \n\nThe **EliteMining App** provides a comprehensive GUI for configuring mining automation, tracking sessions, and managing all settings. It can run standalone without VoiceAttack.\n\n### Start EliteMining  \n- EliteMining Desktop icon or direct: `\\EliteMining\\Configurator\\EliteMining.exe`\n\n[Back to Top](#top)\n\n---\n\n## VoiceAttack Controls\n\nConfigure automation sequences for VoiceAttack integration. These settings can be adjusted via GUI even if running standalone.\n\n### Firegroups \u0026 Fire Buttons\n\nConfigure Elite Dangerous firegroups (A-H) and fire buttons (Primary/Secondary) for automated mining sequences:\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/configurator-main.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Firegroups configuration for mining tools and fire button assignments.*\n\n**Available Tools:**\n- **Mining Lasers/MVR** – Automated laser mining with configurable duration\n- **Discovery Scanner** – System honk on FSD arrival  \n- **Prospector Limpet** – Launch and auto-target asteroids\n- **Pulse Wave Analyser** – Core asteroid scanning\n- **Seismic Charge Launcher** – Fissure targeting for core mining\n- **Weapons** – Defense firegroup configuration\n- **Sub-surface Displacement Missile** – Deposit extraction\n\n### Mining Controls (VoiceAttack)\n\nControl mining sequence timing and automated behaviors:\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/configurator-timers_toggles.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Mining controls for automation sequences.*\n\n**Timers:** Configure duration for laser periods, pauses, and delays (1-50 seconds range)\n\n**Toggles:**\n- **Auto Honk** – Scan system automatically on FSD arrival\n- **Cargo Scoop** – Auto-retract when mining completes\n- **Headtracker Docking Control** – Toggle headtracker (F9) for docking\n- **Laser Mining Extra** – Second laser period with cooldown pause\n- **Night Vision** – Auto-enable when starting mining\n- **FSD Jump Sequence** – Auto-chain jumps with system map toggle\n- **Power Settings** – Max engines during mining, balance when complete\n- **Prospector Sequence** – Auto-target prospector after launch\n- **Pulse Wave Analyser** – Auto-switch to PWA firegroup after mining\n- **Target** – Deselect prospector when mining completes\n\n💡 **Tip:** Use \"Stop all profile commands\" in VoiceAttack to interrupt any active sequence.\n\n[Back to Top](#top)\n\n---\n\n## Hotspot Finder\n\nThe Hotspot Finder provides access to a comprehensive database of 61,000+ confirmed mining hotspots with detailed location data, minerals information, and intelligent filtering capabilities, plus integrated Spansh data.\n\n### Key Features\n- **Search Planetary Rings** – Find optimal mining rings (Ice, Metal Rich, Rocky, Metallic)\n- **Filter by Minerals** – Search for specific minerals (Painite, Platinum, Low Temperature Diamonds, etc.)\n- **Spansh Data Integration** – Search includes Spansh.co.uk data alongside your personal scans for comprehensive coverage (~50 LY typical, Ring Search mode reaches 300 LY)\n- **Ring Type Only Search** – Find rings by type without requiring hotspot data, useful for exploring unmarked rings\n- **Data Source Selection** – Choose between Database (your scans), Spansh (Spansh data), or Both for best results\n- **Min Hotspots Filter** – Filter results to show only rings with X or more hotspots (1-20 range, available when specific mineral selected)\n- **Save to Local Database** – Right-click Spansh results to save them to your personal database for offline access (max 50 rows)\n- **Update Reserve Level** – Right-click local entries with missing reserve data to fetch and update from Spansh\n- **Auto-Search** – Automatically searches for hotspots when jumping to new systems and auto-refreshes results when scanning rings (remembers preference across restarts)\n- **Pre-loaded Database** – 61,000+ hotspots with minerals types, ring densities\n- **Auto-Import \u0026 Tracking** – Automatically imports hotspots from journal files and tracks new discoveries\n- **Distance-Based Results** – Filter by jump range (up to 500 LY) to find nearby opportunities\n- **Ring Composition Details** – View distance from arrival (LS) with comma-separated formatting\n- **Smart Sorting** – Results ranked by distance and hotspot overlaps\n- **Overlap Tracking** – Add and find hotspot overlaps (2x, 3x) for higher yield mining locations\n- **RES Site Tracking** – Add and find Resource Extraction Sites (Hazardous, High, Low) for combat mining\n- **Pre-loaded Overlap \u0026 RES Data** – Ships with 161 known overlaps and 71 RES site locations\n\n### Setting \u0026 Managing Overlap/RES Data\n- **Set Overlap** – Right-click any ring to set hotspot overlaps (2x, 3x) for specific minerals\n- **Set RES** – Right-click any ring to set Resource Extraction Sites (Hazardous, High, Low)\n- **Remove Overlap/RES** – Select \"None\" in the Set Overlap/RES dialog to remove existing entries\n- **Bookmarks** – Overlap and RES data saved in bookmarks also syncs to the Ring Finder database\n- Data is stored locally and appears in all future searches\n\nAutomatically imports hotspots from your Elite Dangerous journal files and continuously tracks newly discovered locations.\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/ring_finder.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Hotspot Finder showing search results with minerals filters and distance calculations.*\n\n[Back to Top](#top)\n\n---\n\n## Commodity Market\n\nThe Commodity Market helps you find the best prices for mining commodities and trade goods using real-time market data from the Ardent API, with automatic distance calculations to help you maximize profits.\n\n### Key Features\n- **Two Tabs:**\n  - **Mining Commodities** – Search for 28 mineable resources (Painite, Platinum, Low Temperature Diamonds, etc.)\n  - **Trade Commodities** – Search across 15 categories of trade goods (Chemicals, Machinery, Medicines, Technology, and more)\n- **Two Search Modes:**\n  - **Near System** – Find top 30 stations within 500 LY, filtered by distance\n  - **Galaxy-Wide** – Find top 30 best prices anywhere in the galaxy with calculated distances\n- **Buy/Sell Toggle:**\n  - **Sell Mode** – Find stations buying your commodities (best sell prices)\n  - **Buy Mode** – Find stations selling commodities you want to purchase (lowest buy prices)\n- **Real-Time Market Data** – Live commodity prices from multiple sources: Ardent API, Spansh, and a local EDDN cache (data broadcast by other commanders in real-time, retained for 24 hours)\n- **Smart Filtering:**\n  - Station type (Orbital/Surface/Fleet Carrier/MegaShip)\n  - Landing pad size (Large pads only option)\n  - Exclude Fleet Carriers\n- **Distance Calculations** – Automatically calculates jump distance from your reference system\n- **Data Freshness** – Shows when prices were last updated (minutes/hours/days ago)\n- **Sortable Results** – Click column headers to sort by location, type, distance, demand, or price\n- **Threaded Updates** – Results appear instantly with distances calculated in background for smooth performance\n- **External Links** – Right-click any search result to:\n  - Open station in Inara (station search)\n  - Open system in EDSM (system page with all stations)\n  - Copy system name to clipboard\n\nPerfect for planning your mining runs and finding the most profitable stations to sell your haul or locate trade goods.\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/commidity_marked.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Commodity Market showing mining commodities search results with filters and distance calculations.*\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/trade_commodities.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Trade Commodities tab with 15 categories covering all tradeable goods in Elite Dangerous.*\n\n[Back to Top](#top)\n\n---\n\n## Mining Missions\n\nTrack your active mining missions and quickly find hotspots matching mission requirements.\n\n### Key Features\n- **Mission Tracking** – View all active mining missions with commodity requirements and progress\n- **Find Hotspots** – Search for hotspots directly from mission commodity requirements\n- **Auto-Import** – Missions automatically imported from Elite Dangerous journals\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/mining_missions.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Mining Missions tab showing active missions with quick search options.*\n\n[Back to Top](#top)\n\n---\n\n## Ring Mining Reference\n\nQuick reference guide for ring types and mining minerals, accessible from the Mining tab.\n\n### Key Features\n- **Ring Type Guides** – Expandable sections for Icy, Metallic, Metal-Rich, and Rocky rings\n- **Mineral Categories** – Laser (High/Low) and Core (High/Low) minerals for each ring type\n- **RES Sites Reference** – Resource Extraction Site types with pirate levels and mining bonus percentages\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/mining_reference.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Ring Mining Reference showing ring types and RES site bonuses.*\n\n[Back to Top](#top)\n\n---\n\n## Star Systems\n\nSearch for nearby star systems with detailed status information. Perfect for finding systems with specific conditions for missions, bounty hunting, or exploration.\n\n### Key Features\n- **Current System Info** – View detailed status of your current system (security, allegiance, government, state, economy, population)\n- **Nearby System Search** – Find systems within range of your reference system\n- **Server-Side Filtering** – Filter by Security, Allegiance, Government, State, Economy, Population\n- **Distance Sorting** – Results sorted by distance from reference system\n- **Quick Actions:**\n  - Right-click to copy system name or open in Inara/EDSM/Spansh\n  - \"Use Current\" button fills reference system instantly\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/star_system.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Star Systems tab showing current system info and nearby system search with filters.*\n\n[Back to Top](#top)\n\n---\n\n## Distance Calculator\n\nCalculate distances between any two systems using real-time EDSM data. Perfect for planning long-distance trips, tracking your home base, or finding your fleet carrier.\n\n### Key Features\n- **System Distance Calculator** – Calculate precise jump distances between any two star systems\n- **Home System Tracking** – Save your home system and see distance from your current location in real-time\n- **Fleet Carrier Tracking** – Auto-detect your fleet carrier location from journals or set manually\n- **Coordinates \u0026 Sol Distance** – View galactic coordinates and distance to Sol for all systems\n- **Live Updates** – Distances to Home and Fleet Carrier update automatically when you jump systems\n- **Session Memory** – Remembers your last calculated systems and settings between app restarts\n- **Quick Actions:**\n  - \"Use Current\" button fills with your current system instantly\n  - \"Home\" and \"FC\" buttons quickly fill destination field\n  - Press Enter to calculate without clicking\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/distance_calc.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Distance Calculator showing system distances with Home and Fleet Carrier tracking.*\n\n[Back to Top](#top)\n\n---\n\n## Fleet Carrier\n\nMonitor your fleet carrier status at a glance — populated automatically from your Elite Dangerous journal files.\n\n### Key Features\n- **Live Status** – Carrier name, callsign, current location, docking access and tritium fuel level\n- **Jump Schedule** – Destination, body, departure time and live countdown timer\n- **Finances** – Carrier balance, available funds, reserve balance and reserve percentage\n- **Services** – All installed and active services listed; inactive/not-installed shown in grey\n- **Cargo Capacity** – Total capacity, cargo in use, crew modules and free space\n- **Jump History** – Last 10 jump destinations with timestamps\n- **VoiceAttack** – Say *\"Show fleet carrier tab\"* to switch directly to this tab\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/fleet_carrier.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Fleet Carrier tab showing live status, finances, services and cargo.*\n\n[Back to Top](#top)\n\n---\n\n## Getting Started\n\u003cdetails open\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n### Firegroup (FG) Setup  \n| Component | FG | Fire Button | Notes |\n|-----------|----|-------------|-------|\n| Mining Lasers (MVR) | Preset/Command | Primary | – |\n| Discovery Scanner | Preset/Command | Secondary | – |\n| Prospector Limpet Controller | Same as PWA | Secondary | Must set manually |\n| Pulse Wave Analyser | Preset/Command | Primary | – |\n| Seismic Charge Launcher | Preset/Command | – | – |\n| Weapons | Preset/Command | – | – |\n| Sub-surface Displ Missile | Preset/Command | – | – |\n| Collector Limpet Controller | Preset/Command | – | Must set manually |\n\n\u003e **⚠️ Important for Automated Firegroup Switching:**  \n\u003e For the mining sequence automation to work correctly, **ALL firegroups (A through H) must be populated** in Elite Dangerous, even if you don't actively use them. Not populated firegroups will prevent automatic switching.\n\u003e \n\u003e \u003cimg src=\"Screenshot/fg_all.png\" width=\"900\"\u003e\u003cbr\u003e\n\u003e *Example: All 8 firegroups configured (A-H). Unused groups can have any weapon assigned.*\n\n### Key / HOTAS Bindings  \n| Action | Description |\n|--------|-------------|\n| Start mining sequence | Begin automated mining |\n| Start prospector | Start prospector sequence |\n| Reset mining sequence | Reset to default state |\n| Deploy seismic charge launcher | Fire seismic charge |\n| Deploy Sub-Surface Displacement Missile | Fire SSDM |\n| Deploy weapons | Deploy hardpoints |\n| Start Pulse wave scanning | Enable PWA scanner |\n| Stop Pulse wave scanning | Disable PWA scanner |\n| Clear and jump | Retract hardpoints and jump |\n| Toggle Listening | Enable/disable voice recognition |\n| Stop all | Emergency stop all sequences |\n\n\u003c/details\u003e\n\n[Back to Top](#top)\n\n---\n\n### EliteMining GUI  \n\u003cdetails open\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n### Mining Session Tab  \n\n#### Mining Session  \n\u003cimg src=\"Screenshot/mining-session.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Tracks time, prospector reports, minerals, and progress.*  \n\n\u003cimg src=\"Screenshot/dashboard-graphs_yield_timeline_comparison.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Yield comparisons across sessions.*  \n\n\u003cimg src=\"Screenshot/dashboard-graphs_material_comparison.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Minerals collection comparisons.*  \n\n#### Reports \n\u003cimg src=\"Screenshot/mining-reports.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Detailed mining statistics and summaries.*  \n\n#### Detailed HTML Reports  \n*HTML reports with charts and statistics.*  \n\n\u003e **Work in Progress:** The detailed HTML report system is under active development. New features and improvements are being added regularly. Report layouts, analytics calculations, and data presentation may change in future updates.\n\nGenerate comprehensive HTML reports with interactive charts, mining analytics, and session comments. Features include:\n- **Dark/Light Theme Toggle** - Switch between themes with one click  \n- **Session Comments** - Add notes and observations to your reports  \n- **Visual Charts** - Minerals breakdowns and performance graphs  \n- **Screenshot Integration** - Attach screenshots to document your sessions  \n- **Overall Statistics** - Compare current session to your mining history\n- **Analytics Tooltips** - Hover explanations for all efficiency metrics\n- **Clickable Images** - Charts and screenshots expand to full size\n- **Data Preservation** - Reports protected during software updates\n- **Export Options** - CSV, HTML, and PDF formats available\n\n**File Locations:**\n- Reports saved to: `Reports/Mining Session/`\n- Screenshots: `Reports/Mining Session/Detailed Reports/Screenshots/`\n- Performance graphs: `Reports/Mining Session/Graphs/`  \n\nRight-click any mining session to generate a detailed report, add screenshots, or manage existing reports. All reports are saved with your session data and can be opened directly from the reports tab.\n\n#### Discord Integration\n*Manually share mining session reports to Discord channels.*  \n\nShare completed mining session summaries to Discord channels via webhook integration. Configure your Discord webhook URL in settings, then manually share individual session reports with custom comments. Reports include materials found, yields, performance metrics, and session duration. \n\n#### 📊 Mining Cards\nGenerate shareable PNG cards from your mining sessions.\n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/mining_cards.png\" width=\"300\"\u003e\u003cbr\u003e\n\n**Features:**\n- Session stats, performance metrics, and commodity breakdown\n- Add your CMDR name and optional notes\n- Right-click any session in Reports → \"Mining Card\"\n\nCards saved to: `app/Reports/Mining Session/Cards/`\n\n\u003cdetails\u003e\n\u003csummary\u003e📸 View HTML Report Screenshots\u003c/summary\u003e\n\n\u003cimg src=\"Screenshot/html_report_1.png\" width=\"250\"\u003e \u003cimg src=\"Screenshot/html_report_2.png\" width=\"250\"\u003e \u003cimg src=\"Screenshot/html_report_3.png\" width=\"250\"\u003e\n\n*Click images to view full size*\n\n\u003c/details\u003e\n\n#### Bookmarks  \n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/mining-session_bookmarks.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Save, search, and manage mining spots.*  \n\n#### Comprehensive Analytics  \n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/mining-session_statistic.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Session statistics: yields, hit rates, and comparisons.*  \n\n---\n\n#### Settings Tab  \n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/configurator-options.png\" width=\"900\"\u003e\u003cbr\u003e  \n*UI and announcement preferences.*  \n\n#### Announcement Panel  \n\u003cimg src=\"Screenshot/mining-announcement.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Controls announcements, thresholds, and filters.*  \n\n#### Text Overlay  \n\u003cimg src=\"Screenshot/txt_overlay.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Text overlay showing real-time mining announcements in-game.*\n\n\u003cimg src=\"Screenshot/txt_overlay_enhanced.png\" width=\"900\"\u003e\u003cbr\u003e  \n*Enhanced overlay with improved readability and detailed mining statistics.*\n\n\u003e **Note:** The text overlay automatically follows the game window across monitors. On high DPI scaling settings (above 150%), the overlay position may be slightly offset. For best results, use 100–150% display scaling on the monitor running the game.\n\n\u003e **Hide in Supercruise:** Enable \"Hide in Supercruise\" in the General Settings tab to automatically hide all text overlays (including cargo status) while in supercruise. Overlays are instantly restored when you drop out of supercruise.\n\n\u003e **Only during Mining Session:** Enable \"Only during Mining Session\" to show overlays only while a mining session is active. When no session is running, overlays stay hidden to keep your screen clean.\n\n\u003cimg src=\"Screenshot/txt_overlay_settings.png\" width=\"900\"\u003e\u003cbr\u003e\n*Text overlay settings in the General Settings tab.*\n\n\u003c/details\u003e\n\n[Back to Top](#top)\n\n---\n\n### Backup \u0026 Restore \n- Easily save and restore your complete EliteMining setup including settings, bookmarks, and reports. Create timestamped backups before updates or quickly restore previous configurations with one click.  \n\n\u003cimg src=\"https://github.com/Viper-Dude/EliteMining/blob/main/Screenshot/backup.png\" width=\"900\"\u003e\u003cbr\u003e  \n\n[Back to Top](#top)\n\n---\n\n## VoiceAttack Commands\n\u003cdetails open\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\nControl EliteMining with voice commands. These require VoiceAttack with the EliteMining profile.\n\n### Mining Sequences (Custom Keybinds)\nThese commands trigger in-game actions. Configure your keybinds in the \"Custom Keybinds for Mining Control\" category.\n\n#### Repeated Mining Cycles\nConfigure how many times the laser mining extra sequence runs:\n- Adjustable repeat count (1-10 cycles)\n- Set in VoiceAttack Controls → Mining Controls tab\n- Default: 1 cycle (standard mining)\n- Higher values: automated repeated mining without manual restart\n\n| Voice Command | Action |\n|---------------|--------|\n| Start mining sequence | Begin automated mining |\n| Start prospector | Start prospector sequence |\n| Deploy Sub-Surface Displacement Missile | Fire SSDM |\n| Start Pulse wave scanning | Enable PWA scanner |\n| Stop Pulse wave scanning | Disable PWA scanner |\n| Deploy seismic charge launcher | Fire seismic charge |\n| Clear and jump | Retract hardpoints and jump |\n| Deploy weapons | Deploy hardpoints |\n| Toggle Listening | Enable/disable voice recognition |\n| Stop all | Emergency stop all sequences |\n| Reset mining sequence | Reset to default state |\n\n### App Control\n| Voice Command | Action |\n|---------------|--------|\n| Open Elite Mining | Launch the app |\n| Close Elite Mining | Close app gracefully |\n| Minimize Elite Mining | Minimize to taskbar |\n| Restore Elite Mining | Restore from taskbar |\n\n### UI Navigation\n| Voice Command | Action |\n|---------------|--------|\n| Show mining | Switch to Mining Session tab |\n| Show hotspots | Switch to Hotspots Finder tab |\n| Show market | Switch to Commodity Market tab |\n| Show missions | Switch to Mining Missions tab |\n| Show ring guide | Switch to Ring Mining Reference tab |\n| Show systems | Switch to Star Systems tab |\n| Show distance | Switch to Distance Calculator tab |\n| Show voice attack | Switch to VoiceAttack tab |\n| Show bookmarks | Switch to Bookmarks tab |\n| Show settings | Switch to Settings tab |\n\n### Mining Session Control\n| Voice Command | Action |\n|---------------|--------|\n| Start mining | Start mining session |\n| Pause mining | Pause/Resume session |\n| Stop mining | Stop and save session |\n| Cancel mining | Cancel without saving |\n\n### Announcement Presets\n| Voice Command | Action |\n|---------------|--------|\n| Load announcement 1-6 | Load announcement preset |\n\n### Settings\n| Voice Command | Action |\n|---------------|--------|\n| Import settings | Import settings from game |\n| Apply settings | Apply settings to game |\n\n### Overlay Control\n| Voice Command | Action |\n|---------------|--------|\n| Enable text overlay | Turn on the text overlay |\n| Disable text overlay | Turn off the text overlay |\n| Enable standard text overlay | Switch to standard text overlay mode |\n| Disable standard text overlay | Switch off standard text overlay mode |\n| Enable enhanced text overlay | Switch to enhanced prospector overlay mode |\n| Disable enhanced text overlay | Switch off enhanced prospector overlay mode |\n| Enable cargo text overlay | Turn on the cargo status overlay |\n| Disable cargo text overlay | Turn off the cargo status overlay |\n\n\u003e 💡 **Tip:** The VoiceAttack profile contains many more commands including firegroup assignments, status checks, and custom sequences. To see all available commands:\n\u003e 1. Open VoiceAttack and export EliteMining profile\n\u003e 2. Select export → Save Profile to HTML (Quick Reference)\n\n\u003e This generates a complete reference document of all voice commands.\n\n\u003c/details\u003e\n\n[Back to Top](#top)\n\n---\n\n## Mining Presets\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n### Hazardous Mining Preset  \n- **Command:** `\"Set mining configuration for 3 x haz\"`  \n- Pre-configured firegroups, timers, and toggles for HAZ mining.  \n\n### Customization  \n- Create and manage ship presets via the **EliteMining App UI**\n- Adjust firegroups/timers on-the-fly  \n- Modify via built-in commands  \n\n\u003c/details\u003e\n\n[Back to Top](#top)\n\n---\n\n## Usage Tips\n- **Short press** → Starts command  \n- **Long press** → Stops/resets command  \n- Enable **\"Shortcut is invoked when long-pressed\"** in VoiceAttack  \n\n[Back to Top](#top)\n\n---\n\n\n\n## Known Limitations\n- **Only works with in-game keybinds (HOTAS setup manual)**\n- **Works with EDCopilot**\n- **DPI / Resolution changes require restart** — If you change your display DPI scaling or screen resolution, restart EliteMining for the text overlays to render correctly.\n\n\u003e **Note:** VoiceAttack startup warnings about EliteVA plugin bindings are normal due to recent Elite Dangerous changes and can be safely ignored – they don't impact EliteMining voice commands.\n\n[Back to Top](#top)\n\n---\n\n## Training Speech Recognition\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n1. Open VoiceAttack  \n2. Go to **Help → Utilities → Recognition Training**  \n3. Train in a quiet environment  \n4. Backup your speech profile: [SpProfileMgr.zip](https://voiceattack.com/filesend.aspx?id=SpProfileMgr.zip)  \n\n\u003c/details\u003e\n\n[Back to Top](#top)\n\n---\n\n## Community \u0026 Resources\n\n### GitHub\n- **Discussions:** [EliteMining Forum](https://github.com/Viper-Dude/EliteMining/discussions/4)\n- **Bug Reports:** [GitHub Issues](https://github.com/Viper-Dude/EliteMining/issues)\n\n### Help Translate\nWant to help translate EliteMining into your language? See our [Translation Guide](docs/TRANSLATION_GUIDE.md).\n\n**Currently supported:** English, German  \n**Needed:** French, Spanish, Russian, Portuguese\n\n### Discord\nJoin our Discord server for real-time help, mining tips, and community discussions:  \n[![Discord](https://img.shields.io/badge/EliteMining%20Community-Join%20Server-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/5dsF3UshRR)\n\n**Your feedback is always appreciated!**\n\n[Back to Top](#top)\n\n---\n\n## License \u0026 Third-Party Notices  \n\n**EliteMining** © 2024-2026 CMDR ViperDude (Viper-Dude).  \nLicensed under the [GNU General Public License v3.0](LICENSE).  \n\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\n**Third-Party Components:**  \n- **ELITEVA** © 2023 Somfic – MIT License  \n\nFor complete license terms, see the [LICENSE](LICENSE) file in the repository.  \n\n[Back to Top](#top)\n\n---\n\n## Credits  \n- [Somfic](https://docs.somfic.dev/projects/eliteva) – Creator of EliteVA  \n- [Iain Collins](https://github.com/iaincollins/ardent-api) – Developer of Ardent API for Elite Dangerous market data  \n- [EDCD/EDDN](https://github.com/EDCD/EDDN) – Elite Dangerous Data Network for real-time game data  \n- **gOOvER | CMDR Shyvin** – For continued support and contributions to this project\n\n[Back to Top](#top)\n\n---\n\n## FAQ\n\nFor detailed answers to common questions, see our [FAQ page](FAQ.md).\n\n[Back to Top](#top)\n\n---\n\n**Disclaimer:** This project is not affiliated with, endorsed by, or associated with Frontier Developments plc. All trademarks and copyrights are the property of their respective owners.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviper-dude%2Felitemining","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fviper-dude%2Felitemining","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviper-dude%2Felitemining/lists"}