I have been getting more requests asking how to use BTCRecover on a Mac, so I picked up an Apple Silicon M1 Mac Mini and ran through the whole setup from a fresh macOS install. The goal was simple: get BTCRecover working in a way that is as native and practical as possible for Mac users, then see what kind of performance you can expect from M1 hardware.
In this article, I will cover how to download BTCRecover, install Homebrew, set up the correct Python version, add the required dependencies, run the tests, and do a quick Solana wallet seed recovery demo where one mnemonic word is missing. I also include performance notes comparing the M1 Mac Mini with an Intel i7 desktop, plus an important macOS power setting you should change before running long recoveries.
Compatibility note
For this installation path, I am using macOS Monterey 12.2 on a Mac mini with an Apple M1 chip and 8 GB of memory. You should make sure you are running at least this macOS version before following the steps below.

The procedure should be broadly similar whether your Mac uses Intel or Apple Silicon, but I want to keep this as Mac-native as possible. In the video, I even use a Magic Keyboard and only one mouse button, so I am relying on the control-click menu instead of a right-click.
Download BTCRecover from the documentation
The first thing you need is the latest BTCRecover source code. Open the BTCRecover documentation in your browser and go to the installation page for macOS.

Follow the instructions on the documentation page. The first step is downloading the latest BTCRecover from the master branch. In my case, Safari automatically unzipped the downloaded archive into a folder called btcrecover-master in Downloads. This can save you a manual unzip step compared with some other platforms.

Open Terminal at the BTCRecover folder
Before running any commands, open a terminal window directly inside your btcrecover-master folder. This makes it easier to run the installation and test commands later without typing long paths.
Open Finder, go to Downloads, locate btcrecover-master, then control-click the folder and choose New Terminal at Folder.

You should now have a terminal prompt open inside that directory.
Install Homebrew
On macOS, you need to install the Homebrew package manager before installing Python and other build requirements. You can copy the command from the BTCRecover documentation or use the installation command shown on the Homebrew website.

Paste the command into your terminal and press Enter. You will be asked for your account password. As you type it, nothing appears on screen; that is normal. If your Mac account does not have administrator access, this step will not work properly.
After Homebrew finishes installing, pay attention to the “Next steps” output. You need to run the commands shown there to add Homebrew to your shell path. Otherwise, some later commands may fail because macOS cannot find brew.

After running those commands, typing brew should work correctly in a new terminal session or after the shell profile is applied.
Install Python and Coincurve build requirements
Go back to the BTCRecover documentation for macOS. The next step installs some build requirements for Coincurve, and it also installs the Python version you need.
Copy the documented command into your terminal and run it. This command is needed regardless of which wallet type you plan to use. There may be additional modules for other wallets, but this is the base starting point.

If you want to use any of the graphical interfaces in BTCRecover, you also need tk. Install it using the documented command shown on the page.

Use the exact Python version installed by Homebrew
This is one of the most confusing parts of macOS: there can be multiple Python versions available on the same machine.
If you type just python, it may run an older Python version that you do not want. If you type python3, it may run the Python bundled with macOS, which also is not the one you installed through Homebrew.
You need to use the exact Python command that matches the Homebrew-installed version. In this example, that means using python3.9 for commands such as:
pip3.9 install -r requirements.txt
python3.9 run-all-tests.py -vv
python3.9 seedrecover.py
The exact Python version number may change over time, so always check which version Homebrew installed and use that specific command. If you are unsure, you can inspect the location of each Python command to confirm whether it is coming from your system folders or your Homebrew folder.

Install BTCRecover base requirements
Once you have the correct Python command, return to the btcrecover-master directory and install the base requirements:
pip3.9 install -r requirements.txt
This downloads and builds the packages needed for the core BTCRecover setup.
Run the tests after installation
After installing the base requirements, run the test suite:
python3.9 run-all-tests.py -vv
You want to see a lot of green passing results. If you try running the tests with the wrong Python version, such as the built-in macOS python3, some tests may fail with confusing error messages. In the video, I showed both what can go wrong and what success looks like after using the correct Homebrew-installed Python.

When the installation is correct, the tests should pass cleanly.

Install full requirements for broader wallet support
If you only need Bitcoin or a small set of wallets, the base requirements may be enough. But if you want to work with many different altcoin wallets without figuring out each extra package yourself, install the full requirements:
pip3.9 install -r requirements-full.txt
This installs basically everything BTCRecover needs for the supported wallet types. After that, run the tests again:
python3.9 run-all-tests.py -vv
You should see most of the optional wallet tests pass. Some OpenCL-related entries may be skipped if you are not using that setup.

Quick Solana missing-word recovery demo
Once BTCRecover is installed, running seedrecover.py works similarly to other operating systems:
python3.9 seedrecover.py
You can choose the wallet file type, enter the address or account details you are trying to recover, and provide the mnemonic words you have. In the demo, I used a Solana wallet test case with one missing word from the mnemonic. Because only one word was missing, BTCRecover found the correct seed almost instantly and identified the missing word.
This is the kind of recovery I do often: someone has most of their mnemonic phrase but is missing one or more words, and BTCRecover can narrow down the possibilities using the wallet address or account data.
M1 versus Intel i7 performance
After running a test recovery on the M1 Mac Mini, I checked Activity Monitor to confirm that the Python processes were running natively as ARM64 code. That means the system is not falling back to an older translation layer; it is using the Apple Silicon architecture directly.

