Skip to content

michaelWuensch/BitBanana

Repository files navigation

BitBanana

Screenshot of BitBanana app

GitHub license Translated GitHub Release

⚡️ Superpowers for you and your bitcoin lightning node! Use and manage your node wherever you are. ⚡️

BitBanana is a native android app for node operators focused on user experience and ease of use. While it is not a wallet on its own, BitBanana works like a remote control allowing you to use your node as a wallet wherever you go.
The app is designed with an educational approach, providing the user with guidance on every aspect of node operation.

BitBanana forked from Zap Android. You can find more information about this on the Rebranding page.

Getting started

The easiest way to get started is using Start9 or Umbrel to run LND or Core Lightning on a raspberry pi and then connect BitBanana to that node. There are of course a lot more possible ways to run a node, so please refer to the setup section in the Wiki if you need help to get started.

Get it on F-Droid Get it on Google Play

Or download the latest APK from the Releases Section.

Features

General

  • Connect to remote lightning nodes (LND, Core Lightning & LndHub)
  • Available in many languages
  • Explanations and help across the app
  • Convenient VPN automation
  • And of course, BitBanana is Bitcoin only!

Node Management

  • Use your node as a lightning wallet wherever you are
  • Manage multiple nodes
  • Manage peers
  • Manage channels
  • Manage routing fees
  • Routing summary
  • Manage watchtowers

Wallet

  • 100% free. The only fees you pay are to the bitcoin network. BitBanana won't charge you a single sat.
  • Send & receive on-chain and off-chain
  • Contacts (with Avatars)
  • Send funds to lightning addresses (email like addresses)
  • Send funds without an invoice (keysend)
  • Bolt 12 support (Core Lightning only)
  • NFC support
  • Transaction filters
  • BTC, mBTC, bit & Satoshi units
  • Fiat currency prices
  • Support for SegWit & Taproot
  • Sign/Verify
  • LNURL support (pay, withdraw, auth, channel)

Security & Privacy

  • 100% Self-custodial
  • 100% open source code with reproducible releases
  • ZERO data collection
  • Tor support
  • PIN protected access
  • Scrambled PIN by default
  • Stealth mode (hide app)
  • Hide balances
  • User guardian system (BitBanana warns you when you are about to perform a potentially dangerous or privacy leaking action)
  • Supports self-hosted block explorers
  • Supports self-hosted exchange rate providers
  • Supports self-hosted fee estimation providers
  • Protection against screen recording

Security

If you discover or learn about a potential error, weakness, or threat that can compromise the security of BitBanana, we ask you to keep it confidential and submit your concern directly to the BitBanana developer.

Self-custodial

BitBanana is fully self-custodial. When using the app there is absolutely no interaction with any BitBanana team or service. We do not even know you are using our app.

Get Help

If you are having problems with BitBanana, please report the issue in GitHub or on discord with screenshots and/or how to reproduce the bug/error.

Contribute

Hey! Do you like BitBanana? Awesome! We could actually really use your help!

Open source isn't just writing code. You can help BitBanana with any of the following:

  • Donate
  • Drop a star on github
  • Share a positive review and rate the app in the app store
  • Tell your friends about it
  • Translate the app using Weblate
  • Find and report bugs, Open an issue
  • Suggest new features
  • Provide support to fellow users on BitBanana's discord
  • Contribute to our documentation
  • Review pull requests
  • Fix bugs, implement new features

If you would like to contribute to the project code, please see the Contributing Guide

If you want to setup a testing environment, please see the Regtest Guide

Build

If you want to build the app yourself take a look at the Installation Guide

Verify/Reproduce

BitBanana is reproducible.
You want to verify that the app distributed in the app store is actually built from the source available here on github?
See these reproduce instructions.

Maintainers

License

This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. See LICENSE for more information.

MIT © Jack Mallers, Michael Wuensch