Mining/miner/cuda/README.md
snider 69376b886f feat: Rebrand xmrig to miner and vendor XMRig ecosystem
Complete rebranding of all components:
- Core miner: xmrig -> miner (binary, version.h, CMakeLists.txt)
- Proxy: xmrig-proxy -> miner-proxy
- CUDA plugin: xmrig-cuda -> miner-cuda
- Heatmap: xmrig-nonces-heatmap -> miner-nonces-heatmap
- Go CLI wrapper: miner-cli -> miner-ctrl

Vendored XMRig ecosystem into miner/ directory:
- miner/core - XMRig CPU/GPU miner
- miner/proxy - Stratum proxy
- miner/cuda - NVIDIA CUDA plugin
- miner/heatmap - Nonce visualization tool
- miner/config - Configuration UI
- miner/deps - Pre-built dependencies

Updated dev fee to use project wallet with opt-out (kMinimumDonateLevel=0)
Updated branding to Lethean (domain, copyright, version 0.1.0)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 19:43:02 +00:00

1.5 KiB

xmrig-cuda

This repository contains the CUDA plugin for the XMRig miner, which provides support for NVIDIA GPUs.

This plugin is a separate project because of the main reasons listed below:

  1. Not all users need CUDA support, and it is an optional feature.
  2. CUDA has strict compiler version requirements that may be difficult to meet, unlike CPU mining code, which is generally very flexible.

Windows

  • To download the plugin, you must choose the appropriate CUDA version. Generally, the latest version is all you need, unless you have very old GPUs. Windows builds are available for every major CUDA release. Alternatively, you can build the plugin from the source.
  • Place xmrig-cuda.dll and other dll files near to xmrig.exe.
  • Edit config.json enable the plugin.
{
   ...
   "cuda": {
      "enabled": true,
      ...
   }
   ...
}

Advanced

You can specify the path to the plugin using the loader option.

{
   ...
   "cuda": {
      "enabled": true,
      "loader": "c:/some/path/xmrig-cuda.dll",
      ...
   }
   ...
}

Due to JSON format restrictions, the directory separator must be written in Linux style / or escaped \\.

Linux

Linux usage is almost the same as Windows except we don't provide binaries and you must build the plugin from the source and the name of the plugin is different libxmrig-cuda.so.

macOS

CUDA no longer supports macOS, which means that the plugin also does not support it.