Skip to content
This repository was archived by the owner on Apr 22, 2025. It is now read-only.

Installation

Jump to bottom
Spooks edited this page Nov 6, 2024 · 4 revisions

Installation Guide

This guide provides detailed instructions for installing GhostESP firmware on your ESP32 device.

Prerequisites

Before starting, ensure you have:

  • A compatible ESP32 board (see Supported Hardware)
  • A modern web browser (Google Chrome recommended, as Firefox doesn’t support WebSerial)
  • Appropriate USB cable (Micro USB or USB-C, ensure it's a data cable, not a charge-only cable)
  • Internet connection for downloading firmware
  • If using a Flipper Zero, ensure it has the latest firmware for compatibility

Note: For best results, disable any VPN or firewall that might block the flashing process, as some network configurations may interfere with the web flasher.

Flashing Methods

Choose your preferred method:

Web Flasher Method

  1. Prepare for Flashing

    • Visit Spooky Tools Web Flasher
    • If the site doesn’t load correctly, clear your browser cache and try again.
    • Use Google Chrome as Firefox does not support WebSerial.
    • Ensure your ESP32 is disconnected from other software or tools to avoid port conflicts.

  2. Enter Bootloader Mode

    • Most boards: Hold the boot button while connecting the USB cable to your computer.
    • Boards without a USB-UART: Follow the special instructions in the tutorial video for alternative flashing setups.
    • Once in bootloader mode, connect to your PC.

  3. Flash Process

    • Select your board type from the dropdown menu on the flasher site. If you're unsure of your specific model, the generic ESP32 version will work for most boards.
    • Follow the on-screen instructions to initiate flashing.
    • Wait until the process is complete, and verify that the firmware boots correctly.

Tips: After flashing, you may need to restart the device to initialize the new firmware. To ensure a clean start, disconnect and reconnect your ESP32.

Flipper Zero Method

  1. Download Required Files

    • Obtain the latest Ghost ESP .fap file from this link.
    • Download the latest firmware files from GitHub for the GhostESP project.

  2. Transfer Files

    • Place the .fap file and firmware files onto your Flipper Zero in the following path: 
      SDCard/apps/gpio/esp
    • Important: Ensure the .fap file is placed in this folder for correct functionality.

  3. Connection

    • Enter bootloader mode on your ESP32 as described above.
    • Connect your ESP32 to the Flipper Zero using the GPIO header.

  4. Flashing Process

    • Open the ESP flasher app on your Flipper Zero.
    • Select Manual Flash to flash each firmware component.
    • Reset your ESP32 after completion to finalize installation.

Note: The Flipper Zero app requires the latest version to fully support GhostESP. Check the Flipper Zero GitHub or community forum for any compatibility updates.

Post-Installation

After flashing, you have several control options to configure and interact with GhostESP.

Control Options

  1. Web Interface

    • Open a browser and connect to either ghostesp.local or 192.168.4.1 to access device settings.
    • Use the auto-updating configuration panel to manage settings, Evil Portal controls, and device info.

  2. Qt6 Control App

    • Download and install the Qt6-based desktop application for more advanced control options.
    • Offers access to advanced features, customizable settings, and an improved interface for interacting with GhostESP.

  3. Serial Command Line

    • Connect via a serial interface for direct command-line control.
    • Provides full access to GhostESP’s command suite and is ideal for advanced users or troubleshooting.

  4. Flipper Zero App

    • Control GhostESP directly from the Flipper Zero.
    • Ensure you have the latest .fap version on your Flipper Zero for full functionality and access to features like Evil Portal, Wi-Fi control, and more.

Common Installation Issues

Refer to the Troubleshooting page for solutions to common issues:

  • Boot loops: Check your board model and USB cable for compatibility.
  • Flash errors: Ensure you are in bootloader mode, and try a different USB port if flashing fails.
  • Connection issues: Ensure proper drivers are installed, especially on Windows.
  • Power supply problems: Use a stable USB power source to avoid disconnection during flashing.
  • Cache-related issues with the web flasher: Clear your browser cache or try a different browser if problems persist.

Troubleshooting Tip: For the Flipper Zero method, ensure the GPIO connections are secure, and the .fap file is correctly placed in SDCard/apps/gpio/esp.

Clone this wiki locally