# romanz/amodem

Audio MODEM Communication Library in Python

Repository: https://github.com/romanz/amodem
Canonical: https://ross.abutalabs.com/products/amodem
Language: Python
License: NOASSERTION
License Family: other
Topics: python, audio, modem, airgap
Last push: 2025-11-12T20:15:09+00:00

## Health v2 (maintenance only)
Score: 55/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 51, release rhythm 35, longevity 100
- inputs: {"age_days": 4415, "days_push": 294, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1047, forks 137 (observed 2026-08-28T04:03:22.236534+00:00)

## What it is
A Python library and CLI tool that transmits files between computers by modulating data into audio signals (OFDM) played through a speaker and demodulated from a microphone, enabling air-gapped communication. It supports bitrates up to 80 kbps over an audio cable with CRC-32 integrity checks.

## Use cases
- transfer files between air-gapped computers via audio
- send data over an audio cable between two machines
- exfiltrate or import data from a machine with no network interfaces
- experiment with OFDM modulation and demodulation in Python
- build acoustic data communication into a Python application

## When to choose
- you need to move small files to or from a truly air-gapped machine using only speakers and microphones
- you want a simple Python-based acoustic modem with configurable bitrates
- you need a higher-bandwidth alternative to QR-code or blinking-LED air-gap transfers

## When to avoid
- you need fast, reliable bulk data transfer - audio transmission is slow (~10 kB/s max) and error-prone
- you need network-based file transfer between connected machines
- you require a production-grade communication channel with strong guarantees

## Facets
- artifact type: library
- maturity: active
- function: audio-processing, serialization, developer-tools
- domain: networking, security, developer-tools, hardware
- platform: python, windows, cross-platform, cli
- tags: audio-modem, air-gap, ofdm, data-exfiltration, acoustic-communication, file-transfer, linux, macos

## Member repositories
- romanz/amodem (main) score 55

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:22.236534+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:01:09.158088+00:00, confidence not recorded.
  - readme: https://github.com/romanz/amodem (fetched 2026-08-28T04:03:22.236534+00:00, sha 81ba4fa69caa)
  - registry_pypi: https://pypi.org/pypi/amodem/json (fetched 2026-08-29T13:02:50.694157+00:00, sha 4fc7821f2a56)
- Data as of 2026-08-30T08:39:29.467469+00:00.