
BTCRecover Install on MacOS (Python 3) & Enable GPU Acceleration + Demo Bitcoin Wallet Seed Recovery
Audio Summary
AI Summary
This video provides a detailed guide on installing and running BTC Recover on macOS, emphasizing the Mac Mini with Apple Silicon as an ideal dedicated, secure, and offline device for this purpose. The presenter, who frequently assists with wallet recoveries, advocates for a separate machine to run BTC Recover offline for extended periods, highlighting the Mac Mini's cost-effectiveness, performance, low noise, and power efficiency.
The tutorial begins by directing viewers to the BTC Recover documentation website (btc-recover.readthedocs.io) and advises following the written instructions, as they are more easily updated than video content. The initial step involves downloading BTC Recover from its GitHub repository. Once downloaded, users are instructed to locate the BTC Recover folder in their Finder, then use a control-click to open a new terminal window within that directory. This terminal will be used for all subsequent BTC Recover operations.
A crucial part of the installation process on macOS is ensuring Python 3 is installed correctly. The presenter stresses that macOS does not come with Python 3 by default, and simply typing "python3" in the terminal might prompt an installation of an older, problematic version. Therefore, the recommended method is to install Python 3 using Homebrew, a package manager for macOS. The transcript outlines the specific Homebrew commands to execute, noting that this process may take several minutes and require the user's account password. After the Homebrew installation, it's essential to run subsequent commands to configure the shell to recognize the Homebrew-installed Python 3 as the default. A check using `which python3` confirms the correct installation.
The guide also touches upon the necessity of a Rust installation for certain wallet recovery scenarios. After installing Rust, the presenter observed that the shell might revert to using the older, system-installed Python 3. To rectify this, it's recommended to close and reopen the terminal window to ensure the Homebrew Python 3 is still the active version.
For installing the Python requirements for BTC Recover, two options are presented: essential requirements for basic recoveries (like Bitcoin or Ethereum) and full requirements for more complex or obscure wallet types. The tutorial opts for the extended wallet support. On macOS, specific export commands are necessary before installing these requirements to prevent build failures. The presenter emphasizes the need to include a space and the "break system packages" argument in the command to avoid errors. Once these prerequisites are met, the installation of all Python packages can proceed.
The video then introduces the exciting development of GPU acceleration on Apple Silicon for BTC Recover. Viewers are directed to the `pyopencl` installation page, with a disclaimer that performance gains will vary significantly based on the wallet type, CPU strength, and the system's GPU. The installation process on macOS is described as similar to Windows, involving a `pip3 install pyopencl` command with the same "break system packages" argument. The presenter shares personal findings, noting a substantial acceleration (around 10x) for Bitcoin Core recoveries on an M1 Mac Mini when using GPU acceleration, but less so for BIP 39 wallets due to Apple Silicon's strong CPU performance relative to its GPU.
After all requirements are installed, the tutorial demonstrates how to run all tests using `python3 run_all_tests.py -vv`. During this process, macOS may prompt for permission to access the Downloads folder, which should be allowed. A successful test run will display a series of green "ok" messages. The presenter reiterates that while the installation process differs across operating systems, the usage of BTC Recover remains consistent.
Examples of using BTC Recover are provided, including both its graphical interface and command-line options. For the graphical interface, users can select the wallet type and input details. For command-line usage, the presenter shows how to adapt examples from the documentation, specifically by changing "python" to "python3" in the commands. These examples are designed for quick copy-pasting to verify functionality and serve as a starting point for specific recovery needs.
A critical tip for macOS users performing long recoveries is to adjust system settings. Users should navigate to System Settings > Energy and select "prevent automatic sleep when display is off." Failing to do so will cause BTC Recover to slow down significantly when the screen saver activates or the display turns off.
The most critical piece of advice is about security. Once BTC Recover is installed and ready for use, the Mac system **must be taken offline**. This involves unplugging the network cable and disabling Wi-Fi before entering any recovery phrases. The system should remain offline until the wallet is successfully recovered and funds are moved to a new seed phrase. This measure is crucial to prevent any malicious software on the device or potentially downloaded during the installation process from compromising the recovery. The presenter strongly advises against cutting corners on this security step.
In conclusion, the video acknowledges that installing BTC Recover on macOS can be a bit intricate but is achievable by following the steps. The Mac Mini is re-emphasized as the ideal hardware for this task due to its offline capabilities, speed, efficiency, low heat output, and the convenience of being pre-assembled. For those who find the installation process too daunting, the presenter offers private consultations and trusted recovery services, with free support available in the YouTube comments for general questions. The video ends with a call to like, subscribe, and leave comments for future content and questions.