Offline Bitcoin ATM
===================

A Bitcoin ATM (coins only) with Lightning Network support, running **fully
offline** on an ESP32. It accepts physical euro coins through a coin acceptor,
generates an LNURL-withdraw QR code locally — no internet connection required for
operation — and shows it on an e-paper display for the user to scan with any
Lightning wallet.

The Lightning Network is a second-layer protocol on top of Bitcoin that enables
trustless transactions with instant settlement and cheap fees.

.. tip::

   **Just want to flash a device?** Open the
   `Web Flasher <https://f321x.github.io/offline-bitcoin-atm/>`_ in Chrome or
   Edge, connect your ESP32 over USB, and click *Install Firmware* — no tools to
   install. See :doc:`firmware/web-flasher` for details.

Where to start
--------------

- **Building one from scratch?** Start with the :doc:`bill-of-materials`, then
  follow :doc:`hardware/index` and :doc:`firmware/index`.
- **Already assembled the hardware?** Jump to :doc:`firmware/index` and
  :doc:`configuration`.
- **Want to print a case?** See :doc:`3d-printing/index`.
- **Hacking on the firmware?** See :doc:`development/index`.

.. toctree::
   :maxdepth: 2
   :caption: Getting Started

   introduction
   bill-of-materials

.. toctree::
   :maxdepth: 2
   :caption: Building the ATM

   hardware/index
   3d-printing/index

.. toctree::
   :maxdepth: 2
   :caption: Firmware & Setup

   firmware/index
   configuration

.. toctree::
   :maxdepth: 2
   :caption: Extras

   companion/telegram-bot

.. toctree::
   :maxdepth: 2
   :caption: Development

   development/index
   development/building-and-testing
   contributing