Installation

Requirements


Electrum	{{ bal.electrum_latest }} (last stable release tested)
Platform	Desktop — Linux, Windows, macOS
License	MIT
Wallet type	Standard seed-based single-signature, or a hardware wallet. See Compatibility.

Install Electrum first, from the official site electrum.org, and verify its signature as you normally would.

1. Download the plugin

Get the latest release from the plugin releases page.

!!! tip "Verify the archive" Check that the zip's SHA-256 matches the value printed by build_zip.py. If you built the zip yourself from source, compare it against the published release.

2. Install it in Electrum

{ .screenshot } Electrum → Tools → Plugins.

BAL is an external plugin, so it is added from a .zip file:

Open Electrum and go to Tools → Plugins.
Internal plugins are listed in the dialog — you toggle their checkbox to enable or disable them.
External plugins such as BAL are imported from .zip files with the Add button in the plugins dialog.
Some plugins (hardware wallets) are enabled automatically when you create or restore a hardware wallet.

{ .screenshot } Selecting the plugin archive.

First-time setup: the plugin authorization password

The first time you load any external plugin, Electrum asks you to set a plugin authorization password. Two things to know about it:

It is independent of your wallet password, and it can be reset if you forget it.
Setting it requires administrator (root) permissions, because Electrum writes a password-derived public key into the system. On later startups that key lets Electrum verify the plugin's authenticity without asking you for the password again.

!!! info "Why administrator permissions are needed" This is an Electrum security measure, not something specific to BAL. The elevated permissions are what stop malware from silently installing or modifying plugins, or from tampering with the stored key. External plugins can only be enabled by someone who can enter that password — so a piece of malware running as your normal user cannot enable one behind your back.

Full details: [plugins.electrum.org](https://plugins.electrum.org/)

3. Enable and restart

Tick Bitcoin After Life in the plugin list, then restart Electrum.

{ .screenshot } The plugin enabled and ready.

4. Check that it loaded

After restarting you will see two new tabs in the Electrum window: HEIRS and WILL.

{ .screenshot } HEIRS is where you define who inherits; WILL shows the technical state of your inheritance transactions.

Next: create your first will.

Platform-specific notes

Step-by-step installation notes for specific platforms are kept in their own repositories:

More on Electrum plugins

For how Electrum's plugin system works in general — internal vs external plugins, the authorization password, and the plugin directory — see the official reference: plugins.electrum.org

3.7 KiB Raw Blame History