Skip to content
Easiest BTC/LN desktop app, for Windows, macOS, and Linux
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github remove version Feb 11, 2019
AppIcon.appiconset try to add mac icons Nov 26, 2018
node_launcher Retry stopping LND Jul 23, 2019
tests fixing tests and a few tweaks and bugfixes Jun 4, 2019
.gitignore refactor node_set directory structure Apr 18, 2019
AppIcon.icns fix macos icon Dec 13, 2018
LICENSE Add MIT License Jun 3, 2019 Readme Install python3.7-dev - Fix for Issue #378 Aug 11, 2019 enable downloading the latest lnd release Nov 24, 2018 Create and code of conduct Jan 27, 2019
macos.png Update screenshots Apr 1, 2019
requirements-windows.txt Unpin requirements and fix tiny bug Apr 9, 2019
run-windows.spec Fix asset path in spec May 17, 2019 initial commit Dec 21, 2018 Added suggestions and other features to the vision doc Feb 23, 2019
windows.png Update screenshots Apr 1, 2019

User Guides

  1. Please start here!
  2. Send a payment with the Joule Chrome extension


  1. ~300 GB of download bandwidth
  2. ~10 GB of disk space (~300 GB if you want the Bitcoin transaction index, makes for a faster LND)
  3. Windows 7+ or macOS 10.12.6+

Linux works but it is not packaged, follow the developer steps below to run it from the Linux command line.

Please submit a pull request if you want to add Linux packaging! A .deb and .rpm would help grow the Lightning network...


Download and open the latest release for your operating system:

Node Launcher

  1. Creates a node launcher data directory
    • macOS: ~/Library/Application Support/Node Launcher/
    • Windows: %localappdata%/Node\ Launcher/
  2. Finds available ports for Bitcoin and LND, testnet and mainnet
  3. When launched, Bitcoin nodes use the datadir directory specified in bitcoin.conf (or the default data directory)
  4. If you don't have >300 GB of disk space free, Bitcoin nodes will fall back to pruned
  5. Pruning still requires downloading data, so make sure you can handle downloading ~300 GB of data




Review the file

Install Python3.7+

macOS: brew install python3 dbus dbus-glib

Linux: sudo apt install python3.7-venv libdbus-glib-1-dev python3.7-dev

For Windows see

For macOS and Linux:

  1. git clone
  2. cd node-launcher
  3. python3.7 -m venv venv
  4. . venv/bin/activate
  5. pip3.7 install -r requirements.txt
  6. python develop
  7. python


pytest tests

To include tests with network calls to GitHub: pytest tests --run_slow


macOS: pyinstaller run-mac.spec

Windows: pyinstaller run-windows.spec (pyinstaller packaging only works on Windows 7)

Generate LND Bindings

You can’t perform that action at this time.