Download code from esp32 using ampy

Here is a bash script which downloads all the content present in your esp32 folder flashed with micropython

#!/bin/bash
# Recursive downloader using ampy (duplicate path bug fixed)

PORT="/dev/ttyACM1"
BACKUP_DIR="./esp32_backup"

normalize_remote() {
    # Ensure leading / and collapse multiple slashes
    echo "/$1" | sed 's#//*#/#g'
}

download_recursive() {
    local remote_path=$(normalize_remote "$1")
    local local_path="$2"

    mkdir -p "$local_path"

    # List contents of the current remote path
    for entry in $(ampy --port $PORT ls "$remote_path" 2>/dev/null); do
        entry=$(echo "$entry" | tr -d '\r')

        # `ampy ls` already returns full path → don’t join twice
        local remote_item=$(normalize_remote "$entry")

        # Strip leading / for local mirror
        local rel_item="${remote_item#/}"
        local local_item="$BACKUP_DIR/$rel_item"

        echo "🔍 Checking $remote_item ..."

        if ampy --port $PORT ls "$remote_item" >/dev/null 2>&1; then
            echo "📂 Entering directory: $remote_item"
            download_recursive "$remote_item" "$(dirname "$local_item")/$(basename "$remote_item")"
        else
            echo "⬇️  Downloading $remote_item → $local_item"
            mkdir -p "$(dirname "$local_item")"
            if ! ampy --port $PORT get "$remote_item" "$local_item"; then
                echo "⚠️ Failed to download $remote_item"
            fi
        fi
    done
}

echo ""
echo "📥 Downloading all files and folders from ESP32 to $BACKUP_DIR ..."
echo ""

download_recursive "/" "$BACKUP_DIR"

echo ""
echo "✅ Download complete."

just change the PORT variable on top of the file to your port of esp32, thats it.

Get Shoubhik Saha’s stories in your inbox

Join Medium for free to get updates from this writer.

Remember me for faster sign in

it will download the entire file folder structure in a new directory name esp32_backup

before running this script you should have installed the ampy in your linux machine.

pipx install adafruit-ampy