# Miner

***

### Overview of the Miner Dashboard

Here you can see the **three main tabs** —

* **Assignments** → Manage bulk device assignments and run miners
* **Flightsheets** → Configure pools, wallet addresses, and algorithms
* **Miner Types** → Create or edit miner logic (install, run, stop scripts)

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2Fo7K4XaRjTx6SGUFuiUdt%2FScreenshot%202025-10-24%20174732.png?alt=media&#x26;token=1d62b64a-6f76-4c6c-9c48-8840acc38a1a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FuACZMjJJqKzYmg6qkfjT%2FScreenshot%202025-10-24%20175538.png?alt=media&#x26;token=2e1570f3-e911-490f-a50e-545bf080beef" alt=""><figcaption></figcaption></figure>

> The **Assignments tab** shows connected devices ready to be assigned to bulk mining sheets. Each device displays its model, IP, and connection type.
>
> Note: Greyed out bulksheets as shown in the image above simply mean the device is not connected to the manager software.

***

### Creating a New Flightsheet

A **Flightsheet** defines how your miner runs — including algorithm, pool URL, wallet address, and thread count.

<div><figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2Fcx3ZVtjGaNitDoUPcASc%2FScreenshot%202025-10-24%20175635.png?alt=media&#x26;token=edb75cc8-49da-4713-ac20-845d0d58ce17" alt=""><figcaption></figcaption></figure> <figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FwVimOzcn35eorpn291qF%2FScreenshot%202025-10-24%20174938.png?alt=media&#x26;token=48d3b660-13dc-46db-b79c-3292cbc43677" alt=""><figcaption></figcaption></figure></div>

> Example of creating a **Solo BTC Flightsheet**, defining miner type, pool, wallet, and other configuration details.

***

### Managing Bulksheets

Each **Bulksheet** is a collection of devices running the same Flightsheet.\
You can create multiple bulksheets for different coins or miner types.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FIdpPYyej31GTgSm4m4SW%2FScreenshot%202025-10-24%20182451.png?alt=media&#x26;token=88be5b6c-4b5d-413f-a84d-c22c15f1b02f" alt=""><figcaption></figcaption></figure>

> All available devices are listed at the top. You can drag and drop devices into a new Bulksheet or hold Ctrl/Cmd to duplicate them across multiple sheets.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FuACZMjJJqKzYmg6qkfjT%2FScreenshot%202025-10-24%20175538.png?alt=media&#x26;token=2e1570f3-e911-490f-a50e-545bf080beef" alt=""><figcaption></figcaption></figure>

> Example of configured bulksheets for BTC, Verus, Virel, and more — each containing 20 devices.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FZj4hybSCxbwx8fMmJBIh%2FScreenshot%202025-10-24%20182606.png?alt=media&#x26;token=3c3f7fa6-a867-4d1f-acfd-b6c3b4a45e63" alt=""><figcaption></figcaption></figure>

> Use the 3-dot menu to install miners, install Termux, uninstall, or duplicate bulksheets. You can install miners on all 20 devices simultaneously.

***

### Miner Types

The **Miner Types** tab lets you edit or create miner logic —\
Each miner has **Install**, **Run**, **Stop**, and **Uninstall** scripts, typically written in Python.\
(Must setup Miner Types first for any of the flightsheet,running,bulksheets to work)

{% hint style="success" %}
Our Pre-Made Miner Types Require you to have python path setup in the Settings Page
{% endhint %}

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2Fv6nUMYRYCU5TgxOcbijZ%2FScreenshot%202025-10-24%20175652.png?alt=media&#x26;token=eb7a15cd-f57e-4da1-a5da-73db74a0a3e8" alt=""><figcaption></figcaption></figure>

> Use **CH Miners** to quickly import ready-to-use miner templates from CellHasher’s GitHub.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FI5QsDnGcq0ux566X5vqg%2FScreenshot%202025-10-24%20183419.png?alt=media&#x26;token=7ec4bb30-c6d8-47f8-b52e-edde04f2393b" alt=""><figcaption></figcaption></figure>

