# hypriot/flash

Command line script to flash SD card images of any kind

Repository: https://github.com/hypriot/flash
Canonical: https://ross.abutalabs.com/products/hypriot-flash
Language: Shell
License: MIT
License Family: permissive
Topics: sd-cards, flash, raspberry-pi, card-reader, sd-card-image, wifi-settings, hypriot-os, hypriot-flash
Last push: 2022-06-06T09:48:11+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4179, "days_push": 1549, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1016, forks 167 (observed 2026-08-28T04:03:14.526933+00:00)

## What it is
A command-line shell script for flashing SD card images (compressed or uncompressed, local or remote) onto SD cards, primarily for Raspberry Pi devices. It can also customize the flashed card with hostname, WiFi settings, and cloud-init files copied into the boot partition.

## Use cases
- flash a raspberry pi os image to an sd card from the command line
- download and flash a compressed sd card image from a url
- set hostname and wifi credentials on a raspberry pi sd card before first boot
- copy cloud-init user-data onto a flashed sd card boot partition
- wait for an sd card to be plugged in and flash it automatically

## When to choose
- you flash Raspberry Pi or similar SBC images regularly from Linux or macOS
- you want to preconfigure hostname, WiFi, or cloud-init files during flashing
- you prefer a lightweight script over GUI tools like Raspberry Pi Imager or Etcher

## When to avoid
- you are on Windows, which is not supported
- you need a graphical flashing tool
- you need actively maintained software - the latest release is from 2022

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, developer-tools, file-system
- domain: developer-tools, iot, embedded-systems
- platform: cli
- tags: sd-card, raspberry-pi, disk-imaging, shell-script, cloud-init, hypriotos, command-line, linux, macos

## Member repositories
- hypriot/flash (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:14.526933+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:11:18.971439+00:00, confidence not recorded.
  - readme: https://github.com/hypriot/flash (fetched 2026-08-28T04:03:14.526933+00:00, sha 3dddc8752f8a)
- Data as of 2026-08-30T08:39:29.467469+00:00.