For a 12-word seed test, the M1 Mac Mini was sitting around 67,000 passwords per second. For comparison, a 10th generation Intel i7 desktop achieved close to 90,000 passwords per second on the same type of task.

For a 24-word seed test, the M1 Mac Mini ran at about 365,000 passwords per second, while the i7 desktop was just over 400,000 passwords per second. That is impressive for what is essentially a mobile-class chip coming close to a high-end desktop CPU.

I also tried PyOpenCL in this setup, but it did not behave well. Your best bet on this Mac configuration is usually not to install PyOpenCL unless you have a specific reason and know how to troubleshoot it.
Disable low-power behavior during long recoveries
One important thing I noticed: once the display sleeps on these M1 Macs, performance can drop significantly because macOS moves into a lower-power state. For long recovery runs, this is not what you want.
Open System Preferences, go to Energy Saver, and check the option that prevents your Mac from automatically sleeping when the display is off.

Your Mac will use more energy in this situation, but for a serious recovery run that can take hours or longer, maintaining consistent CPU performance matters. If you are running on a system where you can simply turn off the physical monitor, or if you are using a headless setup, you may also set “Turn display off after” to never. In most cases, though, the sleep prevention setting above should be enough.
Security reminder: run recoveries offline
This is the big disclaimer I always give when talking about recovery tools like BTCRecover: run your system totally offline while handling private keys and mnemonic words.
macOS may often be a more secure environment than Windows, but that is not an excuse to let your guard down. Do not enter seed phrases or handle sensitive wallet data on an internet-connected machine unless you have a very strong reason and know the risks. For recovery work, offline is much safer.
If you get stuck anywhere along the way, I would love to hear about it in the comments. If you have performance numbers from another Apple Silicon setup, such as an M1 Pro or newer Mac, please share them so we can build a better picture of what different machines can do. And if you are completely stuck and need one-on-one help with lost funds or wallet recovery, you can see more about paid private sessions here: recovery services and consultations.
Conclusion
Getting BTCRecover running on macOS is straightforward once you follow the documentation carefully. The main things to remember are:
- Use a recent macOS version, such as Monterey or newer for this path.
- Install Homebrew first and add it to your PATH.
- Install the documented Python and Coincurve build requirements.
- Use the exact Homebrew-installed Python command, not generic
pythonor systempython3. - Run the tests after installing base requirements.
- Install full requirements if you need broader altcoin wallet support.
- Prevent macOS from entering low-power mode during long recovery runs.
The M1 Mac Mini delivered strong native ARM64 performance and came close to a high-end Intel desktop in these seed-recovery tests. For many people, that makes it a practical machine for running BTCRecover, as long as you configure the power settings correctly and keep your system offline while working with sensitive wallet data.
Questions from viewers
Common questions from the comments on this video, with my answers.
I installed Homebrew but I don't see the 'Next steps' message telling me to add it to my PATH. Do I need to run those commands?
On many modern macOS systems, Homebrew is added to your path automatically. You can test this by simply typing `brew` in your terminal. If it returns a list of commands (like `brew search`, `brew info`, etc.), then it is already working and you do not need to manually add it to your path. Just proceed with the rest of the installation process.
When I run seedrecover.py, I get an error saying 'Unable to load TK, no gui available'. How do I fix this?
This warning appears because the Python environment doesn't have the Tkinter library installed, which is needed for the graphical interface. You need to install TK using pip (e.g., `pip3.9 install tk`). Once installed, the GUI should load correctly. If you prefer not to use the GUI, you can set the recovery arguments manually via command line flags instead.
I am getting a 'FileNotFoundError' for './derivationpath-lists/ETH.txt' or similar files when running the script. What is wrong?
This usually means you are not running the command from within the main BTCRecover folder where you extracted the repository, or the file was not downloaded/unzipped correctly. Make sure you are in the correct directory and that you haven't renamed any files. If the issue persists after re-downloading, ensure you are following the exact process shown in the video without modifying file names. If you’d like hands-on help, see wallet recovery services.
Can I recover a wallet if I have lost all of my seed words?
No. If you are missing all of the seed words, you cannot recover the seed. It is mathematically impossible; trying to brute-force a full seed phrase would take over a billion years (more like 10^30). You must have at least some of the words to perform a recovery.
I have a wallet.dat file from an old Bitcoin Core wallet (pre-mnemonic era) and the password. Can BTCRecover help me access it?
BTCRecover is primarily for mnemonic seeds. However, if you have the wallet.dat file and the password, you don't necessarily need BTCRecover. You can either dump the private keys directly from the wallet file or import the wallet.dat into a current version of Bitcoin Core to access your funds.
My recovery was working fine for months, but now I'm getting a 'ModuleNotFoundError: No module named Crypto'. What happened?
Something has changed in your Python environment, possibly due to updating Python or installing other software that conflicts with the libraries. The best fix is to reinstall all the requirements for BTCRecover. In some cases, re-downloading the master branch and extracting it over the previous folder has resolved these environment conflicts.
Stuck with a wallet recovery?
I maintain BTCRecover and have helped people recover seed phrases, passphrases and wallet passwords since 2019. Book a one-hour video session and I’ll walk you through doing the recovery yourself, without sharing your seed. Or, if you’d rather I run it, a trusted recovery is charged only if it succeeds.
Private sessions: US$100 per hour. Trusted recovery: 10% of recovered funds. I never contact people first and will never ask for your seed phrase over chat or email.
Found this useful?
These guides are free and ad-free. You can support them by sharing them, subscribing on YouTube, or sending a tip.