> Example: Editing a Bitcoin miner type. You can customize commands, add dependencies, and manage install logic. Note, you do not need lines 4-8 in the install script, but do want them in the (Run Script) if you make your own script, this communicates with our environment flight sheets.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FDRkOvDDc9z2RhlVczj3M%2FScreenshot%202025-10-24%20183339.png?alt=media&#x26;token=66055f67-df2c-4576-aa0b-8477edf1fb7c" alt=""><figcaption></figcaption></figure>

> Creating a new Miner Type from scratch — includes a Python script template ready for custom miner logic.

***

### Troubleshooting & Repair Tools

Sometimes, when installing miners on multiple devices, one or two may fail due to mirror errors or slow internet.&#x20;

(Troubleshoot Button is located at the top of the Miner page.)

\
Use the **Automated Repair Tool** instead of reinstalling manually.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FTBSVS3brqQanhjYBH2cL%2FScreenshot%202025-10-24%20183633.png?alt=media&#x26;token=6147c5f9-bfbf-47b3-ba9f-05711050e5c9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FozocOGsCwoaBtvVDuzGv%2FScreenshot%202025-10-24%20181013.png?alt=media&#x26;token=08a68cb3-852d-469e-abb9-0d9aa5eb6629" alt=""><figcaption></figcaption></figure>

> The **Troubleshoot Tab** includes a “Try Our Repair Tool” button for automated fixes.

***

### Step-by-Step: Begin Mining

1. **Install First** → Ensure the latest version of CellHasher is installed.
2. **Set Up Flightsheet** → Add your wallet, pool, and miner type under *Flightsheets*.
3. **Assign Devices** → Go to *Assignments*, drag devices into your preferred Bulksheet.
4. **Install Miner** → Click the 3-dot menu → *Install Miner (All)*.
5. **Run the Bulksheet** → Once installed, hit *Run* to start mining.
6. **Monitor Progress** → Use *Detached Mirror Window* to view screens, or use **v0.3** for low-end mirror-only control.
7. **(Optional)** Multi-task → With *wake-locks* enabled, miners can run while you use apps like **Grass** or **Acurast**.
8. If a Miner doesn't install its more than likely okay, just need to clear it on the device the uninstall script, select the devices you want to run it on in the Bulksheet, open the 3 dots menu and uninstall the miner/install the miner, use the repair tool as well if needed.

***

### Setting Up Your Miner Scripts

Each miner has **Install**, **Run**, **Stop**, and **Uninstall** scripts that define how it behaves on your devices.\
When writing these scripts, always include the system environment variables so your miner automatically receives configuration data from your Flightsheets.

**Base variables:**

```python
ADB = os.environ.get("adb_path", "adb")
devices = os.environ.get("devices", "").split()
wallet_address = os.environ.get("wallet_address", "")
pool_url = os.environ.get("pool_url", "")
threads = os.environ.get("threads", "8")
algorithm = os.environ.get("algorithm", "")
password = os.environ.get("password", "")
additional_flags = os.environ.get("additional_flags", "")
```

**For XMRig miners, also add:**

```python
cpu_max_threads_hint = os.environ.get("cpu_max_threads_hint", "")
xmrig_algorithm = os.environ.get("xmrig_algorithm", "")
custom_flags = os.environ.get("custom_flags", "")
```

These are automatically injected from your **Flightsheets** whenever you install or run miners, allowing fully dynamic setups without modifying your code.\
The install script usually prepares Termux and downloads dependencies, while the run script executes your miner with the provided pool, wallet, and thread count.

<figure><img src="https://740728927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyHs71H35gSuLlkbdhdKs%2Fuploads%2FUG0JSWp0vMxtKzBKTwd1%2FScreenshot%202025-10-24%20183947.png?alt=media&#x26;token=f266fca9-08dc-49be-955e-9aded49c76e5" alt=""><figcaption></figcaption></figure>

> Example: ADVC miner type showing environment-driven install logic in Python.

### Advanced Features

* Create **custom miner types** with Python logic
* Import **CH Miners** from GitHub
* Edit, duplicate, or delete existing flightsheets
* Install or repair Termux automatically
* Use the **Repair Termux (pkg cache)** tool from the Scripts page if any installation fails
